# 必要な確認に新しいエラーコードを追加する ## 新規情報 [Accounts API](https://docs.stripe.com/api/accounts/object.md?api-version=2025-03-31.basil#account_object-requirements-errors-code)、[Capabilities API](https://docs.stripe.com/api/capabilities/object.md?api-version=2025-03-31.basil#capability_object-requirements-errors-code)、[Persons API](https://docs.stripe.com/api/persons/object.md?api-version=2025-03-31.basil#person_object-requirements-errors-code)、[Bank Accounts API](https://docs.stripe.com/api/external_account_bank_accounts/object.md?api-version=2025-03-31.basil#account_bank_account_object-requirements-errors-code) の `requirements.errors` 配列に次のエラーコードを追加します。 - `information_missing` - `invalid_signator` - `verification_failed_authorizer_authority` - `verification_rejected_ownership_exemption_reason` `information_missing` エラーコードは、以前のエラーコードよりも一般的です。関連する `requirement` フィールドと `reason` フィールドを使用して、不足している情報を確認します。たとえば、シンガポールの一部のアカウントには次のように表示されます。 ```json // GET /v1/accounts/{{CONNECTED_ACCOUNT_ID}} { ... "requirements": { "currently_due": ["documents.proof_of_ultimate_beneficial_ownership.files"], "errors": [ { "code": "information_missing", "requirement": "documents.proof_of_ultimate_beneficial_ownership.files", "reason": "We identified that your business is owned by holding companies that require additional information to be collected. Please provide documents that include information for each applicable holding company. For more information, see https://support.stripe.com/questions/beneficial-ownership-verification-for-holding-companies. The new holding companies we have identified are: ACME INC." } ], ... }, ... } ``` 最終的な会社代表者の証明文書として [Letter of Attestation](https://support.stripe.com/questions/singapore-ultimate-beneficial-ownership-and-director-requirements) がアップロードされ、その文書を公証した専門機関を確認できなかった場合は、`invalid_signator` エラーが返されます。 ```json { ... "requirements": { "currently_due": ["documents.proof_of_ultimate_beneficial_ownership.files"], "errors": [ { "code": "invalid_signator", "requirement": "documents.proof_of_ultimate_beneficial_ownership.files", "reason": "We could not verify the professional certifying body of this document." } ], ... }, ... } ``` アカウントで個人を[承認者](https://docs.stripe.com/api/persons/update.md?api-version=2025-03-31.basil#update_person-relationship-authorizer)として指定していて、会社内での権限の所在を確認できなかった場合は、`verification_failed_authorizer_authority`エラーが返されます。詳細については、[代表権の確認](https://support.stripe.com/questions/representative-authority-verification)をご覧ください。 ```json { ... "requirements": { "currently_due": ["{{AUTHORIZER_PERSON_TOKEN}}.relationship.authorizer"], "errors": [ { "code": "verification_failed_authorizer_authority", "requirement": "{{AUTHORIZER_PERSON_TOKEN}}.relationship.authorizer", "reason": "The authority of the authorizer could not be verified. Authorizers must be one of Director, Chief Executive Officer listed on acra.gov.sg." } ], ... }, ... } ``` 最終的な会社代表者の提供に対する免除を申請し、免除の申請が却下された場合は、`verification_rejected_ownership_exemption_reason` エラーが返されます。 ```json { ... "requirements": { "currently_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", "requirement": "company.ownership_exemption_reason", "reason": "The ownership exemption reason was rejected." } ], ... }, ... } ``` ## この変更により互換性が失われる理由 一部の Connect 実装では、新しいエラーコードを処理するために更新が必要な場合があります。 ## 影響 シンガポールでは、[今後の要件の更新](https://docs.stripe.com/connect/upcoming-requirements-updates.md?program=sg-2023)のため、新しいエラーコードを処理できるようになります。 ## 変更点 #### REST API | Values | Change | Enums | | ----------------------------------------------------------------------------------------------------------------------------------------- | ------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `information_missing`, `invalid_signator`, `verification_failed_authorizer_authority`, `verification_rejected_ownership_exemption_reason` | Added | [Account.future_requirements.errors[].code](/api/accounts/object?api-version=2025-03-31.basil#account_object-future_requirements-errors-code), [Account.requirements.errors[].code](/api/accounts/object?api-version=2025-03-31.basil#account_object-requirements-errors-code), [BankAccount.future_requirements.errors[].code](/api/external_account_bank_accounts/object?api-version=2025-03-31.basil#account_bank_account_object-future_requirements-errors-code), [BankAccount.requirements.errors[].code](/api/external_account_bank_accounts/object?api-version=2025-03-31.basil#account_bank_account_object-requirements), [Capability.future_requirements.errors[].code](/api/capabilities/object?api-version=2025-03-31.basil#capability_object-future_requirements-errors-code), [Capability.requirements.errors[].code](/api/capabilities/object?api-version=2025-03-31.basil#capability_object-requirements-errors-code), [Person.future_requirements.errors[].code](/api/persons/object?api-version=2025-03-31.basil#person_object-future_requirements-errors-code), [Person.requirements.errors[].code](/api/persons/object?api-version=2025-03-31.basil#person_object-requirements-errors-code) | #### Ruby この変更は、Ruby SDK には影響しません。 #### Python | Values | Change | Enums | | ----------------------------------------------------------------------------------------------------------------------------------------- | ------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `information_missing`, `invalid_signator`, `verification_failed_authorizer_authority`, `verification_rejected_ownership_exemption_reason` | Added | [Account.FutureRequirement.Error.code](/api/accounts/object?api-version=2025-03-31.basil#account_object-future_requirements-errors-code), [Account.Requirement.Error.code](/api/accounts/object?api-version=2025-03-31.basil#account_object-requirements-errors-code), [AccountCapability.FutureRequirement.Error.code](/api/capabilities/object?api-version=2025-03-31.basil#capability_object-future_requirements-errors-code), [AccountCapability.Requirement.Error.code](/api/capabilities/object?api-version=2025-03-31.basil#capability_object-requirements-errors-code), [AccountPerson.FutureRequirement.Error.code](/api/persons/object?api-version=2025-03-31.basil#person_object-future_requirements-errors-code), [AccountPerson.Requirement.Error.code](/api/persons/object?api-version=2025-03-31.basil#person_object-requirements-errors-code), [BankAccount.FutureRequirement.Error.code](/api/accounts/object?api-version=2025-03-31.basil#account_object-future_requirements-errors-code), [BankAccount.Requirement.Error.code](/api/accounts/object?api-version=2025-03-31.basil#account_object-requirements-errors-code) | #### PHP この変更は、PHP SDK には影響しません。 #### Java この変更は、Java SDK には影響しません。 #### Node.js | Values | Change | Enums | | ----------------------------------------------------------------------------------------------------------------------------------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `information_missing`, `invalid_signator`, `verification_failed_authorizer_authority`, `verification_rejected_ownership_exemption_reason` | Added | [Account.future_requirements.errors[].code](/api/accounts/object?api-version=2025-03-31.basil#account_object-future_requirements-errors-code), [Account.requirements.errors[].code](/api/accounts/object?api-version=2025-03-31.basil#account_object-requirements-errors-code), [AccountCapability.future_requirements.errors[].code](/api/capabilities/object?api-version=2025-03-31.basil#capability_object-future_requirements-errors-code), [AccountCapability.requirements.errors[].code](/api/capabilities/object?api-version=2025-03-31.basil#capability_object-requirements-errors-code), [AccountPerson.future_requirements.errors[].code](/api/persons/object?api-version=2025-03-31.basil#person_object-future_requirements-errors-code), [AccountPerson.requirements.errors[].code](/api/persons/object?api-version=2025-03-31.basil#person_object-requirements-errors-code), [BankAccount.future_requirements.errors[].code](/api/external_account_bank_accounts/object?api-version=2025-03-31.basil#account_bank_account_object-future_requirements-errors-code), [BankAccount.requirements.errors[].code](/api/external_account_bank_accounts/object?api-version=2025-03-31.basil#account_bank_account_object-requirements) | #### Go | Values | Change | Enums | | ----------------------------------------------------------------------------------------------------------------------------------------- | ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `information_missing`, `invalid_signator`, `verification_failed_authorizer_authority`, `verification_rejected_ownership_exemption_reason` | Added | [BankAccountFutureRequirementsErrors.Code](/api/external_account_bank_accounts/object?api-version=2025-03-31.basil#account_bank_account_object-future_requirements-errors-code), [BankAccountRequirementsErrors.Code](/api/external_account_bank_accounts/object?api-version=2025-03-31.basil#account_bank_account_object-requirements-errors-code) | #### .NET この変更は、.NET SDK には影響しません。 ## アップグレード #### REST API 1. Workbench で[現在の API バージョンを表示します](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench)。 1. SDK を使用している場合は、この API バージョンに対応する SDK バージョンにアップグレードします。 - SDK を使用していない場合は、`Stripe-Version: 2025-03-31.basil` を含めるように [API リクエスト](https://docs.stripe.com/api/versioning.md)を更新してください。 1. [Webhook エンドポイント](https://docs.stripe.com/webhooks/versioning.md)に使用する API バージョンをアップグレードします。 1. 新しいバージョンに対して、[実装内容をテスト](https://docs.stripe.com/testing.md)します。 1. Connect を使用する場合は、[Connect の実装内容をテスト](https://docs.stripe.com/connect/testing.md)します。 1. Workbench で[アップグレードを実行](https://docs.stripe.com/upgrades.md#perform-the-upgrade)します。[バージョンをロールバック](https://docs.stripe.com/upgrades.md#roll-back-your-api-version)できるのは 72 時間以内です。 [Stripe API のアップグレード](https://docs.stripe.com/upgrades.md)について、詳細をご確認ください。 #### Ruby 1. Workbench で[現在の API バージョンを表示します](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench)。 1. Ruby SDK を [v15.0.0](https://github.com/stripe/stripe-ruby/releases/tag/v15.0.0)にアップグレードします。 1. [Webhook エンドポイント](https://docs.stripe.com/webhooks/versioning.md)に使用する API バージョンをアップグレードします。 1. 新しいバージョンに対して、[実装内容をテスト](https://docs.stripe.com/testing.md)します。 1. Connect を使用する場合は、[Connect の実装内容をテスト](https://docs.stripe.com/connect/testing.md)します。 1. Workbench で[アップグレードを実行](https://docs.stripe.com/upgrades.md#perform-the-upgrade)します。[バージョンをロールバック](https://docs.stripe.com/upgrades.md#roll-back-your-api-version)できるのは 72 時間以内です。 [Stripe API のアップグレード](https://docs.stripe.com/upgrades.md)について、詳細をご確認ください。 #### Python 1. Workbench で[現在の API バージョンを表示します](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench)。 1. Python SDK を [v12.0.0](https://github.com/stripe/stripe-python/releases/tag/v12.0.0)にアップグレードします。 1. [Webhook エンドポイント](https://docs.stripe.com/webhooks/versioning.md)に使用する API バージョンをアップグレードします。 1. 新しいバージョンに対して、[実装内容をテスト](https://docs.stripe.com/testing.md)します。 1. Connect を使用する場合は、[Connect の実装内容をテスト](https://docs.stripe.com/connect/testing.md)します。 1. Workbench で[アップグレードを実行](https://docs.stripe.com/upgrades.md#perform-the-upgrade)します。[バージョンをロールバック](https://docs.stripe.com/upgrades.md#roll-back-your-api-version)できるのは 72 時間以内です。 [Stripe API のアップグレード](https://docs.stripe.com/upgrades.md)について、詳細をご確認ください。 #### PHP 1. Workbench で[現在の API バージョンを表示します](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench)。 1. PHP SDK を [v17.0.0](https://github.com/stripe/stripe-php/releases/tag/v17.0.0)にアップグレードします。 1. [Webhook エンドポイント](https://docs.stripe.com/webhooks/versioning.md)に使用する API バージョンをアップグレードします。 1. 新しいバージョンに対して、[実装内容をテスト](https://docs.stripe.com/testing.md)します。 1. Connect を使用する場合は、[Connect の実装内容をテスト](https://docs.stripe.com/connect/testing.md)します。 1. Workbench で[アップグレードを実行](https://docs.stripe.com/upgrades.md#perform-the-upgrade)します。[バージョンをロールバック](https://docs.stripe.com/upgrades.md#roll-back-your-api-version)できるのは 72 時間以内です。 [Stripe API のアップグレード](https://docs.stripe.com/upgrades.md)について、詳細をご確認ください。 #### Java 1. Workbench で[現在の API バージョンを表示します](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench)。 1. Java SDK を [v29.0.0](https://github.com/stripe/stripe-java/releases/tag/v29.0.0)にアップグレードします。 1. [Webhook エンドポイント](https://docs.stripe.com/webhooks/versioning.md)に使用する API バージョンをアップグレードします。 1. 新しいバージョンに対して、[実装内容をテスト](https://docs.stripe.com/testing.md)します。 1. Connect を使用する場合は、[Connect の実装内容をテスト](https://docs.stripe.com/connect/testing.md)します。 1. Workbench で[アップグレードを実行](https://docs.stripe.com/upgrades.md#perform-the-upgrade)します。[バージョンをロールバック](https://docs.stripe.com/upgrades.md#roll-back-your-api-version)できるのは 72 時間以内です。 [Stripe API のアップグレード](https://docs.stripe.com/upgrades.md)について、詳細をご確認ください。 #### Node.js 1. Workbench で[現在の API バージョンを表示します](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench)。 1. Node SDK を [v18.0.0](https://github.com/stripe/stripe-node/releases/tag/v18.0.0)にアップグレードします。 1. [Webhook エンドポイント](https://docs.stripe.com/webhooks/versioning.md)に使用する API バージョンをアップグレードします。 1. 新しいバージョンに対して、[実装内容をテスト](https://docs.stripe.com/testing.md)します。 1. Connect を使用する場合は、[Connect の実装内容をテスト](https://docs.stripe.com/connect/testing.md)します。 1. Workbench で[アップグレードを実行](https://docs.stripe.com/upgrades.md#perform-the-upgrade)します。[バージョンをロールバック](https://docs.stripe.com/upgrades.md#roll-back-your-api-version)できるのは 72 時間以内です。 [Stripe API のアップグレード](https://docs.stripe.com/upgrades.md)について、詳細をご確認ください。 #### Go 1. Workbench で[現在の API バージョンを表示します](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench)。 1. Go SDK を [v82.0.0](https://github.com/stripe/stripe-go/releases/tag/v82.0.0)にアップグレードします。 1. [Webhook エンドポイント](https://docs.stripe.com/webhooks/versioning.md)に使用する API バージョンをアップグレードします。 1. 新しいバージョンに対して、[実装内容をテスト](https://docs.stripe.com/testing.md)します。 1. Connect を使用する場合は、[Connect の実装内容をテスト](https://docs.stripe.com/connect/testing.md)します。 1. Workbench で[アップグレードを実行](https://docs.stripe.com/upgrades.md#perform-the-upgrade)します。[バージョンをロールバック](https://docs.stripe.com/upgrades.md#roll-back-your-api-version)できるのは 72 時間以内です。 [Stripe API のアップグレード](https://docs.stripe.com/upgrades.md)について、詳細をご確認ください。 #### .NET 1. Workbench で[現在の API バージョンを表示します](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench)。 1. .NET SDK を [v48.0.0](https://github.com/stripe/stripe-dotnet/releases/tag/v48.0.0)にアップグレードします。 1. [Webhook エンドポイント](https://docs.stripe.com/webhooks/versioning.md)に使用する API バージョンをアップグレードします。 1. 新しいバージョンに対して、[実装内容をテスト](https://docs.stripe.com/testing.md)します。 1. Connect を使用する場合は、[Connect の実装内容をテスト](https://docs.stripe.com/connect/testing.md)します。 1. Workbench で[アップグレードを実行](https://docs.stripe.com/upgrades.md#perform-the-upgrade)します。[バージョンをロールバック](https://docs.stripe.com/upgrades.md#roll-back-your-api-version)できるのは 72 時間以内です。 [Stripe API のアップグレード](https://docs.stripe.com/upgrades.md)について、詳細をご確認ください。