コンテンツにスキップ
アカウント作成/サインイン
Stripe ドキュメントのロゴ
/
アカウントを作成サインイン
概要
アカウント管理
決済処理
プラットフォーム管理

今後の要件の更新

必要な確認情報の変更と、この変更が貴社で構築済みの Stripe システムに及ぼす影響について、詳細をご紹介します。

決済に関する規制は、マネーロンダリング、不正利用、脱税などの犯罪を防ぐために設けられています。世界中の金融規制当局は、Know Your Customer (KYC) 要件を施行し、Stripe が特定のタイプのビジネスと、最終的にそれらを所有、管理、または指示する個人から本人確認情報を収集、検証、維持することを義務付けています。これらの要件は、金融サービスの規制当局、カードネットワーク、その他の金融機関によって頻繁に更新されます。

このガイドは、今後の変更の概要を示すものであり、最も重要な変更内容を強調表示しています。要件をすべて網羅したリストについては、必要な確認情報を参照してください。

連結アカウントのユーザー登録に API ベースのフローを使用する場合は、要件の変更をすべて処理するように導入を更新する必要があります。Connect アカウント登録オプションと、API ベースのユーザー登録および改善策フローを Stripe がホストするフローまたは埋め込みフローに移行する方法の詳細をご確認ください。

最終更新日: 2026 年 2 月 23 日

検証要件の変更を理解

イギリス金融行動監視機構 (FCA) とアイルランド中央銀行 (CBI) の規制に合わせるため、Stripe は KYC (顧客確認) 要件と、最終的実質的所有者 (UBO) と取締役の関係確認を更新する予定です。

リストに記載されているいずれかの国で連結アカウントを運用している場合、ユーザー登録フローを更新する必要がある可能性があります。必要な更新を行わないと、連結アカウントの決済や金融サービスへのアクセスが中断されます。

変更点と理由については、新しい法令遵守要件に対応する記事 をご覧ください。

今度の変更は、以下の国の連結アカウントに影響します。

アイスランド
アイルランド
イギリス
イタリア
エストニア
オーストリア
オランダ
キプロス
ギリシャ
クロアチア
ジブラルタル
スイス
スウェーデン
スペイン
スロバキア
スロベニア
チェコ共和国
デンマーク
ドイツ
ノルウェー
ハンガリー
フィンランド
フランス
ブルガリア
ベルギー
ポーランド
ポルトガル
マルタ
ラトビア
リトアニア
リヒテンシュタイン
ルーマニア
ルクセンブルグ

継続的な更新

Stripe は 2026 年 4 月 1 日まで、これらの要件の収集をサポートする API の更新を続けます。

導入するアプローチの選択

Stripe では、事業および本人確認の要件を収集する際に、Stripe ホスト型または組み込み型のオンボーディングの使用を推奨しています。これらのオプションは、API オンボーディングを使用するよりも実装および維持に必要なリソースが少なくて済みます。以下の表は主な違いを示しています。

  • Stripe ホスト型オンボーディング:推奨 Stripe ホスト型フローにアカウントを送信して、必要な情報を送信します。
  • 組み込みオンボーディング::推奨 Stripe が提供するオンボーディングコンポーネントを埋め込むことで、アプリ内から Stripe にアカウント情報を直接送信できます。
  • API onboarding:Stripe API を使用してカスタムオンボーディングフローを構築、管理します。
Stripe ホスト型ユーザー登録組み込みユーザー登録API によるアカウント登録
以下の場合に最適Stripe がアカウント登録を担当するプラットフォームブランドのアプリ内ユーザー登録フローを求めるプラットフォーム完全なコントロールを必要とし、それを構築・維持できるプラットフォーム
初期導入作業3～4週間3～4週間30～40 週間
要件更新への継続的な取り組みStripe が自動的に処理Stripe が自動的に処理今後の変更を事前に監視し、変更ごとにユーザー登録フローを更新するエンジニアリングリソースが必要
カスタマイズプラットフォームブランディングによる Stripe ホストインターフェイス口座がプラットフォームアプリからアクセスできるテーマ性の高いコンポーネントプラットフォームの設計、構築、インターフェイスのメンテナンス
追加国に対応する努力Stripe が自動的に処理Stripe が自動的に処理追加国ごとにユーザー登録フローを更新するためのエンジニアリングリソースが必要

Connect アカウント登録オプションと、API ベースのユーザー登録および改善策フローを Stripe がホストするフローまたは埋め込みフローに移行する方法をご紹介します。

オンボーディングフローへの変更 は、どのように情報を収集するかによって異なります。オンボーディングフローを更新するだけでなく、必要に応じて社内外のドキュメントも更新し、サポートチームが変更に関する質問に対応できるよう準備してください。

Stripe ホストまたは組み込みオンボーディングを使用している場合は、これらの要件更新に備えて統合を更新する必要はありません。ただし、要件が変更された際に Stripe が新しい、または更新された本人確認情報の提供を連結アカウントに求める可能性があることは通知しておくとよいでしょう。

API 導入概要

Stripe ホストまたはエンベデッドユーザー登録に移行しない場合は、以下のアップデートに対応する必要があります。

タイムラインの更新

以下のタイムラインでは、これらの変更に関する主なマイルストーンを説明しています。新しい要件が適用されたときに問題が発生しないように、早めに更新して導入テストを行うようにしてください。

日付マイルストーン説明
2025 年 10 月導入プランニングの開始初期 API の更新をご利用いただけます。このガイドと変更内容をレビューして、導入の更新を計画してください。
2026 年 2 月影響を受けるアカウントをレビューし、導入の更新をテストするStripe は、影響を受ける連結アカウントの推定数を提供します。更新されたアカウント登録フローのテストを開始してください。
2026 年 3 月future_requirements の展開が開始されます (API アカウント登録)API アカウント登録を使用するプラットフォームの場合、Stripe は新規アカウントと既存アカウントの両方について、future_requirements に新しい要件の追加を開始します。
2026 年 4 月 1 日事業形態 individual の連結アカウントに対する新しい要件の開始更新されたアカウント登録フローが、individual の事業形態のアカウントに対する新しい要件を収集する準備ができていることを確認してください。Stripe は新しい要件を徐々に展開する予定ですが、特定のアカウントの発効日を保証するものではありません。4 月 1 日までに、更新されたフローを individual アカウントで機能させる必要があります。
2026 年 5 月 1 日事業形態 company の連結アカウントに対する新しい要件の開始更新されたアカウント登録フローが、事業形態 company のアカウントに対する新しい要件を収集する準備ができていることを確認してください。Stripe は新しい要件を順次展開しますが、特定のアカウントについて発効日を保証するものではありません。5 月 1 日までに、更新されたフローを company のアカウントに対して有効にする必要があります。
2026 年 4 月から 2026 年 7 月上旬現在、既存のアカウントには新しい要件が適用されます新しい要件は、この期間中に既存の連結アカウントにも適用されます。必要に応じて、更新されたオンボーディングフローを使って情報を収集してください。
2026 年 7 月から 10 月新しい要件の期日制限を回避するには、各アカウントの更新された要件を、そのアカウントの期日までに確認する必要があります。

