API を利用して本人確認を処理する

API を使用して連結アカウントを登録している Connect プラットフォームは、顧客確認 (KYC) のために必要な情報を Stripe に提供して、アカウントのケイパビリティを有効にする必要があります。各プラットフォームは、自ら情報を収集し、Accounts API と Persons API を使用してその情報を Stripe に提供します。その後、Stripe が情報を確認し、必要に応じて詳細を尋ねます。

責任あるプラットフォームは、連結アカウントの要件ステータスも監視し、更新にタイムリーに対応する必要があります。

確認プロセス

連結アカウントの支払いと入金を有効にする前に、Stripe は以下に応じて異なる特定の情報を必要とします。

• 連結アカウントの所在国
• 連結アカウントに適用される利用規約タイプ
• 連結アカウントでリクエストされるケイパビリティ
• business_type (個人または会社など) および company.structure (public_corporation または private_partnership など)

プラットフォームは、KYC 要件を満たすために、ビジネスと連結アカウントに適したオンボーディングフローを選択する必要があります。つまり、必要な情報を最初から、または段階的に提供することを意味します。いずれにせよ、Stripe からのリクエストを監視し、それに応答する実装を設定してください。

1. Webhook 設定で Connect Webhook URL を確立し、アクティビティ、特に account.updated イベントを監視します。Persons API を使用するときは、person.updated イベントも監視します。
2. アカウント作成後、すぐに Account オブジェクトの requirements.currently_due 属性で追加の要件を確認します。連結アカウントから必要な情報を取得し、Account を更新します。requirements.currently_due が空でない限り、Account には、ケイパビリティが制限される可能性のある未対応の要件があります。
3. account.updated のイベント通知を引き続き注視して、requirementsのハッシュが変わるか確認し、必要に応じて連結アカウントに追加情報を求めてください。

追加情報を入力した場合、以前に確認した情報を再度提出する必要はありません。例えば、既に dob が確認されていれば、変更しない限り再度提出する必要はありません。

Stripe のリスクレビュー要件

Stripe の連結アカウントのリスクレビューでは、API を使用して提供できない追加の要件が追加される場合があります。ダッシュボードで対応するか、連結アカウントが Connect 埋め込みコンポーネント、Stripe ホスト型オンボーディング、または改善リンクを通じて提供できます。

確認が必要かどうかを判断する

Account オブジェクトの charges_enabled 属性と payouts_enabled 属性は、支払いを作成して入金を受け付けることができるかどうかを示します。

これらの属性のいずれかが false の場合は、Account の requirements ハッシュを確認して、支払いと入金を有効にするために必要な情報を判断します。

requirements ハッシュには、次のプロパティが含まれます。

以下の例は、currently_due の情報、eventually_due の情報、確認 errors を引き起こしている情報が含まれるアカウントの場合に、requirements ハッシュがどのように表示されるかを示しています。

{
  "id": 
"{{CONNECTED_ACCOUNT_ID}}",
  "object": "account",
  "requirements": {
      "alternatives": [],
      "current_deadline": 1529085600,
      "currently_due": [
          "company.tax_id",
          "company.verification.document",
          "tos_acceptance.date",
          "tos_acceptance.ip"
      ],
      "disabled_reason": null,
      "errors": [
          {
            "requirement": "company.verification.document",
            "reason": "The company name on the account couldn't be verified. Either update your business name or upload a document containing the business name.",
            "code": "failed_name_match"
          },
      ]
      "eventually_due": [
          "company.address.city",
          "company.address.line1",
          "company.address.postal_code",
          "company.address.state",
          "company.tax_id",
          "company.verification.document",
          "external_account",
          "tos_acceptance.date",
          "tos_acceptance.ip"
      ],
      "past_due": [],
      "pending_verification": []
  },
  ...
}

