事業形態の検証に関する新しいエラーコードを追加互換性に関わる変更
新機能
Accounts API、Capabilities API、Persons API、Bank Accounts API の requirements.errors 配列に unsupported_ エラーコードを追加します。
加盟店の国で事業形態がサポートされていない場合、unsupported_ エラーが返されます。
// GET /v1/accounts/{{CONNECTED_ACCOUNT_ID}} { ... "requirements": { "currently_due": ["business_type"], "errors": [ { "code": "unsupported_business_type", "requirement": "business_type", "reason": "Business type isn't supported in merchant country. 'individual' isn't a supported business type in country NL." } ], ... }, ... }
この変更により互換性が失われる理由
一部の Connect 実装では、新しいエラーコードを処理するために更新が必要な場合があります。
影響
加盟店の国でサポートされていない事業形態を指定すると、unsupported_ エラー コードが返されます。事業形態を有効な値に更新する必要があります。
正しい事業形態と会社組織で新しいアカウントを作成する
新しいアカウントを作成する際は、その国の有効な事業形態と会社組織を指定してください。そうすることで、エラーが表示されなくなります。
// Correct approach for new accounts 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"
既存のアカウントでエラーが発生した場合は、アカウントを更新してエラーを解決します。
// Update existing accounts curl -X POST https://api.stripe.com/v1/accounts/acct_123 \ -u sk_test_123: \ -d "business_type=company" \ -d "company[structure]=sole_proprietorship" \ // Successful response { "id": "acct_123", "business_type": "company", "company": { "structure": "sole_proprietorship", ... }, "requirements": { "currently_due": [], // business_type requirement resolved "errors": [] } ... }