# Entfernt Refund-Objekte in Abläufen zur teilweisen Erfassung und Stornierung von Zahlungen

## Das ändert sich

Die folgenden Abläufe führen nicht mehr dazu, dass ein `Refund`-Objekt erstellt und mit der Zahlung verknüpft wird:

- Anteilige Erfassung
- Stornierung von Zahlungen (sowohl manuell als auch automatisch)

## Warum ist dies eine wichtige Änderung?

Diese Änderung kann Ihre Integration in den folgenden Szenarien unterbrechen:

- Wenn Ihre Integration eine teilweise Erfassung oder eine Zahlungsstornierung erwartet, um ein Rückerstattungsobjekt zu erstellen.
- Wenn Ihre Integration erwartet, dass eine teilweise Erfassung zwei Guthabentransaktionen erstellt.

Weitere Details zu möglichen Auswirkungen auf Ihre Integration finden Sie in der folgenden Aufschlüsselung.

## Ergebnis

Diese Änderung wirkt sich auf Ihre Integration aus, wenn Sie auf das `Refund`-Objekt oder zugehörige Felder für die Rückerstattung erfasster Zahlungen oder die Stornierung von Zahlungen angewiesen sind. Das Entfernen des `Refund`-Objekts wirkt sich auf die folgenden Felder bzw. Objekte aus.

### Rückerstattungsobjekt

- Ein `Refund`-Objekt, das die Stornierung oder die Rückbuchung einer erfassten Zahlung darstellt, wird nicht mehr erstellt.
- Es wird nicht zurückgegeben, wenn Sie es aufrufen, um alle Rückerstattungen im Zusammenhang mit dem Payment Intent oder der Zahlung zu erhalten.
- Es ist in keinem Webhook-Ereignis vorhanden.
- Es ist nicht für das `Charge`-Objekt in einer API-Antwort vorhanden.
- E ist nicht im Dashboard sichtbar.

### PaymentIntent Objekt

- Es wird ein neuer `cancellation_reason`-Wert `expired` mit der Bezeichnung eingeführt. Dieser neue Wert steht für Zahlungen, die aufgrund einer abgelaufenen Autorisierung storniert wurden. Er ersetzt den zuvor verwendeten Wert von `automatic`.

### Charge-Objekt

- `amount_captured` wird in Abläufen für die Zahlungsstornierung 0 statt `nil` sein.
- `amount_refunded` werden durch diese Aktionen nicht mehr aktualisiert.
- `refunded` ist nicht mehr `true` für Abläufe zur Zahlungsstornierung.

### Saldo-Transaktionen

- Es wird nur eine einzige Saldo-Transaktion für teilweise Erfassungen geben. Es wird keine Saldo-Transaktion mehr geben, die den stornierten Betrag und die stornierten Gebühren darstellt.
- Die Saldo-Transaktion, die die Erfassung darstellt, zeigt den erfassten Betrag anstelle des für die zugehörige Zahlung autorisierten Betrags an.

### Webhooks

- Die Ereignisse `charge.refunded` und `charge.refund.updated` senden wir nicht mehr.
- Wir senden weiterhin die Ereignisse `charge.expired`, `charge.captured` und `payment_intent.canceled` für die entsprechenden Abläufe.

### Überprüfung von Radar-Zahlungen

- Gegebenenfalls wird eine Radar-Zahlungsprüfung nach der Stornierung der Zahlung mit dem Grund `canceled` statt `refunded` geschlossen.

## Änderungen

#### REST API

#### Ruby

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

#### Python

#### PHP

#### Java

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

#### Node.js

#### Go

#### .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: 2025-03-31.basil`
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 [v15.0.0](https://github.com/stripe/stripe-ruby/releases/tag/v15.0.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 [v12.0.0](https://github.com/stripe/stripe-python/releases/tag/v12.0.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 [v17.0.0](https://github.com/stripe/stripe-php/releases/tag/v17.0.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 [v29.0.0](https://github.com/stripe/stripe-java/releases/tag/v29.0.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 [v18.0.0](https://github.com/stripe/stripe-node/releases/tag/v18.0.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 [v82.0.0](https://github.com/stripe/stripe-go/releases/tag/v82.0.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 [v48.0.0](https://github.com/stripe/stripe-dotnet/releases/tag/v48.0.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).

## Zugehörige Änderungen

- [Aktualisiert die Vault and Forward API, um einen 402-Statuscode für Zeitüberschreitungen bei Upstream-Anfragen zurückzugeben](https://docs.stripe.com/changelog/basil/2025-03-31/vault-forward-api-returns-402.md)
- [Entfernt die manuelle Erfassungsmethode für Interac-Karten](https://docs.stripe.com/changelog/basil/2025-03-31/deprecate-interac-present-manual-capture-method.md)
- [Zahlungsmethoden lassen keine Änderung von Feldern für Naver Pay zu, nachdem das Objekt zum ersten Mal erstellt wurde](https://docs.stripe.com/changelog/basil/2025-03-31/naver-pay-payment-method.md)
- [Fügt Unterstützung für Klarna auf der gehosteten Rechnungsseite hinzu](https://docs.stripe.com/changelog/basil/2025-03-31/klarna-send-invoice.md)
- [Bietet die Möglichkeit, gespeicherte Zahlungsmethoden für einmalige Zahlungen auf der gehosteten Rechnungsseite zu konfigurieren](https://docs.stripe.com/changelog/basil/2025-03-31/hosted-payment-method-save.md)
- [Fügt Unterstützung für das Speichern und die Wiederverwendung von Naver Pay-Zahlungsmethoden hinzu](https://docs.stripe.com/changelog/basil/2025-03-31/naver-pay-recurring.md)
- [Fügt Unterstützung für die lokale Zahlungsmethode Billie hinzu](https://docs.stripe.com/changelog/basil/2025-03-31/add-billie.md)
- [Fügt Unterstützung für die lokale Zahlungsmethode Satispay hinzu](https://docs.stripe.com/changelog/basil/2025-03-31/satispay-lpm.md)
- [Macht den Client-Parameter für WeChat Pay bis zur Bestätigung optional](https://docs.stripe.com/changelog/basil/2025-03-31/lient-param-optional-wechatpay-before-confirmation.md)
- [Fügt Unterstützung für die lokale Zahlungsmethode BECS-Lastschriftverfahren in Neuseeland hinzu](https://docs.stripe.com/changelog/basil/2025-03-31/nz-bank-account.md)