コンテンツにスキップ
アカウントを作成
または
サインイン
Stripe ドキュメントのロゴ
/
AI に質問する
アカウントを作成
サインイン
始める
支払い
売上
プラットフォームおよびマーケットプレイス
資金管理
開発者向けのツール
概要
バージョン管理
変更ログ
    概要
    Basil
    Acacia
    以前のバージョン
API バージョンのアップグレード
SDK バージョンをアップグレードする
開発者向けのツール
SDK
API
テスト
ワークベンチ
イベントの送信先
ワークフロー
Stripe CLI
Stripe Shell
開発者ダッシュボード
エージェントツールキット
LLM を使用した構築Visual Studio Code をご利用の場合Stripe 健全性アラートファイルのアップロード
セキュリティとプライバシー
セキュリティ
プライバシー
Stripe を拡張する
Stripe Apps
Stripe のコネクター
パートナー
Partner Ecosystem
パートナー認定
ホーム開発者向けのツールChangelogBasil2025-03-31.basil

注

このページはまだ日本語ではご利用いただけません。より多くの言語で文書が閲覧できるように現在取り組んでいます。準備が整い次第、翻訳版を提供いたしますので、もう少しお待ちください。

必要な確認に新しいエラーコードを追加する破壊的変更

新規情報

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

  • information_missing
  • invalid_signator
  • verification_failed_authorizer_authority
  • verification_rejected_ownership_exemption_reason

information_missing エラーコードは、以前のエラーコードよりも一般的です。関連する 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_signator エラーが返されます。

{ ... "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." } ], ... }, ... }

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

{ ... "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 エラーが返されます。

{ ... "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 実装では、新しいエラーコードを処理するために更新が必要な場合があります。

影響

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

変更点

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

Upgrade

  1. View your current API version in Workbench.
  2. If you use an SDK, upgrade to the corresponding SDK version for this API version.
    • If you don’t use an SDK, update your API requests to include Stripe-Version: 2025-03-31.basil
  3. Upgrade the API version used for webhook endpoints.
  4. Test your integration against the new version.
  5. If you use Connect, test your Connect integration.
  6. In Workbench, perform the upgrade. You can roll back the version for 72 hours.

Learn more about Stripe API upgrades.

このページはお役に立ちましたか。
はいいいえ
お困りのことがございましたら 、サポートにお問い合わせください。
早期アクセスプログラムにご参加ください。
変更ログをご覧ください。
ご不明な点がございましたら、お問い合わせください。
LLM ですか?llms.txt を読んでください。
Powered by Markdoc