# Auszahlungen mit einer eindeutigen Kennung nachverfolgen ## Das ändert sich Führt ein Feld [trace_id](https://docs.stripe.com/api/payouts/object.md?api-version=2024-11-20.acacia#payout_object-trace_id) für die Ressource [Auszahlung](https://docs.stripe.com/api/payouts.md?api-version=2024-11-20.acacia) ein. [Nachverfolgungs-IDs](https://docs.stripe.com/payouts/trace-id.md) sind eindeutige Kennungen für eine Auszahlung, die unsere Bankpartner erstellen, um Ihnen bei der Nachverfolgung fehlender oder verspäteter Auszahlungen behilflich zu sein. Wenn eine erwartete Auszahlung nach 10 Werktagen noch nicht auf Ihrem Bankkonto eingegangen ist, wenden Sie sich an Ihre Bank, um eine Aktualisierung zu erhalten, und geben Sie die Nachverfolgungs-ID an. For Connect users, you can provide your connected accounts their payout trace IDs by [retrieving them from the Stripe API](https://docs.stripe.com/api/payouts/retrieve.md?api-version=2024-11-20.acacia). Dadurch können Ihre verbundenen Konten ihre verspäteten oder fehlenden Auszahlungen selbst abwickeln, ohne dass ein manueller Support-Eingriff erforderlich ist. Die `trace_id` enthält zwei Unterfelder: [Wert](https://docs.stripe.com/api/payouts/object.md?api-version=2024-11-20.acacia#payout_object-trace_id-value) und [Status](https://docs.stripe.com/api/payouts/object.md?api-version=2024-11-20.acacia#payout_object-trace_id-status): - `value`: Die Zeichenfolge mit der Nachverfolgungs-ID, die wir von unseren Bankpartnern erhalten, wenn eine Auszahlung erfolgt. - `status`: Der aktuelle Status der Nachverfolgungs-ID während des Abrufs von unseren Bankpartnern. | Status | Beschreibung | | ------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `pending` | Nachdem Sie eine Auszahlung als bezahlt markiert haben, versucht Stripe bis zu 10 Tage lang, die Nachverfolgungs-ID vom Bankpartner abzurufen. Während dieser Zeit wird der `status` auf `pending` gesetzt. | | `supported` | Nachdem der Bankpartner die Nachverfolgungs-ID bereitgestellt hat, wird der `status` auf `supported` gesetzt und Stripe aktualisiert den `value`. | | `unsupported` | In einigen Fällen ist die Bereitstellung der Nachverfolgungs-ID nicht möglich, z. B. bei einer fehlgeschlagenen Auszahlung oder einer nicht unterstützten Kombination aus Land und Währung. In diesen Fällen handelt es sich bei dem `status` um `unsupported`. | ## Auswirkungen Sie können die Nachverfolgungs-ID für eine bestimmte Auszahlung erhalten, indem Sie [die Auszahlung abrufen](https://docs.stripe.com/api/payouts/retrieve.md?api-version=2024-11-20.acacia). Für Connect-Nutzer/innen ermöglicht die Angabe der Nachverfolgungs-ID in Ihren verbundenen Konten Folgendes: - Minimieren von Supportanfragen von Ihren verbundenen Konten im Zusammenhang mit verspäteten oder fehlenden Auszahlungen. - Verbessern der Nutzerzufriedenheit, indem die mit Ihrem Konto verbundenen Konten ihre verspäteten oder fehlenden Auszahlungsanfragen bei ihrer Bank selbst bearbeiten können. ## Änderungen #### REST API | Parameter | Change | Resources or endpoints | | ---------- | ------ | ----------------------------------------------------------- | | `trace_id` | Added | [Payout](/api/payouts/object?api-version=2024-11-20.acacia) | #### Ruby Diese Änderung wirkt sich nicht auf das Ruby SDK aus. #### Python | Parameter | Change | Resources or methods | | ---------- | ------ | ------------------------------------------------------------------ | | `trace_id` | Added | [stripe.Payout](/api/payouts/object?api-version=2024-11-20.acacia) | #### PHP | Parameter | Change | Resources or methods | | ---------- | ------ | ----------------------------------------------------------- | | `trace_id` | Added | [Payout](/api/payouts/object?api-version=2024-11-20.acacia) | #### Java | Parameter | Change | Resources or methods | | ---------- | ------ | ----------------------------------------------------------- | | `trace_id` | Added | [Payout](/api/payouts/object?api-version=2024-11-20.acacia) | #### Node.js | Parameter | Change | Resources or methods | | ---------- | ------ | ----------------------------------------------------------- | | `trace_id` | Added | [Payout](/api/payouts/object?api-version=2024-11-20.acacia) | #### Go | Parameter | Change | Resources or methods | | --------- | ------ | ----------------------------------------------------------- | | `TraceID` | Added | [Payout](/api/payouts/object?api-version=2024-11-20.acacia) | #### .NET | Parameter | Change | Resources or methods | | --------- | ------ | ----------------------------------------------------------- | | `TraceId` | Added | [Payout](/api/payouts/object?api-version=2024-11-20.acacia) | ## 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: 2024-11-20.acacia` 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 [v13.2.0](https://github.com/stripe/stripe-ruby/releases/tag/v13.2.0) 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 [v11.3.0](https://github.com/stripe/stripe-python/releases/tag/v11.3.0) 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 [v16.3.0](https://github.com/stripe/stripe-php/releases/tag/v16.3.0) 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 [v28.1.0](https://github.com/stripe/stripe-java/releases/tag/v28.1.0) 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 [v17.4.0](https://github.com/stripe/stripe-node/releases/tag/v17.4.0) 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 [v81.1.0](https://github.com/stripe/stripe-go/releases/tag/v81.1.0) 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 [v47.1.0](https://github.com/stripe/stripe-dotnet/releases/tag/v47.1.0) 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).