requirements.currently_due にエントリが含まれる場合は、Unixタイムスタンプである requirements.current_deadline を確認します。通常、Stripe が current_deadline までに情報を受信しない場合、そのアカウントでの入金は無効化されます。ただし、状況によっては、別の結果になる可能性もあります。たとえば、入金がすでに無効になっていて、アカウントが問い合わせに応答しない場合、Stripe が支払いを処理する機能も無効にすることがあります。

それとは別に、requirements.disabled_reason プロパティには、アカウントの特定のケイパビリティが無効化された理由を示す文字列を含めることができます。状況によっては、プラットフォームと連結アカウントがフォームを送信して、理由の解決または異議申し立てを行うことができます。

• Standard アカウントを含む、Stripe ダッシュボードの全機能にアクセスできる連結アカウントは、ダッシュボードにある追加情報 (利用可能な場合) にアクセスできます。
• プラットフォームは、Connected accounts ページでアカウントの disabled_reason を参照できます。連結アカウントの代理として追加情報を提供できる場合があります。無効化の理由が異議申し立てに関連付けられている場合は、アカウントが異議申し立てを解決するためのフォームへのリンクを生成できます。

検証エラーと確認エラー

Account オブジェクトには、検証要件または確認要件が満たされていない理由を説明する requirements.errors 配列が含まれます。アカウントのケイパビリティを有効にするには、これらの要件を満たす必要があります。

errors 配列には、次の属性があります。

次の例は、currently_due の要件があるアカウントの errors 配列、提出された情報を使用してアカウントを有効化できない理由、およびエラーを解決する方法を示しています。

{
  "id": 
"{{CONNECTED_ACCOUNT_ID}}",
  "object": "account",
  "requirements": {
      "current_deadline": 1234567800,
      "currently_due": [
          "company.address.line1",
          "{{PERSON_ID}}.verification.document",
      ],
      "errors": [
          {
            "requirement": "company.address.line1",
            "code": "invalid_street_address",
            "reason": "The provided street address cannot be found. Please verify the street name and number are correct in \"10 Downing Street\"",
          },
          {
            "requirement": "{{PERSON_ID}}.verification.document",
            "code": "verification_document_failed_greyscale",
            "reason": "Greyscale documents cannot be read. Please upload a color copy of the document.",
          }
      ]
  },
  ...
}

確認または検証に失敗した場合、要件がエラー情報とともに currently_due、alternative_fields_due、または eventually_due に再表示される場合があります。これらの要件の通知を受け取るには、Connect Webhook を設定して account.updated イベントをリッスンします。

事業情報

Stripe は、ビジネスについて送信されたすべての情報を確認します。たとえば、ビジネスの URL が有効であり、アクセス可能であり、ビジネスに関する情報が含まれていることを確認します。確認ステータスをチェックするには、Account オブジェクトの requirements ハッシュを取得します。

事業情報の確認に関連するエラーは次のとおりです。

次の URL エラーを解決するには、URL 確認エラーを処理するを参照してください。

• invalid_url_denylisted
• invalid_url_format
• invalid_url_web_presence_detected
• invalid_url_website_business_information_mismatch
• invalid_url_website_empty
• invalid_url_website_inaccessible
• invalid_url_website_inaccessible_geoblocked
• invalid_url_website_inaccessible_password_protected
• invalid_url_website_incomplete
• invalid_url_website_incomplete_cancellation_policy
• invalid_url_website_incomplete_customer_service_details
• invalid_url_website_incomplete_legal_restrictions
• invalid_url_website_incomplete_refund_policy
• invalid_url_website_incomplete_return_policy
• invalid_url_website_incomplete_terms_and_conditions
• invalid_url_website_incomplete_under_construction
• invalid_url_website_other

担当者

連結アカウントに関連付けられている人物に関する情報を収集して送信する必要があります。このプロセスは、連結アカウントが会社、個人、またはその両方であるかによって異なります。

企業の場合は、Persons API を使用して、Account オブジェクトに関連付けられた Person オブジェクトに情報を追加します。Person オブジェクトの verification ハッシュにドキュメントを追加するには、まず Files API を使用してドキュメントファイルを Stripe のサーバーにアップロードします。