顧顧客情報 (KYC) の確認

Stripe は本人確認プロセスを強化しており、連結アカウントの一部に追加情報の提供が必要になる可能性があります。また、API に情報確認のオプションも追加しています。

以下の事業体は、検証可能な KYC 情報を提供する必要があります。

  • 法人 (個人および個人事業主の場合);
  • アカウント代表者
  • UBOと取締役 (Stripeリスクモデルによって高リスクと見なされるアカウントの場合)

その他の確認方法

標準のキー入力情報に加えて、次の方法を使用すると、確認成功率を向上させることができます。

  • 国民 ID 確認: 推奨 初回確認率を高めるため、事前に国民 ID 番号を収集します。
  • Stripe Identity: 自動確認に失敗したアカウントには顔写真と書類のキャプチャーを使用します。
  • 追加書類のアップロード: 手動レビューのために本人確認書類または住所確認書類を提出して、手動レビューを依頼します。

Stripe Identity 推奨

自動確認に失敗した連結アカウントの確認には、Stripe Identityを使って確認を試みることができます。Identity は、顔写真と身分証明書を撮ることで機能します。ほとんどのヨーロッパ諸国は Stripe Identity に対応しており、成功率は国によって異なります。

本人確認セッションを作成し、related_personパラメーターを使用して、その人物のdocumentとproof_of_livenessの要件を送信します。結果は、API またはダッシュボードを使用して確認できます。

国民 ID の確認 公開プレビュー

この更新の影響を受ける国では、連結アカウントの担当者の名前、生年月日、住所、国籍に加えて国民 ID 番号を提供することで、担当者の確認を強化できます。

現在、本人確認は以下の国民 ID 番号のみに対応しています。

国身分証明書の種類
デンマーク中央個人登録 (CPR)
イタリア納税者番号 (Codice Fiscale)
ポーランドPESEL 番号
スペインDocumento Nacional de Identidad (DNI)
スウェーデン個人識別番号 (Personnummer)

この更新の影響を受ける国の連結アカウントにのみ国民 ID 番号を指定できます。たとえば、オーストラリアの連結アカウントの代表者として行動するスペイン市民には ID 番号を指定できますが、米国の連結アカウントの代表者として行動するスペイン市民には ID 番号を指定できません。

National ID が利用可能

この導入は、更新された要件が将来の要件になったときに本番環境で利用可能になります。以下の例を使用して導入をテストしてください。

API を使用した国民 ID 照合の実施

次の例は、要件が更新された新しい連結アカウントのオンボーディングを示しています。

メモ

以下の違いは、v1 Accounts API にのみ影響し、v2 には影響しません。

ステップ 1: Connect アカウントの作成

将来の要件がロールアウトされた後は、通常どおり連結アカウントを作成してください。それまでは、テスト環境で新しい連結アカウントを作成し、新しい KYC 動作を有効にしてください。

口座作成コールの 2 つの部分を変更することで、この動作をトリガーします。

  1. ヘッダー experimental_onboarding_preview=v2 を追加します。
  2. capabilities[card_payments][preview]=true します。

アカウントを作成すると、新しい要件文字列 representative.nationality が表示されます。これは、アカウントの代表者を作成し、国籍情報を渡せることを示しています。

// Creating a connected account in Spain
> curl https://api.stripe.com/v1/accounts \
  -u sk_test_123 \
  -H "Stripe-Version: 2025-08-27.basil;experimental_onboarding_preview=v2" \
  -d 'type'='custom' \
  -d 'country'='ES' \
  -d 'capabilities[card_payments][requested]'='true' \
  -d 'capabilities[card_payments][preview]'='true' \
  -d 'capabilities[transfers][requested]'='true'

{
  "id": "acct_1Nv0FGQ9RKHgCVdB",
  ...
  "requirements": {
    "past_due": [
      ...
      "representative.nationality",
      ...
    ]
  }
 ...
}

ステップ 2: 口座担当者の作成

連結アカウントを作成したら、アカウント担当者を作成します。

> curl https://api.stripe.com/v1/accounts/acct_1Nv0FGQ9RKHgCVdB/persons \
  -u sk_test_123: \
  -d first_name=John \
  -d last_name=Doe

{
  "id": "person_1N9XNb2eZvKYlo2CjPX7xF6B",
  ...
}

ステップ 3: 国籍の提出

担当者を作成すると、nationality が past_due に表示されます。このフィールドを徴収することで、Stripe は担当者が id_number 回収の対象かどうかを判断できます。

> curl https://api.stripe.com/v1/accounts/acct_1Nv0FGQ9RKHgCVdB -u sk_test_123:

{
  ...
  "requirements": {
    "past_due": [
      "person_1N9XNb2eZvKYlo2CjPX7xF6B.dob.year",
      ...other person requirements...
      "person_1N9XNb2eZvKYlo2CjPX7xF6B.nationality"
    ]
  }
 ...
}

国籍を徴収した後、その人が対象国にいる場合、past_due と alternatives が表示されます。これは、国民 ID を徴収することが推奨されるが、必須ではないことを示しています。

> curl https://api.stripe.com/v1/accounts/acct_1Nv0FGQ9RKHgCVdB/persons/person_1N9XNb2eZvKYlo2CjPX7xF6B \
  -u sk_test_123: \
  -d nationality=ES

> curl https://api.stripe.com/v1/accounts/acct_1Nv0FGQ9RKHgCVdB -u sk_test_123:

{
  "requirements": {
    "past_due": [
      "person_1N9XNb2eZvKYlo2CjPX7xF6B.dob.year",
      ...other person fields...
    ],
    "alternatives": [
      {
        "original_fields_due": [
          "person_1N9XNb2eZvKYlo2CjPX7xF6B.dob.year",
          ...other person fields...
        ],
        "alternative_fields_due": [
          "person_1N9XNb2eZvKYlo2CjPX7xF6B.id_number"
        ]
      }
    ]
  }
}

ステップ 4: 残りの担当者欄を徴収

プログラムで KYC 検証を開始するために、国民 ID 番号を含む追加的な人物の属性を徴収します。

> curl https://api.stripe.com/v1/accounts/acct_1Nv0FGQ9RKHgCVdB/persons/person_1N9XNb2eZvKYlo2CjPX7xF6B \
  -u sk_test_123: \
  -d 'id_number'='74362315-A' \
  ...other person fields...

ステップ 5: キー入力されたフィールドは、検証保留状態になります

キー入力されたデータを提供すると、pending_verification にフィールドが新しい方法で表示されます。

  • キー入力されたフィールドは、verification.document および verification.additional_document ではなく、pending_verification に入ります。これは、キー入力されたフィールドが検証中であることを示しています。
  • id_number 要件は、提供されていれば pending_verification に入ることができます。alternative_fields_due にのみ表示され、past_due や currently_due には表示されない場合でもです。
