# Fügt Zahlungsaufzeichnungen und Aufzeichnungen zu Zahlungsversuchen hinzu

## Das ändert sich

Fügt [PaymentRecords](https://docs.stripe.com/api/payment-record.md?api-version=2025-10-29.clover) und [PaymentAttemptRecords](https://docs.stripe.com/api/payment-attempt-record.md?api-version=2025-10-29.clover) hinzu, die es ermöglichen, Zahlungen zu erfassen, die außerhalb von Stripe verarbeitet werden. Sie unterstützen außerdem Funktionen wie [Abos](https://docs.stripe.com/subscriptions.md) und [Rechnungen](https://docs.stripe.com/invoicing.md), sodass diese mit Zahlungen über Drittanbieter funktionieren.

## Auswirkungen

Sie können nun Payment Records verwenden, um Zahlungen zu erfassen, die über Ihren eigenen Zahlungsabwickler verarbeitet werden und damit Funktionen wie die folgenden zu nutzen:

- Verwenden Sie Abos und Rechnungen mit [Zahlungen, die außerhalb von Stripe verarbeitet werden](https://docs.stripe.com/billing/subscriptions/third-party-payment-processing.md).
- Erfassen Sie externe Zahlungen in Stripe, damit Sie diese in Ihre Buchhaltung und Berichterstattung einbeziehen können.

## Änderungen

#### REST API

|  | Change | Resources                                                                                                                                                           |
|  | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|  | Added  | [PaymentAttemptRecord](/api/payment-attempt-record/object?api-version=2025-10-29.clover), [PaymentRecord](/api/payment-record/object?api-version=2025-10-29.clover) |

| Endpoints                                                                                                                                                                                                                | Change | Resources                                                                                |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------ | ---------------------------------------------------------------------------------------- |
| `list`, `retrieve`                                                                                                                                                                                                       | Added  | [PaymentAttemptRecord](/api/payment-attempt-record/object?api-version=2025-10-29.clover) |
| `report_payment`, `report_payment_attempt`, `report_payment_attempt_canceled`, `report_payment_attempt_failed`, `report_payment_attempt_guaranteed`, `report_payment_attempt_informational`, `report_refund`, `retrieve` | Added  | [PaymentRecord](/api/payment-record/object?api-version=2025-10-29.clover)                |

#### Ruby

|  | Change | Resources                                                                                                                                                           |
|  | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|  | Added  | [PaymentAttemptRecord](/api/payment-attempt-record/object?api-version=2025-10-29.clover), [PaymentRecord](/api/payment-record/object?api-version=2025-10-29.clover) |

| Methods                                                                                                                                                                                                                  | Change | Resources                                                                                |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------ | ---------------------------------------------------------------------------------------- |
| `list`, `retrieve`                                                                                                                                                                                                       | Added  | [PaymentAttemptRecord](/api/payment-attempt-record/object?api-version=2025-10-29.clover) |
| `report_payment`, `report_payment_attempt`, `report_payment_attempt_canceled`, `report_payment_attempt_failed`, `report_payment_attempt_guaranteed`, `report_payment_attempt_informational`, `report_refund`, `retrieve` | Added  | [PaymentRecord](/api/payment-record/object?api-version=2025-10-29.clover)                |

#### Python

|  | Change | Resources                                                                                                                                                           |
|  | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|  | Added  | [PaymentAttemptRecord](/api/payment-attempt-record/object?api-version=2025-10-29.clover), [PaymentRecord](/api/payment-record/object?api-version=2025-10-29.clover) |

| Methods                                                                                                                                                                                                                  | Change | Resources                                                                                |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------ | ---------------------------------------------------------------------------------------- |
| `list`, `retrieve`                                                                                                                                                                                                       | Added  | [PaymentAttemptRecord](/api/payment-attempt-record/object?api-version=2025-10-29.clover) |
| `report_payment`, `report_payment_attempt`, `report_payment_attempt_canceled`, `report_payment_attempt_failed`, `report_payment_attempt_guaranteed`, `report_payment_attempt_informational`, `report_refund`, `retrieve` | Added  | [PaymentRecord](/api/payment-record/object?api-version=2025-10-29.clover)                |

#### PHP

|  | Change | Resources                                                                                                                                                           |
|  | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|  | Added  | [PaymentAttemptRecord](/api/payment-attempt-record/object?api-version=2025-10-29.clover), [PaymentRecord](/api/payment-record/object?api-version=2025-10-29.clover) |

| Methods                                                                                                                                                                                                                  | Change | Resources                                                                                |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------ | ---------------------------------------------------------------------------------------- |
| `all`, `retrieve`                                                                                                                                                                                                        | Added  | [PaymentAttemptRecord](/api/payment-attempt-record/object?api-version=2025-10-29.clover) |
| `report_payment`, `report_payment_attempt`, `report_payment_attempt_canceled`, `report_payment_attempt_failed`, `report_payment_attempt_guaranteed`, `report_payment_attempt_informational`, `report_refund`, `retrieve` | Added  | [PaymentRecord](/api/payment-record/object?api-version=2025-10-29.clover)                |

#### Java

|  | Change | Resources                                                                                                                                                           |
|  | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|  | Added  | [PaymentAttemptRecord](/api/payment-attempt-record/object?api-version=2025-10-29.clover), [PaymentRecord](/api/payment-record/object?api-version=2025-10-29.clover) |

| Methods                                                                                                                                                                                                                  | Change | Resources                                                                                |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------ | ---------------------------------------------------------------------------------------- |
| `list`, `retrieve`                                                                                                                                                                                                       | Added  | [PaymentAttemptRecord](/api/payment-attempt-record/object?api-version=2025-10-29.clover) |
| `report_payment`, `report_payment_attempt`, `report_payment_attempt_canceled`, `report_payment_attempt_failed`, `report_payment_attempt_guaranteed`, `report_payment_attempt_informational`, `report_refund`, `retrieve` | Added  | [PaymentRecord](/api/payment-record/object?api-version=2025-10-29.clover)                |

#### Node.js

|  | Change | Resources                                                                                                                                                           |
|  | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|  | Added  | [PaymentAttemptRecord](/api/payment-attempt-record/object?api-version=2025-10-29.clover), [PaymentRecord](/api/payment-record/object?api-version=2025-10-29.clover) |

| Methods                                                                                                                                                                                                                  | Change | Resources                                                                                |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------ | ---------------------------------------------------------------------------------------- |
| `list`, `retrieve`                                                                                                                                                                                                       | Added  | [PaymentAttemptRecord](/api/payment-attempt-record/object?api-version=2025-10-29.clover) |
| `report_payment`, `report_payment_attempt`, `report_payment_attempt_canceled`, `report_payment_attempt_failed`, `report_payment_attempt_guaranteed`, `report_payment_attempt_informational`, `report_refund`, `retrieve` | Added  | [PaymentRecord](/api/payment-record/object?api-version=2025-10-29.clover)                |

#### Gehen Sie zu

|  | Change | Resources                                                                                                                                                           |
|  | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|  | Added  | [PaymentAttemptRecord](/api/payment-attempt-record/object?api-version=2025-10-29.clover), [PaymentRecord](/api/payment-record/object?api-version=2025-10-29.clover) |

| Methods                                                                                                                                                                                             | Change | Resources                                                                                |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------ | ---------------------------------------------------------------------------------------- |
| `Get`, `List`                                                                                                                                                                                       | Added  | [PaymentAttemptRecord](/api/payment-attempt-record/object?api-version=2025-10-29.clover) |
| `Get`, `ReportPayment`, `ReportPaymentAttempt`, `ReportPaymentAttemptCanceled`, `ReportPaymentAttemptFailed`, `ReportPaymentAttemptGuaranteed`, `ReportPaymentAttemptInformational`, `ReportRefund` | Added  | [PaymentRecord](/api/payment-record/object?api-version=2025-10-29.clover)                |

#### .NET

|  | Change | Resources                                                                                                                                                           |
|  | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|  | Added  | [PaymentAttemptRecord](/api/payment-attempt-record/object?api-version=2025-10-29.clover), [PaymentRecord](/api/payment-record/object?api-version=2025-10-29.clover) |

| Methods                                                                                                                                                                                             | Change | Resources                                                                                |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------ | ---------------------------------------------------------------------------------------- |
| `Get`, `List`                                                                                                                                                                                       | Added  | [PaymentAttemptRecord](/api/payment-attempt-record/object?api-version=2025-10-29.clover) |
| `Get`, `ReportPayment`, `ReportPaymentAttempt`, `ReportPaymentAttemptCanceled`, `ReportPaymentAttemptFailed`, `ReportPaymentAttemptGuaranteed`, `ReportPaymentAttemptInformational`, `ReportRefund` | Added  | [PaymentRecord](/api/payment-record/object?api-version=2025-10-29.clover)                |

## 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-10-29.clover`
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 [v17.1.0](https://github.com/stripe/stripe-ruby/releases/tag/v17.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).

#### 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 [v13.1.0](https://github.com/stripe/stripe-python/releases/tag/v13.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).

#### 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 [v18.1.0](https://github.com/stripe/stripe-php/releases/tag/v18.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).

#### 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 [v30.1.0](https://github.com/stripe/stripe-java/releases/tag/v30.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 [v19.2.0](https://github.com/stripe/stripe-node/releases/tag/v19.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).

#### 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 [v83.1.0](https://github.com/stripe/stripe-go/releases/tag/v83.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 [v49.1.0](https://github.com/stripe/stripe-dotnet/releases/tag/v49.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).