Eine Zahlungsmethode zurückhalten

Wenn Sie eine Zahlung erstellen, können Sie eine zulässige Zahlungsmethode zurückhalten, um Gelder zurückzustellen, die Sie später erfassen können. Zum Beispiel autorisieren Hotels eine Zahlung oft vollständig, bevor ein Gast eintrifft, und erfassen das Geld dann, wenn der Gast auscheckt. Dies wird manchmal als manuelle Erfassung bezeichnet.

Durch Autorisierung einer Zahlung wird der Betrag garantiert, indem er für die Zahlungsmethode des Kunden/der Kundin zurückgehalten wird. Wenn Sie die API verwenden, gibt das Attribut payment_method_details.card.capture_before für die Zahlung an, wann die Autorisierung abläuft.

Sie müssen die Gelder erfassen, bevor die Autorisierung abläuft. Wenn die Autorisierung abläuft, bevor Sie die Gelder erfassen, werden die Gelder freigegeben, und der Zahlungsstatus ändert sich in canceled. Erfahren Sie mehr über Status für asynchrone Zahlungen.

Gültigkeitsfenster für Autorisierung

Die folgenden Tabellen skizzieren Gültigkeitsfenster für die Autorisierung verschiedener Transaktionstypen.

Distanzzahlungen

Zahlungen mit vorhandener Karte (persönlichen Zahlungen)

30-tägige Autorisierungsfenster in Japan

Wenn Ihr Konto in Japan ansässig ist, können Sie auf JPY lautende Transaktionen von Visa, Mastercard, JCB, Diners Club und Discover für bis zu 30 Tage zurückhalten. Nicht-JPY- und American Express-Transaktionen laufen nach dem standardmäßigen 7-Tage-Fenster ab.

Einschränkungen der Zahlungsmethode

Machen Sie sich vor der Implementierung mit den folgenden Einschränkungen für die separate Autorisierung und Erfassung vertraut.

• Nur einige Zahlungsmethoden unterstützen die separate Autorisierung und Erfassung. Zu den Zahlungsmethoden, die dies unterstützen, zählen Karten, Affirm, Afterpay, Cash App Pay, Klarna und PayPal. Zu den Zahlungsmethoden, die dies nicht unterstützen, zählen ACH und iDEAL. Lesen Sie mehr über Support für Zahlungsmethodenfunktionen.

• Über das hinaus, was in den obigen Tabellen beschrieben ist, haben andere Zahlungsmethoden unterschiedliche Regeln und Autorisierungsfenster:

  • Kartenzahlungen: Der Betrag wird üblicherweise 7 Tage lang für Online-Zahlungen und 2 Tage lang für Terminal-Zahlungen zurückgehalten (abhängig von der Art der Transaktion und dem Kartennetzwerk). Sie können eine erweiterte Autorisierung für bestimmte Online- und Terminal-Zahlungsautorisierungen anfordern, die für eine verlängerte Gültigkeitsdauer berechtigt sind. Kartennetzwerke können auch 1 USD-Autorisierungen untersagen, die Sie nicht zu erfassen beabsichtigen.
  • Affirm: Wenn Affirm eine Anzahlung für sehr große Bestellbeträge verlangt, wird der Betrag während der Autorisierung in Rechnung gestellt und erstattet, wenn die Zahlung nicht erfasst wird. Sie haben dann 30 Tage Zeit, um den Zahlungssaldo zu erfassen.
  • Afterpay/Clearpay: Bei der Autorisierung zahlt der Kunde/die Kundin die erste Rückzahlungsrate. Afterpay erstattet die Zahlung, wenn sie nie erfasst wird. Sie haben dann 13 Tage Zeit, um den Zahlungssaldo zu erfassen.
  • Cash App Pay: Gültige Autorisierungen müssen innerhalb von 7 Tagen erfasst werden, um eine Zahlung abzuschließen.
  • Klarna: Sie müssen die Zahlung bis Mitternacht des 28. Kalendertages nach der Zahlungsanfrage erfassen, andernfalls läuft die Autorisierung ab. Zum Beispiel müssen Sie eine Zahlungsanfrage um 14:00 Uhr UTC am 01.10.2020 bis 00:00 Uhr UTC am 29.10.2020 erfassen.
  • PayPal: Behält den Betrag 10 Tage lang ein. Stripe versucht automatisch, die Einbehaltung um weitere 10 Tage auf insgesamt 20 Tage zu verlängern. Ihre bevorzugte Zahlungsabwicklungsart kann sich auf den Autorisierungszeitraum auswirken. Weitere Informationen finden Sie unter Getrennte Autorisierung und Erfassung.

Autorisierung und Erfassung über das Dashboard

Sie können eine Zahlung autorisieren und Gelder separat erfassen, ohne Code schreiben zu müssen.

1. Erstellen Sie im Dashboard eine neue Zahlung. Wählen Sie Einmalig.
2. Wenn Sie die Zahlungsmethode eingeben oder auswählen, wählen Sie Weitere Optionen und dann Gelder später einziehen aus.

Die Zahlung wird auf Ihrer Zahlungsseite als Nicht erfasst angezeigt.

