必要な確認に新しいエラーコードを追加する互換性に関わる変更

新規情報

Accounts API、Capabilities API、Persons API、Bank Accounts API の requirements.errors 配列に次のエラーコードを追加します。

information_missing エラーコードは、以前のエラーコードよりも一般的です。関連する requirement フィールドと reason フィールドを使用して、不足している情報を確認します。たとえば、シンガポールの一部のアカウントには次のように表示されます。

最終的な会社代表者の証明文書として Letter of Attestation がアップロードされ、その文書を公証した専門機関を確認できなかった場合は、invalid_signator エラーが返されます。

アカウントの authorizer として Person を指定し、社内での権限の位置を確認できなかった場合は、verification_failed_authorizer_authority エラーが返されます。詳細については、代表者の権限の確認を参照してください。

最終的な会社代表者の提供に対する免除を申請し、免除の申請が却下された場合は、verification_rejected_ownership_exemption_reason エラーが返されます。

一部の Connect 実装では、新しいエラーコードを処理するために更新が必要な場合があります。

シンガポールでは、今後の要件の更新のため、新しいエラーコードを処理できるようになります。

値	変更する	列挙値
information_missinginvalid_signatorverification_failed_authorizer_authorityverification_rejected_ownership_exemption_reason	追加済み	Account.future_requirements.errors[].code Account.requirements.errors[].code BankAccount.future_requirements.errors[].code + さらに 5 件 BankAccount.requirements.errors[].code Capability.future_requirements.errors[].code Capability.requirements.errors[].code Person.future_requirements.errors[].code Person.requirements.errors[].code

Workbench で現在の API バージョンを表示します。
SDK を使用している場合は、この API バージョンに対応する SDK バージョンにアップグレードします。
- SDK を使用していない場合は、Stripe-Version: 2025-03-31.basil を含めるように API リクエストを更新してください。
Webhook エンドポイントに使用する API バージョンをアップグレードします。
新しいバージョンに対して、実装内容をテストします。
Connect を使用する場合は、Connect の実装内容をテストします。
Workbench でアップグレードを実行します。バージョンをロールバックできるのは 72 時間以内です。

Stripe API のアップグレードについて、詳細をご確認ください。