必要な確認に新しいエラーコードを追加する互換性に関わる変更
新規情報
Accounts API、Capabilities API、Persons API、Bank Accounts API の requirements. 配列に次のエラーコードを追加します。
information_missing invalid_signator verification_failed_ authorizer_ authority verification_rejected_ ownership_ exemption_ reason
information_ エラーコードは、以前のエラーコードよりも一般的です。関連する requirement フィールドと reason フィールドを使用して、不足している情報を確認します。たとえば、シンガポールの一部のアカウントには次のように表示されます。
// 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 がアップロードされ、その文書を公証した専門機関を確認できなかった場合は、invalid_ エラーが返されます。
{ ... "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." } ], ... }, ... }
アカウントで個人を承認者として指定していて、会社内での権限の所在を確認できなかった場合は、verification_エラーが返されます。詳細については、代表権の確認をご覧ください。
{ ... "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_ エラーが返されます。
{ ... "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 実装では、新しいエラーコードを処理するために更新が必要な場合があります。
影響
シンガポールでは、今後の要件の更新のため、新しいエラーコードを処理できるようになります。