> curl https://api.stripe.com/v1/accounts/acct_1Nv0FGQ9RKHgCVdB/ -u sk_test_123:

{
  "requirements": {
    "pending_verification": [
      "person_1N9XNb2eZvKYlo2CjPX7xF6B.address.city",
      "person_1N9XNb2eZvKYlo2CjPX7xF6B.address.line1",
      "person_1N9XNb2eZvKYlo2CjPX7xF6B.address.postal_code",
      "person_1N9XNb2eZvKYlo2CjPX7xF6B.dob.day",
      "person_1N9XNb2eZvKYlo2CjPX7xF6B.dob.month",
      "person_1N9XNb2eZvKYlo2CjPX7xF6B.dob.year",
      "person_1N9XNb2eZvKYlo2CjPX7xF6B.first_name",
      "person_1N9XNb2eZvKYlo2CjPX7xF6B.id_number",
      "person_1N9XNb2eZvKYlo2CjPX7xF6B.last_name"
    ],
  }
}

ステップ 6: 検証エラーの処理

多くの場合、フィールドが pending_verification を入力した後、代表者は KYC に合格し、プロセスは完了します。

認証に失敗した場合、Stripe は次のステップに進むための追加情報を返します。

重要な変更点は 2 つあります。

複数の選択肢

要件ハッシュには、複数の選択肢が表示されます。これらはそれぞれ、ユーザーが進むべき道を示します。

たとえば、名前と生年月日が一致していても、名前と住所が一致しない場合、連結アカウントはいくつかの方法で問題を解決できます。

  1. 入力した名前や住所の情報を確認し、間違いがあれば再入力することができます。
  2. 生年月日、名前、住所、id_number に入力した情報を確認し、正しい情報を再入力することができます。
  3. 名前と住所が一致する書類をアップロードすることができます
  4. Stripe Identity を完了することができます

これらの 4 つのパスは、past_due フィールドおよび alternatives として表示されます。

> curl https://api.stripe.com/v1/accounts/acct_1Nv0FGQ9RKHgCVdB -u sk_test_123:

{
  "requirements": {
    // 1. They can check the information they've entered for dob, name, and address, and re-enter the correct information.
    "past_due": [
      "person_1N9XNb2eZvKYlo2CjPX7xF6B.first_name",
      "person_1N9XNb2eZvKYlo2CjPX7xF6B.last_name",
      "person_1N9XNb2eZvKYlo2CjPX7xF6B.address.*",
    ],
    "alternatives": [
      // 2. They can check the information they entered for dob, name, address and id_number and re-key correct information.
      {
        "original_fields_due": [
          "person_1N9XNb2eZvKYlo2CjPX7xF6B.first_name",
          "person_1N9XNb2eZvKYlo2CjPX7xF6B.last_name",
          "person_1N9XNb2eZvKYlo2CjPX7xF6B.address.*",
        ],
        "alternative_fields_due": [
          "person_1N9XNb2eZvKYlo2CjPX7xF6B.id_number"
        ]
      },
      // 3. They can upload document that matches their name and address
      {
        "original_fields_due": [
          "person_1N9XNb2eZvKYlo2CjPX7xF6B.first_name",
          "person_1N9XNb2eZvKYlo2CjPX7xF6B.last_name",
          "person_1N9XNb2eZvKYlo2CjPX7xF6B.address.*"
        ],
        "alternative_fields_due": [
          "person_1N9XNb2eZvKYlo2CjPX7xF6B.verification.additional_document"
        ]
      },
      // 4. They can complete Stripe Identity
      {
        "original_fields_due": [
          "person_1N9XNb2eZvKYlo2CjPX7xF6B.first_name",
          "person_1N9XNb2eZvKYlo2CjPX7xF6B.last_name",
          "person_1N9XNb2eZvKYlo2CjPX7xF6B.address.*"
        ],
          "person_1N9XNb2eZvKYlo2CjPX7xF6B.proof_of_liveness"
        ]
      },
    ]
  }
}

キー入力されたフィールドのエラー これまでは、キー入力されたフィールドの処理中に検証エラーが発生すると、ドキュメントフィールドは past_due に移動し、エラーが表示されていました。今後は、キー入力されたフィールドは past_due に戻ります。id_number のようなフィールドは alternative_fields_due に残ります。

例えば、名前、生年月日、住所がもともと past_due であった場合、提出後に名前と生年月日が一致し、名前と住所が一致しなかった場合、名前と住所は past_due に戻り、生年月日は削除されます。

この場合、past_due および alternative_fields_due のフィールドにエラーが表示されます。

> curl https://api.stripe.com/v1/accounts/acct_1Nv0FGQ9RKHgCVdB -u sk_test_123:
{
  "requirements": {
    "past_due": [
      "person_1N9XNb2eZvKYlo2CjPX7xF6B.name",
      "person_1N9XNb2eZvKYlo2CjPX7xF6B.address"
    ],
    "alternatives": [
      {
        "original_fields_due": [
          "person_1N9XNb2eZvKYlo2CjPX7xF6B.name",
          "person_1N9XNb2eZvKYlo2CjPX7xF6B.address"
        ],
        "alternative_fields_due": [
          "person_1N9XNb2eZvKYlo2CjPX7xF6B.id_number"
        ]
      },
      {
        "original_fields_due": [
          "person_1N9XNb2eZvKYlo2CjPX7xF6B.name",
          "person_1N9XNb2eZvKYlo2CjPX7xF6B.address"
        ],
        "alternative_fields_due": [
          "person_1N9XNb2eZvKYlo2CjPX7xF6B.proof_of_liveness"
        ]
      },
      {
        "original_fields_due": [
          "person_1N9XNb2eZvKYlo2CjPX7xF6B.name",
          "person_1N9XNb2eZvKYlo2CjPX7xF6B.address"
        ],
        "alternative_fields_due": [
          "person_1N9XNb2eZvKYlo2CjPX7xF6B.verification.additional_document"
        ]
      }
    ]
    "errors": [
      {
        "code": "verification_failed_keyed_in_mismatch",
        "reason": "Identity information could not be verified."
        "requirement": "person_1N9XNb2eZvKYlo2CjPX7xF6B.name"
      },
      {
        "code": "verification_failed_keyed_in_mismatch",
        "reason": "Identity information could not be verified."
        "requirement": "person_1N9XNb2eZvKYlo2CjPX7xF6B.address"
      },
      {
        "code": "verification_failed_keyed_in_mismatch",
        "reason": "Identity information could not be verified."
        "requirement": "person_1N9XNb2eZvKYlo2CjPX7xF6B.id_number"
      }
    ]
  }
}

UBO と取締役の関係の確認

Stripe は、最終的な実質的所有者 (UBO) と取締役の確認プロセスを強化しています。ヨーロッパの規制では、UBO と取締役の法人との関係の確認が義務付けられています。

  • UBO: 法人 (例えば、会社、法人、LLC、パートナーシップなど) の 25% 以上を直接的または間接的に所有または支配する個人。
  • 取締役: 事業の経営に責任を負う取締役または上級役員 (CEO、COO、常務取締役など)。

