コンテンツにスキップ
アカウントを作成
または
サインイン
Stripe ドキュメントのロゴ
/
アカウントを作成
サインイン

注

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

Accounts v2 ケイパビリティのリクエスト時のエラータイプ (サポート対象外の国または法人) を追加公開プレビュー

新規情報

Accounts v2 を使用している場合、アカウントの本人確認情報が更新されるたびに、利用対象国が自動的に再計算されるようになりました。

ケイパビリティをリクエストする際のエラータイプが 2 つ導入されました。400 検証エラーを返す代わりに、status_details.code が以下をレポートするかどうかを確認できます。

  • unsupported_country: アカウントの国は、このケイパビリティに対応していません。
  • unsupported_entity_type: アカウントの法人タイプは、このケイパビリティに対応していません。

効果

国や法人タイプが原因でアカウントのケイパビリティがサポート対象外とマークされている場合、そのケイパビリティを手動で引き出して再リクエストする必要がなくなりました。また、特定の国や法人タイプで対象外であるケイパビリティをリクエストした際に、400 エラーが発生することはありません。

変更点

値変更する列挙値
unsupported_entity_type追加済み
V2.Core.Account.configuration.merchant.capabilities.affirm_payments.status_details[].codeV2.Core.Account.configuration.merchant.capabilities.afterpay_clearpay_payments.status_details[].codeV2.Core.Account.configuration.merchant.capabilities.alma_payments.status_details[].codeV2.Core.Account.configuration.merchant.capabilities.amazon_pay_payments.status_details[].codeV2.Core.Account.configuration.merchant.capabilities.au_becs_debit_payments.status_details[].codeV2.Core.Account.configuration.merchant.capabilities.bacs_debit_payments.status_details[].codeV2.Core.Account.configuration.merchant.capabilities.bancontact_payments.status_details[].codeV2.Core.Account.configuration.merchant.capabilities.blik_payments.status_details[].codeV2.Core.Account.configuration.merchant.capabilities.boleto_payments.status_details[].codeV2.Core.Account.configuration.merchant.capabilities.card_payments.status_details[].codeV2.Core.Account.configuration.merchant.capabilities.cartes_bancaires_payments.status_details[].codeV2.Core.Account.configuration.merchant.capabilities.cashapp_payments.status_details[].codeV2.Core.Account.configuration.merchant.capabilities.eps_payments.status_details[].codeV2.Core.Account.configuration.merchant.capabilities.fpx_payments.status_details[].codeV2.Core.Account.configuration.merchant.capabilities.gb_bank_transfer_payments.status_details[].codeV2.Core.Account.configuration.merchant.capabilities.grabpay_payments.status_details[].codeV2.Core.Account.configuration.merchant.capabilities.ideal_payments.status_details[].codeV2.Core.Account.configuration.merchant.capabilities.jcb_payments.status_details[].codeV2.Core.Account.configuration.merchant.capabilities.jp_bank_transfer_payments.status_details[].codeV2.Core.Account.configuration.merchant.capabilities.kakao_pay_payments.status_details[].codeV2.Core.Account.configuration.merchant.capabilities.klarna_payments.status_details[].codeV2.Core.Account.configuration.merchant.capabilities.konbini_payments.status_details[].codeV2.Core.Account.configuration.merchant.capabilities.kr_card_payments.status_details[].codeV2.Core.Account.configuration.merchant.capabilities.link_payments.status_details[].codeV2.Core.Account.configuration.merchant.capabilities.mobilepay_payments.status_details[].codeV2.Core.Account.configuration.merchant.capabilities.multibanco_payments.status_details[].codeV2.Core.Account.configuration.merchant.capabilities.mx_bank_transfer_payments.status_details[].codeV2.Core.Account.configuration.merchant.capabilities.naver_pay_payments.status_details[].codeV2.Core.Account.configuration.merchant.capabilities.oxxo_payments.status_details[].codeV2.Core.Account.configuration.merchant.capabilities.p24_payments.status_details[].codeV2.Core.Account.configuration.merchant.capabilities.pay_by_bank_payments.status_details[].codeV2.Core.Account.configuration.merchant.capabilities.payco_payments.status_details[].codeV2.Core.Account.configuration.merchant.capabilities.paynow_payments.status_details[].codeV2.Core.Account.configuration.merchant.capabilities.promptpay_payments.status_details[].codeV2.Core.Account.configuration.merchant.capabilities.revolut_pay_payments.status_details[].codeV2.Core.Account.configuration.merchant.capabilities.samsung_pay_payments.status_details[].codeV2.Core.Account.configuration.merchant.capabilities.sepa_bank_transfer_payments.status_details[].codeV2.Core.Account.configuration.merchant.capabilities.sepa_debit_payments.status_details[].codeV2.Core.Account.configuration.merchant.capabilities.stripe_balance.payouts.status_details[].codeV2.Core.Account.configuration.merchant.capabilities.swish_payments.status_details[].codeV2.Core.Account.configuration.merchant.capabilities.twint_payments.status_details[].codeV2.Core.Account.configuration.merchant.capabilities.us_bank_transfer_payments.status_details[].codeV2.Core.Account.configuration.merchant.capabilities.zip_payments.status_details[].codeV2.Core.Account.configuration.recipient.capabilities.bank_accounts.local.status_details[].codeV2.Core.Account.configuration.recipient.capabilities.bank_accounts.wire.status_details[].codeV2.Core.Account.configuration.recipient.capabilities.cards.status_details[].codeV2.Core.Account.configuration.recipient.capabilities.stripe_balance.payouts.status_details[].codeV2.Core.Account.configuration.recipient.capabilities.stripe_balance.stripe_transfers.status_details[].code

アップグレード

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

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

このページはお役に立ちましたか。
はいいいえ