# 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 Sofern Ihr Konto in Japan geführt wird, können Sie auf JPY lautende Transaktionen von Visa, Mastercard, JCB, Diners Club und Discover für bis zu 30 Tage zurückhalten. Nicht auf JPY lautende Transaktionen sowie American Express-Transaktionen verfallen gemäß den [üblichen Autorisierungsfristen](https://docs.stripe.com/payments/place-a-hold-on-a-payment-method.md#authorization-validity-windows). ## 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?payment-ui=direct-api#manual-capture): Wenn Affirm bei sehr hohen Bestellbeträgen eine Anzahlung verlangt, buchen sie den Betrag während der Autorisierung ab und erstatten ihn zurück, wenn die Zahlung nicht erfasst wird. Sie haben dann 30 Tage Zeit, um den Restbetrag der Zahlung 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**. 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](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 "automatic_payment_methods[enabled]=true" \ -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` wie im folgenden Beispiel mithilfe von [allowed_payment_method_types](https://docs.stripe.com/api/payment_intents/create.md#create_payment_intent-allowed_payment_method_types) auflisten. ```curl curl https://api.stripe.com/v1/payment_intents \ -u "<>:" \ -d amount=1099 \ -d currency=eur \ -d "allowed_payment_method_types[]=card" \ -d "allowed_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 eine [Mehrfacherfassung](https://docs.stripe.com/payments/multicapture.md) infrage kommen, können Sie bei den meisten Zahlungen nur eine einzige Erfassung für eine autorisierte Zahlung durchführen. Wenn Sie eine Zahlung teilweise erfassen, können Sie keine weitere Erfassung für den Differenzbetrag durchführen. (Erwägen Sie stattdessen, [die Zahlungsmethodendetails der Kundin/des Kunden für später zu speichern](https://docs.stripe.com/payments/save-during-payment.md?payment-ui=elements#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 für Kartenzahlungsmethoden vor Ablauf der Autorisierung automatisch zu erfassen, anstatt die Erfassung manuell auszulösen. Verwenden Sie die automatische verzögerte Erfassung, um sicherzustellen, dass Sie die Erfassung autorisierter Zahlungen nicht verpassen. Sie können mit dem Parameter `capture_by` auch steuern, wann die Erfassung erfolgt. 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 "automatic_payment_methods[enabled]=true" \ -d "payment_method_options[card][capture_method]=automatic_delayed" ``` Mit diesem Ansatz erfasst Stripe Ihre Kartenzahlung, bevor die Autorisierung abläuft, und löst die Erfassung etwa 6 Stunden vor dem Ablaufzeitpunkt aus. Dies dient als Backup-Prozess, um sicherzustellen, dass wir autorisierte Zahlungen vor Ablauf erfassen. Sie können den PaymentIntent weiterhin manuell [erfassen](https://docs.stripe.com/api/payment_intents/capture.md) oder [stornieren](https://docs.stripe.com/refunds.md#cancel-payment), bevor er automatisch erfasst wird. ### Zeitpunkt der Erfassung steuern Verwenden Sie den Parameter `capture_by`, um zu steuern, wann Gelder vom Kundenkonto erfasst werden. Die folgenden Werte werden unterstützt: - `auth_expiry`: Erfasst Gelder, bevor die Autorisierung abläuft. Dies ist das Standardverhalten, wenn `capture_by` weggelassen wird. - `end_of_day`: Erfasst Gelder am Ende des Tages (UTC). - `target_delay`: Erfasst Gelder nach einer festgelegten Verzögerung. Wenn Sie `target_delay` verwenden, geben Sie einen `capture_delay`-Hash mit `days` oder `hours` an, um die Verzögerungszeit festzulegen. Das folgende Beispiel verwendet `capture_by` auf `target_delay` gesetzt mit einem `capture_delay` von 3 Tagen, um den PaymentIntent 3 Tage nach der erfolgreichen Autorisierung automatisch zu erfassen: ```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]=automatic_delayed" \ -d "payment_method_options[card][capture_by]=target_delay" \ -d "payment_method_options[card][capture_delay][days]=3" ``` Dies ist nützlich, wenn Sie wissen, wie viel Zeit erforderlich ist, um Aktionen zwischen der Autorisierung und der Erfassung durchzuführen, und um sicherzustellen, dass Sie die Zahlung erfassen, bevor die Autorisierung abläuft. Sie können sowohl `days` als auch `hours` festlegen, solange die Gesamtverzögerung 30 Tage nicht überschreitet. > 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. ### Sind Sie daran interessiert, frühzeitig Zugang zu den automatischen zeitversetzten Erfassungen zu erhalten? Geben Sie unten Ihre E-Mail-Adresse an und unser Team wird sich in Kürze mit Ihnen in Verbindung setzen. ```bash curl https://docs.stripe.com/preview/register \ -X POST \ -H "Content-Type: application/json" \ -H "Referer: https://docs.stripe.com/payments/place-a-hold-on-a-payment-method" \ -d '{"email": "EMAIL", "preview": "automatic_delayed_capture_beta_preview"}' ``` ## 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)