# Aktualisiert Fehlercodes für die ausgehende Setup Intents API

## Das ändert sich

Aktualisiert die von der [ausgehenden Setup Intents](https://docs.stripe.com/api/v2/money-management/outbound-setup-intents.md?api-version=2026-01-28.preview) API zurückgegebenen [Fehlercodes](https://docs.stripe.com/api/errors.md?api-version=2026-01-28.preview#errors-code), sodass allgemeinere Fehlertypen anstelle von Codes für bestimmte Anmeldedaten verwendet werden. Durch diese Änderung werden mehrere vorhandene Fehlercodes durch standardisierte Fehlertypen ersetzt:

- Die Fehler `blocked_payout_method_bank_account`, `blocked_payout_method_card` und `blocked_payout_method_crypto_wallet` geben nun den Fehler `blocked_payout_method` zurück.
- Die Fehler `unsupported_payout_method_bank_account` und `unsupported_payout_method_card` geben nun den Fehler `unsupported_payout_method` zurück.
- Die Fehler `invalid_payout_method_bank_account`, `invalid_payout_method_card` und `invalid_payout_method_crypto_wallet` geben nun den Fehler `invalid_payout_method` zurück.
- Die Fehler `limit_payout_method_bank_account`, `limit_payout_method_card` und `limit_payout_method_crypto_wallet` geben nun den Fehler `limit_payout_method` zurück.

Diese Standardisierung verbessert die Konsistenz der Fehlerbehandlung bei verschiedenen [Auszahlungsmethoden](https://docs.stripe.com/api/v2/money-management/payout-methods.md?api-version=2026-01-28.preview) und unterstützt die zukünftige Erweiterbarkeit, wenn neue Anmeldedaten zu den Auszahlungsmethoden hinzugefügt werden.

## Warum ist dies eine wichtige Änderung?

Dies ist eine grundlegende Änderung, da Ihre Integration möglicherweise auf den spezifischen Fehlercode-Identifikatoren basiert, die durch dieses Update ersetzt werden. Wenn Ihr Code auf typspezifische Fehlercodes wie `blocked_payout_method_bank_account`, `unsupported_payout_method_bank_account`, `invalid_payout_method_bank_account` oder `limit_payout_method_bank_account` prüft, funktionieren diese Prüfungen nicht mehr und müssen aktualisiert werden, um die generischen Fehlertypen zu verarbeiten.

## Auswirkungen

Falls Ihre Integration bestimmte Fehlercodes von ausgehenden Setup-Intents-Endpoints verarbeitet, müssen Sie Ihre Fehlerbehandlungslogik aktualisieren, um die generischen Fehlertypen zu verwenden. Die Fehlermeldungen und zugrunde liegenden Ursachen bleiben unverändert, jedoch wurden die Fehlercode-Kennungen angepasst, um eine größere Konsistenz zwischen den verschiedenen Auszahlungsmethoden zu gewährleisten.

## Änderungen

#### 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

Diese Änderung wirkt sich nicht auf das Ruby SDK aus.

#### Python

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

#### PHP

Diese Änderung wirkt sich nicht auf das PHP SDK aus.

#### Java

Diese Änderung wirkt sich nicht auf das Java SDK aus.

#### 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

Diese Änderung wirkt sich nicht auf das .NET SDK aus.

## Upgrade

#### REST API

1. [Zeigen Sie Ihre aktuelle API-Version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench an.
1. Wenn Sie ein SDK verwenden, aktualisieren Sie auf die entsprechende SDK-Version für diese API-Version.
   - Wenn Sie kein SDK verwenden, aktualisieren Sie Ihre [API-Anfragen](https://docs.stripe.com/api/versioning.md) auf `Stripe-Version: 2026-01-28.preview`
1. Aktualisieren Sie die für [Webhook-Endpoints](https://docs.stripe.com/webhooks/versioning.md) verwendete API-Version.
1. [Testen Sie Ihre Integration](https://docs.stripe.com/testing.md) mit der neuen Version.
1. Wenn Sie Connect verwenden, [testen Sie Ihre Connect-Integration](https://docs.stripe.com/connect/testing.md).
1. Führen Sie das [Upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade) in Workbench durch. Sie können [die Version für 72 Stunden zurücksetzen](https://docs.stripe.com/upgrades.md#roll-back-your-api-version).

Erfahren Sie mehr über [Stripe-API-Upgrades](https://docs.stripe.com/upgrades.md).

#### Ruby

1. [Zeigen Sie Ihre aktuelle API-Version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench an.
1. Aktualisieren Sie Ihr Ruby SDK auf die neueste Version.
1. Aktualisieren Sie die für [Webhook-Endpoints](https://docs.stripe.com/webhooks/versioning.md) verwendete API-Version.
1. [Testen Sie Ihre Integration](https://docs.stripe.com/testing.md) mit der neuen Version.
1. Wenn Sie Connect verwenden, [testen Sie Ihre Connect-Integration](https://docs.stripe.com/connect/testing.md).
1. Führen Sie das [Upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade) in Workbench durch. Sie können [die Version für 72 Stunden zurücksetzen](https://docs.stripe.com/upgrades.md#roll-back-your-api-version).

Erfahren Sie mehr über [Stripe-API-Upgrades](https://docs.stripe.com/upgrades.md).

#### Python

1. [Zeigen Sie Ihre aktuelle API-Version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench an.
1. Aktualisieren Sie Ihr Python SDK auf die neueste Version.
1. Aktualisieren Sie die für [Webhook-Endpoints](https://docs.stripe.com/webhooks/versioning.md) verwendete API-Version.
1. [Testen Sie Ihre Integration](https://docs.stripe.com/testing.md) mit der neuen Version.
1. Wenn Sie Connect verwenden, [testen Sie Ihre Connect-Integration](https://docs.stripe.com/connect/testing.md).
1. Führen Sie das [Upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade) in Workbench durch. Sie können [die Version für 72 Stunden zurücksetzen](https://docs.stripe.com/upgrades.md#roll-back-your-api-version).

Erfahren Sie mehr über [Stripe-API-Upgrades](https://docs.stripe.com/upgrades.md).

#### PHP

1. [Zeigen Sie Ihre aktuelle API-Version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench an.
1. Aktualisieren Sie Ihr PHP SDK auf die neueste Version.
1. Aktualisieren Sie die für [Webhook-Endpoints](https://docs.stripe.com/webhooks/versioning.md) verwendete API-Version.
1. [Testen Sie Ihre Integration](https://docs.stripe.com/testing.md) mit der neuen Version.
1. Wenn Sie Connect verwenden, [testen Sie Ihre Connect-Integration](https://docs.stripe.com/connect/testing.md).
1. Führen Sie das [Upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade) in Workbench durch. Sie können [die Version für 72 Stunden zurücksetzen](https://docs.stripe.com/upgrades.md#roll-back-your-api-version).

Erfahren Sie mehr über [Stripe-API-Upgrades](https://docs.stripe.com/upgrades.md).

#### Java

1. [Zeigen Sie Ihre aktuelle API-Version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench an.
1. Aktualisieren Sie Ihr Java SDK auf die neueste Version.
1. Aktualisieren Sie die für [Webhook-Endpoints](https://docs.stripe.com/webhooks/versioning.md) verwendete API-Version.
1. [Testen Sie Ihre Integration](https://docs.stripe.com/testing.md) mit der neuen Version.
1. Wenn Sie Connect verwenden, [testen Sie Ihre Connect-Integration](https://docs.stripe.com/connect/testing.md).
1. Führen Sie das [Upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade) in Workbench durch. Sie können [die Version für 72 Stunden zurücksetzen](https://docs.stripe.com/upgrades.md#roll-back-your-api-version).

Erfahren Sie mehr über [Stripe-API-Upgrades](https://docs.stripe.com/upgrades.md).

#### Node.js

1. [Zeigen Sie Ihre aktuelle API-Version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench an.
1. Aktualisieren Sie Ihr Node SDK auf die neueste Version.
1. Aktualisieren Sie die für [Webhook-Endpoints](https://docs.stripe.com/webhooks/versioning.md) verwendete API-Version.
1. [Testen Sie Ihre Integration](https://docs.stripe.com/testing.md) mit der neuen Version.
1. Wenn Sie Connect verwenden, [testen Sie Ihre Connect-Integration](https://docs.stripe.com/connect/testing.md).
1. Führen Sie das [Upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade) in Workbench durch. Sie können [die Version für 72 Stunden zurücksetzen](https://docs.stripe.com/upgrades.md#roll-back-your-api-version).

Erfahren Sie mehr über [Stripe-API-Upgrades](https://docs.stripe.com/upgrades.md).

#### Go

1. [Zeigen Sie Ihre aktuelle API-Version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench an.
1. Aktualisieren Sie Ihr Go SDK auf die neueste Version.
1. Aktualisieren Sie die für [Webhook-Endpoints](https://docs.stripe.com/webhooks/versioning.md) verwendete API-Version.
1. [Testen Sie Ihre Integration](https://docs.stripe.com/testing.md) mit der neuen Version.
1. Wenn Sie Connect verwenden, [testen Sie Ihre Connect-Integration](https://docs.stripe.com/connect/testing.md).
1. Führen Sie das [Upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade) in Workbench durch. Sie können [die Version für 72 Stunden zurücksetzen](https://docs.stripe.com/upgrades.md#roll-back-your-api-version).

Erfahren Sie mehr über [Stripe-API-Upgrades](https://docs.stripe.com/upgrades.md).

#### .NET

1. [Zeigen Sie Ihre aktuelle API-Version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench an.
1. Aktualisieren Sie Ihr .NET SDK auf die neueste Version.
1. Aktualisieren Sie die für [Webhook-Endpoints](https://docs.stripe.com/webhooks/versioning.md) verwendete API-Version.
1. [Testen Sie Ihre Integration](https://docs.stripe.com/testing.md) mit der neuen Version.
1. Wenn Sie Connect verwenden, [testen Sie Ihre Connect-Integration](https://docs.stripe.com/connect/testing.md).
1. Führen Sie das [Upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade) in Workbench durch. Sie können [die Version für 72 Stunden zurücksetzen](https://docs.stripe.com/upgrades.md#roll-back-your-api-version).

Erfahren Sie mehr über [Stripe-API-Upgrades](https://docs.stripe.com/upgrades.md).

## Zugehörige Änderungen

- [Fügt Ressourcen für Bankkonten und Auszahlungsmethoden ein alternatives Referenzfeld hinzu](https://docs.stripe.com/changelog/clover/2026-01-28/alternative-reference-field.md)
- [Fügt Kartenauszahlungsmethoden die Fingerabdruck-Eigenschaft hinzu](https://docs.stripe.com/changelog/clover/2026-01-28/card-payout-methods-fingerprint-property.md)
- [Global Payouts fügt Support für 15 neue Länder für grenzüberschreitende Auszahlungen hinzu](https://docs.stripe.com/changelog/clover/2026-01-28/cross-border-payouts-new-countries.md)