次の表は、各法人タイプについて確認が必要な関係を示しています。

法人タイプ確認する関係注
会社、法人、LLC、パートナーシップUBO が存在する場合は UBO、それ以外の場合は取締役英国のみ: UBOと取締役の両方
非営利団体取締役非営利団体には通常 UBO はありません
政府省庁、政府機関、個人、個人事業主、上場企業該当なし本人確認のみ

UBO および取締役情報の確認

Stripe は、個人の主要なプロパティと法人のプロパティを照合して、その人物の関係を確認しようとします。

法人主なプロパティ
個人
  • 名
  • 姓
  • ID 番号
法人
  • 名前
  • 住所
  • 納税者番号
  • VAT ID
  • 登録番号

認証が成功するためには、プロパティの一部のみが一致していればよい場合があります。

Stripe は、次の方法で関係を確認しようとします：

方法説明サンプル要件
サードパーティー決済代行業者サードパーティー決済代行業者が利用可能な場合、Stripe はそのアカウントのすべての関係の確認を自動的に試行します。
  • owners.first_name
  • owners.last_name
  • company.tax_id
公式文書所有者の場合は「UBO 証明書」、取締役の場合は「登録証明書」を提出できます。受付可能な書類は国によって異なります。
  • owners.first_name
  • owners.last_name
  • company.name
  • company.address.line1
  • company.address.city
  • company.address.state
  • documents.proof_of_ultimate_beneficial_ownership
デジタル証明以下の PDF テンプレートを使用して、関係にデジタル証明書を提供できます：
  • owners.id_number
  • company.tax_id
  • documents.proof_of_ultimate_beneficial_ownership
  • documents.proof_of_ultimate_beneficial_ownership.signer

API を使用して関係の確認要件を特定する

アカウントの要件を取得すると、元の確認オプションと代替の確認オプションは、重要な情報と利用可能な確認方法の組み合わせを表します。ほとんどの場合、所有者または取締役の確認には少なくとも 3 つのオプションがあります。

次のコードは、所有者要件を持つ連結アカウントの例です。特定のオプションと、その表示順序はアカウント間で異なる場合があります。

// Example with owner requirements
> curl https://api.stripe.com/v1/accounts/acct_1234 \
  -u sk_test_123:

{
  "id": "acct_1234",
  "past_due": {
    // third-party provider option
    "currently_due": [
      "owners.first_name",
      "owners.last_name",
      "company.owners_provided",
      "company.tax_id"
    ],
    "alternatives": [
      {
        "original_fields_needed": [
          "owners.first_name",
          "owners.last_name",
          "company.owners_provided",
          "company.tax_id"
        ],
        // official document option
        "alternative_fields_needed": [
          "owners.first_name",
          "owners.last_name",
          "company.owners_provided",
          "company.name",
          "company.address.line1",
          "company.address.state",
          "company.address.city",
          "documents.proof_of_ultimate_beneficial_ownership.files"
        ],
      },
      {
        "original_fields_needed": [
          "owners.first_name",
          "owners.last_name",
          "company.owners_provided",
          "company.tax_id"
        ],
        // digital attestation option
        "alternative_fields_needed": [
          "owners.first_name",
          "owners.last_name",
          "company.owners_provided",
          "company.name",
          "company.address.line1",
          "company.address.state",
          "company.address.city",
          "documents.proof_of_ultimate_beneficial_ownership.files",
          "documents.proof_of_ultimate_beneficial_ownership.signer"
        ],
      }
    ]
  }
}

所有者ではなく取締役を確認する

連結アカウントが所有者ではなく取締役を提供する資格がある場合、取締役を確認するための代替オプションが含まれます。取締役を確認する場合でも、UBO を 0 個提供したことを証明する必要があります。

次の例は、所有者ではなく取締役を確認できる連結アカウントを示しています：

// Example with owner requirements
> curl https://api.stripe.com/v1/accounts/acct_1234 \
  -u sk_test_123:

{
  "id": "acct_1234",
  "past_due": {
    // third-party provider option for owners
    "currently_due": [
      "owners.first_name",
      "owners.last_name",
      "company.owners_provided",
      "company.tax_id"
    ],
    "alternatives": [
      ...,
      {
        "original_fields_needed": [
          "owners.first_name",
          "owners.last_name",
          "company.owners_provided",
          "company.tax_id"
        ],
        // third-party provider option for directors
        "alternative_fields_needed": [
          "directors.first_name",
          "directors.last_name",
          "company.directors_provided",
          "company.owners_provided",
          "company.tax_id"
        ],
      }
    ]
  }
}

取締役情報を提供し、UBO を 0 件提供したことを証明する場合でも、主要な要件オプションには所有者要件が反映されます。所有者情報が利用可能になった場合は、提供できます。

次の例は、UBO 証明が 0 件の連結アカウントを示しています。

// Example with owner requirements
> curl https://api.stripe.com/v1/accounts/acct_1234 \
  -u sk_test_123:

{
  "id": "acct_1234",
  "past_due": {
    // third-party provider option for owners
    "currently_due": [
      "owners.first_name",
      "owners.last_name",
      // company.owners_provided is no longer a requirement
      "company.tax_id"
    ],
    "alternatives": [
      ...,
      {
        "original_fields_needed": [
          "owners.first_name",
          "owners.last_name",
          "company.tax_id"
        ],
        // third-party provider option for directors
        "alternative_fields_needed": [
          "directors.first_name",
          "directors.last_name",
          "company.directors_provided",
          "company.tax_id"
        ],
      }
    ]
  }
}

エラー処理

所有者と取締役の要件エラーには、一般的なドキュメントと詳細の不一致エラーに加えて、次のコード値が含まれる場合があります。

コード説明
verification_missing_ownersこのアカウントには、サードパーティー決済代行業者によって識別された所有者に関する情報、または書類またはデジタル証明書に記載された所有者に関する情報がありません。
verification_missing_directorsアカウントに、サードパーティー決済代行業者によって識別された、または書類またはデジタル証明書に記載された取締役に関する情報が不足しています。
verification_data_not_foundサードパーティー決済代行業者がビジネスに関する情報が見つかりませんでした。

これらのエラーは、ビジネスの詳細を更新することで解決できる場合があります。ただし、ほとんどの場合、連結アカウントを書類のアップロードパスまたはデジタル証明パスのいずれかに誘導する必要があります。

Stripe が行方不明の所有者または取締役を特定すると、プライベートプレビュー API がそれらに関するデータを提供する場合があります。連結アカウントはそのデータを使用して、行方不明の Persons を作成できます。

API を使用して UBO と取締役確認のためのデジタル証明を実装

利用可否

Accounts v2 API はまだデジタル証明をサポートしていません。

次に、UBO または取締役確認のためのデジタル証明を実行する例を示します。

  1. どの証明書類が必要かを確認するために口座を検索します。

    // Check for UBO attestation requirement