個人の場合は、Person を作成するか、Account オブジェクトの individual ハッシュに情報を追加できます。

連結アカウントに会社と個人の両方が含まれる場合は、Person オブジェクトを作成して、すべてのアカウントに対して同じプロセスを使用できるようにします。

Account の確認ステータスをチェックするには、その requirements ハッシュを取得します。

本人確認に関連するエラーは次のとおりです。

受け付け可能な確認書類

Stripe が連結アカウントで受け付ける本人確認書類のタイプは国によって異なり、他の Stripe アカウントと同じです。

会社情報

確認プロセスの際に、アカウントの会社に関する情報の収集が必要になる場合があります。

確認ステータスをチェックするには、Account オブジェクトの company.verification サブハッシュを取得します。

{
  "id": 
"{{CONNECTED_ACCOUNT_ID}}",
  "object": "account",
  ...
  "company": {
    "verification": {
      "document": null
    },
    ...
  },
  ...
}

Account オブジェクトの各検証属性の定義を確認できます。

明細書表記

Stripe は、Account で明細書表記と明細書表記プレフィックスを設定する際に、これらを検証します。たとえば、カードネットワークに提供された最初の 22 文字がビジネスの説明と一致するかどうかを確認します。Account の business_profile.name、business_profile.url、または会社や個人の名前と一致しているかどうかが確認されます。

明細書表記の確認ステータスをチェックするには、Account オブジェクトの requirements ハッシュを取得します。

明細書表記の確認に関連するエラーは次のとおりです。

書類確認の問題を処理する

アップロードされた書類ファイルに関連する一般的な要件確認エラーを解決するには、次の表を参照してください。

認証に失敗した場合は、同じファイルを再度提出しないでください。重複アップロードは自動的に失敗します。

URL 確認エラーを処理する

Stripe’s terms of service require all e-commerce businesses to populate the business_profile.url property on their Account with a working URL of their business website when requesting the card_payments capability. A connected account is considered an e-commerce business if it promotes or sells any products or services through an online website, social media profile, or mobile application. For more information, see the Business website for account activation FAQ.

If the connected account doesn’t operate a website to promote their business, sell products, or accept payments, they’re required to provide the business_profile.product_description instead. A product description must detail the type of products being sold, as well as the manner in which the business charges its customers (for example, in-person transactions).

EC ビジネスの URL は、特定のカードネットワーク基準に準拠している必要があります。Stripe は、これらの基準に準拠するために、URL を審査する際に多くの確認を実施しています。EC ビジネスの URL と共通要素のベストプラクティスをご確認ください。

多くの場合、URL 確認エラーは、以下のいずれかを行うことで解決できます。

• プラットフォームダッシュボードから改善リンクを生成する。
• Account オブジェクトの business_profile.url を更新する。

別の方法でエラーを解決した場合 (会社のウェブサイトを使用して問題を修正した場合など)、Account オブジェクトの URL を別の値に変更し、すぐに元に戻して再確認をトリガーする必要があります。

API を使用して、URL 関連の問題をすべて解決できるわけではありません。URL 確認エラーの種類によっては、連結アカウントのウェブサイトへのアクセス方法や、アカウントが URL 要件を免除されていることの証明などの情報が追加で必要です。この種の問題を解決するには、プラットフォームまたは連結アカウントが補足情報を提供する必要があります。

問題を解決できない場合は、連結アカウントに Stripe サポートへの問い合わせを案内してください。

URL 確認エラーを解決するには、次の表を参照してください。

ライブネス要件を処理する

アカウントには、proof_of_liveness 要件が設定された 1 つ以上の Person オブジェクトを設定できます。proof_of_liveness 要件では、シンガポールの MyInfo などの電子 ID 情報の収集、または Stripe Identity を使用して書類や顔写真を収集する必要がある場合があります。proof_of_liveness 要件のすべてのバリエーションを満たすには、Stripe ホスト型または埋め込み型オンボーディングを使用することをお勧めします。

