# 今後の要件の更新 必要な確認情報の変更と、この変更が貴社で構築済みの Stripe システムに及ぼす影響について、詳細をご紹介します。 このガイドの要件の更新では、Accounts v1 API のプロパティについて説明しています。**Accounts API** ドロップダウンで `v2` を選択し、**要件の更新**ドロップダウンで必要な更新を選択すると、対応する Accounts v2 API プロパティを[必要な確認情報](https://docs.stripe.com/connect/required-verification-information.md)で確認できます。 決済に関する規制は、マネーロンダリング、不正利用、脱税などの犯罪を防ぐために設けられています。世界中の金融規制当局は、[Know Your Customer (KYC) 要件](https://support.stripe.com/questions/know-your-customer)を施行し、Stripe が特定のタイプのビジネスと、最終的にそれらを所有、管理、または指示する個人から本人確認情報を収集、検証、維持することを義務付けています。これらの要件は、金融サービスの規制当局、カードネットワーク、その他の金融機関によって頻繁に更新されます。 このガイドは、今後の変更の概要を示すものであり、最も重要な変更内容を強調表示しています。要件をすべて網羅したリストについては、[必要な確認情報](https://docs.stripe.com/connect/required-verification-information.md)を参照してください。 連結アカウントのユーザー登録に API ベースのフローを使用する場合は、要件の変更をすべて処理するように導入を更新する必要があります。[Connect アカウント登録オプション](https://docs.stripe.com/connect/onboarding.md)と、[API ベースのユーザー登録および改善策フローを Stripe がホストするフローまたは埋め込みフローに移行する方法](https://docs.stripe.com/connect/migrate-from-api-onboarding.md)の詳細をご確認ください。 #### プログラム - ヨーロッパ *最終更新日: 2026 年 2 月 23 日* ## 検証要件の変更を理解 イギリス金融行動監視機構 (FCA) とアイルランド中央銀行 (CBI) の規制に合わせるため、Stripe は KYC (顧客確認) 要件と、最終的実質的所有者 (UBO) と取締役の関係確認を更新する予定です。 リストに記載されているいずれかの国で連結アカウントを運用している場合、ユーザー登録フローを更新する必要がある可能性があります。必要な更新を行わないと、連結アカウントの決済や金融サービスへのアクセスが中断されます。 変更点と理由については、[新しい法令遵守要件に対応するサポート記事](https://support.stripe.com/questions/europe-verification-requirement-updates-for-connected-accounts)をご覧ください。 今度の変更は、以下の国の連結アカウントに影響します。 - AT - BE - BG - CH - CY - CZ - DE - DK - EE - ES - FI - FR - GB - GI - GR - HR - HU - IE - IS - IT - LI - LT - LU - LV - MT - NL - NO - PL - PT - RO - SE - SI - SK > #### 継続的な更新 > > Stripe は 2026 年 4 月 1 日まで、これらの要件の収集をサポートする API の更新を続けます。 ## 導入するアプローチの選択 Stripe では、事業および本人確認の要件を収集する際に、Stripe ホスト型または組み込み型のオンボーディングの使用を推奨しています。これらのオプションは、API オンボーディングを使用するよりも実装および維持に必要なリソースが少なくて済みます。以下の表は主な違いを示しています。 - [Stripe ホスト型オンボーディング](https://docs.stripe.com/connect/hosted-onboarding.md):(推奨) Stripe ホスト型フローにアカウントを送信して、必要な情報を送信します。 - [組み込みオンボーディング](https://docs.stripe.com/connect/embedded-onboarding.md)::(推奨) Stripe が提供するオンボーディングコンポーネントを埋め込むことで、アプリ内から Stripe にアカウント情報を直接送信できます。 - [API onboarding](https://docs.stripe.com/connect/api-onboarding.md):Stripe API を使用してカスタムオンボーディングフローを構築、管理します。 | | **Stripe ホスト型アカウント登録** | **埋め込みアカウント登録** | **API によるアカウント登録** | | -------------- | ------------------------------------- | ------------------------------------- | ----------------------------------------------- | | 最適 | Stripe がアカウント登録を担当するプラットフォーム | ブランドのアプリ内ユーザー登録フローを求めるプラットフォーム | 完全なコントロールを必要とし、それを構築・維持できるプラットフォーム | | 初期導入作業 | 3 ～ 4 週間 | 3 ～ 4 週間 | 30 ～ 40 週間 | | 要件更新への継続的な取り組み | Stripe が自動的に処理 | Stripe が自動的に処理 | 今後の変更を事前に監視し、変更ごとにユーザー登録フローを更新するエンジニアリングリソースが必要 | | カスタマイズ | プラットフォームブランディングによる Stripe ホストインターフェイス | 口座がプラットフォームアプリからアクセスできるテーマ性の高いコンポーネント | プラットフォームの設計、構築、インターフェイスのメンテナンス | | 追加国に対応する努力 | Stripe が自動的に処理 | Stripe が自動的に処理 | 追加国ごとにユーザー登録フローを更新するためのエンジニアリングリソースが必要 | [Connect アカウント登録オプション](https://docs.stripe.com/connect/onboarding.md)と、[API ベースのユーザー登録および改善策フローを Stripe がホストするフローまたは埋め込みフロー](https://docs.stripe.com/connect/migrate-from-api-onboarding.md)に移行する方法をご紹介します。 [アカウント登録フローに加える変更](https://docs.stripe.com/connect/handle-verification-updates.md#collect-future-requirements)は、アカウント登録の設定によって異なります。アカウント登録フローを更新するだけでなく、必要に応じて社内外のドキュメントも更新し、サポートチームが変更に関する質問に対応できるよう準備してください。 Stripe ホストまたは組み込みオンボーディングを使用している場合は、これらの要件更新に備えて統合を更新する必要はありません。ただし、要件が変更された際に Stripe が新しい、または更新された本人確認情報の提供を連結アカウントに求める可能性があることは通知しておくとよいでしょう。 ## API 導入概要 Stripe ホストまたはエンベデッドユーザー登録に移行しない場合は、以下のアップデートに対応する必要があります。 - [顧客確認 (KYC) 検証](https://docs.stripe.com/connect/upcoming-requirements-updates.md#know-your-customer-\(kyc\)-verification) - [最終的な会社代表者 (UBO) と取締役関係の確認](https://docs.stripe.com/connect/upcoming-requirements-updates.md#ubo-director-verification) - [オランダ事業登録 (KvK)の要件](https://docs.stripe.com/connect/upcoming-requirements-updates.md#netherlands-business-registration-requirements) - [新しいエラーコード](https://docs.stripe.com/connect/upcoming-requirements-updates.md#new-error-codes) ## タイムラインの更新 以下のタイムラインでは、これらの変更に関する主なマイルストーンを説明しています。新しい要件が適用されたときに問題が発生しないように、早めに更新して導入テストを行うようにしてください。 | 日付 | マイルストーン | 説明 | | ----------------------- | -------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- | | 2025 年 10 月 | 導入プランニングの開始 | 初期 API の更新をご利用いただけます。このガイドと変更内容をレビューして、導入の更新を計画してください。 | | 2026 年 3 月 | 影響を受けるアカウントをレビューし、導入の更新をテストする | Stripe は、影響を受ける連結アカウントの推定数を提供します。更新されたアカウント登録フローのテストを開始してください。 | | 2026 年 3 月 ～ 4 月 | `future_requirements` の展開が開始されます (API アカウント登録) | API アカウント登録を使用するプラットフォームの場合、Stripe は新規アカウントと既存アカウントの両方について、`future_requirements` に新しい要件の追加を開始します。 | | 2026 年 4 月 1 日 | 事業形態が `individual` の連結アカウントのみを持つプラットフォームに新しい要件が適用されます。 | 更新されたアカウント登録フローにおいて新しい要件を収集する準備ができていることを確認してください。Stripe が新しい要件の展開を開始する 4 月 1 日までに、更新されたフローを稼働させる必要があります。すべての新しい要件は 4 月末までに有効になります。 | | 2026 年 5 月 1 日 | 事業形態が `company` の連結アカウントを持つプラットフォームに、新しい要件が適用されます。これには、`individual` の連結アカウントもプラットフォームが含まれます。 | 更新されたアカウント登録フローにおいて新しい要件を収集する準備ができていることを確認してください。Stripe が新しい要件の展開を開始する 5 月 1 日までに、更新されたフローをすべての連結アカウントで稼働させる必要があります。すべての新しい要件は 5 月末までに有効になります。 | | 2026 年 6 月 ～ 2026 年 8 月 | 現在、既存のアカウントには新しい要件が適用されます | 新しい要件は、この期間中に既存の連結アカウントにも適用されます。必要に応じて、更新されたオンボーディングフローを使って情報を収集してください。 | | 2026 年 7 月から 10 月 | 新しい要件の期日 | 制限を回避するには、各アカウントの更新された要件を、そのアカウントの期日までに確認する必要があります。 | ## 顧顧客情報 (KYC) の確認 Stripe は本人確認プロセスを強化しており、連結アカウントの一部に追加情報の提供が必要になる可能性があります。また、API に情報確認のオプションも追加しています。 以下の事業体は、検証可能な KYC 情報を提供する必要があります。 - 法人 (個人および個人事業主の場合); - アカウント代表者 - UBOs (Stripe のリスクモデルで高リスクと見なされるアカウントの場合) ### その他の確認方法 標準のキー入力情報に加えて、次の任意の方法を使用すると、確認成功率を最大限に高めることができます。 - [Stripe Identity](https://docs.stripe.com/connect/upcoming-requirements-updates.md#stripe-identity): (推奨)自動確認に失敗したアカウントには顔写真と書類キャプチャーしてください。 - [国民 ID 確認](https://docs.stripe.com/connect/upcoming-requirements-updates.md#national-id-verification): 国民 ID 番号を事前に収集して、初回確認率を高めます。 - [追加書類のアップロード](https://support.stripe.com/questions/documents-for-identity-and-home-address-verification): 手動レビューのために本人確認書類または住所確認書類を提出して、手動レビューを依頼します。 ### Stripe Identity (推奨) 自動確認に失敗した連結アカウントの確認には、[Stripe Identity](https://stripe.com/identity)を使って確認を試みることができます。Identity は、顔写真と[身分証明書](https://docs.stripe.com/acceptable-verification-documents.md)を撮ることで機能します。ほとんど[のヨーロッパ諸国](https://docs.stripe.com/identity/use-cases.md)は Stripe Identity に対応しており、成功率は国によって異なります。 本人確認[セッション](https://docs.stripe.com/api/identity/verification_sessions.md?api-version=preview)を作成し、[related_person](https://docs.stripe.com/api/identity/verification_sessions/object.md?api-version=preview#identity_verification_session_object-related_person)パラメーターを使用して、その人物の`document`と`proof_of_liveness`の要件を送信します。結果は、API またはダッシュボードを使用して確認できます。 ### 本人確認書類番号の確認 この更新の[影響を受ける国](https://docs.stripe.com/connect/upcoming-requirements-updates.md#affected-countries)では、連結アカウントの担当者の名前、生年月日、住所、国籍に加えて国民 ID 番号を提供することで、担当者の確認を強化できます。 現在、本人確認は以下の国民 ID 番号のみに対応しています。 | 国 | 身分証明書の種類 | | ------ | ------------------------------------- | | デンマーク | 中央個人登録 (CPR) | | イタリア | 納税者番号 (Codice Fiscale) | | ポーランド | PESEL 番号 | | スペイン | Documento Nacional de Identidad (DNI) | | スウェーデン | 個人識別番号 (Personnummer) | アメリカなど、この更新の影響を受けない国では、本人確認書類番号の確認には対応していません。たとえば、EU 内のオーストリアにある連結アカウントの代表者であるスペイン市民については、本人確認書類番号を指定できます。一方、アメリカにある連結アカウントの代表者であるスペイン市民については、本人確認書類番号を指定できません。 > #### National ID が利用可能 > > 更新後の要件が将来の要件になった時点で、連結アカウントの本人確認書類番号の収集を開始できます。それまでは、この連携機能をサンドボックスアカウントでプレビュー機能として利用できます。 ### API を使用した国民 ID 照合の実施 次の例は、要件が更新された新しい連結アカウントのオンボーディングを示しています。 > 以下の違いは、v1 Accounts API にのみ影響し、v2 には影響しません。 #### ステップ 1: テスト用の連結アカウントを作成 (Public preview) 今後の要件が導入された後は、通常どおり連結アカウントを作成できます。それまでは、新しい KYC の動作を有効にするために、[サンドボックス](https://docs.stripe.com/sandboxes.md)で新しい連結アカウントを作成してください。 口座作成コールの 2 つの部分を変更することで、この動作をトリガーします。 1. ヘッダー `experimental_onboarding_preview=v2` を追加します。 1. `capabilities[card_payments][preview]=true` します。 アカウントを作成すると、新しい要件文字列 `representative.nationality` が表示されます。これは、アカウントの代表者を作成し、国籍情報を渡せることを示しています。 ```shell // 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: 口座担当者の作成 連結アカウントを作成したら、アカウント担当者を作成します。 ```shell > 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` 回収の対象かどうかを判断できます。 ```shell > 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" ] } ... } ``` 国籍を収集した後、その人物が対象国にいる場合は、`alternatives` 配列に代替要件として ID 番号が表示されます。`alternatives` 配列の各エントリーは、標準要件に対する代替の対応パスを表します。元の要件の代わりに代替要件を満たすこともできますが、両方を満たす必要はありません。 この例では、`alternatives` には、期限超過となっている `dob.year` 要件の代替として `id_number` が含まれています。つまり、出生年の代わりに本人確認書類番号を指定できます。出生年を指定する場合は、本人確認書類番号を指定する必要はありません。 ```shell > 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 番号を含む追加的な人物の属性を徴収します。 ```shell > 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` には表示されない場合でもです。 ```shell > 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. 入力した名前や住所の情報を確認し、間違いがあれば再入力することができます。 1. 生年月日、名前、住所、id_number に入力した情報を確認し、正しい情報を再入力することができます。 1. 名前と住所が一致する書類をアップロードすることができます 1. Stripe Identity を完了することができます これらの 4 つのパスは、`past_due` フィールドおよび `alternatives` として表示されます。 ```shell > 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.*" ], "alternative_fields_due": [ "person_1N9XNb2eZvKYlo2CjPX7xF6B.proof_of_liveness" ] } ] } } ``` **キー入力されたフィールドのエラー** これまでは、キー入力されたフィールドの処理中に検証エラーが発生すると、ドキュメントフィールドは `past_due` に移動し、エラーが表示されていました。今後は、キー入力されたフィールドは `past_due` に戻ります。`id_number` のようなフィールドは `alternative_fields_due` に残ります。 例えば、名前、生年月日、住所がもともと `past_due` であった場合、提出後に名前と生年月日が一致し、名前と住所が一致しなかった場合、名前と住所は `past_due` に戻り、生年月日は削除されます。 この場合、`past_due` および `alternative_fields_due` のフィールドにエラーが表示されます。 ```shell > 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_identity", "reason": "Identity information could not be verified.", "requirement": "person_1N9XNb2eZvKYlo2CjPX7xF6B.name" }, { "code": "verification_failed_keyed_identity", "reason": "Identity information could not be verified.", "requirement": "person_1N9XNb2eZvKYlo2CjPX7xF6B.address" }, { "code": "verification_failed_keyed_identity", "reason": "Identity information could not be verified.", "requirement": "person_1N9XNb2eZvKYlo2CjPX7xF6B.id_number" } ] } } ``` ### 高リスクのアカウント Stripe のリスクモデルでは、高リスクに分類されたアカウントに対してのみ、UBO の KYC 確認が必要です。テストでは、ビジネス名の末尾に `_high_risk` を追加して、高リスク評価を強制します。これにより、導入で処理する必要がある要件やエラーを含め、所有者の KYC 確認フロー全体をテストできます。 この例では、高リスクのテストアカウントを作成し、所有者を追加する方法を示します。 ```curl // 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_123", ... "requirements": {...} ... } // Set the business name to enforce the account to be high risk curl https://api.stripe.com/v1/accounts/acct_123 \ -u sk_test_123: \ -d "business_profile[name]"="example_high_risk" ``` ```curl curl https://api.stripe.com/v1/accounts/acct_123/persons \ -u sk_test_123: \ -d first_name=Marie \ -d last_name=Dupont \ -d "dob[day]"=1 \ -d "dob[month]"=1 \ -d "dob[year]"=1901 \ -d "relationship[owner]=true" \ -d "address[line1]"="address_no_match" \ -d "address[city]"="Madrid" \ -d "address[postal_code]"="28001" { "id": "person_123", ... } ``` ```curl curl https://api.stripe.com/v1/accounts/acct_123 \ -u sk_test_123: \ -d "company[owners_provided]"="true" ``` Stripe が所有者に対して KYC 確認を実行すると、アカウント要件にその結果が反映されます。所有者の名前は一致していても住所が一致しない場合 (`address_no_match` のテスト用住所を使用すると発生)、要件には所有者のフィールドの `verification_failed_keyed_identity` エラーが含まれます。 ```json { "requirements": { "past_due": [ "people.person_123.address.city", "people.person_123.address.line1", "people.person_123.address.postal_code", "people.person_123.first_name", "people.person_123.last_name" ], "errors": [ { "code": "verification_failed_keyed_identity", "requirement": "people.person_123.address.city" }, { "code": "verification_failed_keyed_identity", "requirement": "people.person_123.address.line1" }, { "code": "verification_failed_keyed_identity", "requirement": "people.person_123.address.postal_code" }, { "code": "verification_failed_keyed_identity", "requirement": "people.person_123.first_name" }, { "code": "verification_failed_keyed_identity", "requirement": "people.person_123.last_name" } ], "alternatives": [ { "original_fields_due": [ "people.person_123.address.city", "people.person_123.address.line1", "people.person_123.address.postal_code", "people.person_123.first_name", "people.person_123.last_name" ], "alternative_fields_due": [ "people.person_123.verification.additional_document" ] }, { "original_fields_due": [ "people.person_123.address.city", "people.person_123.address.line1", "people.person_123.address.postal_code", "people.person_123.first_name", "people.person_123.last_name" ], "alternative_fields_due": [ "people.person_123.verification.proof_of_liveness" ] } ] } } ``` これらの要件を解決するには、所有者の本人確認のための情報を再提出するか、代替要件のいずれかを満たします (`additional_document` をアップロードするか、`proof_of_liveness` を完了します)。 ## UBO と取締役の関係の確認 Stripe は、最終的な実質的所有者 (UBO) と取締役の確認プロセスを強化しています。ヨーロッパの規制では、UBO と取締役の法人との関係の確認が義務付けられています。 - **UBO:** 法人 (例えば、会社、法人、LLC、パートナーシップなど) の 25% 以上を直接的または間接的に所有または支配する個人。 - **取締役:** 企業の取締役会のメンバー、または企業の経営に責任を負うその他の上級役員 (例: CEO、COO、社長、マネージングディレクター、エグゼクティブディレクターなど)。 次の表は、各法人タイプについて確認が必要な関係を示しています。 | 法人タイプ | 確認する関係 | 注 | | ------------------ | ---------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- | | 会社、法人、LLC、パートナーシップ | UBO が存在する場合は UBO、それ以外の場合は取締役 | 英国のみ: UBOと取締役の両方 | | 非営利団体 | 取締役 | ほとんどの非営利団体には UBO は存在しません | | 個人または個人事業主 | 該当なし | 該当なし | | 政府機関または公的機関 | 該当なし | UBO 情報の提供を免除されるには、政府機関は[このサポートページ](https://support.stripe.com/questions/business-verification-requirements-for-government-entities)に記載されているプロセスに従う必要があります。 | | 上場企業 | 該当なし | UBO 情報の提供を免除されるには、上場企業は[このサポートページ](https://support.stripe.com/questions/business-verification-requirements-for-publicly-traded-companies)に記載されているプロセスに従う必要があります。 | ### UBO および取締役情報の確認 UBO および取締役は以下の情報を提供する必要があります。 - 氏名 - 生年月日 - 住所 - メールアドレス - 役職 (取締役のみ) Stripe は、個人と法人の以下の主要なプロパティを照合することで、その個人と法人の関係性の確認を試みます。 | 法人 | 主なプロパティ | | -- | ----------------------------------------- | | 個人 | - 名 - 姓 - (提供されている場合) ID 番号 | | 法人 | - 名前 - 住所 - 納税者番号 - VAT ID - 登録番号 | 認証が成功するためには、プロパティの一部のみが一致していればよい場合があります。 Stripe は、次の方法で関係を確認しようとします： | 方法 | 説明 | サンプル要件 | | -------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | サードパーティー決済代行業者 | サードパーティー決済代行業者が利用可能な場合、Stripe はそのアカウントのすべての関係の確認を自動的に試行します。 | - `owners.first_name` - `owners.last_name` - `company.tax_id` | | 公式文書 | 所有者の場合は「UBO 証明書」、取締役の場合は「登録証明書」を提出できます。[受付可能な書類](https://docs.stripe.com/acceptable-verification-documents.md)は国によって異なります。 | - `owners.first_name` - `owners.last_name` - `company.name` - `company.address.line1` - `company.address.city` - `company.address.state` - `documents.proof_of_ultimate_beneficial_ownership` | | デジタル証明 | 以下の PDF テンプレートを使用して、関係にデジタル証明書を提供できます： - [UBO デジタル証明テンプレート](https://docs.stripecdn.com/6e82842bfc01bd0b1c46d77f7d46b69673a9ca965ed2ad9ef53139f98abdbbaf.pdf) - [取締役デジタル証明テンプレート](https://docs.stripecdn.com/715ffef45157ff700bc368a4011659ee23bc8ba3c68746c5c15948a6eee1591f.pdf) | - `owners.id_number` - `company.tax_id` - `documents.proof_of_ultimate_beneficial_ownership` - `documents.proof_of_ultimate_beneficial_ownership.signer` | ### API を使用して関係の確認要件を特定する `アカウント`の要件を取得すると、元の確認オプションと代替の確認オプションは、重要な情報と利用可能な確認方法の組み合わせを表します。ほとんどの場合、所有者または取締役の確認には少なくとも 3 つのオプションがあります。 次のコードは、所有者要件を持つ連結アカウントの例です。特定のオプションと、その表示順序はアカウント間で異なる場合があります。 ```shell // 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 個提供したことを証明する必要があります。 次の例は、所有者ではなく取締役を確認できる連結アカウントを示しています： ```shell // 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 件の連結アカウントを示しています。 ```shell // 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" ], } ] } } ``` ### エラー処理 所有者と取締役の要件エラーには、一般的な[ドキュメントと詳細の不一致エラー](https://docs.stripe.com/error-codes.md)に加えて、次の`コード`値が含まれる場合があります。 | コード | 説明 | | ----------------------------------------------- | ---------------------------------------------------------------------------------- | | `verification_missing_owners` | この`アカウント`には、サードパーティー決済代行業者によって識別された所有者に関する情報、または書類またはデジタル証明書に記載された所有者に関する情報がありません。 | | `verification_missing_directors` | `アカウント`に、サードパーティー決済代行業者によって識別された、または書類またはデジタル証明書に記載された取締役に関する情報が不足しています。 | | `verification_data_not_found` (Private preview) | サードパーティー決済代行業者がビジネスに関する情報が見つかりませんでした。 | これらのエラーは、ビジネスの詳細を更新することで解決できる場合があります。ただし、ほとんどの場合、連結アカウントを書類のアップロードパスまたはデジタル証明パスのいずれかに誘導する必要があります。 Stripe が行方不明の所有者または取締役を特定すると、プライベートプレビュー API がそれらに関するデータを提供する場合があります。連結アカウントはそのデータを使用して、行方不明の `Persons` を作成できます。 ### API を使用して UBO と取締役確認のためのデジタル証明を実装 > #### 利用可否 > > Accounts v2 API はまだデジタル証明をサポートしていません。 次に、UBO または取締役確認のためのデジタル証明を実行する例を示します。 1. どの証明書類が必要かを確認するために口座を検索します。 ```shell // 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 を作成し、承認された担当者に電子署名してもらいます。 1. ファイル API を使用して、署名済みの証明書類をアップロードします。 ```shell 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" } ``` 1. 署名者を表す `Person` の ID を記載した書類を提出します。 ```shell // 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% 以上) - 取締役および役員 - その他の承認された口座メンバー 重要: 署名者は、口座に関連する既存の人物でなければなりません。認証文書に署名できるのは、法務法人との法的文書上の関係を有する個人のみです。 ### エラー処理 デジタル認証には、対処すべき特定のエラーシナリオがあります。 #### 無効な署名者 署名者がアカウントに関連付けられていないか、権限がない場合に発生します。 ```shell { "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." }] } } ``` #### ドキュメント失敗 アップロードされた文書が読めないか、間違っている場合に発生します。 ```shell { "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 エラー ```shell { "error": { "code": "invalid_signator", "message": "signer.person can only be provided when a file is also provided", "type": "invalid_request_error" } } ``` ### 次のステップ 1. 認証文書を使用する際に署名者を徴収するよう、導入を更新します。 1. 新しい認証固有のエラーコードに対するエラー処理の実装。 1. 新しい認証要件についてサポートチームをトレーニング。 #### UBO および取締役情報の事前入力 (プライベートプレビュー) オプションで、法人に関連付けられた UBO または取締役をプログラムで検出して事前入力する API と統合することもできます。連結アカウントは、書類のアップロードやデジタル証明を使用する代わりに、検出された情報を確認することで関係を確認できます。 この方法は、確認率を高め、負担を軽減できますが、すべてのアカウントで機能するわけではありません。Stripe が関係を事前入力できないアカウントについては、書類のアップロードやデジタル証明を処理する必要があります。 UBO または取締役確認のための事前入力に関心がある場合は、以下から登録してご関心をお寄せください。 ## オランダ事業登録 (KvK)の要件 **2026 年 5 月 14 日より適用** 2026 年初頭、プラットフォームはオランダ (NL) の連結アカウントから、KvK (Kamer van Koophandel) 番号 (8 桁の一意の事業登録番号) を収集することが義務付けられました。この変更の一環として、 `individual` の事業形態は `unsupported_business_type` エラーにより制限され、非法人団体は `company.tax_id` を通じて KvK 番号を提供する必要がありました。 2026 年 5 月 14 日以降、Stripe のダッシュボードにアクセスできない個人または非法人団体を表す連結アカウントでは、KvK 番号の提供は不要になりました。 Stripe ダッシュボードのフルバージョンまたは Express ダッシュボードにアクセスできる個人または非法人団体を表す連結アカウントは、引き続き KvK 番号を提供する必要があります。 ### 変更点 - Stripe のダッシュボードにアクセスできないオランダの連結アカウントで、`business_type: "individual"` がサポートされるようになりました。これらのアカウントでは、`unsupported_business_type` エラーは表示されなくなりました。 - Stripe のダッシュボードにアクセスできない連結アカウントでは、 `unincorporated_partnership` と `unincorporated_non_profit` の事業形態について、KvK 番号を保持するために `company.tax_id` を使用する必要がなくなりました。 ### 必要なご対応 対応は不要です。インテグレーションを変更する必要はありません。 この変更の影響を受ける既存の連結アカウントについて: - Stripe は、個人アカウントの `requirements.errors` から `unsupported_business_type` エラーを自動的に解除します。 - このエラーに関連するケイパビリティの制限 (`card_payments` や `transfers` など) は、自動的に解除されます。 - KvK 番号がないために制限されていた個人または非法人団体を表すアカウントも、自動的に制限解除されます。 ## 新しいエラーコード ### 確認エラーコード (プライベートプレビュー) `Account` オブジェクトの `requirements.errors` 配列に新しいエラーコード `verification_data_not_found` が表示されることがあります。このエラーは、Stripe が連結アカウントの既知の法人情報を使用してサードパーティーの確認プロバイダーから情報 (UBO や取締役/役員のデータなど) を取得できなかったことを示しています。これはさまざまな理由で発生する可能性がありますが、多くの場合、アカウントが情報を誤って入力したことが原因です。 この「データが見つかりません」エラーは、既存の確認エラーコードとは異なります。 - **`verification_missing_owners`**: アカウントに既知の所有者がいないことを示します。 - **`verification_failed_keyed_match`**: 提出された情報と確認ソースの不一致を示します。 ```shell // 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 のテスト](https://docs.stripe.com/connect/testing.md)をご覧ください。 ### テストアカウントを作成 [サンドボックスシークレットキー](https://docs.stripe.com/keys.md)を使用して Accounts API に POST リクエストを送信し、テスト`Account` を作成します。 テスト環境以外のアカウントにリリースする前に新しい要件にアクセスするには、API のプレビューバージョンを有効にするヘッダーを設定し、試験的なアカウント登録プレビュー機能を有効にし、ケイパビリティをリクエストするときにプレビューバージョンを有効にします。以下に例を示します。 ```shell 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' ``` 以下の例は、テストアカウントに対して特定のレスポンスをトリガーする値を使用して、さまざまな状況をシミュレートする方法を示しています。 ### 個人に属するアカウントをテストする この例では、法人タイプが`個人`であるため、関係の確認を必要としないアカウントを作成します。 [前の手順](https://docs.stripe.com/connect/upcoming-requirements-updates.md#create-a-test-account)に従ってテストアカウントを作成し、次に基本的なビジネスの詳細を設定します。 ```shell 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" ``` レスポンスには、個人の基本的な要件が含まれます。代表者を作成することで、これらの要件を満たすことができます。 ```shell 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 を指定すると、サンドボックスで本人確認が成功します。その他の結果トリガーについては、[テスト用の生年月日](https://docs.stripe.com/connect/testing.md#test-dobs)をご覧ください。同様に、住所の 1 行目を文字列 `address_full_match`に設定すると、住所確認が成功します。その他の結果トリガーについては、[テスト用の事業所住所](https://docs.stripe.com/connect/testing.md#test-validation-addresses)をご覧ください。 レスポンスは、個人の要件が保留中になったことを示しています。しばらく待ってから`Account` を取得すると、これらの要件がクリアされていることがわかります。 ```shell curl https://api.stripe.com/v1/accounts/acct_test_123 \ -u sk_test_123 ``` 残りの要件は、銀行口座 (`external_account`) と利用規約 (TOS) のみです。利用規約要件をクリアするには、`Account` の `tos_acceptance` ハッシュを設定します。 ```shell 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` のテスト用銀行口座を作成します。[国に応じたテスト用銀行口座番号](https://docs.stripe.com/connect/testing.md#account-numbers)を指定してください。 ```shell 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` に設定しているアカウントでテストしてください。 [前の手順](https://docs.stripe.com/connect/upcoming-requirements-updates.md#create-a-test-account)に従ってテストアカウントを作成し、次に基本的なビジネスの詳細を設定します。 ```shell 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` を指定すると、会社の確認が成功します。その他の結果のトリガーについては、[事業者の納税者番号のテスト](https://docs.stripe.com/connect/testing.md#test-business-tax-ids)をご覧ください。 次に、代表者を指定します。 ```shell 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 リクエストで残りの要件を確認できます。 ```shell curl https://api.stripe.com/v1/accounts/acct_test_123 \ -u sk_test_123: ``` `requirements.currently_due` 配列の要件には、`Account` の所有者について必要な詳細がリストされます。`requirements.alternatives` 配列には、特定の要件を満たすために提供できるオプション情報が含まれる場合があります。以下に例を示します。 ```json { "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` を使用するテストアカウント用にハードコードされた値です。 ```shell 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` のすべての所有者を作成したことを示します。 ```shell 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 を使用してアップロードする方法を示します。 [前述の手順](https://docs.stripe.com/connect/upcoming-requirements-updates.md#create-a-test-account)に従ってテストアカウントを作成し、基本的な事業者情報を設定します。納税者番号を `222221001` に設定すると、所有者確認の失敗がトリガーされます。その他の結果トリガーについては、[事業者の納税者番号のテスト](https://docs.stripe.com/connect/testing.md#test-business-tax-ids)をご覧ください。 ```shell 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" ``` 次に、代表者を指定します。 ```shell 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" ``` 次に、所有者を作成します。 ```shell 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 に設定して、所有者の作成が終了したことを示します。 ```shell curl https://api.stripe.com/v1/accounts/acct_test_123 \ -u sk_test_123: \ -d "company[owners_provided]=true" ``` `アカウント`を調べると、所有者の要件が残り、`requirements.errors` 配列に `requirement` が `owners` で `code` が `verification_failed_other` のエントリーが存在することがわかります。これは、Stripe が提供された会社情報を使用して所有者を確認できなかったことを意味します。 > API のプライベートプレビューバージョンを使用している場合、エラーコードは `verification_failed_other` ではなく [verification_data_not_found](https://docs.stripe.com/changelog/clover/2025-10-29/accounts-verification-data-error.md) です。 実際の`Account` についてこのエラーが表示された場合は、正しい法人の詳細が入力されていることを確認してください。この例では、詳細が正しいこと、および確認のための書類を提出する必要があることを前提としています。 実際の `Account` では、[Files API を使用して書類をアップロードし](https://docs.stripe.com/file-upload.md)、レスポンスで返されたトークンを使用して `Account` を更新します。この例では、テストトークン `file_relationship_document_success` を使用します。その他の結果トリガーについては、[関係書類トークンのテスト](https://docs.stripe.com/connect/testing.md#test-relationship-document-tokens)をご覧ください。 ```shell 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` を更新してからしばらくすると、現在の要件が取得され、所有者の要件がクリアされていることを確認できます。 ```shell curl https://api.stripe.com/v1/accounts/acct_test_123 \ -u sk_test_123: ``` ### 該当する所有者がいない会社のテスト 会社に 25% を超える所有権を持つ所有者がいない場合、Stripe は代わりに取締役情報を必要とします。この例は、取締役情報を提供する方法を示しています。 [前の手順](https://docs.stripe.com/connect/upcoming-requirements-updates.md#create-a-test-account)に従ってテストアカウントを作成し、次に基本的なビジネスの詳細を設定します。納税者番号を `000000000` に設定します。これにより、会社の確認が成功します。 ```shell 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" ``` 次に、代表者を指定します。 ```shell 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` を再利用するには、既存の所有者をすべて削除します。 ```shell curl https://api.stripe.com/v1/accounts/acct_test_123 \ -u sk_test_123: \ -d "company[owners_provided]=true" ``` `requirements.alternatives` 配列には、所有者プロパティに代わる一連の取締役プロパティが含まれます。取締役の作成プロセスは、所有者の作成プロセスとよく似ています。 ```shell 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 に設定して、取締役の作成が終了したことを示します。 ```shell curl https://api.stripe.com/v1/accounts/acct_test_123 \ -u sk_test_123: \ -d "company[directors_provided]=true" ``` 関係の確認の成功をシミュレートするには、`company.name` を文字列 `match_name_relationships` に設定します。 ```shell curl https://api.stripe.com/v1/accounts/acct_test_123 \ -u sk_test_123: \ -d "company[name]=match_name_relationships" ``` ### その他のテストケース 以下のテストも重要です。 - 取締役の確認が必要な`non_profit`タイプの事業体 (UBO の確認はオプションではありません)。 - 書類を使用して取締役の確認要件を満たす。 - UBO の確認と取締役の確認の両方を必要とするイギリスの企業。 #### プログラム - ブラジル *最終更新日: 2026 年 4 月 27 日* ## 検証要件の変更を理解 ブラジル中央銀行 (BCB) の Circular BCB 3978/20 に基づく規制に準拠するため、Stripe は KYC (顧客確認)、KYB (ビジネス確認)、会社代表者 (UBO) に関する本人確認要件を更新しています。 連結アカウントがブラジルで事業を行っている場合、アカウント登録フローおよび改善策フローの更新が必要になることがあります。必要な更新を行わない場合、連結アカウントの決済および金融サービスへのアクセスに支障が生じます。 ## 導入アプローチの選択 Stripe では、事業および本人確認の要件を収集する際に、Stripe ホスト型または組み込み型のオンボーディングの使用を推奨しています。これらのオプションは、API オンボーディングを使用するよりも実装および維持に必要なリソースが少なくて済みます。以下の表は主な違いを示しています。 - [Stripe ホスト型オンボーディング](https://docs.stripe.com/connect/hosted-onboarding.md):(推奨) Stripe ホスト型フローにアカウントを送信して、必要な情報を送信します。 - [組み込みオンボーディング](https://docs.stripe.com/connect/embedded-onboarding.md)::(推奨) Stripe が提供するオンボーディングコンポーネントを埋め込むことで、アプリ内から Stripe にアカウント情報を直接送信できます。 - [API onboarding](https://docs.stripe.com/connect/api-onboarding.md):Stripe API を使用してカスタムオンボーディングフローを構築、管理します。 | | **Stripe ホスト型アカウント登録** | **埋め込みアカウント登録** | **API によるアカウント登録** | | -------------- | ------------------------------------- | ------------------------------------- | ----------------------------------------------- | | 最適 | Stripe がアカウント登録を担当するプラットフォーム | ブランドのアプリ内ユーザー登録フローを求めるプラットフォーム | 完全なコントロールを必要とし、それを構築・維持できるプラットフォーム | | 初期導入作業 | 3 ～ 4 週間 | 3 ～ 4 週間 | 30 ～ 40 週間 | | 要件更新への継続的な取り組み | Stripe が自動的に処理 | Stripe が自動的に処理 | 今後の変更を事前に監視し、変更ごとにユーザー登録フローを更新するエンジニアリングリソースが必要 | | カスタマイズ | プラットフォームブランディングによる Stripe ホストインターフェイス | 口座がプラットフォームアプリからアクセスできるテーマ性の高いコンポーネント | プラットフォームの設計、構築、インターフェイスのメンテナンス | | 追加国に対応する努力 | Stripe が自動的に処理 | Stripe が自動的に処理 | 追加国ごとにユーザー登録フローを更新するためのエンジニアリングリソースが必要 | [Connect アカウント登録オプション](https://docs.stripe.com/connect/onboarding.md)と、[API ベースのユーザー登録および改善策フローを Stripe がホストするフローまたは埋め込みフロー](https://docs.stripe.com/connect/migrate-from-api-onboarding.md)に移行する方法をご紹介します。 Stripe ホスト型または組み込み型のアカウント登録を使用しているプラットフォームは、これらの要件更新のために実装を変更する必要はありません。Stripe が自動的に処理します。API ベースのアカウント登録を使用しているプラットフォームは、要件の変更を積極的に追跡し、更新ごとにエンジニアリングリソースを確保する必要があります。 ## API 導入の概要 プラットフォームが API ベースのアカウント登録を使用している場合、ブラジルの連結アカウントに対して以下の変更に対応するために実装を更新する必要があります。 - **KYC: 個人の本人確認** — すべての個人アカウントおよび担当者について、CPF、生年月日、住所、および生存確認を収集 - **KYB: 法人の本人確認** — 法人の CNPJ、法人名、および登録住所を収集。プログラムによる確認および書類によるフォールバックフローに対応 - **納税者番号の登録ステータス** — 非アクティブまたは無効な CPF、CNPJ の登録ステータスに対応 - **UBO と関係性の確認** — 取締役または所有者が法律上そのように登録されていることを確認 - **財務能力** — 機能を有効にする前に、ブラジルのすべてのアカウントについて月間収入または総収益を収集 - **新しいエラーコード** — `requirements.errors` 配列に表示される新しい確認エラーコードに対応 ## KYC: 個人の本人確認 Stripe はブラジル中央銀行 (BCB) の要件に準拠するため、ブラジルの個人アカウントに対する本人確認を強化しています。個人の連結アカウントおよび法人アカウントの担当者は確認が必要であり、アカウント登録の一環として追加情報の提供が求められる場合があります。 以下の人物は、確認可能な KYC 情報を提供する必要があります。 - **担当者**: 利用規約に署名し、アカウントに対して法的責任を負う個人。 - **所有者**: 法人の所有者 (該当する場合)。 Stripe は入力データと書類審査を組み合わせて各人の本人確認を行います。また、ブラジルの規制により、本人確認書類を提出する人物が実際に本人であることを確認するための生存確認 (`proof_of_liveness`) が必要です。Stripe ホスト型および組み込み型のアカウント登録フローでは、このステップが自動的に処理されます。プラットフォームが API ベースのアカウント登録を使用している場合、Stripe ホスト型の確認ステップにユーザーをリダイレクトするか、`` 組み込みコンポーネントを実装して生存確認の収集を完了する必要があります。詳細については[生存確認要件の処理](https://docs.stripe.com/connect/api-onboarding.md?accounts-namespace=v1&liveness=hosted#proof-of-liveness)を参照してください。 **年齢要件:** 担当者は 18 歳以上でなければなりません。所有者、取締役、役員は 16 歳以上である必要があります。これらの要件を満たさない新規ユーザーは機能が有効になりません。担当者が 16 歳未満の既存アカウントは、プラットフォームの移行時に直ちにオフボーディングされます。 ### 必須フィールド ブラジルの個人アカウントには、以下のフィールドが新たに必要となります。 | フィールド | 説明 | | ----------------------------------------------------------- | -------------------------------------------------- | | `person.first_name`, `person.last_name` | 正式氏名 | | `person.id_number` | CPF (ブラジルの個人納税者番号) | | `person.address.line1`, `.city`, `.postal_code`, `.country` | ブラジルの居住地住所。すべての担当者はブラジル居住者であり、ブラジルの住所を提供する必要があります。 | | `person.dob.day`, `.month`, `.year` | 生年月日 | | `person.verification.proof_of_liveness` | 生存確認の顔写真—Stripe ホスト型または組み込み型フローのみ対応 | | `person.verification.additional_document` | 入力による住所確認が失敗した場合の任意の書類要件。 | プラットフォームがすでに `person.id_number` を収集している場合、フィールド名は不要です。UI で CPF を具体的に収集していることを確認してください。ブラジルのアカウントでは他の ID タイプ (パスポート番号、海外の納税者番号) は受け付けていません。 ### 初期要件のレスポンス 新しい個人アカウントが作成されると、`requirements` ハッシュには以下が含まれます。 ```json { "currently_due": [ "person.first_name", "person.last_name", "person.id_number", "person.dob.day", "person.dob.month", "person.dob.year", "person.address.line1", "person.address.city", "person.address.state", "person.address.country", "person.verification.proof_of_liveness" ], "pending_verification": [], "alternatives": [ { "original_fields_due": ["person.address.line1", "person.address.city", "person.address.state", "person.address.country"], "alternative_fields_due": ["person.verification.additional_document"] } ], "errors": [] } ``` ### 個人データの収集 Persons API を使用して個人フィールドを送信します。 ```shell curl https://api.stripe.com/v1/accounts/{{CONNECTED_ACCOUNT_ID}}/persons/{{PERSON_ID}} \ -u "{{PLATFORM_SECRET_KEY}}:" \ -d "first_name=Maria" \ -d "last_name=Silva" \ -d "id_number=123.456.789-09" \ -d "dob[day]=15" \ -d "dob[month]=6" \ -d "dob[year]=1985" \ -d "address[line1]=Rua das Flores, 123" \ -d "address[city]=São Paulo" \ -d "address[state]=SP" \ -d "address[postal_code]=01310-100" \ -d "address[country]=BR" ``` ### エラー処理 | エラーコード | トリガー | 改善策 | | ------------------------------------------ | ------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- | | `verification_failed_id_number_inactive` | CPF は見つかりましたが、ステータスが非アクティブ (例: 停止中、取り消し済み、死亡) です。 | ユーザーはブラジル連邦税務局 (Receita Federal) で CPF ステータスを解決する必要があります。取り消し済み、無効、または死亡の CPF ステータスのアカウントはオフボーディングされます。書類のアップロードでは解決できません。 | | `verification_failed_keyed_match` | プログラムによる照会と手動レビューの両方で CPF の確認に失敗しました。 | ユーザーが CPF と本人確認書類を再提出し、アカウントが MVR キューに入ります。 | | `verification_document_type_not_supported` | アップロードされた書類の種類が誤っている、対象国が異なる、または読み取り不可能です。 | ユーザーが許容されるブラジルの公的な本人確認書類を再アップロードします。 | ## KYB における法人の本人確認 Stripe は、ブラジル中央銀行 (BCB) のマネーロンダリング防止規制に準拠するため、ブラジルの法人に対するビジネス確認要件を更新しています。この種の確認は、KYB (ビジネス確認) 要件の広範なカテゴリに該当します。連結アカウントにブラジルで設立された企業が含まれる場合、アカウント登録時に追加情報の提供が必要になる場合があります。 Stripe は、CNPJ (Cadastro Nacional da Pessoa Jurídica)—ブラジルの国家企業登録番号—と法人名および登録住所を使用して法人を確認します。Stripe はまず、ブラジル政府の CNPJ レジストリに対してプログラムによる確認を試みます。入力された情報が一致しない場合、アカウントは会社確認書類 (Receita Federal の CNPJ 証明書など) をアップロードすることで要件を解決できます。 本人確認に加え、ブラジルのマネーロンダリング防止規制では、チャージと入金を有効化する前に、連結アカウントの財務能力を評価することが Stripe に義務付けられています。ブラジルのすべてのアカウントは、機能が有効化される前に推定月間収益または所得を提供する必要があります。この情報は規制上のモニタリング目的のみに使用され、アカウント登録時に独自に確認されることはありません。 ### 必須フィールド ブラジルの法人アカウントには、以下のフィールドが必要です。 | フィールド | 説明 | | ----------------------------------------------------- | -------------------------------- | | `company.tax_id` | CNPJ (14 桁のブラジル企業登録番号)。 | | `company.name` | 法人名 — CNPJ レジストリと一致する必要があります。 | | `company.address.line1`, `.city`, `.postal_code` | 登録されたブラジルの事業所住所。 | | `company.verification.document` | 最初は任意ですが、プログラムによる確認が失敗した場合は必須です。 | | `business_profile.monthly_estimated_revenue.amount` | BRL の月間総収益。 | | `business_profile.monthly_estimated_revenue.currency` | `brl` である必要があります。 | ### 初期要件のレスポンス ```json { "currently_due": [ "company.tax_id", "company.name", "company.address.line1", "company.address.city", "company.address.postal_code", "business_profile.monthly_estimated_revenue.amount", "business_profile.monthly_estimated_revenue.currency" ], "pending_verification": [], "alternatives": [ { "original_fields_due": [ "company.tax_id", "company.name", "company.address.line1", "company.address.city", "company.address.postal_code" ], "alternative_fields_due": [ "company.tax_id", "company.name", "company.address.line1", "company.address.city", "company.address.postal_code", "company.verification.document" ] } ], "errors": [] } ``` `alternatives` 配列は、プログラムによる CNPJ 確認が失敗した場合、`company.verification.document` も提供することでプラットフォームが解決できることを示しています。 ### 会社データの収集 ```shell curl https://api.stripe.com/v1/accounts/{{CONNECTED_ACCOUNT_ID}} \ -u "{{PLATFORM_SECRET_KEY}}:" \ -d "company[tax_id]=12.345.678/0001-99" \ -d "company[name]=Empresa Exemplo Ltda" \ -d "company[address][line1]=Avenida Paulista, 1000" \ -d "company[address][city]=São Paulo" \ -d "company[address][postal_code]=01310-100" \ -d "company[address][country]=BR" \ -d "business_profile[monthly_estimated_revenue][amount]=5000000" \ -d "business_profile[monthly_estimated_revenue][currency]=brl" ``` 会社の納税者番号、法人名、住所を送信すると、Stripe が CNPJ レジストリに対して確認を行う間、要件は `pending_verification` に移行します。 ```json { "currently_due": [], "pending_verification": [ "company.tax_id", "company.name", "company.address.line1", "company.address.city", "company.address.postal_code" ], "alternatives": [], "errors": [] } ``` 処理を進める前に `account.updated` Webhook を待ちます。確認が成功した場合、すべてのフィールドが要件からクリアされます。確認が失敗した場合は、以下のエラー処理セクションを参照してください。 ### 納税者番号の登録ステータス CNPJ と企業情報との照合に加え、Stripe はブラジル政府の記録に対して CNPJ (および担当者の CPF) の登録ステータスを確認します。設定後、納税者番号は変更できません。 | 法人タイプ | 合格 | 不合格 | 即時オフボーディングが必要 | | --------- | ------------------------------------- | -------------- | --------------------------------------------------------- | | 個人 (CPF) | 正常 | 停止中、正規化保留中 | 取り消し済み、無効、死亡 | | 法人 (CNPJ) | 有効 (Ativa)、正規化保留中 (Ativa não regular) | 停止中 (Suspensa) | 解散 (Baixada)、取り消し済み (Baixada)、不適格 (Inapta)、無効 (Nula)、外国法人 | CPF または CNPJ が停止中のアカウントはアカウント登録時に有効として扱われますが、約 30 日以内にステータスを解決することが求められます。未解決の場合、決済機能が制限されます。オフボーディングが必要なステータス (取り消し済み、無効、死亡、解散、不適格) のアカウントは、すべての機能が直ちに無効化され、書類のアップロードによる改善はできません。 ### 財務能力 ブラジルのマネーロンダリング防止規制では、チャージと入金を有効化する前に、連結アカウントの推定財務能力を収集することが Stripe に義務付けられています。これはブラジルのすべてのアカウント (個人および法人の両方) に適用されます。 `monthly_estimated_revenue.amount` は最小通貨単位 (センタボ) で表されます。例: 50,000 BRL = `5000000`。これらの値は規制上のモニタリング目的のみに収集され、アカウント登録時に独自に確認されることはありません。 ### URL と商品説明 ブラジルの規制により、Stripe はすべてのビジネスの活動を把握することが求められます。要件はアカウントの種類によって異なります。 | アカウントの種類 | 要件 | | ----------------- | ---------------------------------------------------------------------- | | Direct と Standard | `business_profile.url` と `business_profile.product_description` の両方が必要 | | Custom と Express | `business_profile.url` または `business_profile.product_description` が必要 | ### エラー処理 | エラーコード | トリガー | 改善策 | | ------------------------------------------------ | -------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- | | `verification_failed_keyed_match` | CNPJ が見つからないか、法人名または住所が CNPJ レジストリと一致しませんでした。 | 正しい法人名と登録住所を再入力するか、`company.verification.document` をアップロードしてください。 | | `verification_failed_id_number_status_not_found` | CNPJ は見つかりましたが、税務ステータスを取得できませんでした。 | 再提出するか、会社の確認書類をアップロードします。 | | `verification_failed_id_number_inactive` | CNPJ は見つかりましたが、ステータスが非アクティブです (例: 停止中、解散)。 | 停止中のステータスの場合、アカウントには Receita Federal でステータスを解決するための猶予期間があります。解散、取り消し済み、不適格、または無効のステータスの場合、アカウントはオフボーディングされます。書類のアップロードによる解決はできません。 | | `verification_document_type_not_supported` | アップロードされた会社書類が判読不能か、種類が誤っています。 | 有効な会社確認書類を再アップロードします。 | | `verification_document_name_mismatch` | 書類に記載されている法人名が入力した名前と一致しません。 | CNPJ 証明書に記載されているとおりに正確に法人名 (商号) を再入力します。 | | `verification_document_id_number_mismatch` | 書類に記載されている納税者番号が入力した CNPJ と一致しないか、納税者番号のステータスが見つからないか非アクティブです。 | Receita Federal の最新の CNPJ 証明書を再アップロードします。 | | `verification_document_address_mismatch` | 書類に記載されている住所が入力した住所と一致しません。 | CNPJ 証明書の登録住所と一致するように住所を再入力します。 | ## UBO と関係性の確認 ブラジルのマネーロンダリング防止規制 (Circular BCB 3978/20) では、すべての担当者について、法人の法的代表者として身元の特定と確認が行われる必要があります。Stripe は以下の 2 つのステップでこれを確認します: 1. **プログラムによる氏名照合**: 担当者のフルネームが CNPJ レジストリのレスポンスと照合されます。 1. **フォールバック—書類審査**: プログラムによる確認が失敗した場合、担当者は有効な関係性書類 (単純な所有構造の場合) または証明書 (複雑な所有構造の場合) をアップロードする必要があります。 > シンプルな所有構造とは、事業が 1 名以上の個人によって直接所有されている場合を指します。一方、複雑な所有構造とは、持株会社、信託、子会社などの中間層が存在し、会社代表者と事業主体が分離されている場合を指します。 ### 有効な関係性書類 (単純な所有構造の場合) ブラジル向けの許容される書類は[許容される確認書類](https://docs.stripe.com/acceptable-verification-documents.md?country=BR&document-type=entity#select-a-country-to-view-its-requirements)でご確認いただけます。 書類には次の内容が必要です: (a) 法人名と CNPJ、(b) オーナーまたは取締役としての明示的な任命（本人のフルネームと CPF を含む）および有効な任期、© 担当者の署名。 プラットフォームが連結アカウントに代わって確認書類をアップロードできるのは、連結アカウントから書面による同意を取得しており、かつその同意書が代理権を明示した法定代理人によって署名されている場合に限られます。また、プラットフォームはその権限を証明する委任状または設立書類も提出する必要があります。 ### 証明書 (複雑な所有構造の場合) 複雑な所有構造を持つ企業は、証明書の PDF 書類をダウンロードして記入し、Stripe にアップロードする必要があります。 ## テスト [テスト環境](https://docs.stripe.com/connect/testing.md)を使用して、実装がすべての KYC/KYB の状態を適切に処理できるか確認してください。 ### テスト: KYC 成功 (個人) ```shell # Create test account curl https://api.stripe.com/v1/accounts \ -u "{{TEST_SECRET_KEY}}:" \ -H "Stripe-Version: 2026-03-25.dahlia;experimental_onboarding_preview=v2" \ -d "type=custom" \ -d "country=BR" \ -d "capabilities[transfers][requested]=true" # Submit person data (use test CPF: 000.000.001-91 for success) curl https://api.stripe.com/v1/accounts/{{ACCT_ID}}/persons/{{PERSON_ID}} \ -u "{{TEST_SECRET_KEY}}:" \ -d "first_name=Maria" \ -d "last_name=Silva" \ -d "id_number=000.000.001-91" \ -d "dob[day]=15" \ -d "dob[month]=6" \ -d "dob[year]=1985" \ -d "address[line1]=Rua das Flores, 123" \ -d "address[city]=São Paulo" \ -d "address[state]=SP" \ -d "address[postal_code]=01310-100" \ -d "address[country]=BR" ``` KYC の成功テストを完了するには、`proof_of_liveness` が引き続き必要です。詳細は[生存確認要件の処理](https://docs.stripe.com/connect/api-onboarding.md?accounts-namespace=v1&liveness=hosted#proof-of-liveness)をご参照ください。 ### テスト: CPF 非アクティブ (`verification_document_id_number_mismatch`) ```shell curl https://api.stripe.com/v1/accounts/{{ACCT_ID}}/persons/{{PERSON_ID}} \ -u "{{TEST_SECRET_KEY}}:" \ -d "id_number=000.000.002-00" ``` 要件に含まれる想定エラー: ```json { "code": "verification_document_id_number_mismatch", "reason": "", "requirement": "person.id_number" } ``` ### テスト: KYB 成功 (法人) ```shell # Create test company account curl https://api.stripe.com/v1/accounts \ -u "{{TEST_SECRET_KEY}}:" \ -H "Stripe-Version: 2026-03-25.dahlia;experimental_onboarding_preview=v2" \ -d "type=custom" \ -d "country=BR" \ -d "business_type=company" \ -d "capabilities[transfers][requested]=true" # Submit company data (use test CNPJ: 00.000.000/0001-91 for success) curl https://api.stripe.com/v1/accounts/{{ACCT_ID}} \ -u "{{TEST_SECRET_KEY}}:" \ -d "company[tax_id]=00.000.000/0001-91" \ -d "company[name]=Empresa Teste Ltda" \ -d "company[address][line1]=Avenida Paulista, 1000" \ -d "company[address][city]=São Paulo" \ -d "company[address][postal_code]=01310-100" \ -d "company[address][country]=BR" \ -d "business_profile[monthly_estimated_revenue][amount]=5000000" \ -d "business_profile[monthly_estimated_revenue][currency]=brl" ``` ### テスト: CNPJ キー入力照合の失敗 (`verification_failed_keyed_match`) ```shell curl https://api.stripe.com/v1/accounts/{{ACCT_ID}} \ -u "{{TEST_SECRET_KEY}}:" \ -d "company[tax_id]=00.000.000/0002-00" \ -d "company[name]=Wrong Name Ltda" ``` 要件に含まれる想定エラー: ```json [ { "code": "verification_failed_keyed_match", "requirement": "company.tax_id" }, { "code": "verification_failed_keyed_match", "requirement": "company.name" }, { "code": "verification_failed_keyed_match", "requirement": "company.address.line1" } ] ``` 会社確認書類をアップロードして解決: ```shell # 1. Upload CNPJ certificate PDF curl https://files.stripe.com/v1/files \ -u "{{TEST_SECRET_KEY}}:" \ -F "file=@/path/to/cnpj_certificate.pdf" \ -F "purpose=account_requirement" # 2. Attach to account curl https://api.stripe.com/v1/accounts/{{ACCT_ID}} \ -u "{{TEST_SECRET_KEY}}:" \ -d "company[verification][document][front]={{FILE_ID}}" ``` #### プログラム - US *最終更新日: 2025 年 9 月 23 日* ## 変更点 - **連結アカウントから収集される必須情報:** 個人事業主、非営利団体、一人会社である LLC から収集する必要がある情報を更新し、未成年者が開設したアカウントについて法定後見人の同意を取得する方法を簡素化します。さらに、すべての法人タイプでアカウント担当者の電子メールが必須になり、政府機関と公開企業については変更されました。 - **事業情報を検証し、詳細な検証レスポンスを新たに提供する方法:** 有効な事業情報の基準を更新し、提供された情報を承認または検証できない場合の新しい検証エラーコードを導入します。 - **納税者番号 (TIN) を検証するしきい値:** Custom アカウントと Express アカウントの場合、現在の連邦税報告基準に合わせて、TIN を検証する決済額のしきい値を引き下げます。 - **明細書表記と明細書表記のプレフィックスを事前入力する方法:** 明細書表記が提供されない場合、連結アカウントのビジネスプロフィール名、ビジネス URL、または法人名のいずれかを使用するように事前入力ロジックが変更されました。 これらの変更は、アメリカでリクエストされた [card_payments](https://docs.stripe.com/api/accounts/object.md#account_object-capabilities-card_payments) ケイパビリティを持つすべてのユーザ―に影響します。 ## 連結アカウントから収集される必須情報 収集される新しい情報と API に追加された新フィールド: - [company.structure](https://docs.stripe.com/api/accounts/create.md#create_account-company-structure) が `sole_proprietorship` および `single_member_llc` である企業は、ビジネスの住所 (「会社の住所」) を提供する必要があります。ビジネスの住所が代表者の個人の住所と同じ場合、連結アカウントは両方に同じ値を提供できます。 - [company.structure](https://docs.stripe.com/api/accounts/create.md#create_account-company-structure) が `government_instrumentality`、`tax_exempt_government_instrumentality`、`governmental_unit`、`public_company`、`public_corporation`、`public_partnership` である法人は、アカウント代表者のメールアドレスの提出が必須となります。この要件は現在、すべての法人タイプに適用されます。 - 未成年者が開設したアカウントについて法的後見人の同意を取得する方法を簡素化するために、[Persons API](https://docs.stripe.com/api/persons.md) が更新され、法定後見人による Stripe 利用規約への同意を記録するために `legal_guardian` と `additional_tos_acceptances` フィールドが追加されました。アカウント代表者の生年月日により、その個人が未成年であることが示されている場合、本番環境利用の申請前に、`legal_guardian` を追加するための要件がトリガーされます。 ## ビジネス情報を確認し、詳細な検証レスポンスを新たに提供する方法 ### すでに収集している情報の更新 連結アカウントに次の情報をリクエストします。 | フィールド | 更新された要件 | その他の考慮事項 | | ------------------------------------ | -------------------------------------------------------------------------------------- | ----------------------------------- | | アメリカに居住する代表者から収集される SSN または ITIN | すべての種類のアカウント (Custom 連結アカウント、Express 連結アカウントを含む) について、ユーザー登録時に末尾 4 桁の入力が必要になります | これは Standard 連結アカウントの現行の動作です。 | | アメリカ在住のオーナーから収集された SSN または ITIN | アカウントタイプに限らず (Custom および Express の連結アカウントを含む) 決済額が 50 万 USD を超えると、下 4 桁が必要になります | 以下の_SSN Full 9 Digit Note_を確認してください | | アメリカ居住者以外の代表者から収集された国民 ID または確認書類 | すべてのアカウントタイプ (Custom および Express 連結アカウントを含む) のユーザー登録時の国民 ID または確認書類 | アメリカに居住していない担当者のみに適用 | | アメリカに居住していないオーナーから収集された国民 ID または確認書類 | アカウントタイプに限らず (Custom および Express の連結アカウントを含む) 決済額が 50 万 USD を超えると、身分証明書または確認書類が必要になります | アメリカ居住者以外のオーナーにのみ適用 | > 提供済みの情報を使用して、アカウントに関連付けられた個人の 9 桁の SSN 全体をプログラムで取得できない場合は、9 桁の SSN 全体を提供する必要があります。 ### 新しい確認エラーコード 連結アカウントが提供する情報を当社で確認できない場合、検証レスポンスの詳細を [requirements.errors](https://docs.stripe.com/api/accounts/object.md#account_object-requirements-errors) 配列に新しいエラーコードとして表示します。[こちらのドキュメントをご覧ください](https://docs.stripe.com/connect/handling-api-verification.md#validation-and-verification-errors)。 #### 同期エラー | フィールド | 新しいエラーコード | エラーメッセージ | | ------------------- | ------------------------------------------------ | ----------------------------------------------------------- | | 商品の詳細 | `invalid_product_description_length` | 商品の説明は 10 文字以上にしてください。 | | 商品の詳細 | `invalid_product_description_url_match` | 商品の説明は URL と異なるものにする必要があります。 | | (完全) 明細書表記 | `invalid_statement_descriptor_length` | 明細書表記は 5 ～ 22 文字にしてください。 | | (完全) 明細書表記 | `invalid_statement_descriptor_business_mismatch` | 明細書表記はビジネス名、法人名、または URL に類似している必要があります。 | | (完全) 明細書表記 | `invalid_statement_descriptor_denylisted` | 明細書表記に総称的な表記や既知の表記を使用することはできません。 | | (短縮) 明細書表記 | `invalid_statement_descriptor_prefix_mismatch` | 明細書表記のプレフィックスは、明細書表記、ビジネス名、法人名、または URL と共通点があるものにする必要があります。 | | (短縮) 明細書表記 | `invalid_statement_descriptor_prefix_denylisted` | 明細書表記のプレフィックスとして、総称的なものや既知のものを使用することはできません。 | | LE ビジネス名 | `invalid_company_name_denylisted` | 総称的なビジネス名やよく知られているビジネス名は使用できません。 | | ビジネスプロフィールの名前 (DBA) | `invalid_business_profile_name_denylisted` | 総称的なビジネス名やよく知られているビジネス名は使用できません。 | | ビジネスプロフィールの名前 (DBA) | `invalid_business_profile_name` | ビジネスプロフィールの名前は、認識できる単語で構成する必要があります。 | | 個人の生年月日 | `invalid_dob_age_under_minimum` | 年齢は 13 歳以上である必要があります。 | | 個人の生年月日 | `invalid_dob_age_over_maximum` | 生年月日は過去 120 年以内である必要があります。 | | 個人の電話番号 | `invalid_phone_number` | 電話番号が有効ではないようです。入力形式が正しいことを確認してください。 | | LE ビジネスの電話番号 | `invalid_phone_number` | 電話番号が有効ではないようです。入力形式が正しいことを確認してください。 | | 会社の納税番号 | `invalid_tax_id_format` | 納税者番号は、ダッシュなどの特殊文字を含まない 9 桁の固有の数字である必要があります。 | | URL | `invalid_url_format` | https://example.com ような形式で指定してください | | URL | `invalid_url_denylisted` | 汎用的なビジネス URL は使用できません。 | #### 非同期のエラー | フィールド | 新しいエラーコード | エラーメッセージ | | ----- | --------------------------------------------------- | -------------------------------------------------------------------------------------- | | URL | `invalid_url_website_inaccessible` | この URL に接続できませんでした。URL が利用可能であり、正しく入力されていることを確認するか、別の URL を指定してください。 | | URL | `invalid_url_website_business_information_mismatch` | ウェブサイトのビジネス情報は、Stripe に提出した詳細と一致している必要があります。 | | URL | `invalid_url_website_incomplete` | お客様のウェブサイトには、必須情報の一部が不足しているようです。必須情報の詳細をご確認ください。 | | URL | `invalid_url_website_other` | 指定された URL ではお客様のビジネスを確認できませんでした。URL が正しく入力されていることを確認するか、別の URL を指定してください。 | | URL | `invalid_url_web_presence_detected` | ウェブサイト、アプリ、ソーシャルメディアページ、オンラインプロフィールを使用して商品やサービスの販売を行っているため、ビジネスの URL をお知らせいただく必要があります。 | ### 納税者番号 (TIN) を確認するしきい値を更新しました 1099-K、1099-NEC、および 1099-MISC の各申告書の IRS 申告基準に合わせて、Stripe が TIN を確認する基準値を更新します。今後は、決済金額が 600 USD に達した時点または初回請求から 30 日以内のいずれか早いほうのタイミングで確認が行われます。 ### Stripe が明細書表記と明細書のプレフィックスを事前入力する方法 指定しない場合、明細書表記は提供された次のフィールドを使用して事前に入力されます。フィールドは以下の順に使用されます: [business_profile.name](https://docs.stripe.com/api/accounts/object.md#account_object-business_profile-name) (「商号」)、 [business_profile.url](https://docs.stripe.com/api/accounts/object.md#account_object-business_profile-url)、法人名 ( [individual.first_name](https://docs.stripe.com/api/accounts/object.md#account_object-individual-first_name) + [individual.last_name](https://docs.stripe.com/api/accounts/object.md#account_object-individual-last_name) または [company.name](https://docs.stripe.com/api/accounts/object.md#account_object-company-name))`。さらに、明細書表記のプレフィックスが提供されない場合、明細書表記の最初の 10 文字から事前入力されます。 #### プログラム - Singapore *最終更新日:2025 年 5 月 21 日* ## システムに関する推奨事項 システムへの必要な変更は、連結アカウントからどのようにアカウント登録情報を収集するかによって異なります。また、確認要件に関する社内および社外向けのドキュメントを更新するための準備をし、ユーザーからの質問に対応できるようにサポートチームをトレーニングする必要があります。 > ビジネスと本人確認情報の収集には、[Stripe ホスト型](https://docs.stripe.com/connect/hosted-onboarding.md)アカウント登録または[組み込みアカウント登録](https://docs.stripe.com/connect/embedded-onboarding.md)の使用を強くお勧めします。Stripe ホスト型アカウント登録と組み込みアカウント登録では、現在 API では利用できない、会社代表者と取締役に関する追加情報がガイド付きで提供されます。この情報は政府のデータベースから取得され、連結アカウントから収集される確認情報が削減されます。 ### システムの概要 3 月中旬以降、[future_requirements](https://docs.stripe.com/api/accounts/object.md#account_object-future_requirements) ハッシュを使用して、連結アカウントの今後の新しい要件とその期限をプレビューできます。`current_deadline` 前に最新情報の収集に関する対策を講じることで、連結アカウントのケイパビリティへの影響を回避できます。2025 年 4 月以降に作成される新しい Custom 連結アカウントも、新しい確認要件を満たす必要があります。account.updated イベントをリッスンして、アカウントのステータスの変化を検出します。タイムラインの詳細については、[よくあるご質問のページ](https://support.stripe.com/questions/singapore-verification-requirements-for-custom-connected-accounts-faq)を参照してください。 新しいアカウントを登録したり、既存アカウントから更新された情報を収集したりする際に、システムが[最新の確認要件に対応](https://docs.stripe.com/connect/handle-verification-updates.md)できるよう設定されていることを確認してください。 特に、埋め込みアカウント登録または Stripe ホスティング登録フローの場合、動作をカスタマイズして、必要に応じて事前に [future_requirements](https://docs.stripe.com/api/accounts/object.md#account_object-future_requirements) を収集できます。Stripe ホスティング登録の場合は、[アカウントリンクの作成](https://docs.stripe.com/api/account_links/create.md#create_account_link-collection_options)時に `collection_options.future_requirements` パラメーターを `include` に設定します。埋め込みアカウント登録の場合は、[`collectionOptions`](https://docs.stripe.com/connect/supported-embedded-components/account-onboarding.md#requirements-collection-options) 属性の futureRequirements フィールドを `include` に設定します。 ### 要件の概要 | 法人タイプ | 実質的支配者 (UBO) の確認 | 取締役情報の収集 | 権限証明 (PoA) | 授権書 | | -------- | ------------------------------------------------ | -------- | ---------- | -------------- | | 個人 | 不要 | 不要 | 不要 | 不要 | | 個人事業主 | 不要 | 不要 | 必ず必要 | 不要 | | 民間企業 | 所有権が 25% 以上の所有者に必須* 免除が可能 | 必ず必要 | 必ず必要 | PoA が失敗した場合の代替 | | パートナーシップ | すべてのパートナー、経営者および 25% 以上の所有権を持つその他の個人に必須 免除が可能 | 不要 | 必ず必要 | PoA が失敗した場合の代替 | | 政府機関** | 不要 | 不要 | 必ず必要 | 必ず必要 | | 公開企業** | 免除 | 必ず必要 | 必ず必要 | PoA が失敗した場合の代替 | | 非営利団体 | すべての取締役および主要幹部 免除が可能 | 不要 | 必ず必要*** | PoA が失敗した場合の代替 | > 25% 以上の所有権を有する所有者がいない場合は、すべての取締役が UBO として扱われます。 > > \** 政府機関と公開企業は、シンガポールでは新しい事業体タイプです。アクセスを希望する場合は、[Stripe サポート](https://support.stripe.com/)に連絡してください。 > > \*** charities.gov.sg に記載されていない非営利団体は、すべての取締役と主要な役員を示す [proof_of_ultimate_beneficial_ownership](https://docs.stripe.com/api/accounts/update.md#update_account-documents-proof_of_ultimate_beneficial_ownership) 書類をアップロードする必要があります。 ## サポートされるビジネスのタイプと構造 ビジネスのタイプによって確認要件が異なります。ビジネスのタイプが `company` である場合、法的 (ビジネス) 構造を特定することで、ユーザーのビジネスをさらに分類できます。ビジネス構造は、日々の業務、税負担、責任、組織的構造など、法人の詳細を説明するものです。 Account オブジェクトの [company.structure](https://docs.stripe.com/api/accounts/create.md#create_account-company-structure) フィールドを使用してビジネスを分類できます。[company.structure](https://docs.stripe.com/api/accounts/create.md#create_account-company-structure) に関する情報が指定されていない場合、会社はデフォルトで非公開と見なされます。シンガポールのガイドラインに沿って、すべての会社タイプが [ACRA](https://www.acra.gov.sg/) に登録されている必要があります。 `business_type` のみの分類から [business_type](https://docs.stripe.com/api/accounts/object.md#account_object-business_type) および [company.structure](https://docs.stripe.com/api/accounts/create.md#create_account-company-structure) の併用による分類へ移行するための推奨マッピングは以下のとおりです。 | 既存のビジネスタイプ | 新しいビジネスタイプと会社組織の組み合わせ | 説明 | | ------------------------- | ---------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `individual` | タイプ: `individual`、構造: `nil` | 企業構造の下で運営されていない事業活動に従事する個人。 | | `sole_prop` | タイプ: `company`、構造: `sole_proprietorship` | 1 人の個人が所有する法人格のないビジネス。このビジネスは [ACRA](https://www.acra.gov.sg/how-to-guides/before-you-start/choosing-a-business-structure) に個人事業主として登録されています。 | | `company` / `corporation` | タイプ: `company`、構造: `private_company` | 取引または事業の遂行を目的とした、複数の個人、企業、信託、またはパートナーシップ間の提携または関係。このビジネスは、保証有限責任会社を含め、[ACRA](https://www.acra.gov.sg/how-to-guides/before-you-start/choosing-a-business-structure) に会社として登録されています。 | | `partnership` | タイプ: `company`、構造: `private_partnership` | 取引または事業の遂行を目的とした、複数の個人、企業、信託、またはパートナーシップ間の提携または関係。このビジネスは、[ACRA](https://www.acra.gov.sg/how-to-guides/before-you-start/choosing-a-business-structure) にパートナーシップとして登録されています。 | | `public_company` | タイプ: `company`、構造: `public_company` | 一般公開で証券を販売する会社。このビジネス構造は制限されているため、利用方法については [Stripe サポート](https://support.stripe.com/)にお問い合わせください。このビジネスは会社として [ACRA](https://www.acra.gov.sg/how-to-guides/before-you-start/choosing-a-business-structure) に登録されています。 | | `non_profit` | タイプ: `non_profit`、構造: `nil` | 多くの場合、社会的、教育的、慈善的、またはその他のコミュニティの目標を推進することを目的として、利益を生み出す以外の目的で運営されている組織。 | > ビジネスが ACRA に登録されている非営利団体の場合は、ACRA に登録されているビジネスのタイプの要件が適用されます。 ## 担当者の確認 ### 本人確認の強化 シンガポールでは、一般的なデジタル ID プロバイダーである [Singpass MyInfo](https://www.singpass.gov.sg/main/individuals/) を使用して、あらゆるビジネスタイプの代表者の本人確認を強化する必要があります。ユーザーが MyInfo にアクセスできない場合は、[Stripe Identity](https://docs.stripe.com/identity.md) を使用して生体認証を行う必要があります。 SingPass MyInfo または Stripe Identity を使用した高度な本人確認を完了するには、[Connect Onboarding または Embedded Onboarding](https://docs.stripe.com/connect/custom/onboarding.md) の導入が必要です。Stripe API を使用して連結アカウントを登録する場合は、フォームを更新してください。これにより、新たに要求される検証情報をユーザーから収集して、最終段階で Connect アカウント登録にリダイレクトし、高度な本人確認を完了させることができます。 ### 住所確認 すべてのビジネスで、ビジネス代表者の住所の確認が必要です。住所を確認できない場合、Stripe は[住所証明書](https://docs.stripe.com/acceptable-verification-documents.md?country=SG&document-type=address)を収集する必要があります。 ## 権限証明の確認 Stripe は、[アカウントの代理人に十分な権限があり](https://support.stripe.com/questions/representative-authority-verification)、法人の代理でアカウントの開設が可能であることを確認する必要があります。プログラムによる確認が不可能な場合は、十分な権限を持つ人物に代表者を変更する必要があります。 十分な権限を持つ人物をビジネスの代表者に指定できない場合は、その人物を[承認者](https://docs.stripe.com/api/persons/update.md#update_person-relationship-authorizer)として追加できます。その後、ビジネスは[承認者](https://b.stripecdn.com/content/Letter_of_authorization_for_Stripe_Singapore.pdf)が署名した[委任状](https://docs.stripe.com/api/persons/update.md#update_person-relationship-authorizer)を提出し、ビジネスの代表者にアカウントの管理を許可する必要があります。委任状は代理人の [company_authorization](https://docs.stripe.com/api/persons/update.md#update_person-documents-company_authorization) として提出します。承認者の[名](https://docs.stripe.com/api/persons/object.md#person_object-first_name)と[姓](https://docs.stripe.com/api/persons/object.md#person_object-last_name)を、[身分証明書](https://docs.stripe.com/api/persons/update.md#update_person-verification-document)のコピーとともにアカウントに追加する必要があります。 > Stripe では現在、指定された[委任状](https://b.stripecdn.com/content/Letter_of_authorization_for_Stripe_Singapore.pdf)のテンプレートのみを受け付けています。 ``` { "id": ""{{CONNECTED_ACCOUNT_ID}}"", "future_requirements": { "past_due": [ "authorizer.first_name", "authorizer.last_name", "authorizer.id_document", "{{REPRESENTATIVE_ID}}.documents.company_authorization.files" ], "alternatives": [ { "original_fields_due": [ "authorizer.first_name", "authorizer.last_name", "authorizer.id_document", "{{REPRESENTATIVE_ID}}.documents.company_authorization.files" ], "alternative_fields_due": [ "{{REPRESENTATIVE_ID}}.first_name", "{{REPRESENTATIVE_ID}}.last_name", "{{REPRESENTATIVE_ID}}.id_number" ] } ], "errors": [ { "code": "verification_failed_representative_authority", "requirement": "authorizer.first_name", "reason": "..." }, { "code": "verification_failed_representative_authority", "requirement": "authorizer.last_name", "reason": "..." }, ... ], ... }, ... } ``` さらに、委任状の要件により、`verification_document_name_mismatch` や `verification_document_type_not_supported` などの書類関連のエラーが発生する可能性があります。[書類確認エラー](https://docs.stripe.com/connect/handling-api-verification.md#handle-document-verification-problems)と[新しい確認エラーコード](https://docs.stripe.com/connect/upcoming-requirements-updates.md#new-verification-error-codes)に必ず対応できるようにしてください。 ## 法人確認 ビジネス名、UEN、法人タイプの確認はすべてのビジネスに対して義務付けられています。Stripe が会社の存在を確認できない場合は、会社の書類を収集していただく必要があります。 また、Stripe は、ビジネスのタイプとビジネスの構造が地方自治体の記録と一致していることも確認する必要があります。[business type](https://docs.stripe.com/api/accounts/object.md#account_object-business_type) または [business structure](https://docs.stripe.com/api/accounts/object.md#account_object-company-structure) が一致しない場合、`verification_legal_entity_structure_mismatch` エラーが発生し、ビジネスのタイプまたはビジネスの構造を更新するか、法人であることを証明するために会社の書類が必要になります。 ``` { "id": ""{{CONNECTED_ACCOUNT_ID}}"", "future_requirements": { "past_due": [ "company.verification.document" ], "errors": [ { "code": "verification_legal_entity_structure_mismatch", "requirement": "company.verification.document", "reason": "Business type or structure seems to be incorrect. Provide the correct business type and structure for this account." }, ... ], ... }, ... } ``` ## 実質的支配者の確認 ### 法人タイプに基づく所有者の判定 #### 民間企業 Stripe は、25% 以上の所有権を持つ個人を最終受益者 (UBO) と定義し、その人物の確認を試みます。[Stripe ホスティング](https://docs.stripe.com/connect/hosted-onboarding.md)または[埋め込みアカウント登録](https://docs.stripe.com/connect/embedded-onboarding.md)を使用して、ユーザーが所有者をプレビューして確認できるようにすることをおすすめします。または、API の[所有者](https://docs.stripe.com/api/persons/object.md) ポジションを使用して、すべての UBO を収集してアカウントに追加することもできます。 Stripe がこれらの個人を特定できない場合、会社は[実質的支配者の証明書](https://docs.stripe.com/acceptable-verification-documents.md?country=SG&document-type=relationship)を提出して、所有権構造を証明する必要があります。これには、連結アカウントの株式を 25% 以上所有する持株会社の所有権を証明する書類を含める必要があります。Stripe ホスティング登録または埋め込みアカウント登録では、これらのドキュメントを自動的に収集しますが、v1/accounts API を使用して収集して送信することもできます。実質的支配者の証明書に記載されているすべての UBO をアカウントに追加する必要があります。 > 連結アカウントは、ビジネスの書類 1 点と、所有率が高い持株会社の書類 1 点を個別に提出する代わりに、[実質的支配者の証明書](https://docs.stripe.com/acceptable-verification-documents.md?country=SG&document-type=relationship) 1 点を提出できます。 > > 会社に 25% 以上の所有権を保有する所有者がいない場合、政府の記録に記載されていて、(Stripe ホスティング登録または埋め込みアカウント登録で確認可能な) すべての取締役 が UBO と見なされ、アカウントに追加する必要があります。 #### パートナーシップ パートナーシップの場合は、ビジネスとすべてのパートナー、経営者および 25% 以上の所有権を持つその他の個人との関係を確認する必要があります。これらの人物は、API の[所有者](https://docs.stripe.com/api/persons/object.md#person_object-relationship-owner)としてアカウントに追加する必要があります。 #### 非営利団体 非営利団体の場合、すべての主要幹部と取締役が UBO と見なされます。以下の役職が含まれます。 - 社長 - 取締役 - CEO - 経理 - 幹事または総書記 - 議長 - 理事 - 新たに追加された役職 - アシスタント、代理、または副責任者の役職のいずれか。 Stripe は、シンガポールで登録されている慈善団体のすべての取締役および主要役員を特定しようとします。これらの情報は Stripe ホスティング登録または埋め込みアカウント登録でプレビューおよび確認することができます。他のすべての非営利団体は[実質的支配者の証明書](https://docs.stripe.com/acceptable-verification-documents.md?country=SG&document-type=relationship)を提出する必要があり、ここに記載されている個人は、API を使用して[取締役](https://docs.stripe.com/api/persons/object.md#person_object-relationship-director)としてアカウントに追加する必要があります。 ### システム情報 [法人を最終的に所有または管理するすべての自然人の名](https://docs.stripe.com/api/persons/object.md#person_object-first_name)、[姓](https://docs.stripe.com/api/persons/object.md#person_object-last_name)、[ID 番号](https://docs.stripe.com/api/persons/update.md#update_person-id_number)、および[別名](https://docs.stripe.com/api/persons/object.md#person_object-full_name_aliases)は、API の[所有者](https://docs.stripe.com/api/persons/object.md#person_object-relationship-owner)または[取締役](https://docs.stripe.com/api/persons/object.md#person_object-relationship-director)としてアカウントに追加する必要があります。UBO は、法人の種類に基づいて異なる方法で定義されます。非公開会社、非公開パートナーシップ、非営利組織の場合、会社代表者の確認が必要です。UBO を確認できない場合は、未確認の UBO の[身分証明書](https://docs.stripe.com/api/persons/update.md#update_person-verification-document)を収集する必要があります。 ``` { "id": ""{{CONNECTED_ACCOUNT_ID}}"", "future_requirements": { "past_due": [ "{{REPRESENTATIVE_ID}}.verification.document" ], "errors": [ { "code": "verification_failed_keyed_identity", "requirement": "{{REPRESENTATIVE_ID}}.verification.document", "reason": "..." }, ... ], ... }, ... } ``` アカウントに必要な所有者、取締役、または持株会社の書類が不足していると Stripe が判断した場合、`documents.proof_of_ultimate_beneficial_ownership.files` フィールドが [future_requirements](https://docs.stripe.com/api/accounts/object.md#account_object-future_requirements) で返されます。シンガポールで受理される書類の一覧は、[受付可能な確認書類](https://docs.stripe.com/acceptable-verification-documents.md?country=SG&document-type=relationship)でご確認いただけます。 Stripe ホスティング登録および埋め込みアカウント登録では、未入力の[所有者](https://docs.stripe.com/api/persons/object.md#person_object-relationship-owner)および[取締役](https://docs.stripe.com/api/persons/object.md#person_object-relationship-director)のリストが表示されます。これをクリックすると、ユーザーは情報をアカウントに追加できます。特定の個人を追加すると、所有構造に持株会社が含まれていない会社の UBO 要件を満たすことができます。持株会社がある会社の場合、Stripe は所有者を確認しようとします。確認できない場合は、アカウントの実質的支配者を特定するために[実質的支配者の証明書](https://docs.stripe.com/acceptable-verification-documents.md?country=SG&document-type=relationship)または関連する[所有権の書類](https://docs.stripe.com/acceptable-verification-documents.md?country=SG&document-type=relationship)をアップロードするように求められます。(これは、非営利団体など、他のビジネスのタイプにも当てはまります。) 会社代表者が不足しているアカウントには、[future_requirements](https://docs.stripe.com/api/accounts/object.md#account_object-future_requirements-errors) のエラーハッシュに `verification_missing_owners` エラーコードが表示されます。同様に、取締役が不足しているアカウントには `verification_document_directors_mismatch` エラーコードが表示されます。所有権に関する追加情報の提出が必要なアカウントには、`verification_requires_additional_proof_of_registration` エラーコードが表示されます。 ``` { "id": ""{{CONNECTED_ACCOUNT_ID}}"", "future_requirements": { "past_due": [ "documents.proof_of_ultimate_beneficial_ownership.files", ], "errors": [ { "code": "verification_missing_owners", "requirement": "documents.proof_of_ultimate_beneficial_ownership.files", "reason": "..." }, ... ], ... }, ... } ``` ### 免除 状況によっては、事業体が所有権を申告する必要がない場合があります。免除の対象となるには、正当な理由を [company.ownership_exemption_reason](https://docs.stripe.com/api/accounts/update.md#update_account-company-ownership_exemption_reason) フィールドに指定する必要があります。免除の有効な理由は次のとおりです。 - `qualified_entity_exceeds_ownership_threshold`: 政府、上場企業、または金融機関がビジネスの 75% 以上を所有している場合、そのビジネスは所有権の詳細の提供が免除されます。 - `qualifies_as_financial_institution`: [シンガポール金融管理局](https://eservices.mas.gov.sg/fid/institution?sector=Banking&category=Finance%20Company)によって規制されている金融機関であるビジネスは、所有権の詳細を提供することが免除されます。 ``` { "id": ""{{CONNECTED_ACCOUNT_ID}}"", "future_requirements": { "past_due": [ "documents.proof_of_ultimate_beneficial_ownership.files", ], "alternatives": [ { "original_fields_due": [ "documents.proof_of_ultimate_beneficial_ownership.files", ], "alternative_fields_due": [ "company.ownership_exemption_reason", ] } ], ... }, ... } ``` 免除の理由を送信すると、Stripe で事業体の詳細を確認します。この審査中に、要件は [future_requirements.pending_verification](https://docs.stripe.com/api/accounts/object.md#account_object-future_requirements-pending_verification) に移行します。事業体が免除の対象ではないと Stripe が判断した場合、エラーメッセージが表示され、所有権の要件はそのまま残ります。 ``` { "id": ""{{CONNECTED_ACCOUNT_ID}}"", "future_requirements": { "past_due": [ "documents.proof_of_ultimate_beneficial_ownership.files", ], "alternatives": [ { "original_fields_due": [ "documents.proof_of_ultimate_beneficial_ownership.files", ], "alternative_fields_due": [ "company.ownership_exemption_reason", ] } ], "errors": [ { "code": "verification_rejected_ownership_exemption_reason", "reason": "The ownership exemption reason was rejected.", "requirement": "company.ownership_exemption_reason" } ], ... }, ... } ``` ## 取締役情報の収集 民間企業、上場企業、非営利団体については、連結アカウントの政府登録記録に記載されているすべての[取締役](https://docs.stripe.com/api/persons/object.md#person_object-first_name)の[名](https://docs.stripe.com/api/persons/object.md#person_object-last_name)、[姓](https://docs.stripe.com/api/persons/update.md#update_person-id_number)、[ID 番号](https://docs.stripe.com/api/persons/object.md#person_object-full_name_aliases)、[別名](https://docs.stripe.com/api/persons/object.md#person_object-relationship-director)を収集して提出する必要があります。 さらに、API の `company.directorship_declaration.ip` フィールド、`company.directorship_declaration.date` フィールド、およびオプションで `company.directorship_declaration.user_agent` フィールドを設定することで、取締役のリストが最新かつ正しいことを証明するよう求められる場合があります。取締役のリストに不一致が検出された場合、Stripe は、要件フィールドに`company.directorship_declaration.ip` および `company.directorship_declaration.date` の要件を返して、新しい宣言を要求する場合があります。 ## 新しい確認エラーコード 連結アカウントから提供された情報を Stripe で確認できない場合、確認レスポンスの詳細が新しいエラーコードとして Accounts オブジェクトの [requirements.errors](https://docs.stripe.com/api/accounts/object.md#account_object-requirements-errors) 配列に含まれます。 API バージョン [2025-03-31](https://docs.stripe.com/upgrades.md#2025-03-31) では、以下のエラーコードが導入されています。以前の API バージョンでは、代わりに `verification_failed_other` を受信します。また、API 組み込みにベータヘッダーを追加して、API バージョンを変更せずに新しいエラーコードを公開することもできます。このベータヘッダーにアクセスするには、[Stripe サポート](https://support.stripe.com/)にお問い合わせください。 | エラーコード | エラーの説明 | | -------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `verification_legal_entity_structure_mismatch` | ビジネスのタイプまたは構造が正しくないようです。このアカウントの正しいビジネスのタイプまたは構造を指定してください。 | | `verification_failed_representative_authority` | アカウント代表者の権限を確認できませんでした。承認者をアカウントに追加し、承認者が署名した委任状を提出してください。[代表者の地位の確認](https://support.stripe.com/questions/representative-authority-verification)のサポート記事をご覧ください。 | | `verification_failed_authorizer_authority` | 指定された承認者の権限を確認できませんでした。承認者を、委任代理人として登録されている人物に変更してください。[代表者の地位の確認](https://support.stripe.com/questions/representative-authority-verification)のサポート記事をご覧ください。 | | `verification_rejected_ownership_exemption_reason` | 所有権の免除理由が却下されました。代わりに、別の免除理由を選択するか、実質的支配者の証明書をアップロードしてください。 | | `information_missing` | エラーメッセージを参照して、ドキュメントまたはキー入力データにどの情報が欠落しているかを理解します。重要な所有権を持つ持株会社に関連している場合、エラーコードには、特定された未入力の持株会社も記載されています。詳しくは、[持株会社の受益所有権の確認](https://support.stripe.com/questions/beneficial-ownership-verification-for-holding-companies)のサポート記事をご覧ください。 | | `verification_missing_owners` | ビジネスオーナーが指定されていません。すべてのビジネスオーナーの情報を入力するか、自身で入力するよう依頼する必要があります。不足していると判断されたオーナーは、[名前1、名前2] です。 | | `verification_missing_directors` | アカウントの取締役が記載されていません。アカウントを更新し、現在の取締役が記載されている登録書類をアップロードしてください。 | | `verification_document_directors_mismatch` | ドキュメントの取締役がアカウントにありません。アカウントを更新し、現在の取締役の登録書類をアップロードします。 | ## See also - [Custom アカウントの Connect アカウント登録](https://docs.stripe.com/connect/custom/hosted-onboarding.md) - [Custom アカウントのアカウント登録ソリューション](https://docs.stripe.com/connect/custom/onboarding.md) - [アカウントを更新する](https://docs.stripe.com/connect/updating-service-agreements.md) - [API による本人確認の処理](https://docs.stripe.com/connect/handling-api-verification.md) - [Custom アカウントの本人確認のテスト](https://docs.stripe.com/connect/testing-verification.md)