> curl https://api.stripe.com/v1/accounts/acct_1234 \
  -u sk_test_123:

// Response showing UBO attestation
{
  "id": "acct_1234",
  "requirements": {
    "past_due": [
      "documents.proof_of_ultimate_beneficial_ownership.files",
      "documents.proof_of_ultimate_beneficial_ownership.signer",
    ],
    "errors": []
  }
}

// Or for directors & officers requirement
{
  "id": "acct_1234",
  "requirements": {
    "past_due": [
      "documents.proof_of_registration.files",
      "documents.proof_of_registration.signer"
     ],
    "errors": []
  }
}

デジタル証明要件オプションは、主要なオプションとして、または別のオプションの代替として表示できます。特定のオプションと、その表示順序はアカウントによって異なります。

  1. テンプレートを使って PDF を作成し、承認された担当者に電子署名してもらいます。

  2. ファイル API を使用して、署名済みの証明書類をアップロードします。

    curl -X POST https://files.stripe.com/v1/files \
  -u sk_test_123: \
  -F purpose=account_requirement \
  -F file=@signed_attestation.pdf

// Response
{
  "id": "file_1234567890",
  "object": "file",
  "purpose": "account_requirement"
}

  3. 署名者を表す Person の ID を記載した書類を提出します。

    // For UBO attestation
curl -X POST https://api.stripe.com/v1/accounts/acct_1234 \
  -u sk_test_123: \
  -d "documents[proof_of_ultimate_beneficial_ownership][files][]=file_1234567890" \
  -d "documents[proof_of_ultimate_beneficial_ownership][signer][person]=person_xyz"

// For D&O attestation
curl -X POST https://api.stripe.com/v1/accounts/acct_1234 \
  -u sk_test_123: \
  -d "documents[proof_of_registration][files][]=file_1234567890" \
  -d "documents[proof_of_registration][signer][person]=person_xyz"

署名者の検証要件

証明書に署名できる人

  • 口座担当者
  • 事業所有者 (所有率 25% 以上)
  • 取締役および役員
  • その他の承認された口座メンバー

重要: 署名者は、口座に関連する既存の人物でなければなりません。認証文書に署名できるのは、法務法人との法的文書上の関係を有する個人のみです。

エラー処理

デジタル認証には、対処すべき特定のエラーシナリオがあります。

無効な署名者

署名者がアカウントに関連付けられていないか、権限がない場合に発生します。

{
  "requirements": {
    "errors": [{
      "requirement": "documents.proof_of_ultimate_beneficial_ownership.files",
      "code": "invalid_signator",
      "reason": "Unauthorized attestation signer. The signer must have a documented relationship with the legal entity."
    },
    {
      "requirement": "documents.proof_of_ultimate_beneficial_ownership.signer",
      "code": "invalid_signator",
      "reason": "Unauthorized attestation signer. The signer must have a documented relationship with the legal entity."
    }]
  }
}

ドキュメント失敗

アップロードされた文書が読めないか、間違っている場合に発生します。

{
  "requirements": {
    "past_due": ["documents.proof_of_registration.files"],
    "errors": [{
      "requirement": "documents.proof_of_registration.files",
      "code": "verification_document_failed_other",
      "reason": "Your team can contact Stripe to learn more about why identity verification failed."
    }]
  }
}

署名者がファイルなしで提出されました

ファイルなしで署名者を申請した場合の API エラー

{
  "error": {
    "code": "invalid_signator",
    "message": "signer.person can only be provided when a file is also provided",
    "type": "invalid_request_error"
  }
}

次のステップ

  1. 認証文書を使用する際に署名者を徴収するよう、導入を更新します。
  2. 新しい認証固有のエラーコードに対するエラー処理の実装。
  3. 新しい認証要件についてサポートチームをトレーニング。

UBO および取締役情報の事前入力 プライベートプレビュー

オプションで、法人に関連付けられた UBO または取締役をプログラムで検出して事前入力する API と統合することもできます。連結アカウントは、書類のアップロードやデジタル証明を使用する代わりに、検出された情報を確認することで関係を確認できます。

この方法は、確認率を高め、負担を軽減できますが、すべてのアカウントで機能するわけではありません。Stripe が関係を事前入力できないアカウントについては、書類のアップロードやデジタル証明を処理する必要があります。

UBO または取締役確認のための事前入力に関心がある場合は、以下から登録してご関心をお寄せください。

オランダ事業登録 (KvK)の要件

2026 年から、オランダ (NL) アカウントに対して、オランダの規制への準拠を確保するため、より厳格な事業形態要件を適用します。これにより、オランダの事業者に必要な 8 桁の会社登録番号 (KvK、Kamer van Koophandel) の収集方法に特に影響があります。

変更点

  • 対応しなくなった個人事業形態

    • individual ビジネス用銀行口座形態はオランダ口座では対応しなくなりました。これは business_type: "individual" および business_type: "sole_proprietorship" の既存および新規のオランダ口座に影響を受けます。

    なぜこれが重要なのか: オランダでは、すべてのビジネスは KvK (商工会議所) 番号を提供する必要があります。当社の「個人」事業形態は KvK を徴収していないため、非準拠となります。

  • 新しいエラーコード: unsupported_business_type

    • 無効なビジネスタイプのアカウントでは、要件（requirements）に新しいエラーが表示されます。

    // Account with unsupported business type
{
  "id": "acct_123",
  "business_type": "individual",
  "country": "NL",
  "requirements": {
    "past_due": ["business_type"],
    "errors": [{
      "requirement": "business_type",
      "code": "unsupported_business_type",
      "reason": "Business type isn't supported in merchant country. 'individual' isn't a supported business type in country NL."
    }]
  }
}

  • 未法人口座の KvK 登録を徴収

    • 以下の事業形態および構造を持つ既存および新規のオランダ口座は、KvK 登録が必要です。

    • business_type: "company" and business_structure: "unincorporated_partnership"
    • business_type: "non_profit" and business_structure: "unincorporated_non_profit"

    なぜこれが重要なのか: 法人格のない口座は 現在 KvK 番号を提供する必要がなく、オランダの法令遵守要件に違反しています。すべての NL 企業は KvK 登録を提出しなければなりません。

    解決方法

    既存口座の場合

    individual ビジネス用銀行口座をお持ちの既存の NL 口座は、この新しい要件のロールアウト開始時に準拠を維持するため、company と sole_proprietorship 構造に更新する必要があります。

    // Update existing account
curl -X POST https://api.stripe.com/v1/accounts/acct_123 \
  -u sk_test_123: \
  -d "business_type=company" \
  -d "company[structure]=sole_proprietorship" \
  -d "company[tax_id]=12345678"  // KvK number

// Successful response
{
  "id": "acct_123",
  "business_type": "company",
  "company": {
    "structure": "sole_proprietorship",
    "tax_id": "12345678"
  },
  "requirements": {
    "past_due": [],  // business_type requirement resolved
    "errors": []
  }
}

    新規口座開設について

    individual のビジネス用銀行口座でオランダ口座を作成しようとすると、unsupported_business_type エラーが返されます。

    // This will fail
