コンテンツにスキップ
アカウント作成/サインイン
Stripe ドキュメントのロゴ
/
AI に質問
アカウントを作成サインイン
導入方法
決済管理
売上管理
プラットフォームとマーケットプレイス
資金管理
開発者向けリソース
API & SDKヘルプ
概要
バージョン管理
変更ログ
    概要
    Clover
    Basil
    Acacia
    以前のバージョン
API バージョンのアップグレード
SDK バージョンをアップグレードする
Essentials
SDK
API
テスト
Stripe CLI
サンプルプロジェクト
ツール
Stripe ダッシュボード
ワークベンチ
開発者ダッシュボード
Stripe Shell
Visual Studio Code をご利用の場合
Terraform
機能
ワークフロー
イベントの送信先
Stripe 健全性アラートファイルのアップロード
AI ソリューション
エージェントツールキット
モデルコンテキストプロトコルエージェントを使用した AI SaaS 請求ワークフローの構築
セキュリティとプライバシー
セキュリティ
Stripebot ウェブクローラー
Stripe を拡張する
Stripe Appsを構築する
Stripe アプリを使用する
パートナー
Partner Ecosystem
パートナー認定
アメリカ
日本語
ホーム開発者向けリソースChangelogClover2026-01-28.preview

メモ

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

Outbound Setup Intents API のエラーコードを更新互換性に関わる変更

新機能

Outbound Setup Intents API から返される エラーコード を、認証情報タイプ固有のコードではなく、より汎用的なエラータイプを使用するように更新します。この変更により、いくつかの既存のエラーコードが標準化されたエラータイプに置き換えられます。

  • blocked_payout_method_bank_account、blocked_payout_method_card、blocked_payout_method_crypto_wallet のエラーでは、blocked_payout_method が返されるようになりました。
  • unsupported_payout_method_bank_account および unsupported_payout_method_card のエラーでは、unsupported_payout_method が返されるようになりました。
  • invalid_payout_method_bank_account、invalid_payout_method_card、invalid_payout_method_crypto_wallet のエラーでは、invalid_payout_method が返されるようになりました。
  • limit_payout_method_bank_account、limit_payout_method_card、limit_payout_method_crypto_wallet のエラーでは、limit_payout_method が返されるようになりました。

この標準化により、さまざまな Payout Method タイプ間でのエラー処理の一貫性が向上し、Payout Method に新しい認証情報タイプを追加する際の将来の拡張性もサポートされます。

互換性に関わる変更である理由

この更新によって置き換えられる特定のエラーコード識別子に連携機能が依存している可能性があるため、これは互換性に関わる変更です。コードで blocked_payout_method_bank_account、unsupported_payout_method_bank_account、invalid_payout_method_bank_account_、または limit_payout_method_bank_account などのタイプ固有のエラーコードをチェックしている場合、これらのチェックは機能しなくなり、汎用的なエラータイプを処理するように更新する必要があります。

影響

導入環境が Outbound Setup Intents エンドポイントからの特定のエラーコードを処理する場合、汎用的なエラータイプを使用するようにエラー処理ロジックを更新する必要があります。エラーメッセージと根本的な理由は変わりませんが、エラーコード識別子が変更され、さまざまな Payout Method タイプ間で一貫性が強化されています。

変更点

個のコード変更する
blocked_payout_methodunsupported_payout_method追加済み
blocked_by_stripe
invalid_payout_method_data追加済み
invalid_payout_method
limit_payout_method追加済み
quota_exceeded

アップグレード

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

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

関連する変更

  • 銀行口座と入金方法のリソースに代替参照フィールドを追加
  • カード入金方法にフィンガープリントプロパティを追加
  • Global Payouts が越境入金のサポート対象として 15 カ国を新たに追加
このページはお役に立ちましたか。
はいいいえ
  • お困りのことがございましたら 、サポートにお問い合わせください。
  • 変更ログをご覧ください。
  • ご不明な点がございましたら、お問い合わせください。
  • LLM は llms.txt を参照してください。
  • Powered by Markdoc