Erfassen Sie mehr als den autorisierten Betrag für eine Zahlung
Verwenden Sie Übererfassungen, um mehr als den für einen PaymentIntent autorisierten Betrag zu erfassen.
Durch Übererfassung können Sie bei einer Kartenzahlung einen höheren Betrag als den autorisierten Betrag erfassen. Im Gegensatz zu inkrementellen Autorisierungen resultiert die Übererfassung nicht in zusätzlichen Autorisierungen bei den Kartennetzwerken. Wenn Sie ein PaymentIntent übererfassen, sieht Ihr Kunde/Ihre Kundin keine sofortigen Aktualisierungen auf seiner/ihrer Kreditkartenabrechnung. Nachdem der erfasste Betrag beglichen ist, wird die ursprünglich ausstehende Autorisierung durch den endgültig erfassten Betrag ersetzt.
Verfügbarkeit
Beachten Sie bei der Verwendung einer Übererfassung folgende Einschränkungen:
- Nur verfügbar mit Visa, Mastercard, American Express oder Discover.
- Nur für Online-Kartenzahlungen geeignet. Bei persönlichen Kartenzahlungen lesen Sie bitte Trinkgelder einziehen.
- Karte begrenzen den Betrag, den Sie übererfassen können (der in der Regel als Prozentsatz des autorisierten Betrags berechnet wird) und legen zusätzliche Beschränkungen fest, einschließlich Beschränkungen des Landes, des Kartentyps und der Händlerkategorie (siehe unten).
- Modus ist auf
payment
und capture_method in der CheckoutSession ist aufmanual
gesetzt.
IC+-Funktion
Mit dem Preismodell IC+ erhalten Nutzer/innen Zugriff auf Übererfassungen. Wenn Sie ein Standard-Stripe-Preismodell nutzen und auf diese Funktion zugreifen möchten, erfahren Sie mehr unter support.stripe.com.
Verfügbarkeit nach Kartennetzwerk, Händlerland und Händlerkategorie
Marke der Karte | Land der Händlerin/des Händlers | Händlerkategorie | Prozentlimit |
---|---|---|---|
Visa* | Global | Taxiunternehmen und Limousinen; Gaststätten und Restaurants, Schankwirtschaften (alkoholische Getränke), Fastfood-Restaurants, Schönheitssalons und Herrenfriseure; Gesundheits- und Wellnesseinrichtungen | +20 % |
Global | Autovermietung | Mehr als +15 % oder +75 USD (oder den Gegenwert in lokaler Währung) | |
Global | Unterkunft; Kreuzfahrtunternehmen | +15 % | |
Global** | Alle anderen Händlerkategorien | +15 % | |
Mastercard | USA*** | Gaststätten und Restaurants; Fastfood-Restaurants | |
American Express | Global**** | Gaststätten und Restaurants, Schankwirtschaften (alkoholische Getränke), Fastfood-Restaurants | |
Global | Taxiunternehmen und Limousinen; Schönheitssalons und Herrenfriseure; Gesundheits- und Wellnesseinrichtungen | +20 % | |
Global | Unterkunft; Autovermietung; Vermietung von Lastkraftwagen und Nutzanhängern; Vermietung von Wohnmobilen und Freizeitfahrzeugen; Lebensmittelgeschäfte; Einzelhandel | +15 % | |
Discover | Global | Taxiunternehmen und Limousinen; Gaststätten und Restaurants, Schankwirtschaften (alkoholische Getränke), Fastfood-Restaurants, Schönheitssalons und Herrenfriseure; Gesundheits- und Wellnesseinrichtungen | +20 % |
Global | Unterkunft; Autovermietung | +15 % |
** Für von Karteninhaber/innen initiierte Transaktionen
***Die Karte muss auch in den USA ausgestellt sein
**** Der Schwellenwert für Zahlungen per Debit- und Prepaid-Karte beträgt 20 %
Netzwerke mit eingeschränktem Support (Beta)
Übererfassung mit starker Kundenauthentifizierung (SCA)
Wenn Sie und der/die Karteninhaber/in sich in einem Land befinden, in dem die starke Kundenauthentifizierung (SCA) erforderlich ist, beachten Sie die Einschränkungen der Verfügbarkeit von Übererfassungen.
- Entsprechend den SCA-Anforderungen müssen Sie in der Regel einen Betrag authentifizieren, der größer oder gleich dem Betrag ist, den Sie letztendlich erfassen. Aus diesem Grund müssen Sie sich für den höchsten geschätzten Betrag, den Sie erfassen möchten, authentifizieren und autorisieren, anstatt wie an anderer Stelle auf dieser Seite beschrieben eine Übererfassung zu verwenden. Anschließend können Sie bis zum vollständigen authentifizierten Betrag erfassen, abhängig vom Gesamtbetrag für die bereitgestellten Waren oder Dienstleistungen. Wenn Sie einen Betrag erfassen müssen, der über den ursprünglich autorisierten und authentifizierten Betrag hinausgeht, müssen Sie die ursprüngliche Zahlung stornieren und eine neue mit dem korrekten Betrag erstellen. Es gibt jedoch einige Ausnahmen von dieser Anforderung (siehe unten).
- Es gibt eine Reihe von Ausnahmen für Transaktionen für die starke Kundenauthentifizierung, bei denen eine Übererfassung zulässig sein kann. Beispielsweise sind von Händlern/Händlerinnen initiierte Transaktionen (MIT), bei denen der Kunde/die Kundin während des Bezahlvorgangs nicht physisch anwesend ist, potenziell ausgenommen. Erfahren Sie, wann eine Transaktion als händlerinitiiert eingestuft werden sollte.
Sie müssen sich mit der gesamten Dokumentation vertraut machen, um ein umfassendes Verständnis der Anforderungen im Zusammenhang mit der Übererfassung und der starke Kundenauthentifizierung (SCA) zu erlangen. Weitere Informationen finden Sie in unserem SCA-Leitfaden.
Sie können das Feld custom_text verwenden, wenn Sie eine neue CheckoutSession erstellen, um zusätzlichen Text auf der Bezahlseite anzuzeigen, um die Compliance-Anforderungen zu erfüllen.
Compliance
Sie sind für die Einhaltung aller geltenden Gesetze, Vorschriften und Netzwerkregeln verantwortlich, wenn Sie die Übererfassung nutzen. Lesen Sie die Regeln für die Kartennetzwerke, für die Sie diese Funktion verwenden möchten, um sicherzustellen, dass Ihre Verkäufe den geltenden Regeln entsprechen, die je nach Netzwerk variieren. Beispielsweise erlauben einige Kartennetzwerke keine Übererfassung für Transaktionen, bei denen der endgültige Transaktionsbetrag zum Zeitpunkt der Autorisierung bekannt sein sollte.
Die auf dieser Seite bereitgestellten Informationen im Zusammenhang mit der Einhaltung dieser Anforderungen dienen Ihrer allgemeinen Orientierung und stellen keine rechtliche, steuerliche, buchhalterische oder sonstige fachliche Beratung dar. Wenden Sie sich an eine Fachperson, wenn Sie sich bezüglich Ihrer Verpflichtungen unsicher sind.
Checkout-Sitzung erstellen
Fügen Sie Ihrer Website eine Schaltfläche zum Bezahlen hinzu, über die ein serverseitiger Endpoint aufgerufen wird, um eine Checkout-Sitzung zu erstellen.
<html> <head> <title>Buy cool new product</title> </head> <body> <!-- Use action="/create-checkout-session.php" if your server is PHP based. --> <form action="/create-checkout-session" method="POST"> <button type="submit">Checkout</button> </form> </body> </html>
Eine Checkout-Sitzung ist eine programmgesteuerte Darstellung dessen, was Ihren Kundinnen und Kunden bei der Weiterleitung zum Zahlungsformular angezeigt wird. Sie können es mit Optionen wie den folgenden konfigurieren:
- Posten für die Zahlungsabwicklung
- Zu verwendende Währungen
Sie müssen success_
mit dem URL-Wert einer Seite auf Ihrer Website ausfüllen, an die Checkout Ihre Kundinnen und Kunden nach Abschluss der Zahlung zurückleitet. Optional können Sie auch einen cancel_
-Wert einer Seite auf Ihrer Website angeben, zu der Checkout Ihre Kundinnen/Kunden zurückleitet, wenn sie den Zahlungsvorgang vor Zahlungsabschluss abbrechen.
Notiz
Checkout-Sitzungen laufen standardmäßig 24 Stunden nach Erstellung ab.
Leiten Sie Ihre Kundinnen und Kunden nach dem Erstellen einer Checkout-Sitzung zu der in der Antwort zurückgegebenen URL weiter.
Um die Übererfassungsfunktion zu aktivieren, legen Sie request_overcapture auf if_
fest.
Nachdem der Kunde/die Kundin den Bezahlvorgang abgeschlossen hat, sehen Sie sich das Feld overcapture.status auf der latest_charge im PaymentIntent an, um zu bestimmen, ob für die Zahlung basierend auf der Verfügbarkeit eine Übererfassung verfügbar ist. Falls available
, gibt das Feld maximum_amount_capturable den maximal erfassbaren Betrag für den PaymentIntent an. Falls unavailable
, ist der maximum_amount_capturable der autorisierte Betrag.
// PaymentIntent response { "id": "pi_xxx", "object": "payment_intent", "amount": 1000, "amount_capturable": 1000, "amount_received": 0, "status": "requires_capture", ... // if latest_charge is expanded "latest_charge": { "id": "ch_xxx", "object": "charge", "payment_method_details": { "card": { "amount_authorized": 1000 "overcapture": { "status": "available", // or "unavailable" "maximum_amount_capturable": 1200 } } } ... } ... }
PaymentIntent erfassen
Wenn Sie einen Betrag für einen PaymentIntent erfassen möchten, der über dem autorisierten Betrag liegt, verwenden Sie den capture-Endpoint und geben einen amount_to_capture-Wert bis zu maximum_amount_capturable an.
Wenn Sie einen Betrag erfassen müssen, der größer ist als der maximum_
, führen Sie eine inkrementelle Autorisierung durch, um den autorisierten Betrag ggf. zu erhöhen.
Die Felder amount_capturable und amount_received werden in der PaymentIntent-Erfassungsantwort entsprechend aktualisiert. Der erfasste PaymentIntent, der zurückgegeben wird, hat einen aktualisierten Betrag, der den für diese Zahlung verschobenen Gesamtbetrag widerspiegelt. Verwenden Sie das Feld amount_authorized für die zugehörige Zahlung, um auf den anfänglich autorisierten Betrag für eine erfolgreich übererfasste Zahlung zu verweisen.
// PaymentIntent response { "id": "pi_xxx", "object": "payment_intent", "amount": 1200, "amount_capturable": 0, "amount_received": 1200, "status": "succeeded", ... // if latest_charge is expanded "latest_charge": { "id": "ch_xxx", "object": "charge", "payment_method_details": { "card": { "amount_authorized": 1000, "overcapture": { "maximum_amount_capturable": 1200, "status": "available" // or "unavailable" } } } ... } ... }
Ihre Integration testen
Verwenden Sie die unten aufgeführten Stripe-Testkarten mit einer beliebigen Prüfziffer (CVC) und einem beliebigen Ablaufdatum in der Zukunft, um während des Tests Übererfassungen anzufordern und durchzuführen. Wenn Übererfassungen für Zahlungen für ein bestimmtes Netzwerk während des Tests verfügbar sind, sind sie auch für Live-Zahlungen verfügbar.
Marke der Karte | Die Nummer | Zahlungsmethode |
---|---|---|
Visa | pm_ | |
Mastercard | pm_ | |
Amex | pm_ | |
Discover | pm_ |