# 今後の要件の更新 必要な確認情報の変更と、この変更が貴社で構築済みの 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 および取締役情報の確認 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 年から、オランダ (NL) アカウントに対して、オランダの規制への準拠を確保するため、より厳格な事業形態要件を適用します。これにより、オランダの事業者に必要な 8 桁の会社登録番号 (KvK、Kamer van Koophandel) の収集方法に特に影響があります。 ### 変更点 #### 対応しなくなった個人事業形態 `individual` ビジネス用銀行口座形態はオランダ口座では対応しなくなりました。これは `business_type: "individual"` および `business_type: "sole_proprietorship"` の既存および新規のオランダ口座に影響を受けます。 **なぜこれが重要なのか:** オランダでは、すべてのビジネスは KvK (商工会議所) 番号を提供する必要があります。当社の「個人」事業形態は KvK を徴収していないため、非準拠となります。 #### 新しいエラーコード: `unsupported_business_type` 無効なビジネスタイプのアカウントでは、要件（requirements）に新しいエラーが表示されます。 ```shell // 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` 構造に更新する必要があります。 ```shell // 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 エラーが返されます。 ```shell // 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 必須 | | ------------ | ---------------------------- | ------ | | `company` | `sole_proprietorship` | はい | | `company` | `incorporated_partnership` | はい | | `company` | `unincorporated_partnership` | はい | | `company` | `private_corporation` | はい | | `company` | `public_corporation` | はい | | `non_profit` | さまざまな構造 | はい | ### ケイパビリティへの影響 `unsupported_business_type` エラーが発生した口座は、事業形態が更新されるまでケイパビリティが制限されます。 ```shell { "capabilities": { "card_payments": "inactive", "transfers": "inactive" }, "requirements": { "disabled_reason": "requirements.past_due", "past_due": ["business_type"] } } ``` KvK 登録が提供されていない口座は、この情報が提供されるまで、`card_payments` のケイパビリティが制限されます。 ```shell { "capabilities": { "card_payments": "inactive" }, "requirements": { "disabled_reason": "requirements.past_due", "past_due": ["company.tax_id"] } } ``` ### 実装チェックリスト NL 連結アカウントを持つプラットフォームの場合: 1. **既存口座の監査** ```javascript // 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) を徴収 1. **新しいエラーコードを処理** ```javascript 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 番号の検索を支援 ### テスト これらのシナリオで実装をテストしてください。 ```javascript // 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` フィールドに具体的なエラー内容が含まれます。 ## 新しいエラーコード ### 確認エラーコード (プライベートプレビュー) `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 の確認と取締役の確認の両方を必要とするイギリスの企業。 #### プログラム - 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)