Auf die neuesten flexiblen Zahlungsszenarien umstellen
Passen Sie Ihre erweiterten Beta-Zahlungsszenarien an die allgemeine Version an.
Stripe now supports several flexible payment scenarios for non-card-present transactions. If you’ve already integrated the private beta version of any of these features, this guide provides details to upgrade to the general release. For new integrations, use the following guides for the features that interest you:
- Eine Autorisierung schrittweise erhöhen
- Mehr als den autorisierten Betrag erfassen
- Online-Kartenzahlung länger zurückhalten
- Eine Zahlung mehrmals erfassen
Wir haben die folgenden auf Feedback basierenden Verbesserungen an diesen Funktionen vorgenommen:
- Detaillierte Kontrolle über die Funktionen auf der Ebene des PaymentIntent.
- Klarere Erwartungen in Bezug auf die Verfügbarkeit und Nutzung von Funktionen nach einer Bestätigungsphase.
Für jede der flexiblen Zahlungsfunktionen gelten andere Anforderungen als für die Private Beta-Integration. Wählen Sie die Funktion aus, die Sie aktualisieren möchten, und lesen Sie den Hinweis oben bezüglich der Änderungen und Anforderungen, die für diese Funktion gelten.
Änderungen gegenüber der Beta
Der erste Schritt dieser Integration ist jetzt obligatorisch.
Inkrementeller Autorisierung anfordern![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Ihr PaymentIntent muss vor der Bestätigung eine Aufforderung zur inkrementellen Autorisierung enthalten.
Achtung
Dieser vormals optionale Schritt ist jetzt obligatorisch.
Die Antwort gibt jetzt den Status der inkrementellen Autorisierungsanfrage in der Eigenschaft payment_
der latest_charge zurück. Der Statuswert ist available
oder unavailable
je nach Zahlungsmethode des Kunden/der Kundin.
// PaymentIntent Response { "id": "pi_ANipwO3zNfjeWODtRPIg", "object": "payment_intent", "amount": 1000, "amount_capturable": 1000, "amount_received": 0, ... // if latest_charge is expanded { "latest_charge": { "amount": 1000, "payment_method_details": { "card": { "incremental_authorization_supported": true // or false } } ... } } }
// PaymentIntent Response { "id": "pi_ANipwO3zNfjeWODtRPIg", "object": "payment_intent", "amount": 1000, "amount_capturable": 1000, "amount_received": 0, ... // if latest_charge is expanded { "latest_charge": { "amount": 1000, "payment_method_details": { "card": { "incremental_authorization": { "status": "available" // or "unavailable" } } } ... } } }
Autorisierten Betrag schrittweise ändern![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Im Vergleich zur Beta-Version wurden an diesem Schritt keine Änderungen vorgenommen.
Wählen Sie aus, wie Sie mehr als den ursprünglich autorisierten Betrag erfassen möchten![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Zwei der flexiblen Zahlungsfunktionen ermöglichen es Ihnen, einen höheren als den ursprünglich autorisierten Betrag zu erfassen:
- Übererfassung bis zu einem bestimmten Limit (Mehr als den autorisierten Betrag einer Zahlung erfassen)
- Erhöhen Sie die bestehende Autorisierung und erfassen Sie dann den neu autorisierten Betrag (Autorisierung erhöhen)
Das folgende Beispiel zeigt, wie sich diese Funktionen in der allgemein verfügbaren Version ergänzen können.
// PaymentIntent Response { "object": "payment_intent", "amount": 1000, ... // if latest_charge is expanded { "latest_charge": { "payment_method_details": { "card": { "incremental_authorization": { "status": "available" // or "unavailable" }, "overcapture": { "status": "available", // or "unavailable" "maximum_capturable_amount": 1200 } } } ... } } }
Wenn beide Funktionen verfügbar sind, haben Sie nach derBestätigung des PaymentIntent bei den nächsten Schritten die Möglichkeit, einen höheren als den ursprünglich autorisierten Betrag zu erfassen:
- Führen Sie eine Übererfassung durch, wenn der gewünschte Betrag kleiner oder gleich dem
maximum_
ist.capturable_ amount - Führen Sie eine inkrementelle Autorisierung bis zum gewünschten Betrag durch und führen Sie dann die Erfassung durch.