# Eine Zahlungsmethode zurückhalten Trennen Sie die Autorisierung und Erfassung von Zahlungen, um eine Zahlung jetzt zu erstellen, aber die Gelder später zu erfassen. 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* (Manually capture funds separately from an authorization) 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](https://docs.stripe.com/api/charges/object.md#charge_object-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](https://docs.stripe.com/payments/paymentintents/lifecycle.md). ## Gültigkeitsfenster für Autorisierung Die folgenden Tabellen skizzieren Gültigkeitsfenster für die Autorisierung verschiedener Transaktionstypen. ### Distanzzahlungen | Kartenmarke | Gültigkeitsfenster für die Autorisierung einer [vom Händler initiierten Transaktion](https://docs.stripe.com/payments/cits-and-mits.md) | Gültigkeitsfenster für die Autorisierung einer [von Kundinnen/Kunden initiierten Transaktion](https://docs.stripe.com/payments/cits-and-mits.md) | | -------------------- | --------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ | | **Visa** | 5 Tage* | 7 Tage | | **Mastercard** | 7 Tage | 7 Tage | | **American Express** | 7 Tage | 7 Tage | | **Discover** | 7 Tage | 7 Tage | Das genaue Autorisierungsfenster beträgt 4 Tage und 18 Stunden, um Zeit für Clearing-Prozesse zu haben. > Stripe und das Kartennetzwerk klassifizieren Transaktionen als MIT oder CIT, je nach den Signalen zur Teilnahme der Karteninhaber/innen und nicht nur anhand von API-Parametern wie [off_session](https://docs.stripe.com/api/payment_intents/create.md#create_payment_intent-off_session). Beispielsweise kann eine Zahlung mit `off_session: true` auch als CIT eingestuft werden, wenn eine Prüfziffer vorhanden ist, was stattdessen das CIT-Autorisierungsfenster öffnet. ### Zahlungen mit vorhandener Karte (persönlichen Zahlungen) | Kartenmarke | Gültigkeitsfenster für Autorisierung | | -------------------- | ------------------------------------ | | **Visa** | 5 Tage* | | **Mastercard** | 2 Tage | | **American Express** | 2 Tage | | **Discover** | 2 Tage | Das genaue Autorisierungsfenster beträgt 4 Tage und 18 Stunden, um Zeit für Clearing-Prozesse zu haben. ### 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. > Ab dem 14. April 2024 hat Visa das Autorisierungsfenster für [von Online-Händern initiierte Transaktionen](https://docs.stripe.com/payments/cits-and-mits.md) von 7 Tagen auf 5 Tage verkürzt. Visa hat außerdem das Autorisierungsfenster für persönliche (Terminal)-Transaktionen von 2 Tagen auf 5 Tage verlängert. ## 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* (Fulfillment is the process of providing the goods or services purchased by a customer, typically after payment is collected). 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](https://docs.stripe.com/payments/ach-direct-debit.md) und [iDEAL](https://docs.stripe.com/payments/ideal.md). Lesen Sie mehr über [Support für Zahlungsmethodenfunktionen](https://docs.stripe.com/payments/payment-methods/payment-method-support.md). - Über das hinaus, was in den obigen Tabellen beschrieben ist, gelten für 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](https://docs.stripe.com/payments/extended-authorization.md)- und [Terminal-Zahlungsautorisierungen](https://docs.stripe.com/terminal/features/extended-authorizations.md) 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](https://docs.stripe.com/payments/affirm/accept-a-payment.md?platform=web#manual-capture): 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](https://docs.stripe.com/payments/afterpay-clearpay/accept-a-payment.md?web-or-mobile=web&payment-ui=direct-api#manual-capture): 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](https://docs.stripe.com/payments/cash-app-pay/accept-a-payment.md?web-or-mobile=web&payment-ui=direct-api#manual-capture): Gültige Autorisierungen müssen innerhalb von 7 Tagen erfasst werden, um eine Zahlung abzuschließen. - [Klarna](https://docs.stripe.com/payments/klarna/accept-a-payment.md?web-or-mobile=web&payment-ui=direct-api#manual-capture): 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](https://docs.stripe.com/payments/paypal/accept-a-payment.md?web-or-mobile=web&payment-ui=direct-api#manual-capture): 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](https://docs.stripe.com/payments/paypal/choose-settlement-preference.md) kann sich auf den Autorisierungszeitraum auswirken. Weitere Informationen finden Sie unter [Getrennte Autorisierung und Erfassung](https://docs.stripe.com/payments/paypal/accept-a-payment.md?web-or-mobile=web&payment-ui=direct-api#manual-capture). ## 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](https://dashboard.stripe.com/test/payments/new). Wählen Sie **Einmalig**. 1. 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](https://dashboard.stripe.com/test/payments) 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 #### Checkout Sessions API Um anzugeben, dass Sie Autorisierung und Erfassung trennen möchten, geben Sie [capture_method](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-payment_intent_data-capture_method) beim Erstellen der Checkout-Sitzung auf `manual` an. Dieser Parameter weist Stripe an, den Betrag zu autorisieren, aber nicht über die Zahlungsmethode des Kunden/der Kundin zu erfassen. ```curl curl https://api.stripe.com/v1/checkout/sessions \ -u "<>:" \ -d "line_items[0][price]={{PRICE_ID}}" \ -d "line_items[0][quantity]=2" \ -d mode=payment \ -d ui_mode=elements \ -d "payment_intent_data[capture_method]=manual" ``` Mit dem obigen Verfahren teilen Sie Stripe mit, dass Sie nur „Erfassung nach“ (Capture After) für eine Checkout-Sitzung mit geeigneten Zahlungsmethoden verwenden können. #### Payment Intents API Um anzugeben, dass Autorisierung und Erfassung getrennt werden sollen, geben Sie beim Erstellen des PaymentIntent [capture_method](https://docs.stripe.com/api/payment_intents/create.md#create_payment_intent-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 curl https://api.stripe.com/v1/payment_intents \ -u "<>:" \ -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[]`-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](https://dashboard.stripe.com/settings/payment_methods) verwalten. Stripe übernimmt die Logik für die [dynamische Anzeige](https://docs.stripe.com/payments/payment-methods/dynamic-payment-methods.md) 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 curl https://api.stripe.com/v1/payment_intents \ -u "<>:" \ -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](https://docs.stripe.com/api/payment_intents/create.md#create_payment_intent-payment_method_types) wie im folgenden Beispiel auflisten. ```curl curl https://api.stripe.com/v1/payment_intents \ -u "<>:" \ -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. > #### Erweiterte Autorisierungen > > In der Regel ist eine Autorisierung für eine Online-Kartenzahlung 7 Tage gültig. Um die Gültigkeitsdauer zu verlängern, können Sie eine [Online-Kartenzahlung verlängern](https://docs.stripe.com/payments/extended-authorization.md). ## Gelder erfassen > #### Checkout-Sitzungen verfügen über eine PaymentIntent-ID > > Wenn Sie die Checkout Sessions API verwenden, stellen Sie sicher, dass Sie die [PaymentIntent-ID](https://docs.stripe.com/api/checkout/sessions/object.md#checkout_session_object-payment_intent) verwenden, die im Checkout Session-Objekt zurückgegeben wird. Nachdem die Zahlungsmethode autorisiert wurde, ändert sich der [Status](https://docs.stripe.com/api/payment_intents/object.md#payment_intent_object-status) des PaymentIntent in `requires_capture`. Um die autorisierten Gelder zu erfassen, stellen Sie eine Anfrage zur [Erfassung](https://docs.stripe.com/api/payment_intents/capture.md) 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](https://docs.stripe.com/api/payment_intents/capture.md#capture_payment_intent-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](https://docs.stripe.com/payments/overcapture.md). Das folgende Beispiel zeigt, wie 7,50 USD von der autorisierten Zahlung in Höhe von insgesamt 10,99 USD erfasst werden: ```curl curl https://api.stripe.com/v1/payment_intents/pi_123/capture \ -u "<>:" \ -d amount_to_capture=750 ``` Obwohl einige Kartenzahlungen für [Multicapture](https://docs.stripe.com/payments/multicapture.md) 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](https://docs.stripe.com/payments/save-during-payment.md#save-payment-details-for-future-use) 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](https://docs.stripe.com/api/payment_intents/object.md#payment_intent_object-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](https://docs.stripe.com/refunds.md#cancel-payment) stornieren. ## Zahlung vor Ablauf der Autorisierung erfassen (Private preview) Sie können Stripe anweisen, Zahlungen mit Karten automatisch einzuziehen, bevor die Autorisierung abläuft, statt die Abbuchung manuell auszulösen. Nutzen Sie die automatische verzögerte Abbuchung, um sicherzustellen, dass autorisierte Zahlungen nicht untergehen. Außerdem können Sie einen individuellen Zeitraum zwischen Autorisierung und Abbuchung festlegen. Um die automatische verzögerte Erfassung zu aktivieren, legen Sie [capture_method](https://docs.stripe.com/api/payment_intents/create.md#create_payment_intent-payment_method_options-card) als `automatic_delayed` im PaymentIntent fest: ```curl curl https://api.stripe.com/v1/payment_intents \ -u "<>:" \ -d amount=1099 \ -d currency=usd \ -d "payment_method_types[]=card" \ -d "payment_method_options[card][capture_method]=automatic_delayed" ``` Mit diesem Verfahren zieht Stripe Ihre Kartenzahlung ein, bevor die Autorisierung abläuft, und führt die Abbuchung etwa 6 Stunden vor Ablauf durch. Dies dient als Absicherung, um sicherzustellen, dass autorisierte Zahlungen vor dem Ablauf erfasst werden. Sie können den PaymentIntent weiterhin manuell [einziehen](https://docs.stripe.com/api/payment_intents/capture.md) oder [stornieren](https://docs.stripe.com/refunds.md#cancel-payment), bevor die automatische Abbuchung erfolgt. Sie können eine benutzerdefinierte Verzögerungszeit für die Erfassung angeben, indem Sie den Parameter `capture_delay_days` angeben. Dieser Parameter gibt die Anzahl der Tage an, um die die Erfassung nach erfolgreicher Autorisierung verzögert werden soll: ```curl curl https://api.stripe.com/v1/payment_intents \ -u "<>:" \ -d amount=1099 \ -d currency=usd \ -d "payment_method_types[]=card" \ -d "payment_method_options[card][capture_method]=automatic_delayed" \ -d "payment_method_options[card][capture_delay_days]=3" ``` In diesem Beispiel erfasst Stripe den PaymentIntent automatisch 3 Tage nach erfolgreicher Autorisierung. Dies ist nützlich, wenn Sie wissen, wie viel Zeit Sie benötigen, um Aktionen zwischen Autorisierung und Erfassung durchzuführen und gleichzeitig sicherzustellen, dass die Erfassung erfolgt, bevor die Autorisierung abläuft. > Mit `capture_method=automatic_delayed` erfasst Stripe die Zahlung vorrangig vor dem Ablauf der Autorisierung. Wenn das Zeitfenster für die Autorisierung kürzer ist als der angegebene Verzögerungszeitraum, erfassen wir den PaymentIntent vor Ablauf und ignorieren den Verzögerungszeitraum. ## See also - [Separate Autorisierung und Erfassung mit Checkout](https://docs.stripe.com/payments/accept-a-payment.md?payment-ui=checkout&ui=stripe-hosted#auth-and-capture) - [Online-Kartenzahlung länger zurückhalten](https://docs.stripe.com/payments/extended-authorization.md)