curl https://api.stripe.com/v1/account_links \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d account=
"{{CONNECTED_ACCOUNT_ID}}" \
  --data-urlencode refresh_url="https://example.com/refresh" \
  --data-urlencode return_url="https://example.com/return" \
  -d type=account_onboarding \
  -d "collection_options[fields]"=currently_due

本人確認を処理する

アカウントで本人確認のための情報によっては、1 つ以上の書類のアップロードをお願いする場合があります。必要な書類は、Account オブジェクトの requirements ハッシュに表示されます。

requirements.currently_due に表示される書類をアップロードする必要があります。

• person.verification.document: 受け入れ可能な形式の身分証明書のカラースキャンまたは写真をアップロードしてください。
• person.verification.additional_document: 公共料金の請求書など、ユーザーの住所が確認できる書類のカラースキャンまたは写真をアップロードします。
• company.verification.document: 会社の定款など、事業体 ID 番号を証明する法人書類をアップロードします。

requirements.alternatives.alternative_fields_due に verification.document 要件が含まれている場合、これを requirements.alternatives.original_fields_due の代わりに使用できます。

セキュリティ上の理由から、Stripe はメールでの身分証明書の提出を受け付けていません。文書のアップロードは 2 段階のプロセスです。

1. Stripe にファイルをアップロードする。
2. アカウントにファイルを添付する。

ファイルをアップロードする

ファイルをアップロードするには、Files API を呼び出してファイルを作成します。

アップロードするファイルは以下の要件を満たしている必要があります。

• カラー画像 (8,000 ピクセル x 8,000 ピクセル以下)
• 10 MB 以下
• 本人確認書類が JPG または PNG 形式である
• 住所または法人確認書類が JPG、PNG、または PDF 形式である

ファイルデータを file パラメータに渡し、ドキュメントを保持する Account または Personオブジェクトに応じて purpose パラメータを設定してください。目的を特定するには、API リファレンスでプロパティを確認してください。

curl https://files.stripe.com/v1/files \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -H "Stripe-Account: {{CONNECTED_STRIPE_ACCOUNT_ID}}" \
  -F "purpose"="identity_document" \
  -F "file"="@/path/to/a/file"

次のリクエストはファイルをアップロードし、トークンを返します。

{
  "id": 
"{{FILE_ID}}",
  "created": 1403047735,
  "size": 4908
}

トークンの id 値を使用して、連結アカウントにファイルを関連付けて本人確認を行います。

ファイルを添付する

ファイルをアップロードし、代表トークンを受け取った後、Account オブジェクトまたは Person オブジェクトを更新し、適切なパラメータでファイル ID を提供してください。

次の例は、政府発行の身分証明書の場合です。

curl https://api.stripe.com/v1/accounts/
{{CONNECTED_ACCOUNT_ID}}
/persons/
{{PERSON_ID}} \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "verification[document][front]"=
"{{FILE_ID}}"

次の例は、会社の書類の場合です。

curl https://api.stripe.com/v1/accounts/
{{CONNECTED_ACCOUNT_ID}} \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "company[verification][document][front]"=
"{{FILE_ID}}"

この更新により、verification.status が pending に変更されます。追加の個人を確認する必要がある場合は、Persons API を使用して更新します。

身分証明書を確認する

個人または会社の本人確認要件がすべて満たされると、v2.core.account_person.updated または v2.core.account[identity].updated Webhook 通知がトリガーされ、確認プロセスが完了したことが通知されます。

Stripe による画像の確認には、読み取りやすさに応じて数分から数営業日かかる場合があります。

確認が失敗した場合、関連付けられた要件エントリには、原因を説明する code と description が含まれたエラーが含まれます。description は、アカウントユーザーに提示できる「提供された画像が読み取り不可です」などのローカライズされていない平易なメッセージです。code 値は、verification_document_not_readable などの文字列で、アカウントユーザーのエラーメッセージのローカライズに使用できます。

確認が失敗すると、v2.core.account_person.updated または v2.core.account[identity].updated Webhook 通知もトリガーされます。

