Fügt Unterstützung für mehrere (Teil-)Zahlungen auf Rechnungen hinzuWichtige Änderungen

Das ändert sich

Wir unterstützen jetzt mehrere (teilweise) Zahlungen für Rechnungen und Stornorechnungen. Rechnungen unterstützen jetzt auch Überzahlungen und können außerbandmäßige Zahlungen nachverfolgen. Darüber hinaus fügen wir das Feld confirmation_secret im Rechnungsobjekt hinzu, um die Verwendung des Payment Elements besser zu unterstützen.

Warum ist dies eine wichtige Änderung?

• Die Felder payment_intent, charge, paid und paid_out_of_band wurden aus dem Invoice-Objekt entfernt.
• Das Feld Rechnung aus den Objekten PaymentIntent und Zahlung entfernt.
• Die Felder application_fee_amount und transfer_data wurden aus dem Invoice-Objekt entfernt. Für Zahlungen, die über Stripe erfolgen, sind diese Felder nun über das zugrunde liegende PaymentIntent-Objekt zugänglich, indem Sie payments.data.payment.payment_intent im Invoice-Objekt erweitern.
• Das Feld Rückerstattung für das Objekt Stornorechnung wurde verworfen und durch ein Array für Rückerstattungen ersetzt.
• Das Feld amount_paid im Objekt Invoice gibt nun Out-of-Band-Zahlungen wieder.

Ergebnis

Wir haben das Objekt Rechnungszahlung eingeführt, um den Zusammenhang zwischen Zahlungen und Rechnungen darzustellen und frühere Rechnungen und Zahlungen für relevante Objekte entfernt. Stellen Sie sicher, dass Sie Ihre Integration so aktualisieren, dass nicht mehr davon ausgegangen wird, dass eine einzelne Rechnung von einer einzelnen Zahlung beglichen werden muss und verwenden Sie das neue Rechnungszahlung-Objekt, um die Verbindung zwischen Zahlungen und Rechnungen nachzuvollziehen.

Informationen zur Zahlung im Array invoice.payments] prüfen

Sie können invoice.payments bei der Interaktion mit dem Rechnungs-Objekt prüfen, indem Sie die Eigenschaft Zahlungen erweitern:

curl -G https://api.stripe.com/v1/invoices/{INVOICE_ID} \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "expand[]"=payments

Das Array invoice.payments enthält eine Liste aller mit der Rechnung verbundenen Zahlungen sowie deren jeweiligen Zuordnungs- und Zahlungsstatus.

Verwenden Sie die neuen Rechnungszahlung-Endpoints für Zahlungen und die Verknüpfung mit Rechnungen.

Um den Zusammenhang zwischen einem Payment Intent und Rechnungsobjekt zu verstehen, können Sie den EndpointRechnungszahlung auflisten verwenden:

curl -G https://api.stripe.com/v1/invoice_payments \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "payment[type]"=payment_intent \
  -d "payment[payment_intent]"={PAYMENT_INTENT_ID}

confirmation_secret für Payment Element-Integrationen verwenden

Für Payment Element-Integrationen, insbesondere für Abonnement-Integrationen, die bisher auf der Erweiterung von invoice.payment_intent.client_secret oder latest_invoice.payments.data.payment.payment_intent.client_secret beruhten, können Sie jetzt das neue Feld invoice.confirmation_secret.client_secret im Rechnungsobjekt verwenden, indem Sie confirmation_secret erweitern:

curl -G https://api.stripe.com/v1/invoices/{INVOICE_ID} \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "expand[]"=confirmation_secret

Auf application_fee_amount und transfer_data über PaymentIntents zugreifen

Mit dem Entfernen der Felder application_fee_amount und transfer_data aus dem Invoice-Objekt können Sie für über Stripe abgewickelte Zahlungen nun über das zugrunde liegende PaymentIntent-Objekt auf diese Felder zugreifen. Erweitern Sie dazu payments.data.payment.payment_intent, wenn Sie die Rechnung abrufen:

curl -G https://api.stripe.com/v1/invoices/{INVOICE_ID} \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "expand[]"="payments.data.payment.payment_intent"

Sie können dann über das erweiterte PaymentIntent-Objekt auf invoice.payments.data[i].payment.payment_intent.application_fee_amount und invoice.payments.data[i].payment.payment_intent.transfer_data zugreifen. Diese Felder sind nur für Zahlungen verfügbar, die über Stripe abgewickelt werden, wenn der Zahlungstyp payment_intent ist.

Rechnungen mit Out-of-Band-Zahlungen identifizieren

Nach dem Entfernen des Felds paid_out_of_band können Sie jetzt Rechnungen mit Out-of-Band-Zahlungen mit der Eigenschaft invoice.payments identifizieren.

Um zu überprüfen, ob eine Rechnung vollständig außerhalb von Stripe bezahlt wurde, überprüfen Sie, ob der Rechnungsstatus bezahlt, der amount_due größer als 0 und die Summe der Zahlungen vom Typ PaymentIntent im Array invoice.payments gleich 0 ist.

Um zu überprüfen, ob eine Rechnung teilweise außerhalb von Stripe bezahlt wird, überprüfen Sie, ob der amount_due größer als 0 und die Summe der Zahlungen vom Typ PaymentIntent im Array invoice.payments kleiner als der amount_paid ist.

Änderungen

Upgrade