Autorisierung erhöhen
Mit inkrementellen Autorisierungen können Sie den autorisierten Betrag für einen bestätigten PaymentIntent erhöhen, bevor Sie diesen erfassen. Vor der Erfassung wird jede inkrementelle Autorisierung auf der Kreditkartenabrechnung Ihrer Kundin/Ihres Kunden als zusätzlicher ausstehender Eintrag angezeigt (z. B. erscheinen eine auf von 10 USD auf 15 USD erhöhte Autorisierung als jeweils ausstehende Einträge über 10 USD und 5 USD). Nach der Erfassung werden die ausstehenden Autorisierungen entfernt und der erfasste Gesamtbetrag wird als ein einziger endgültiger Eintrag angezeigt.
Verfügbarkeit
Beachten Sie bei der Verwendung von inkrementellen Autorisierungen folgende Einschränkungen:
- Derzeit nicht verfügbar, wenn Sie oder der/die Karteninhaber/in sich in einem Land mit starker Kundenauthentifizierung oder ähnlichen Authentifizierungsanforderungen befinden.
- Nur verfügbar mit Visa, Mastercard oder Discover.
- Für bestimmte Kartenmarken gelten Einschränkungen hinsichtlich der Händlerkategorie (siehe unten).
Weitere Informationen zu inkrementellen Autorisierungen und persönlichen Zahlungen mit Terminal finden Sie unter Inkrementelle Autorisierungen.
IC+-Funktion
Mit dem Preismodell IC+ erhalten Nutzerinnen und Nutzer Zugriff auf inkrementelle Autorisierungen. Wenn Sie ein Standard-Preismodell von Stripe nutzen und auf diese Funktion zugreifen möchten, erfahren Sie mehr unter support.stripe.com.
Verfügbarkeit nach Kartennetzwerk und Händlerkategorie
Verwenden Sie inkrementelle Autorisierungen für Zahlungen, die die nachfolgenden Kriterien erfüllen. Sie finden Ihre Nutzerkategorie im Dashboard.
Der Versuch, eine inkrementelle Autorisierung für eine Zahlung durchzuführen, die die folgenden Kriterien nicht erfüllt, resultiert in einem Fehler.
Marke der Karte | Land des Händlers | Zahlungsart | Händlerkategorie |
---|---|---|---|
Visa | Global | Alle Kartenzahlungsarten | Alle Nutzerkategorien |
Mastercard | Global* | Alle Kartenzahlungsarten | Alle Nutzerkategorien |
Discover | Global | Alle Kartenzahlungsarten | Autovermietung, Hotels, Orts- und Pendlerverkehr, Personenbeförderung, einschließlich Fähren, Schienenpersonenverkehr, Buslinien-Charter, Tour, Dampf-/Kreuzfahrtschiffe, Vermietung und Leasing von Booten, Lebensmittelgeschäfte und Supermärkte, Laden von Elektrofahrzeugen, Gaststätten und Restaurants, Trinkhallen (alkoholische Getränke), Hotels, Motels, Resorts, Wohnwagenparks und Campingplätze, Vermietung und Leasing von Geräten/Werkzeugen/Möbeln/Haushaltsgeräten, Autovermietung, Vermietung von Lastkraftwagen und Nutzfahrzeugen, Vermietung von Wohnmobilen und Freizeitfahrzeugen, Parkplätze, Parkuhren und Parkhäuser, Vergnügungsparks, Zirkusse, Wahrsager, Freizeitdienstleistungen (nicht klassifiziert) |
Discover | Global | Card Not Present | Taxifahrzeuge und Limousinen |
Netzwerke mit eingeschränktem Support (Beta)
Best Practices
Wenn Sie die inkrementelle Autorisierung verwenden, sollten Sie Ihre Kundinnen und Kunden proaktiv über alle Autorisierungen für geschätzte Beträge benachrichtigen, die inkrementelle Autorisierungen nach sich ziehen können und die Beträge möglicherweise erhöhen. Hier zeigen wir Ihnen einige Best Practices dafür:
- Geben Sie an, dass eine Autorisierung für einen geschätzten Betrag erfolgt und dass während des Bezahlvorgangs bzw. vor dem Kaufabschluss weitere Autorisierungsanfragen folgen können.
- Stützen Sie die geschätzten Beträge auf einer realistischen Schätzung des Gesamtbetrags der Transaktion.
Diese Best Practices sind möglicherweise je nach Netzwerk im Rahmen der geltenden Netzwerkregeln erforderlich.
Compliance
Sie sind für die Einhaltung aller geltenden Gesetze, Vorschriften und Netzwerkregeln verantwortlich, wenn Sie inkrementelle Autorisierungen nutzen. Machen Sie sich mit den Netzwerkspezifikationen der Kartennetzwerke vertraut, die Sie mit dieser Funktion akzeptieren möchten, damit Ihre Verkäufe mit den jeweils geltenden Regeln konform sind. Regeln variieren je nach Netzwerk. Beispielsweise schränken die meisten Kartennetzwerke die Berechnung der in der Erstautorisierung enthaltenen geschätzten Beträge ein. Sie verbieten die Verwendung von inkrementellen Autorisierungen für Transaktionen, bei denen der Transaktionsbetrag zum Zeitpunkt der Autorisierung bekannt sein sollte (z. B. bei wiederkehrenden Zahlungen für Abonnements).
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 professionelle Beratung dar. Wenden Sie sich an eine Fachperson, wenn Sie sich bezüglich Ihrer Verpflichtungen unsicher sind.
Einen nicht erfassten PaymentIntent erstellen und bestätigen
Verwenden Sie den Parameter request_incremental_authorization
, um die PaymentIntents anzugeben, die Sie erhöhen möchten.
Alle PaymentIntents können standardmäßig erhöht werden. Mit den Parametern if_available
oder never
bestimmen Sie, wann die Erhöhung eines PaymentIntent beginnen soll:
if_available
: Der erstellte PaymentIntent lässt zukünftige Erhöhungen basierend auf der inkrementellen Verfügbarkeit des Autorisierungs-Supports zu.never
: Der erstellte PaymentIntent lässt keine zukünftigen Erhöhungen zu.
Sie können inkrementelle Autorisierungen für nicht erfasste Zahlungen nur nach der PaymentIntent-Bestätigung durchführen. Um den Betrag einer Zahlung vor der Bestätigung anzupassen, verwenden Sie stattdessen die Aktualisierungsmethode.
In der PaymentIntent-Bestätigungsantwort enthält das Feld payment_method_details für die latest_charge den Eintrag available
oder unavailable
, je nach der Kundenzahlungsmethode und der oben genannten Verfügbarkeitskriterien. Dadurch wird bestimmt, ob ein PaymentIntent für eine inkrementelle Autorisierung infrage kommt oder nicht. (Wenn Sie in Ihrer PaymentIntent-Bestätigungsanfrage keine inkrementelle Autorisierung angefordert haben, ist diese unavailable
.)
// 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" } } } ... } } }
Inkrementelle Autorisierung durchführen
Verwenden Sie den Endpoint increment_authorization, um den autorisierten Betrag für einen PaymentIntent zu erhöhen, und geben Sie den aktualisierten Autorisierungsbetrag an, auf den erhöht werden soll. Dieser Wert muss größer als der ursprünglich autorisierte Betrag sein. Dadurch wird versucht, einen höheren Betrag auf der Kundenkarte zu autorisieren. Ein einzelner PaymentIntent kann den Endpoint mehrmals aufrufen, um den autorisierten Betrag weiter zu erhöhen.
Sie haben maximal 10 inkrementelle Autorisierungsversuche pro PaymentIntent.
curl https://api.stripe.com/v1/payment_intents/{{PAYMENT_INTENT_ID}}/increment_authorization \ -u
: \ -d "amount"=1500sk_test_4eC39HqLyjWDarjtT1zdp7dc
Wenn die inkrementelle Autorisierung erfolgreich war, geht diese mit dem aktualisierten Betrag an das PaymentIntent-Objekt zurück. Schlägt die Autorisierung fehl, wird stattdessen der Fehler card_declined zurückgegeben. Das PaymentIntent-Objekt kann weiterhin für den zuvor autorisierten Betrag erfasst werden. Jegliche potenziellen Aktualisierungen an anderen PaymentIntent-Feldern (z. B. application_fee_amount, transfer_data, metadata, description und statement_descriptor) werden nicht gespeichert, wenn die inkrementelle Autorisierung fehlschlägt.
Das zugrunde liegende Charge-Objekt für den PaymentIntent enthält das Array-Feld amount_updates, an das die Ergebnisse der inkrementellen Autorisierung angehängt werden. Es zeigt, ob die Autorisierung erfolgreich war oder fehlgeschlagen ist, sowie alle mit dem Ergebnis verbundenen Details.
Die inkrementelle Autorisierung hat eine Höchstgrenze von entweder mindestens 50 USD (bzw. dem entsprechenden lokalen Betrag) oder mehr als 50 % des zuvor autorisierten Betrags (je nachdem, welcher Betrag höher ist) für jede einzelne Erhöhung. Wenn Sie höhere Limits wünschen, wenden Sie sich an unseren Support.
PaymentIntent erfassen
Unabhängig davon, ob Sie den autorisierten Betrag für einen PaymentIntent mit einer inkrementellen Autorisierung erhöhen oder nicht, müssen Sie die Gelder erfassen, bevor die ursprüngliche Autorisierung abläuft. Inkrementelle Autorisierungen verlängern die Gültigkeitsdauer nicht. Um den autorisierten Betrag für einen PaymentIntent mit vorherigen inkrementellen Autorisierungen zu erfassen, verwenden Sie wie gewohnt den capture-Endpoint.
curl https://api.stripe.com/v1/payment_intents/{{PAYMENT_INTENT_ID}}/capture \ -u
:sk_test_4eC39HqLyjWDarjtT1zdp7dc
Wenn die inkrementelle Autorisierung erfolgreich war, geht dies mit dem aktualisierten Betrag an das erfasste PaymentIntent-Objekt zurück. Schlägt die Autorisierung fehl, wird stattdessen der Fehler card_declined error zurückgegeben. Der PaymentIntent wird nicht erfasst, kann aber weiterhin für den zuvor autorisierten Betrag erfasst werden. Jegliche potenziellen Aktualisierungen an anderen PaymentIntent-Feldern (z. B. application_fee_amount, transfer_data, metadata, description und statement_descriptor) werden nicht gespeichert, wenn die inkrementelle Autorisierung fehlschlägt.
Integration testen
Verwenden Sie die Stripe-Testkarte für die inkrementelle Autorisierung mit einer beliebigen Prüfziffer (CVC), Postleitzahl und zukünftigem Ablaufdatum, um im Testmodus eine inkrementelle Autorisierung auszulösen:
Erstellen Sie zunächst den PaymentIntent mit der Testkarte im obigen Schritt zum Erstellen und Bestätigen des PaymentIntent.
Führen Sie die inkrementelle Autorisierung mit den im obigen Schritt zur Durchführung einer inkrementellen Autorisierung angegebenen Parametern durch und verwenden Sie die Testkarte, um die inkrementelle Autorisierung auszulösen.
Anzahl | Zahlungsmethode | Beschreibung |
---|---|---|
pm_card_debit_incrementalAuthAuthorized | Dadurch wird der Autorisierungsbetrag auf den in der Anfrage angegebenen Betrag erhöht. |