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

Das ändert sich

Wir führen Unterstützung für mehrere (Teil-)Zahlungen für Rechnungen und Stornorechnungen ein. Rechnungen dokumentieren auch Überzahlungen und können jetzt auch Out-of-Band-Zahlungen verfolgen. Außerdem fügen wir das Feld confirmation_secret zum Objekt „Rechnung“ hinzu, um die Unterstützung für die Verwendung des Payment Element zu verbessern.

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 Rechnung-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 Rechnung-Objekt erweitern.
• Das Feld refund im Objekt Stornorechnung wurde eingestellt und durch ein refunds-Array ersetzt.
• Das Feld amount_paid im Objekt Invoice gibt nun Out-of-Band-Zahlungen wieder.

Ergebnis

Wir haben das Rechnungszahlungs-Objekt eingeführt, um die Verbindung zwischen Zahlungen und Rechnungen darzustellen, und frühere Rechnungs- und Zahlungszeiger auf relevante Objekte entfernt. Aktualisieren Sie Ihre Integration so, dass nicht mehr davon ausgegangen wird, dass eine einzelne Rechnung mit einer einzigen Zahlung bezahlt werden muss. Nutzen Sie das neue Objekt für die Rechnungszahlung, um die Verbindung zwischen Zahlungen und Rechnungen zu verstehen.

Das Array invoice.payments auf Zahlungsinformationen überprüfen

Sie können invoice.payments bei der Interaktion mit dem Invoice-Objekt überprüfen, indem Sie die Eigenschaft payments 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 Endpoints für Rechnungszahlungen für Zahlungen und die Verbindung von Rechnungen

Um die Verbindung zwischen einem Payment Intent und einem Rechnungs-Objekt zu verstehen, können Sie den Endpoint zum Auflisten von Rechnungszahlungen 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 Rechnung-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