Um die Gelder zu erfassen, gehen Sie zur Seite mit den Zahlungsdetails und klicken Sie auf Erfassen.

Stripe soll nur autorisieren

Um anzugeben, dass Autorisierung und Erfassung getrennt werden sollen, geben Sie beim Erstellen des PaymentIntent capture_method als manual an. Dieser Parameter weist Stripe an, den Betrag zu autorisieren, aber nicht über die Zahlungsmethode des Kunden/der Kundin zu erfassen.

curl https://api.stripe.com/v1/payment_intents \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d amount=1099 \
  -d currency=usd \
  -d "payment_method_types[]"=card \
  -d capture_method=manual

Mit dem oben beschriebenen Ansatz signalisieren Sie Stripe, dass Sie für einen PaymentIntent mit berechtigten Zahlungsmethoden nur die spätere Erfassung verwenden können. Beispielsweise können Sie Kartenzahlungen und SEPA Direct Debit (das die spätere Erfassung nicht unterstützt) nicht für einen einzelnen PaymentIntent akzeptieren. Um Zahlungsmethoden zu akzeptieren, die möglicherweise nicht alle die spätere Erfassung unterstützen, können Sie die spätere Erfassung nach Zahlungsmethode konfigurieren, indem Sie capture_method=manual für das payment_method_options[<payment_method_type>]-Objekt konfigurieren.

Wenn Sie beispielsweise payment_method_options[card][capture_method]=manual konfigurieren, halten Sie nur Kartenzahlungen zurück. Sie können Zahlungsmethoden über das Dashboard verwalten. Stripe übernimmt die Logik für die dynamische Anzeige der relevantesten berechtigten Zahlungsmethoden für jeden Kunden/jede Kundin basierend auf Faktoren wie dem Betrag, der Währung und dem Zahlungsfluss der Transaktion.

curl https://api.stripe.com/v1/payment_intents \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d amount=1099 \
  -d currency=usd \
  -d "automatic_payment_methods[enabled]"=true \
  -d "payment_method_options[card][capture_method]"=manual

Alternativ können Sie card und sepa_debit unter Verwendung von Zahlungsmethodentypen wie im folgenden Beispiel auflisten.

curl https://api.stripe.com/v1/payment_intents \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d amount=1099 \
  -d currency=eur \
  -d "payment_method_types[]"=card \
  -d "payment_method_types[]"=sepa_debit \
  -d "payment_method_options[card][capture_method]"=manual

Bevor Sie mit der Erfassung fortfahren, ordnen Sie dem PaymentIntent eine Zahlungsmethode mit Kartenangaben zu, und autorisieren Sie die Karte durch Bestätigen des PaymentIntent. Dazu können Sie die Felder payment_method und confirm für den PaymentIntent festlegen.

Gelder erfassen

Nachdem die Zahlungsmethode autorisiert wurde, ändert sich der Status des PaymentIntent in requires_capture. Um die autorisierten Gelder zu erfassen, stellen Sie eine Anfrage zur Erfassung für den PaymentIntent. Dabei wird standardmäßig der gesamte autorisierte Betrag erfasst. Um weniger oder (bei bestimmten Online-Kartenzahlungen) mehr als den ursprünglichen Betrag zu erfassen, übergeben Sie die Option amount_to_capture. Bei einer Teilerfassung wird der Restbetrag automatisch freigegeben. Wenn Sie versuchen, mehr als den ursprünglichen Betrag für eine Online-Kartenzahlung einzuziehen, lesen Sie die Dokumentation zur Übererfassung.

Das folgende Beispiel zeigt, wie 7,50 USD von der autorisierten Zahlung in Höhe von insgesamt 10,99 USD erfasst werden:

curl https://api.stripe.com/v1/payment_intents/pi_123/capture \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d amount_to_capture=750

Obwohl einige Kartenzahlungen für Multicapture infrage kommen, können Sie bei den meisten Zahlungen nur eine Erfassung für eine autorisierte Zahlung durchführen. Wenn Sie eine Zahlung teilweise erfassen, können Sie für die Differenz keine weitere Erfassung durchführen. (Erwägen Sie stattdessen, die Angaben zur Zahlungsmethode des Kunden/der Kundin zur späteren Verwendung zu speichern und bei Bedarf zukünftige Zahlungen zu erstellen.)

Bei Kartenabrechnungen einiger Aussteller und Schnittstellen von Zahlungsmethoden wird nicht immer zwischen Autorisierungen und erfassten (abgerechneten) Zahlungen unterschieden, was für Kundinnen und Kunden mitunter verwirrend sein kann.

Wenn ein Kunde/eine Kundin den Zahlungsvorgang zu einem PaymentIntent mit manueller Erfassung abschließt, wird das Ereignis payment_intent.amount_capturable_updated ausgelöst. Sie können die Eigenschaft amount_capturable des PaymentIntent überprüfen, um den vom PaymentIntent zu erfassenden Gesamtbetrag anzuzeigen.

Autorisierung stornieren

Wenn Sie eine Autorisierung stornieren müssen, können Sie den PaymentIntent stornieren.