# Fügt allgemeine Fehlertypen für Auszahlungsmethoden hinzu

## Das ändert sich

Fügt die folgenden allgemeinen Fehlercodes hinzu, die spezifische Fehlercodes für einzelne [Auszahlungsmethodenaktionen](https://docs.stripe.com/api/v2/money-management/payout-methods.md?api-version=2025-12-15.preview) ersetzen:

- `payout_method_cannot_be_updated`
- `payout_method_cannot_be_archived`
- `payout_method_cannot_be_unarchived`

Fügt außerdem einen allgemeinen Fehlertyp `controlled_by_alternate_resource` für Änderungen an Ressourcen hinzu, die von einer anderen API-Ressource gesteuert werden.

## Warum ist dies eine wichtige Änderung?

Mit der Umstellung von typspezifischen Fehlern für Auszahlungsmethoden auf generische Fehler müssen Sie Ihre Fehlerbehandlung an diese Codes anpassen. Wenn Ihre Integration nach Fehlertypen verzweigt, müssen Sie außerdem die Behandlung des neuen Fehlertyps `controlled_by_alternate_resource` hinzufügen.

## Auswirkungen

Sie können in Ihren Integrationen, die Auszahlungsmethoden verwenden, jetzt die generischen Fehlertypen nutzen. Mit generischen Fehlertypen müssen Sie keine typspezifischen Fehlercodes mehr behandeln, wenn neue Typen eingeführt werden.

## Änderungen

#### REST API

| Codes | Change |                                    |
| ----- | ------ | ---------------------------------- |
|       | Added  | `controlled_by_alternate_resource` |

#### Ruby

| Codes | Change |                                      |
| ----- | ------ | ------------------------------------ |
|       | Added  | `ControlledByAlternateResourceError` |

#### Python

| Codes | Change |                                      |
| ----- | ------ | ------------------------------------ |
|       | Added  | `ControlledByAlternateResourceError` |

#### PHP

| Codes | Change |                                          |
| ----- | ------ | ---------------------------------------- |
|       | Added  | `ControlledByAlternateResourceException` |

#### Java

| Codes | Change |                                          |
| ----- | ------ | ---------------------------------------- |
|       | Added  | `ControlledByAlternateResourceException` |

#### Node.js

| Codes | Change |                                      |
| ----- | ------ | ------------------------------------ |
|       | Added  | `ControlledByAlternateResourceError` |

#### Go

| Codes | Change |                                      |
| ----- | ------ | ------------------------------------ |
|       | Added  | `ControlledByAlternateResourceError` |

#### .NET

| Codes | Change |                                          |
| ----- | ------ | ---------------------------------------- |
|       | Added  | `ControlledByAlternateResourceException` |

## 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: 2025-12-15.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 [v18.2.0-beta.1](https://github.com/stripe/stripe-ruby/releases/tag/v18.2.0-beta.1)
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 [v14.2.0b1](https://github.com/stripe/stripe-python/releases/tag/v14.2.0b1)
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 [v19.2.0-beta.1](https://github.com/stripe/stripe-php/releases/tag/v19.2.0-beta.1)
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 [v31.2.0-beta.1](https://github.com/stripe/stripe-java/releases/tag/v31.2.0-beta.1)
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 [v20.2.0-beta.1](https://github.com/stripe/stripe-node/releases/tag/v20.2.0-beta.1)
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 [v84.2.0-beta.1](https://github.com/stripe/stripe-go/releases/tag/v84.2.0-beta.1)
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 [v50.2.0-beta.1](https://github.com/stripe/stripe-dotnet/releases/tag/v50.2.0-beta.1)
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

- [Die Erstellung einer Auszahlungsmethode löst nun ein Ereignis aus](https://docs.stripe.com/changelog/clover/2025-12-15/payout-method-created-event.md)
- [Global Payouts fügt Unterstützung für 13 neue Länder für grenzüberschreitende Auszahlungen hinzu](https://docs.stripe.com/changelog/clover/2025-12-15/cross-border-payouts-new-countries.md)