Stripe Identity によるホスト型書類収集

Stripe Identity を使用してドキュメントを収集し、それをアカウントに直接関連付けることで、person.verification.document 要件を満たすことができます。ただし、Stripe Identity を使用して person.verification.additional_document 要件または company.verification.document 要件を満たすことはできません。

VerificationSession を作成します。以下の例のように、related_person パラメーターを指定して、収集した確認データを document を必要とする Person オブジェクトに関連付けます。

curl https://api.stripe.com/v1/identity/verification_sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d type=document \
  -d "related_person[account]"=
"{{CONNECTED_ACCOUNT_ID}}" \
  -d "related_person[person]"=
"{{PERSON_ID}}"

VerificationSession を作成したら、返された client_secret を使用して、Identity モーダルをユーザーに表示するか、ユーザーを url にリダイレクトします。確認が完了すると、アカウントが自動的に更新されます。

アカウントが本人確認を完了し、情報を更新すると、Stripe から Webhook エンドポイントに account.updated イベントが送信されます。

フォームまたはサポートベースの要件に対応する

Stripe は、リスクと法令遵守の要件を requirements ハッシュでレポートします。これらの要件の形式は <id>.<requirement_description>.<resolution_path> です。

• id: Stripe または金融パートナーが必要とする情報を一意に識別します。この ID には、リスク確認要件を示す interv_ が常にプレフィックスとして付与されます。
• requirement_description: identity_verification、rejection_appeal など、要件を満たすために必要な情報を具体的に説明します。
• resolution_path: リクエストされた情報をプラットフォームまたは連結アカウントが提供する方法を指定します。
  • challenge: 連結アカウントは、チャレンジプロンプトに直接応答する必要があります。多くの場合、銀行口座などの機密情報や、顔写真などアカウント所有者のみが提供できる情報が必要となります。
  • form: フォームリクエストには連結アカウントが入力するか、プラットフォームがアカウントの代理として入力できます。
  • support: 要件に直接対応できません。Stripe サポートにお問い合わせください。

{
  "id": 
"{{CONNECTED_ACCOUNT_ID}}",
  "object": "account",
  "requirements": {
      "current_deadline": 1234567800,
      "currently_due": [
          "{{REQUIREMENT_ID}}.restricted_or_prohibited_industry_diligence.form"
      ],
      "pending_verification": [],
      ...
  },
  ...
}

解決パスの要件が満たされると、要件の解決パスの値が support に変わり、その要件が要件ハッシュの pending_verification セクションにも表示されます。Stripe は提出された情報を確認し、解決済みとして要件を終了するか、現在、期限が来ている新しい要件を掲載します。

{
  "id": 
"{{CONNECTED_ACCOUNT_ID}}",
  "object": "account",
  "requirements": {
      "current_deadline": 1234567800,
      "currently_due": [],
      "pending_verification": [
        "{{REQUIREMENT_ID}}.restricted_or_prohibited_industry_diligence.support"
      ],
      ...
  },
  ...
}

リスクと規制順守の要件は、要件のタイプに応じて、以下のいずれかの方法で改善できます。

• Connect 埋め込みコンポーネント: Connect コンポーネントを埋め込み、ウェブサイトに埋め込んでユーザーをアカウントオンボーディング埋め込みコンポーネントに誘導します。埋め込みコンポーネントでは、UI で未対応の要件を完了するようにユーザーに求めます。または、通知バナー埋め込みコンポーネントを使用して、未対応の要件をユーザーに求めます。
• Stripe ホスト型オンボーディング: 連結アカウントを誘導するリンクを生成して、アカウントリンクからプログラムによって、またはプラットフォームダッシュボードから手動で未対応の要件に対応できます。
• アカウントの代理で入力: プラットフォームダッシュボードを使用して、連結アカウントの詳細からフォームベースのリスク要件を特定し、アカウントの代理で入力します。

次の表は、リスクおよび法令遵守関連の要件の詳細を示しています。