# Fügt SDK-Unterstützung für Nachverfolgungs-IDs hinzu

## Das ändert sich

Fügt SDK-Unterstützung für das Feld `trace_id` am [Payout-Objekt](https://docs.stripe.com/api/payouts/object.md?api-version=2024-12-18.acacia#payout_object-trace_id) hinzu.

Bankpartner erstellen die [Nachverfolgungs-ID](https://docs.stripe.com/payouts/trace-id.md) für Auszahlungen. Mithilfe dieser IDs können Sie fehlende oder verzögerte Auszahlungen bei Ihrer Bank nachverfolgen.

## Ergebnis

Sie können jetzt mithilfe des Stripe SDK auf die `trace_id` der Auszahlung zugreifen.

Für Connect-Nutzerinnen und -Nutzer können Sie Ihren verbundenen Konten deren Nachverfolgungs-IDs bereitstellen, indem Sie [eine Auszahlung abrufen](https://docs.stripe.com/api/payouts/retrieve.md?api-version=2024-12-18.acacia). Ihre verbundenen Konten können dann diese ID verwenden, um verspätete oder fehlende Auszahlungen selbstständig zu klären – ohne dass manuelle Supportunterstützung erforderlich ist.

## Änderungen

#### REST API

| Field | Change | From → to |
| --- | --- | --- |
| `Payout.trace_id` | Changed | `optional → required` |

#### Ruby

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

#### Python

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

#### PHP

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

#### Java

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

#### Node.js

| Field | Change | From → to |
| --- | --- | --- |
| `Payout.trace_id` | Changed | `optional → required` |

#### Go

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

#### .NET

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

## Upgrade

#### REST API

1. [Rufen Sie Ihre aktuelle API-Version](https://docs.stripe.com/workbench/guides.md#view-api-versions) in Workbench ab.
2. Wenn Sie ein SDK verwenden, aktualisieren Sie auf die entsprechende SDK-Version für diese API-Version.
   - Falls Sie kein SDK verwenden, passen Sie Ihre [API-Anfragen](https://docs.stripe.com/api-versions.md#how-versions-are-specified-in-requests) so an, dass sie `Stripe-Version: 2024-12-18.acacia` enthalten.
3. Aktualisieren Sie die für [Webhook-Endpoints](https://docs.stripe.com/webhooks/versioning.md) verwendete API-Version.
4. [Testen Sie Ihre Integration](https://docs.stripe.com/testing.md) mit der neuen Version.
5. Wenn Sie Connect verwenden, [testen Sie Ihre Connect-Integration](https://docs.stripe.com/connect/testing.md).

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.
2. Aktualisieren Sie Ihr Ruby SDK auf [v13.3.0](https://github.com/stripe/stripe-ruby/releases/tag/v13.3.0)
3. Aktualisieren Sie die für [Webhook-Endpoints](https://docs.stripe.com/webhooks/versioning.md) verwendete API-Version.
4. [Testen Sie Ihre Integration](https://docs.stripe.com/testing.md) mit der neuen Version.
5. Wenn Sie Connect verwenden, [testen Sie Ihre Connect-Integration](https://docs.stripe.com/connect/testing.md).
6. 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.
2. Aktualisieren Sie Ihr Python SDK auf [v11.4.0](https://github.com/stripe/stripe-python/releases/tag/v11.4.0)
3. Aktualisieren Sie die für [Webhook-Endpoints](https://docs.stripe.com/webhooks/versioning.md) verwendete API-Version.
4. [Testen Sie Ihre Integration](https://docs.stripe.com/testing.md) mit der neuen Version.
5. Wenn Sie Connect verwenden, [testen Sie Ihre Connect-Integration](https://docs.stripe.com/connect/testing.md).
6. 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.
2. Aktualisieren Sie Ihr PHP SDK auf [v16.4.0](https://github.com/stripe/stripe-php/releases/tag/v16.4.0)
3. Aktualisieren Sie die für [Webhook-Endpoints](https://docs.stripe.com/webhooks/versioning.md) verwendete API-Version.
4. [Testen Sie Ihre Integration](https://docs.stripe.com/testing.md) mit der neuen Version.
5. Wenn Sie Connect verwenden, [testen Sie Ihre Connect-Integration](https://docs.stripe.com/connect/testing.md).
6. 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.
2. Aktualisieren Sie Ihr Java SDK auf [v28.2.0](https://github.com/stripe/stripe-java/releases/tag/v28.2.0)
3. Aktualisieren Sie die für [Webhook-Endpoints](https://docs.stripe.com/webhooks/versioning.md) verwendete API-Version.
4. [Testen Sie Ihre Integration](https://docs.stripe.com/testing.md) mit der neuen Version.
5. Wenn Sie Connect verwenden, [testen Sie Ihre Connect-Integration](https://docs.stripe.com/connect/testing.md).
6. 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.
2. Aktualisieren Sie Ihr Node SDK auf [v17.5.0](https://github.com/stripe/stripe-node/releases/tag/v17.5.0)
3. Aktualisieren Sie die für [Webhook-Endpoints](https://docs.stripe.com/webhooks/versioning.md) verwendete API-Version.
4. [Testen Sie Ihre Integration](https://docs.stripe.com/testing.md) mit der neuen Version.
5. Wenn Sie Connect verwenden, [testen Sie Ihre Connect-Integration](https://docs.stripe.com/connect/testing.md).
6. 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.
2. Aktualisieren Sie Ihr Go SDK auf [v81.2.0](https://github.com/stripe/stripe-go/releases/tag/v81.2.0)
3. Aktualisieren Sie die für [Webhook-Endpoints](https://docs.stripe.com/webhooks/versioning.md) verwendete API-Version.
4. [Testen Sie Ihre Integration](https://docs.stripe.com/testing.md) mit der neuen Version.
5. Wenn Sie Connect verwenden, [testen Sie Ihre Connect-Integration](https://docs.stripe.com/connect/testing.md).
6. 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.
2. Aktualisieren Sie Ihr .NET SDK auf [v47.2.0](https://github.com/stripe/stripe-dotnet/releases/tag/v47.2.0)
3. Aktualisieren Sie die für [Webhook-Endpoints](https://docs.stripe.com/webhooks/versioning.md) verwendete API-Version.
4. [Testen Sie Ihre Integration](https://docs.stripe.com/testing.md) mit der neuen Version.
5. Wenn Sie Connect verwenden, [testen Sie Ihre Connect-Integration](https://docs.stripe.com/connect/testing.md).
6. 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

- [Neue Guthabentransaktionstypen hinzugefügt, um das Mindestguthaben zu unterstützen](https://docs.stripe.com/changelog/acacia/2024-12-18/payout-minimum-balance.md)