# 本人確認チェック Stripe Identity がサポートするさまざまな本人確認チェックについてご紹介します。 Stripe Identity では現在、書類、顔写真、ID 番号、住所、電話番号の ５ 種類の検証チェックがサポートされています。 確認チェックごとに、ユーザーから提供してもらう情報が異なり、対応範囲にも違いがあります。また、確認フローも異なります。いずれかのチェックの導入後に、実装をわずかに変更するだけで、別のチェックを追加できます。 # 書類 > This is a 書類 for when type is document. View the full page at https://docs.stripe.com/identity/verification-checks?type=document. 書類チェックでは、政府発行の本人確認書類が本物であることを検証します。Stripe では、AI モデル、自動ヒューリスティック分析、手動審査を組み合わせて、数百種類もの書類の真正性を検証しています。 AI モデルは、書類の表面と裏面の高解像度画像をキャプチャーするために使用されます。書類の画像はリアルタイムで分析され、判読可能かどうかがチェックされます。書類の有効期限が切れている場合や、確認を完了できる可能性が低い場合、ユーザーに警告が出されます。Stripe は、不正利用の書類テンプレートのデータベースと照合して画像を確認します。このデータベースは頻繁に更新されるため、Stripe は新たな偽の書類テンプレートを検出し、自動的にブロックできます。 可能な場合は、書類内のバーコードやその他の機械読み取り可能な要素がデコードされ、整合性チェックが行われます。これにより、テキストの書類データが、機械読み取り可能なデータと一致していることが確認されます。 不正利用者が盗んだ書類や他人の顔写真を使う「なりすまし攻撃」を防ぐため、Stripe ではコンピュータービジョンと AI アルゴリズムを使用して、実際の書類の画像がユーザーによってキャプチャーされたものであることを確認します。 書類チェックをアプリに組み込む方法については、[ユーザーの本人確認書類を確認する](https://docs.stripe.com/identity/verify-identity-documents.md)ガイドを参照してください。 また、書類チェックは、[ID 番号チェックと組み合わせる](https://docs.stripe.com/api/identity/verification_sessions/create.md#create_identity_verification_session-options-document-require_id_number)こともできます。組み合わせることで、書類の真正性が確保され、書類内の情報をサードパーティーのデータベースで相互参照できるようになります。 ## 利用可能対象 書類チェックで利用できるのは、以下の国の政府発行書類 (国民 ID、運転免許証、パスポート) のほぼすべてです。 ご使用いただける本人確認書類は国によって異なりますが、パスポートは広くサポートされています。 - AE - AL - AM - AR - AT - AU - AZ - BD - BE - BG - BH - BJ - BO - BR - BS - BY - CA - CH - CI - CL - CM - CN - CO - CR - CY - CZ - DE - DK - DO - DZ - EC - EE - EG - ES - FI - FR - GB - GE - GH - GR - GT - HK - HN - HR - HT - HU - ID - IE - IL - IN - IQ - IT - JE - JM - JO - JP - KE - KR - KW - KZ - LB - LI - LK - LT - LU - LV - MA - MD - MK - MM - MN - MT - MU - MX - MY - NG - NL - NO - NP - NZ - PA - PE - PH - PK - PL - PR - PS - PT - PY - RO - RS - RU - SA - SE - SG - SI - SK - SV - TH - TN - TR - TW - UA - UG - US - UY - UZ - VE - VN - ZA > Stripe は、アラビア語、中国語、キリル文字、ギリシャ語、へブライ語、韓国語、タミル語、タイ語で記述されたドキュメントフィールドの抽出をサポートしていません。 # 顔写真 > This is a 顔写真 for when type is selfie. View the full page at https://docs.stripe.com/identity/verification-checks?type=selfie. 書類チェックでは、不正な本人確認書類の使用を未然に防ぐことができますが、不正行為者は盗んだ本物の書類を使用する可能性もあります。これを防ぐために、Stripe Identity では、ユーザーに対して顔写真チェックを行うことができます。 顔写真チェックでは、政府発行の写真付き身分証明書とユーザーの顔写真から、顔の形などの生物学的特徴を検出します。その後、Stripe では高度な機械学習アルゴリズムを使用して、その顔写真が同一人物のものであることを確認します。 EU など一部の地域では、個人情報保護法により、生体認証技術の使用が正当である理由を示すか、生体認証以外の認証手段を提供することが義務付けられています。代替となる認証手段を用意するか、法律顧問に相談されることをお勧めします。 ### 利用可能対象 顔写真チェックで使用できるのは、以下の国の政府発行の写真付き身分証明書です。 - AE - AL - AM - AR - AT - AU - AZ - BD - BE - BG - BH - BJ - BO - BR - BS - BY - CA - CH - CI - CL - CM - CN - CO - CR - CY - CZ - DE - DK - DO - DZ - EC - EE - EG - ES - FI - FR - GB - GE - GH - GR - GT - HK - HN - HR - HT - HU - ID - IE - IL - IN - IQ - IT - JE - JM - JO - JP - KE - KR - KW - KZ - LB - LI - LK - LT - LU - LV - MA - MD - MK - MM - MN - MT - MU - MX - MY - NG - NL - NO - NP - NZ - PA - PE - PH - PK - PL - PR - PS - PT - PY - RO - RS - RU - SA - SE - SG - SI - SK - SV - TH - TN - TR - TW - UA - UG - US - UY - UZ - VE - VN - ZA ## 顔写真チェックを追加する アプリケーションに顔写真チェックを追加するには、まず [本人確認書類を収集と検証](https://docs.stripe.com/identity/verify-identity-documents.md) のガイドに従ってください。 ## VerificationSessions に顔写真チェックを追加する [VerificationSession を作成](https://docs.stripe.com/api/identity/verification_sessions/create.md)する際、[options.document.require_matching_selfie](https://docs.stripe.com/api/identity/verification_sessions/create.md#create_identity_verification_session-options-document-require_matching_selfie) パラメーターを使用して顔写真チェックを有効にします。 ```curl curl https://api.stripe.com/v1/identity/verification_sessions \ -u "<>:" \ -d type=document \ -d "options[document][require_matching_selfie]=true" ``` これにより、政府発行の写真付き身分証明書とユーザーの顔写真を要求する確認フローが構成されます。 ## 顔写真チェックの結果にアクセスする 送信および処理後、VerificationSessionステータスは、チェックの結果に応じて変化します。 - `verified`: 書類と顔写真の両方のチェックが完了しました。セッションの [verified_outputs](https://docs.stripe.com/api/identity/verification_sessions/object.md#identity_verification_session_object-verified_outputs) には、書類から抽出された情報が含まれます。 - `requires_input` — 書類または顔写真のチェックのうち、少なくとも一方が失敗しました。 キャプチャーされた顔写真と書類の画像にアクセスするには、関連する [VerificationReport](https://docs.stripe.com/api/identity/verification_reports.md) を取得する必要があります。これを実行するには、以下のセッションで [last_verification_report](https://docs.stripe.com/api/identity/verification_sessions/object.md#identity_verification_session_object-last_verification_report) フィールドを[拡張](https://docs.stripe.com/api/expanding_objects.md)します。 #### Node.js ```javascript // Don't put any keys in code. See https://docs.stripe.com/keys-best-practices. // Find your keys at https://dashboard.stripe.com/apikeys. const stripe = require('stripe')('<>'); const verificationSession = await stripe.identity.verificationSessions.retrieve( '{{SESSION_ID}}', { expand: ['last_verification_report'], } ); const verificationReport = verificationSession.last_verification_report; ``` VerificationReport には、書類と顔写真のチェック結果を含む [document](https://docs.stripe.com/api/identity/verification_reports/object.md#identity_verification_report_object-document) および [selfie](https://docs.stripe.com/api/identity/verification_reports/object.md#identity_verification_report_object-selfie) のフィールドがあります。以下は、書類と顔写真のチェックに成功した VerificationReport の例です。 ```json { "id": "vr_orWziM4j7CiRL8J4vQmXgW2w", "object": "identity.verification_report", "type": "document", "verification_session": "vs_orWziM4j7CiRL8J4vQmXgW2w", "created": 1611776872, "livemode": true, "options": { "document": { "require_matching_selfie": true } }, "document": { "status": "verified", "error": null, "first_name": "Jenny", "last_name": "Rosen", "address": { "line1": "1234 Main St.", "city": "San Francisco", "state": "CA", "postal_code": "94111", "country": "US" }, "document_type": "id_card", "expiration_date": { "day": 17, "month": 7, "year": 2024 }, "files": ["file_orWziM4j7CiRL8J4vQmXgW2w", "file_orWziM4j7CiRL8J4vQmXgW2w"], "issued_date": { "day": 4, "month": 27, "year": 2021 }, "issuing_country": "US" }, "selfie": { "status": "verified", "error": null, "document": "file_orWziM4j7CiRL8J4vQmXgW2w", "selfie": "file_orWziM4j7CiRL8J4vQmXgW2w", } } ``` 収集された書類と顔の画像にアクセスするには、[検証結果へのアクセス](https://docs.stripe.com/identity/access-verification-results.md) を参照してください。 ## 顔写真チェックの失敗について VerificationReport の [document](https://docs.stripe.com/api/identity/verification_reports/object.md#identity_verification_report_object-document) および [selfie](https://docs.stripe.com/api/identity/verification_reports/object.md#identity_verification_report_object-selfie) のフィールドには、収集されたデータに加え、チェックの成否を知るのに役立つ `status` と `error` のフィールドが含まれます。 `status` フィールドは、各チェックが成功したかどうかを示します。可能な値は以下の通りです。 - `verified`- 検証チェックが成功し、収集されたデータが検証されました。 - `unverified`: 本人確認チェックは失敗しました。詳細については、`error` ハッシュを参照してください。 本人確認チェックが失敗すると、`error` フィールドに、確認失敗の理由を説明する `code` と `reason` の値が含まれます。`error.code` フィールドは、検証失敗をプログラム的に処理するために使用できます。`reason` フィールドには失敗の理由を説明するメッセ―ジが含まれており、ユーザーに表示できます。 ### 書類チェックの失敗 失敗の詳細はレポートの [document.error](https://docs.stripe.com/api/identity/verification_reports/object.md#identity_verification_report_object-document-error) フィールドに表示されます。 | エラーコード | 説明 | | ----------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `document_expired` | 提供された身分証明書の有効期限が切れています。 | | `document_unverified_other` | Stripe は、提供された本人確認書類を確認できませんでした。[対応している書類タイプのリストをご覧ください](https://docs.stripe.com/identity/verification-checks.md?type=document)。 | | `document_type_not_supported` | 提供された本人確認書類は、セッションで[許可されている書類のタイプ](https://docs.stripe.com/api/identity/verification_sessions/create.md#create_identity_verification_session-options-document-allow_document_types)ではありません。 | ### 顔写真チェックの失敗 失敗の詳細はレポートの [selfie.error](https://docs.stripe.com/api/identity/verification_reports/object.md#identity_verification_report_object-selfie-error) フィールドに表示されます。 | エラーコード | 説明 | | ------------------------------- | ---------------------------- | | `selfie_document_missing_photo` | 提供された身分証明書に顔の写真が含まれていませんでした。 | | `selfie_face_mismatch` | 撮影された顔の画像は文書の顔と一致しませんでした。 | | `selfie_unverified_other` | Stripeは、提供された顔写真を確認できませんでした。 | | `selfie_manipulated` | 撮影された顔の画像が加工処理されていました。 | # ID 番号 > This is a ID 番号 for when type is id-number. View the full page at https://docs.stripe.com/identity/verification-checks?type=id-number. ID 番号チェックでは、ユーザーの名前、生年月日、国民 ID 番号を確認できます。Stripe では、信用調査機関、公共機関や政府が発行した書類のデータベースなど、サードパーティーのデータソースを組み合わせて、提供された ID 番号を確認します。 アプリに ID 番号チェックを追加する方法については、[VerificationSession の作成](https://docs.stripe.com/identity/verification-sessions.md#create)を参照してください。 ### 利用可能対象 ID 番号チェックは、以下の国でご利用いただけます。 - US # 電話番号 (招待のみ) > This is a 電話番号 (招待のみ) for when type is phone. View the full page at https://docs.stripe.com/identity/verification-checks?type=phone. 電話番号確認は、コンバージョンの時間を短縮し、本人確認プロセスを向上させるスムーズな確認方法です。Stripe は本人確認フローでユーザーに電話番号と氏名を求めます。指定された電話番号に SMS 確認コードが送信され、ユーザーは画面上でコードを確定する必要があります。同時に、Stripe の記録とそのネットワーク上の他のリスクシグナルによって、電話番号の所有権が確認されます。所有権データを確認できた場合、ユーザーはお客様のサイトに戻ることができます。確認の判断がつかなかった場合、ユーザーをシームレスに書類確認フローへと移行することができます。 ### 提供状況 (招待のみ) 以下の国々における電話番号チェックへのアクセスをご要望の場合は、[お問い合わせ](mailto:identity-phone-verification-beta@stripe.com)ください。 - US # 住所 (招待のみ) > This is a 住所 (招待のみ) for when type is address. View the full page at https://docs.stripe.com/identity/verification-checks?type=address. 住所チェックでは、ユーザーの名前、生年月日、住所を確認できます。Stripe では、信用調査機関、公共機関や政府が発行した書類のデータベースなど、サードパーティーのデータソースを組み合わせて、提供された住所を確認します。 アプリに住所番号チェックを追加する方法については、[VerificationSession の作成](https://docs.stripe.com/identity/verification-sessions.md#create)を参照してください。 ### 提供状況 (招待のみ) 以下の国で住所チェックへのアクセスをご要望の場合は、[サポートにお問い合わせください](https://support.stripe.com/contact)。 - AT - AU - BE - BR - CA - CH - CZ - DE - DK - ES - FI - FR - GB - HK - ID - IE - IT - MT - MX - MY - NL - NO - PL - PT - RO - SE - SG - SK - TH - US ## See also - [ユーザーの本人確認書類を確認する](https://docs.stripe.com/identity/verify-identity-documents.md) - [Verification Session API](https://docs.stripe.com/identity/verification-sessions.md#create)