Weiter zum Inhalt
Konto erstellen oder anmelden
Das Logo der Stripe-Dokumentation
/
KI fragen
Konto erstellenAnmelden
Jetzt starten
Zahlungen
Umsatz
Plattformen und Marktplätze
Geldmanagement
Entwicklerressourcen
APIs und SDKsHilfe
Übersicht
Versionierung
Änderungsprotokoll
    Übersicht
    Clover
    Basilikum
    Acacia
    Vorherige Versionen
Aktualisieren Sie Ihre API-Version
Ihre SDK-Version aktualisieren
Essentials
SDKs
API
Tests
Stripe-CLI
Beispiel-Projekte
Tools
Stripe Dashboard
Workbench
Entwickler-Dashboard
Stripe Shell
Stripe für Visual Studio Code
Funktionen
Arbeitsabläufe
Ereignisziele
Stripe-StatuswarnungenHochgeladene Dateien
KI-Lösungen
Agent-Toolkit
Model Context ProtocolAgentische KI-SaaS-Billing-Workflows aufbauen
Sicherheit und Datenschutz
Sicherheit
Stripebot-Webcrawler
Datenschutz
Extend Stripe
Erstellen Sie Stripe-Apps
Verwenden Sie Apps von Stripe
Partner
Partner-Ecosystem
Partner-Zertifizierung
Vereinigte Staaten
Deutsch
StartseiteEntwicklerressourcenChangelogClover2025-10-29.clover

Notiz

Bis jetzt ist diese Seite noch nicht in dieser Sprache verfügbar. Wir arbeiten aber verstärkt daran, unsere Dokumentation in weiteren Sprachen bereitzustellen, und werden die Übersetzung sofort anzeigen, sobald diese verfügbar ist.

Adds support for using Payment Records with Invoices and Credit Notes

What’s new

Adds support for attaching Payment Records to Invoices and creating Credit Notes against Payment Record refunds. That lets you integrate with third-party payment processors while maintaining accurate accounting records in Stripe.

Impact

Attach Payment Records to Invoices

You can now record payments processed through third-party processors by using the Attach Payment API to attach Payment Records to Invoices:

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/invoices/{INVOICE_ID}/attach_payment \ -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"
\ -d payment_record={PAYMENT_RECORD_ID} \ -d "expand[]"=payments

Create Credit Notes for Payment Record refunds

You can now maintain accurate accounting records by creating Credit Notes to represent refunds made through third-party processors. When you create a Credit Note, provide the ID of the Payment Record associated with the refund:

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/credit_notes \ -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"
\ -d invoice={INVOICE_ID} \ -d "refunds[0][type]"=payment_record_refund \ -d "refunds[0][payment_record_refund][payment_record]"={PAYMENT_RECORD_ID} \ -d "refunds[0][payment_record_refund][refund_group]"={REFUND_REFERENCE_ID}

For more information about issuing credit notes, see the Create Credit Notes API.

Changes

ParameterÄndernRessourcen oder Endpoints
payment_record_refundtypeHinzugefügt
CreditNote#create.refunds[]CreditNote#preview.refunds[]CreditNote#preview_lines.refunds[]
 + 1 weitere
CreditNote.refunds[]
payment_recordHinzugefügt
Invoice#attach_paymentInvoicePayment#list.paymentInvoicePayment.payment
WerteÄndernAufzählungen
payment_recordHinzugefügt
InvoicePayment.payment.type
customHinzugefügt
Invoice#update.payment_settingsInvoice#create.payment_settingsInvoice.payment_settings
 + 3 weitere
Subscription#update.payment_settingsSubscription#create.payment_settingsSubscription.payment_settings
FeldÄndernVon → bis
InvoicePayment#list.payment.typeGeändert
literal('payment_intent') → enum('payment_intent'|'payment_record')

Upgrade

  1. View your current API version in Workbench.
  2. If you use an SDK, upgrade to the corresponding SDK version for this API version.
    • If you don’t use an SDK, update your API requests to include Stripe-Version: 2025-10-29.clover
  3. Upgrade the API version used for webhook endpoints.
  4. Test your integration against the new version.
  5. If you use Connect, test your Connect integration.
  6. In Workbench, perform the upgrade. You can roll back the version for 72 hours.

Learn more about Stripe API upgrades.

Related changes

  • Updates the category field of Credit Grants to be optional
  • Adds a webhook event type for Invoices that require a non-Stripe payment
War diese Seite hilfreich?
JaNein
  • Benötigen Sie Hilfe? Kontaktieren Sie den Kundensupport.
  • Schauen Sie sich unser Änderungsprotokoll an.
  • Fragen? Sales-Team kontaktieren.
  • LLM? Lesen Sie llms.txt.
  • Unterstützt von Markdoc