curl -X POST https://api.stripe.com/v1/accounts \
  -u sk_test_123: \
  -d "country=NL" \
  -d "type=custom" \
  -d "business_type=individual"

// Response
{
  "id": "acct_123",
  "business_type": "individual",
  "country": "NL",
  "requirements": {
    "past_due": ["business_type"],
    "errors": [{
      "requirement": "business_type",
      "code": "unsupported_business_type",
      "reason": "Business type isn't supported in merchant country. 'individual' isn't a supported business type in country NL."
    }]
  }


// Correct approach
curl -X POST https://api.stripe.com/v1/accounts \
  -u sk_test_123: \
  -d "country=NL" \
  -d "type=custom" \
  -d "business_type=company" \
  -d "company[structure]=sole_proprietorship"

    NL で対応する事業形態

    オランダ口座の場合は、これらの事業形態と組織の組み合わせを使用してください。

    ビジネスのタイプ構造KvK 必須
    companysole_proprietorshipはい
    companyincorporated_partnershipはい
    companyunincorporated_partnershipはい
    companyprivate_corporationはい
    companypublic_corporationはい
    non_profitさまざまな構造はい

    ケイパビリティへの影響

    unsupported_business_type エラーが発生した口座は、事業形態が更新されるまでケイパビリティが制限されます。

    {
  "capabilities": {
    "card_payments": "inactive",
    "transfers": "inactive"
  },
  "requirements": {
    "disabled_reason": "requirements.past_due",
    "past_due": ["business_type"]
  }
}

    KvK 登録が提供されていない口座は、この情報が提供されるまで、card_payments のケイパビリティが制限されます。

    {
  "capabilities": {
    "card_payments": "inactive"
  },
  "requirements": {
    "disabled_reason": "requirements.past_due",
    "past_due": ["company.tax_id"]
  }
}

    移行のタイムライン

    • 現在: 新しいエラーコード unsupported_business_type がアクティブ
    • 将来の要件がロールアウトされた際には:既存の口座は是正対応を開始する必要があります
    • 2026 年 9 月 30 日: すべての NL 口座が準拠する必要があります

    実装チェックリスト

    NL 連結アカウントを持つプラットフォームの場合:

    1. 既存口座の監査
    // Find affected accounts
const accounts = await stripe.accounts.list({
  limit: 100,
  // Filter for NL accounts in your system
});

const affected = accounts.data.filter(a =>
  a.country === 'NL' &&
  a.business_type === 'individual'
);

    1. 口座作成フローを更新

      • オランダ口座の individual オプションを削除
      • デフォルトは company と sole_proprietorship
      • KvK 番号 (company.tax_id) を徴収

    2. 新しいエラーコードを処理

    if (account.requirements.errors.some(e =>
  e.code === 'unsupported_business_type')) {
  // Prompt user to update business type
  // Guide them to select appropriate structure
  // Collect KvK number
}

    1. 影響を受ける連結アカウントと連絡

      • なぜその変更が必要なのかの説明
      • 適切な事業構造の選択に関するガイダンスの提供
      • KvK 番号の検索を支援

    テスト

    これらのシナリオで実装をテストしてください。

    // Test updating to valid business type
const updated = await stripe.accounts.update('acct_test_123', {
  business_type: 'company',
  company: {
    structure: 'sole_proprietorship',
    tax_id: '12345678'  // Test KvK
  }
});

    その他の考慮事項

    個人フリーランサー

    オランダでは、個人のフリーランサーであっても、ビジネス (eenmanszaak) として登録し、KvK 番号を取得する必要があります。彼らは company → sole_proprietorship を選択する必要があります。

    連結アカウントの KvK 番号の確認方法

    KvK 番号はコマース会議所の登記簿謄本書 (uittreksel Kamer van Koophandel) に記載されています。

    下位互換性

    古い API バージョンでは、unsupported_business_type は、invalid_value_other として表示され、detailed_code フィールドに具体的なエラー内容が含まれます。

    新しいエラーコード

    verification_data_not_found

    Account オブジェクトの requirements.errors 配列に新しいエラーコード verification_data_not_found が表示されることがあります。このエラーは、Stripe が連結アカウントの既知の法人情報を使用してサードパーティーの確認プロバイダーから情報 (UBO や取締役/役員のデータなど) を取得できなかったことを示しています。これはさまざまな理由で発生する可能性がありますが、多くの場合、アカウントが情報を誤って入力したことが原因です。

    この「データが見つかりません」エラーは、既存の確認エラーコードとは異なります。

    • verification_missing_owners: アカウントに既知の所有者がいないことを示します。
    • verification_failed_keyed_match: 提出された情報と確認ソースの不一致を示します。
    // Example: verification_data_not_found error
{
  "requirements": {
    "errors": [{
      "requirement": "owners",
      "code": "verification_data_not_found",
      "reason": "Stripe was unable to retrieve ownership or director information from third-party providers based on the current legal entity details. Verify that the business information on the account is correct."
    }]
  }
}

    このエラーを処理するには、連結アカウントに法人情報 (会社名、登録番号、住所) をレビューして修正するように促します。連結アカウントが情報を更新した場合、Stripe は自動的にその確認を再度試みます。

    アカウント情報が正しい場合、または更新後の情報を Stripe がまだ確認できない場合は、書類のアップロードやデジタル証明などの手動の確認方法を使用してください。

    テスト

    実装の開発とテストに使用するテストアカウントを作成できます。テストアカウントはさまざまな確認結果をシミュレートでき、API が各ケースの要件とエラーをどのように返すかを確認できます。

    次の例は、今後の EU 要件の変更に備えるのに役立ちます。Connect のテスト全般の詳細については、Stripe Connect のテストをご覧ください。

    テストアカウントを作成

    サンドボックスシークレットキーを使用して Accounts API に POST リクエストを送信し、テストAccount を作成します。

    テスト環境以外のアカウントにリリースする前に新しい要件にアクセスするには、API のプレビューバージョンを有効にするヘッダーを設定し、試験的なアカウント登録プレビュー機能を有効にし、ケイパビリティをリクエストするときにプレビューバージョンを有効にします。以下に例を示します。

    curl https://api.stripe.com/v1/accounts \
  -u sk_test_123: \
  -H "Stripe-Version: 2026-01-28.preview;experimental_onboarding_preview=v2" \
  -d 'type'='custom' \
  -d 'country'='ES' \
  -d 'capabilities[card_payments][requested]'='true' \
  -d 'capabilities[card_payments][preview]'='true' \
  -d 'capabilities[transfers][requested]'='true' \
  -d 'capabilities[transfers][preview]'='true'

    以下の例は、テストアカウントに対して特定のレスポンスをトリガーする値を使用して、さまざまな状況をシミュレートする方法を示しています。

    個人に属するアカウントをテストする

    この例では、法人タイプが個人であるため、関係の確認を必要としないアカウントを作成します。

    前の手順に従ってテストアカウントを作成し、次に基本的なビジネスの詳細を設定します。

    curl https://api.stripe.com/v1/accounts/acct_test_123 \
  -u sk_test_123: \
  -d business_type=individual \
  -d "business_profile[mcc]"=5995 \
  -d "business_profile[url]"="https://accessible.stripe.com"

    レスポンスには、個人の基本的な要件が含まれます。代表者を作成することで、これらの要件を満たすことができます。

    curl https://api.stripe.com/v1/accounts/acct_test_123/persons \
  -u sk_test_123: \
  -d "first_name=Marie" \
  -d "last_name=Dupont" \
  -d "dob[year]=1901" \
  -d "dob[month]=1" \
  -d "dob[day]=1" \
  -d "address[line1]=address_full_match" \
  -d "address[city]=Madrid" \
  -d "address[postal_code]=28009" \
  -d "address[country]=ES" \
  -d "email=test@example.com" \
  -d "phone=%2B35366666666" \
  -d "nationality=ES" \
  -d "relationship[representative]=true"

    DOB 1901-01-01 を指定すると、テスト環境で本人確認が成功します。その他の結果のトリガーについては、テスト生年月日をご覧ください。同様に、住所の最初の行を文字列 address_full_match に設定すると、住所の確認が成功します。その他の結果のトリガーについては、ビジネス住所のテストをご覧ください。

    レスポンスは、個人の要件が保留中になったことを示しています。しばらく待ってからAccount を取得すると、これらの要件がクリアされていることがわかります。

    curl https://api.stripe.com/v1/accounts/acct_test_123 \
  -u sk_test_123

    残りの要件は、銀行口座 (external_account) と利用規約 (TOS) のみです。利用規約要件をクリアするには、Account の tos_acceptance ハッシュを設定します。

    curl https://api.stripe.com/v1/accounts/acct_test_123 \
  -u sk_test_123: \
  -d "tos_acceptance[date]=1540248693" \
  -d "tos_acceptance[ip]=10.0.0.1"

    銀行口座の要件をクリアするには、Account のテスト用銀行口座を作成します。国に応じたテスト用銀行口座番号を指定してください。

    curl https://api.stripe.com/v1/accounts/acct_test_123/external_accounts \
  -u sk_test_123: \
  -d "external_account[object]=bank_account" \
  -d "external_account[account_number]=ES0700120345030000067890" \
  -d "external_account[country]=ES" \
  -d "external_account[currency]=EUR"

    会社に属するアカウントをテストする

    この例では、法人タイプが会社であるため、関係の確認要件の対象となるアカウントを作成します。

    地域的な考慮事項
    イギリス

    イギリスでは、実質的支配者 (UBO) と取締役の両方を確認する必要があります。イギリスに連結アカウントがある場合は、国を GB に設定しているアカウントでテストしてください。

    前の手順に従ってテストアカウントを作成し、次に基本的なビジネスの詳細を設定します。

    curl https://api.stripe.com/v1/accounts/acct_test_123 \
  -u sk_test_123: \
  -d business_type=company \
  -d "business_profile[mcc]"=5995 \
  -d "business_profile[url]"="https://accessible.stripe.com" \
  -d "company[name]=Test company" \
  -d "company[phone]=628123456787" \
  -d "company[address][line1]=address_full_match" \
  -d "company[address][city]=Madrid" \
  -d "company[address][postal_code]=28009" \
  -d "company[address][country]=ES" \
  -d "company[tax_id]=000000000"

    納税者番号 000000000 を指定すると、会社の確認が成功します。その他の結果のトリガーについては、事業者の納税者番号のテストをご覧ください。

    次に、代表者を指定します。

    curl https://api.stripe.com/v1/accounts/acct_test_123/persons \
  -u sk_test_123: \
  -d "first_name=Adam" \
  -d "last_name=" \
  -d "dob[year]=1901" \
  -d "dob[month]=1" \
  -d "dob[day]=1" \
  -d "address[line1]=address_full_match" \
  -d "address[city]=Madrid" \
  -d "address[postal_code]=28009" \
  -d "address[country]=ES" \
  -d "email=test@example.com" \
  -d "phone=%2B35366666666" \
  -d "nationality=ES" \
  -d "relationship[representative]=true" \
  -d "relationship[title]=CEO"

    代表者の確認プロセスが完了すると、GET リクエストで残りの要件を確認できます。

    curl https://api.stripe.com/v1/accounts/acct_test_123 \
  -u sk_test_123:

    requirements.currently_due 配列の要件には、Account の所有者について必要な詳細がリストされます。requirements.alternatives 配列には、特定の要件を満たすために提供できるオプション情報が含まれる場合があります。以下に例を示します。

    {
  "alternative_fields_due": [
    "company.owners_provided",
    "documents.proof_of_ultimate_beneficial_ownership.files",
    "owners.first_name",
    "owners.last_name"
  ],
  "original_fields_due": [
    "company.owners_provided",
    "owners.first_name",
    "owners.last_name"
  ]
}

    対応する original_fields_due リストの要件を満たすための別の方法として、alternative_fields_due にリストされているフィールドを指定することもできます。この例では、alternative_fields_due には original_fields_due のプロパティと documents.proof_of_ultimate_beneficial_ownership.files が含まれます。つまり、元の情報が必要ですが、確認プロセスに役立つ実質的支配者であることを証明する書類を指定することもできます。

    所有者の要件を満たすには、2 人の人物を作成し、所有者として設定します。この例の名前は、納税者番号 000000000 を使用するテストアカウント用にハードコードされた値です。

    curl https://api.stripe.com/v1/accounts/acct_test_123/persons \
  -u sk_test_123: \
  -d "first_name=Marie" \
  -d "last_name=Dupont" \
  -d "dob[year]=1901" \
  -d "dob[month]=1" \
  -d "dob[day]=1" \
  -d "address[line1]=address_full_match" \
  -d "address[city]=Madrid" \
  -d "address[postal_code]=28009" \
  -d "address[country]=ES" \
  -d "email=owner@example.com" \
  -d "relationship[owner]=true"

curl https://api.stripe.com/v1/accounts/acct_test_123/persons \
  -u sk_test_123: \
  -d "first_name=Louis" \
  -d "last_name=Martin" \
  -d "dob[year]=1901" \
  -d "dob[month]=1" \
  -d "dob[day]=1" \
  -d "address[line1]=address_full_match" \
  -d "address[city]=Madrid" \
  -d "address[postal_code]=28009" \
  -d "address[country]=ES" \
  -d "email=owner@example.com" \
  -d "relationship[owner]=true"

    company.owners_provided を true に設定して、Account のすべての所有者を作成したことを示します。

    curl https://api.stripe.com/v1/accounts/acct_test_123 \
  -u sk_test_123: \
  -d "company[owners_provided]=true"

    このリクエストを完了すると、Accountからすべての所有者要件が削除されます。

    書類確認へのフォールバックをテストする

    Account の所有者要件は、確認が成功するまで currently_due (確認中の場合は pending_verification) のままです。

    確認に失敗した場合は、書類をアップロードすることもできます。この例では、API を使用してアップロードする方法を示します。

    前の手順に従ってテストアカウントを作成し、次に基本的なビジネスの詳細を設定します。納税者番号を 222221001 に設定します。これにより、所有者の確認が失敗します。

    curl https://api.stripe.com/v1/accounts/acct_test_123 \
  -u sk_test_123: \
  -d business_type=company \
  -d "business_profile[mcc]"=5995 \
  -d "business_profile[url]"="https://accessible.stripe.com" \
  -d "company[name]=Test company" \
  -d "company[phone]=628123456787" \
  -d "company[address][line1]=address_full_match" \
  -d "company[address][city]=Madrid" \
  -d "company[address][postal_code]=28009" \
  -d "company[address][country]=ES" \
  -d "company[tax_id]=222221001"

    次に、代表者を指定します。

    curl https://api.stripe.com/v1/accounts/acct_test_123/persons \
  -u sk_test_123: \
  -d "first_name=Marie" \
  -d "last_name=Dupont" \
  -d "dob[year]=1901" \
  -d "dob[month]=1" \
  -d "dob[day]=1" \
  -d "address[line1]=address_full_match" \
  -d "address[city]=Madrid" \
  -d "address[postal_code]=28009" \
  -d "address[country]=ES" \
  -d "email=test@example.com" \
  -d "phone=%2B35366666666" \
  -d "nationality=ES" \
  -d "relationship[representative]=true" \
  -d "relationship[title]=CEO"

    次に、所有者を作成します。

    curl https://api.stripe.com/v1/accounts/acct_test_123/persons \
  -u sk_test_123: \
  -d "first_name=Adam" \
  -d "last_name=Smith" \
  -d "dob[year]=1901" \
  -d "dob[month]=1" \
  -d "dob[day]=1" \
  -d "address[line1]=address_full_match" \
  -d "address[city]=Madrid" \
  -d "address[postal_code]=28009" \
  -d "address[country]=ES" \
  -d "email=owner@example.com" \
  -d "relationship[owner]=true"

    company.owners_provided を true に設定して、所有者の作成が終了したことを示します。

    curl https://api.stripe.com/v1/accounts/acct_test_123 \
  -u sk_test_123: \
  -d "company[owners_provided]=true"

    Account を調べると、所有者の要件が残り、requirements.errors 配列に 所有者の 要件 と verification_data_not_found の コード を含むエントリーが存在することがわかります。これは、Stripe が提供された会社情報を使用して所有者を確認できなかったことを意味します。

    実際のAccount についてこのエラーが表示された場合は、正しい法人の詳細が入力されていることを確認してください。この例では、詳細が正しいこと、および確認のための書類を提出する必要があることを前提としています。

    実際のAccount の場合は、Files API を使用して書類をアップロードし、レスポンスで返されたトークンを使用してAccount を更新します。この例では、テストトークン file_relationship_document_success を使用します。

    curl https://api.stripe.com/v1/accounts/acct_test_123 \
  -u sk_test_123: \
  -d "documents[proof_of_ultimate_beneficial_ownership][files][]"=file_relationship_document_success

    Account を更新してからしばらくすると、現在の要件が取得され、所有者の要件がクリアされていることを確認できます。

    curl https://api.stripe.com/v1/accounts/acct_test_123 \
  -u sk_test_123:

    該当する所有者がいない会社のテスト

    会社に 25% を超える所有権を持つ所有者がいない場合、Stripe は代わりに取締役情報を必要とします。この例は、取締役情報を提供する方法を示しています。

    前の手順に従ってテストアカウントを作成し、次に基本的なビジネスの詳細を設定します。納税者番号を 000000000 に設定します。これにより、会社の確認が成功します。

    curl https://api.stripe.com/v1/accounts/acct_test_123 \
  -u sk_test_123: \
  -d business_type=company \
  -d "business_profile[mcc]"=5995 \
  -d "business_profile[url]"="https://accessible.stripe.com" \
  -d "company[name]=Test company" \
  -d "company[phone]=628123456787" \
  -d "company[address][line1]=address_full_match" \
  -d "company[address][city]=Madrid" \
  -d "company[address][postal_code]=28009" \
  -d "company[address][country]=ES" \
  -d "company[tax_id]=000000000"

    次に、代表者を指定します。

    curl https://api.stripe.com/v1/accounts/acct_test_123/persons \
  -u sk_test_123: \
  -d "first_name=Marie" \
  -d "last_name=Dupont" \
  -d "dob[year]=1901" \
  -d "dob[month]=1" \
  -d "dob[day]=1" \
  -d "address[line1]=address_full_match" \
  -d "address[city]=Madrid" \
  -d "address[postal_code]=28009" \
  -d "address[country]=ES" \
  -d "email=test@example.com" \
  -d "phone=%2B35366666666" \
  -d "nationality=ES" \
  -d "relationship[representative]=true" \
  -d "relationship[title]=CEO"

    ビジネスに該当する所有者がいないことを示すには、所有者を作成せずに company.owners_provided を true に設定します。所有者がいる既存のテストAccount を再利用するには、既存の所有者をすべて削除します。

    curl https://api.stripe.com/v1/accounts/acct_test_123 \
  -u sk_test_123: \
  -d "company[owners_provided]=true"

    requirements.alternatives 配列には、所有者プロパティに代わる一連の取締役プロパティが含まれます。取締役の作成プロセスは、所有者の作成プロセスとよく似ています。

    curl https://api.stripe.com/v1/accounts/acct_test_123/persons \
  -u sk_test_123: \
  -d "first_name=Adam" \
  -d "last_name=Smith" \
  -d "dob[year]=1901" \
  -d "dob[month]=1" \
  -d "dob[day]=1" \
  -d "address[line1]=address_full_match" \
  -d "address[city]=Madrid" \
  -d "address[postal_code]=28009" \
  -d "address[country]=ES" \
  -d "email=owner@example.com" \
  -d "relationship[director]=true" \
  -d "relationship[title]=President"

    company.directors_provided を true に設定して、取締役の作成が終了したことを示します。

    curl https://api.stripe.com/v1/accounts/acct_test_123 \
  -u sk_test_123: \
  -d "company[directors_provided]=true"

    関係の確認の成功をシミュレートするには、company.name を文字列 match_name_relationships に設定します。

    curl https://api.stripe.com/v1/accounts/acct_test_123 \
  -u sk_test_123: \
  -d "company[name]=match_name_relationships"

    その他のテストケース

    以下のテストも重要です。

    • 取締役の確認が必要なnon_profitタイプの事業体 (UBO の確認はオプションではありません)。
    • 書類を使用して取締役の確認要件を満たす。
    • UBO の確認と取締役の確認の両方を必要とするイギリスの企業。

    参照情報