# Outbound Setup Intents API のエラーコードを更新

## 新機能

[Outbound Setup Intents](https://docs.stripe.com/api/v2/money-management/outbound-setup-intents.md?api-version=2026-01-28.preview) API から返される [エラーコード](https://docs.stripe.com/api/errors.md?api-version=2026-01-28.preview#errors-code) を、認証情報タイプ固有のコードではなく、より汎用的なエラータイプを使用するように更新します。この変更により、いくつかの既存のエラーコードが標準化されたエラータイプに置き換えられます。

- `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](https://docs.stripe.com/api/v2/money-management/payout-methods.md?api-version=2026-01-28.preview) タイプ間でのエラー処理の一貫性が向上し、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 タイプ間で一貫性が強化されています。

## 変更点

#### REST API

| Codes                                                | Change |                         |
| ---------------------------------------------------- | ------ | ----------------------- |
| `blocked_payout_method`, `unsupported_payout_method` | Added  | `blocked_by_stripe`     |
| `invalid_payout_method_data`                         | Added  | `invalid_payout_method` |
| `limit_payout_method`                                | Added  | `quota_exceeded`        |

#### Ruby

この変更は、Ruby SDK には影響しません。

#### Python

| Codes                                                | Change |                            |
| ---------------------------------------------------- | ------ | -------------------------- |
| `blocked_payout_method`, `unsupported_payout_method` | Added  | `BlockedByStripeError`     |
| `invalid_payout_method_data`                         | Added  | `InvalidPayoutMethodError` |
| `limit_payout_method`                                | Added  | `QuotaExceededError`       |

#### PHP

この変更は、PHP SDK には影響しません。

#### Java

この変更は、Java SDK には影響しません。

#### Node.js

| Codes                                                | Change |                            |
| ---------------------------------------------------- | ------ | -------------------------- |
| `blocked_payout_method`, `unsupported_payout_method` | Added  | `BlockedByStripeError`     |
| `invalid_payout_method_data`                         | Added  | `InvalidPayoutMethodError` |
| `limit_payout_method`                                | Added  | `QuotaExceededError`       |

#### Go

| Codes                                                | Change |                            |
| ---------------------------------------------------- | ------ | -------------------------- |
| `blocked_payout_method`, `unsupported_payout_method` | Added  | `BlockedByStripeError`     |
| `invalid_payout_method_data`                         | Added  | `InvalidPayoutMethodError` |
| `limit_payout_method`                                | Added  | `QuotaExceededError`       |

#### .NET

この変更は、.NET SDK には影響しません。

## アップグレード

#### REST API

1. Workbench で[現在の API バージョンを表示します](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench)。
1. SDK を使用している場合は、この API バージョンに対応する SDK バージョンにアップグレードします。
   - SDK を使用していない場合は、`Stripe-Version: 2026-01-28.preview` を含めるように [API リクエスト](https://docs.stripe.com/api/versioning.md)を更新してください。
1. [Webhook エンドポイント](https://docs.stripe.com/webhooks/versioning.md)に使用する API バージョンをアップグレードします。
1. 新しいバージョンに対して、[実装内容をテスト](https://docs.stripe.com/testing.md)します。
1. Connect を使用する場合は、[Connect の実装内容をテスト](https://docs.stripe.com/connect/testing.md)します。
1. Workbench で[アップグレードを実行](https://docs.stripe.com/upgrades.md#perform-the-upgrade)します。[バージョンをロールバック](https://docs.stripe.com/upgrades.md#roll-back-your-api-version)できるのは 72 時間以内です。

[Stripe API のアップグレード](https://docs.stripe.com/upgrades.md)について、詳細をご確認ください。

#### Ruby

1. Workbench で[現在の API バージョンを表示します](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench)。
1. Ruby SDK を 最新バージョンにアップグレードします。
1. [Webhook エンドポイント](https://docs.stripe.com/webhooks/versioning.md)に使用する API バージョンをアップグレードします。
1. 新しいバージョンに対して、[実装内容をテスト](https://docs.stripe.com/testing.md)します。
1. Connect を使用する場合は、[Connect の実装内容をテスト](https://docs.stripe.com/connect/testing.md)します。
1. Workbench で[アップグレードを実行](https://docs.stripe.com/upgrades.md#perform-the-upgrade)します。[バージョンをロールバック](https://docs.stripe.com/upgrades.md#roll-back-your-api-version)できるのは 72 時間以内です。

[Stripe API のアップグレード](https://docs.stripe.com/upgrades.md)について、詳細をご確認ください。

#### Python

1. Workbench で[現在の API バージョンを表示します](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench)。
1. Python SDK を 最新バージョンにアップグレードします。
1. [Webhook エンドポイント](https://docs.stripe.com/webhooks/versioning.md)に使用する API バージョンをアップグレードします。
1. 新しいバージョンに対して、[実装内容をテスト](https://docs.stripe.com/testing.md)します。
1. Connect を使用する場合は、[Connect の実装内容をテスト](https://docs.stripe.com/connect/testing.md)します。
1. Workbench で[アップグレードを実行](https://docs.stripe.com/upgrades.md#perform-the-upgrade)します。[バージョンをロールバック](https://docs.stripe.com/upgrades.md#roll-back-your-api-version)できるのは 72 時間以内です。

[Stripe API のアップグレード](https://docs.stripe.com/upgrades.md)について、詳細をご確認ください。

#### PHP

1. Workbench で[現在の API バージョンを表示します](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench)。
1. PHP SDK を 最新バージョンにアップグレードします。
1. [Webhook エンドポイント](https://docs.stripe.com/webhooks/versioning.md)に使用する API バージョンをアップグレードします。
1. 新しいバージョンに対して、[実装内容をテスト](https://docs.stripe.com/testing.md)します。
1. Connect を使用する場合は、[Connect の実装内容をテスト](https://docs.stripe.com/connect/testing.md)します。
1. Workbench で[アップグレードを実行](https://docs.stripe.com/upgrades.md#perform-the-upgrade)します。[バージョンをロールバック](https://docs.stripe.com/upgrades.md#roll-back-your-api-version)できるのは 72 時間以内です。

[Stripe API のアップグレード](https://docs.stripe.com/upgrades.md)について、詳細をご確認ください。

#### Java

1. Workbench で[現在の API バージョンを表示します](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench)。
1. Java SDK を 最新バージョンにアップグレードします。
1. [Webhook エンドポイント](https://docs.stripe.com/webhooks/versioning.md)に使用する API バージョンをアップグレードします。
1. 新しいバージョンに対して、[実装内容をテスト](https://docs.stripe.com/testing.md)します。
1. Connect を使用する場合は、[Connect の実装内容をテスト](https://docs.stripe.com/connect/testing.md)します。
1. Workbench で[アップグレードを実行](https://docs.stripe.com/upgrades.md#perform-the-upgrade)します。[バージョンをロールバック](https://docs.stripe.com/upgrades.md#roll-back-your-api-version)できるのは 72 時間以内です。

[Stripe API のアップグレード](https://docs.stripe.com/upgrades.md)について、詳細をご確認ください。

#### Node.js

1. Workbench で[現在の API バージョンを表示します](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench)。
1. Node SDK を 最新バージョンにアップグレードします。
1. [Webhook エンドポイント](https://docs.stripe.com/webhooks/versioning.md)に使用する API バージョンをアップグレードします。
1. 新しいバージョンに対して、[実装内容をテスト](https://docs.stripe.com/testing.md)します。
1. Connect を使用する場合は、[Connect の実装内容をテスト](https://docs.stripe.com/connect/testing.md)します。
1. Workbench で[アップグレードを実行](https://docs.stripe.com/upgrades.md#perform-the-upgrade)します。[バージョンをロールバック](https://docs.stripe.com/upgrades.md#roll-back-your-api-version)できるのは 72 時間以内です。

[Stripe API のアップグレード](https://docs.stripe.com/upgrades.md)について、詳細をご確認ください。

#### Go

1. Workbench で[現在の API バージョンを表示します](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench)。
1. Go SDK を 最新バージョンにアップグレードします。
1. [Webhook エンドポイント](https://docs.stripe.com/webhooks/versioning.md)に使用する API バージョンをアップグレードします。
1. 新しいバージョンに対して、[実装内容をテスト](https://docs.stripe.com/testing.md)します。
1. Connect を使用する場合は、[Connect の実装内容をテスト](https://docs.stripe.com/connect/testing.md)します。
1. Workbench で[アップグレードを実行](https://docs.stripe.com/upgrades.md#perform-the-upgrade)します。[バージョンをロールバック](https://docs.stripe.com/upgrades.md#roll-back-your-api-version)できるのは 72 時間以内です。

[Stripe API のアップグレード](https://docs.stripe.com/upgrades.md)について、詳細をご確認ください。

#### .NET

1. Workbench で[現在の API バージョンを表示します](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench)。
1. .NET SDK を 最新バージョンにアップグレードします。
1. [Webhook エンドポイント](https://docs.stripe.com/webhooks/versioning.md)に使用する API バージョンをアップグレードします。
1. 新しいバージョンに対して、[実装内容をテスト](https://docs.stripe.com/testing.md)します。
1. Connect を使用する場合は、[Connect の実装内容をテスト](https://docs.stripe.com/connect/testing.md)します。
1. Workbench で[アップグレードを実行](https://docs.stripe.com/upgrades.md#perform-the-upgrade)します。[バージョンをロールバック](https://docs.stripe.com/upgrades.md#roll-back-your-api-version)できるのは 72 時間以内です。

[Stripe API のアップグレード](https://docs.stripe.com/upgrades.md)について、詳細をご確認ください。

## 関連する変更

- [銀行口座と入金方法のリソースに代替参照フィールドを追加](https://docs.stripe.com/changelog/clover/2026-01-28/alternative-reference-field.md)
- [カード入金方法にフィンガープリントプロパティを追加](https://docs.stripe.com/changelog/clover/2026-01-28/card-payout-methods-fingerprint-property.md)
- [Global Payouts が越境入金のサポート対象として 15 カ国を新たに追加](https://docs.stripe.com/changelog/clover/2026-01-28/cross-border-payouts-new-countries.md)