# Erweiterte Rückstellung für eine Online-Kartenzahlung einrichten Erfahren Sie, wie Sie erweiterte Autorisierungen verwenden, um Online-Kartenzahlungen bis zu 30 Tage nach der Autorisierung zu erfassen. # Gehostete Seite > This is a Gehostete Seite for when platform is web and ui is stripe-hosted. View the full page at https://docs.stripe.com/payments/extended-authorization?platform=web&ui=stripe-hosted. Erweiterte Autorisierungen haben eine längere Gültigkeitsdauer für Autorisierungen, sodass Sie Kundengelder länger als in den Standard-Gültigkeitsfenstern für Autorisierungen aufbewahren können. Für die meisten Kartennetzwerke beträgt die standardmäßige Gültigkeitsdauer der Autorisierung 7 Tage für Online-Zahlungen und 2 Tage für persönliche [Terminal](https://docs.stripe.com/terminal.md)-Zahlungen, während die verlängerte Gültigkeitsdauer je nach Kartennetzwerk bis zu 30 Tage betragen kann. Weitere Informationen zu den Gültigkeitsfenstern für Autorisierungen finden Sie unter [Zurückstellen einer Zahlungsmethode](https://docs.stripe.com/payments/place-a-hold-on-a-payment-method.md). ## Verfügbarkeit Wenn Sie erweiterte Autorisierungen verwenden, gibt es keine regionalen Einschränkungen. Beachten Sie jedoch die folgenden Einschränkungen: - Diese sind nur mit Visa, Mastercard, American Express und Discover verfügbar. - Für bestimmte Kartenmarken gelten Beschränkungen hinsichtlich der Händlerkategorie. Weitere Informationen finden Sie in der folgenden Tabelle zur Netzwerkverfügbarkeit. - Auf dieser Seite werden erweiterte Autorisierungen für Online-Kartenzahlungen beschrieben. Informationen zu persönlichen Kartenzahlungen mit erweiterten Autorisierungen finden Sie in der [Terminal-Dokumentation](https://docs.stripe.com/terminal/features/extended-authorizations.md). - [Modus](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-mode) ist auf `payment` und [capture_method](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-payment_intent_data-capture_method) in der [CheckoutSession](https://docs.stripe.com/api/checkout/sessions/.md) ist auf `manual` gesetzt. > #### IC+-Funktion > > Mit dem Preismodell *IC+* (A pricing plan where businesses pay the variable network cost for each transaction plus the Stripe fee rather than a flat rate for all transactions. This pricing model provides more visibility into payments costs) erhalten Nutzer/innen Zugriff auf erweiterte Autorisierungen. Wenn Sie ein kombiniertes Preismodell von Stripe nutzen und auf diese Funktion zugreifen möchten, kontaktieren Sie uns unter [support.stripe.com](https://support.stripe.com). ### Verfügbarkeit nach Kartennetzwerk und Händlerkategorie Jedes Kartennetzwerk hat andere Regeln, die bestimmen, für welche Zahlungen erweiterte Autorisierungen möglich sind und wie lange sie gültig sind. Die folgende Tabelle zeigt die Gültigkeitsfenster und Transaktionsarten, für die die erweiterte Autorisierung mit Visa, Mastercard, American Express und Discover verfügbar ist. Wir empfehlen Ihnen jedoch, sich auf das [capture_before field](https://docs.stripe.com/api/charges/object.md#charge_object-payment_method_details-card-capture_before) zu verlassen, um das Gültigkeitsfenster für eine beliebige Zahlung zu bestätigen, da sich diese Regeln ohne vorherige Ankündigung ändern können. | Kartenmarke | Händlerkategorie | Erweitertes Gültigkeitsfenster der Autorisierung | | ------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------ | | **Visa** | Hotel, Unterkunft, Autovermietung und Kreuzfahrtlinie Alle anderen Händlerkategorien* | 30 Tage** | | **Mastercard** (schließt Maestro und Cirrus-Karten nicht ein) | Alle Händlerkategorien | 30 Tage | | **American Express** | Unterkünfte und Mietfahrzeuge | 30 Tage*** | | **Discover** | Fluggesellschaft, Bus-Charter/Bustour, Autovermietung, Kreuzfahrtschiffe, Nah-/Vorstadtpendler, Personenbeförderung einschließlich Fähren, Hotel, Unterkunft und Schienenpersonenverkehr | 30 Tage | Für andere Händlerkategorien erhebt Stripe eine zusätzliche Gebühr von 0,08 % pro Transaktion. Das erweiterte Zeitfenster gilt nur für [von Kundinnen/Kunden initiierte Transaktionen](https://docs.stripe.com/payments/cits-and-mits.md) und nicht für Transaktionen mit Unternehmen in Japan oder Transaktionen im Zusammenhang mit dem Gesundheitswesen, der Bezahlung von Rechnungen und der Tilgung von Schulden. ** Das genaue erweiterte Autorisierungsfenster für Visa umfasst 29 Tage und 18 Stunden, um Zeit für Clearing-Prozesse einzuräumen.*** Obwohl Ihr Gültigkeitsfenster auf 30 Tage verlängert wurde, dürfen Sie die autorisierten Gelder spätestens am Ende des Aufenthalts oder des Mietzeitraums Ihres Kunden/Ihrer Kundin erfassen. ### Netzwerke mit eingeschränktem Support (Beta) Die folgenden Kartennetzwerke bieten eingeschränkte Unterstützung für die erweiterte Autorisierung: | Marke der Karte | Land der Händlerin/des Händlers | Händlerkategorie | Erweitertes Autorisierungs-Gültigkeitsfenster | | --------------- | ------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------- | | **Diners Club** | USA (über Discover) | Alle Händlerkategorien | 30 Tage | | **UnionPay** | Global, ohne USA und Kanada | Alle Händlerkategorien | 27 bis 29 Tage | | | USA und Kanada (über Discover) | Fluggesellschaft, Bus-Charter/Bustour, Autovermietung, Kreuzfahrtschiffe, Nah-/Vorstadtpendler, Personenbeförderung einschließlich Fähren, Hotel, Unterkunft und Schienenpersonenverkehr | 30 Tage | ### Kürzlich geänderte Verfügbarkeit - **September 2023**: Für die folgenden Händlerkategorien sind entsprechend der vom Netzwerk bereitgestellten Informationen erweiterte Genehmigungen für Discover nicht mehr verfügbar: Restaurants und Gaststätten, Bootsverleih, Wohnmobil-Verleih, LKW-Verleih, Ferienwohnrecht (Timesharing), Taxiunternehmen/Limousinenservice, Wohnwagensiedlung, Campingplatz, Geräte- und Mobiliarverleih sowie Verleih von Hausgeräten, Freizeitparks, Zirkusse, Wahrsager, Vergnügungsparks, Freizeiteinrichtungen. - **September 2023**: Die Gültigkeitsdauer der Autorisierung für Visa wurde von 31 auf 30 Tage verkürzt, um Netzwerkgebühren aufgrund fehlender Konformität zu vermeiden. Um sicherzustellen, dass Transaktionen innerhalb dieses Zeitfensters abgewickelt werden, haben wir einen Puffer von 6 Stunden hinzugefügt, wodurch das effektive Autorisierungsfenster auf 29 Tage und 18 Stunden festgelegt wird. ## Best Practices Die Gelder von Kundinnen und Kunden werden länger zurückgehalten, wenn Sie erweiterte Autorisierungen verwenden. Verwenden Sie klare [Zahlungsbeschreibungen in der Abrechnung](https://docs.stripe.com/get-started/account/statement-descriptors.md), um erhöhte Anfechtungen durch nicht zugeordnete Zahlungen zu vermeiden. Sie können das Feld [custom_text](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-custom_text) verwenden, wenn Sie eine neue [CheckoutSession](https://docs.stripe.com/api/checkout_sessions.md) 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 bei der Nutzung der erweiterten Autorisierung verantwortlich. Lesen Sie die Netzwerkspezifikationen der Kartennetzwerke, die Sie mit dieser Funktion akzeptieren möchten, um sicherzustellen, dass Ihre Verkäufe den geltenden Regeln entsprechen, die je nach Netzwerk variieren. Beispielsweise gelten für viele Netzwerke erweiterte Gültigkeitsfenster nur für Fälle, in denen Ihnen der endgültige Betrag, den Sie zum Zeitpunkt der Autorisierung erfassen werden, noch nicht bekannt ist. > > Die auf dieser Seite bereitgestellten Informationen bezüglich Ihrer Einhaltung dieser Anforderungen dienen Ihrer allgemeinen Orientierung und stellen keine rechtliche, steuerliche, buchhalterische oder andere professionelle Beratung dar. Wenden Sie sich an eine Fachperson, wenn Sie sich bezüglich Ihrer Verpflichtungen unsicher sind. ## CheckoutSession erstellen Fügen Sie Ihrer Website eine Schaltfläche zum Bezahlen hinzu, über die ein serverseitiger Endpoint aufgerufen wird, um eine [Checkout-Sitzung](https://docs.stripe.com/api/checkout/sessions/create.md) zu erstellen. ```html Buy cool new product
``` 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](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-line_items) für die Zahlungsabwicklung - Zu verwendende Währungen Sie müssen `success_url` mit dem URL-Wert einer Seite auf Ihrer Website ausfüllen, zu der Checkout Ihre Kundinnen und Kunden nach Abschluss der Zahlung zurückleitet. > 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](https://docs.stripe.com/api/checkout/sessions/object.md#checkout_session_object-url) weiter. Um die erweiterte Autorisierungsfunktion zu aktivieren, legen Sie [request_extended_authorization](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-payment_method_options-card-request_extended_authorization) auf `if_available` fest. #### Ruby ```ruby # This example sets up an endpoint using the Sinatra framework. require 'json' require 'sinatra' require 'stripe' # Don't put any keys in code. See https://docs.stripe.com/keys-best-practices. # Find your keys at https://dashboard.stripe.com/apikeys. Stripe.api_key = '<>' post '/create-checkout-session' do session = Stripe::Checkout::Session.create({ line_items: [{ price_data: { currency: 'usd', product_data: { name: 'T-shirt' }, unit_amount: 2000 }, quantity: 1 }],payment_method_options: { card: { request_extended_authorization: 'if_available' } }, mode: 'payment', # These placeholder URLs will be replaced in a following step. success_url: 'https://example.com/success' }) redirect session.url, 303 end ``` Das Feld [capture_before field](https://docs.stripe.com/api/charges/object.md#charge_object-payment_method_details-card-capture_before) bestätigt Ihnen das Gültigkeitsfenster für eine bestimmte Zahlung. Nachdem die CheckoutSession abgeschlossen ist, ändert sich das Gültigkeitsfenster nicht mehr. Um festzustellen, ob die Autorisierung nach Abschluss der CheckoutSession verlängert wird, sehen Sie sich das [Feld extended_authorization.status](https://docs.stripe.com/api/charges/object.md#charge_object-payment_method_details-card-extended_authorization-status) auf der zugehörigen Zahlung an. ```json { "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,"capture_before": 1696524701, "extended_authorization": { "status": "enabled", // or "disabled" } } } ... } ... } ``` ## 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 erweiterte Autorisierungen anzufordern. Wenn erweiterte Autorisierungen für Zahlungen für ein bestimmtes Netzwerk während des Testens verfügbar sind, sind sie auch für Live-Zahlungen verfügbar. | Marke der Karte | Die Nummer | Zahlungsmethode | | --------------- | ---------------- | -------------------- | | Visa | 4242424242424242 | `pm_card_visa` | | Mastercard | 5555555555554444 | `pm_card_mastercard` | | Amex | 378282246310005 | `pm_card_amex` | | Discover | 6011111111111117 | `pm_card_discover` | # Eingebettete Seite > This is a Eingebettete Seite for when platform is web and ui is embedded-form. View the full page at https://docs.stripe.com/payments/extended-authorization?platform=web&ui=embedded-form. Erweiterte Autorisierungen haben eine längere Gültigkeitsdauer für Autorisierungen, sodass Sie Kundengelder länger als in den Standard-Gültigkeitsfenstern für Autorisierungen aufbewahren können. Für die meisten Kartennetzwerke beträgt die standardmäßige Gültigkeitsdauer der Autorisierung 7 Tage für Online-Zahlungen und 2 Tage für persönliche [Terminal](https://docs.stripe.com/terminal.md)-Zahlungen, während die verlängerte Gültigkeitsdauer je nach Kartennetzwerk bis zu 30 Tage betragen kann. Weitere Informationen zu den Gültigkeitsfenstern für Autorisierungen finden Sie unter [Zurückstellen einer Zahlungsmethode](https://docs.stripe.com/payments/place-a-hold-on-a-payment-method.md). ## Verfügbarkeit Wenn Sie erweiterte Autorisierungen verwenden, gibt es keine regionalen Einschränkungen. Beachten Sie jedoch die folgenden Einschränkungen: - Diese sind nur mit Visa, Mastercard, American Express und Discover verfügbar. - Für bestimmte Kartenmarken gelten Beschränkungen hinsichtlich der Händlerkategorie. Weitere Informationen finden Sie in der folgenden Tabelle zur Netzwerkverfügbarkeit. - Auf dieser Seite werden erweiterte Autorisierungen für Online-Kartenzahlungen beschrieben. Informationen zu persönlichen Kartenzahlungen mit erweiterten Autorisierungen finden Sie in der [Terminal-Dokumentation](https://docs.stripe.com/terminal/features/extended-authorizations.md). - [Modus](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-mode) ist auf `payment` und [capture_method](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-payment_intent_data-capture_method) in der [CheckoutSession](https://docs.stripe.com/api/checkout/sessions/.md) ist auf `manual` gesetzt. > #### IC+-Funktion > > Mit dem Preismodell *IC+* (A pricing plan where businesses pay the variable network cost for each transaction plus the Stripe fee rather than a flat rate for all transactions. This pricing model provides more visibility into payments costs) erhalten Nutzer/innen Zugriff auf erweiterte Autorisierungen. Wenn Sie ein kombiniertes Preismodell von Stripe nutzen und auf diese Funktion zugreifen möchten, kontaktieren Sie uns unter [support.stripe.com](https://support.stripe.com). ### Verfügbarkeit nach Kartennetzwerk und Händlerkategorie Jedes Kartennetzwerk hat andere Regeln, die bestimmen, für welche Zahlungen erweiterte Autorisierungen möglich sind und wie lange sie gültig sind. Die folgende Tabelle zeigt die Gültigkeitsfenster und Transaktionsarten, für die die erweiterte Autorisierung mit Visa, Mastercard, American Express und Discover verfügbar ist. Wir empfehlen Ihnen jedoch, sich auf das [capture_before field](https://docs.stripe.com/api/charges/object.md#charge_object-payment_method_details-card-capture_before) zu verlassen, um das Gültigkeitsfenster für eine beliebige Zahlung zu bestätigen, da sich diese Regeln ohne vorherige Ankündigung ändern können. | Kartenmarke | Händlerkategorie | Erweitertes Gültigkeitsfenster der Autorisierung | | ------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------ | | **Visa** | Hotel, Unterkunft, Autovermietung und Kreuzfahrtlinie Alle anderen Händlerkategorien* | 30 Tage** | | **Mastercard** (schließt Maestro und Cirrus-Karten nicht ein) | Alle Händlerkategorien | 30 Tage | | **American Express** | Unterkünfte und Mietfahrzeuge | 30 Tage*** | | **Discover** | Fluggesellschaft, Bus-Charter/Bustour, Autovermietung, Kreuzfahrtschiffe, Nah-/Vorstadtpendler, Personenbeförderung einschließlich Fähren, Hotel, Unterkunft und Schienenpersonenverkehr | 30 Tage | Für andere Händlerkategorien erhebt Stripe eine zusätzliche Gebühr von 0,08 % pro Transaktion. Das erweiterte Zeitfenster gilt nur für [von Kundinnen/Kunden initiierte Transaktionen](https://docs.stripe.com/payments/cits-and-mits.md) und nicht für Transaktionen mit Unternehmen in Japan oder Transaktionen im Zusammenhang mit dem Gesundheitswesen, der Bezahlung von Rechnungen und der Tilgung von Schulden. ** Das genaue erweiterte Autorisierungsfenster für Visa umfasst 29 Tage und 18 Stunden, um Zeit für Clearing-Prozesse einzuräumen.*** Obwohl Ihr Gültigkeitsfenster auf 30 Tage verlängert wurde, dürfen Sie die autorisierten Gelder spätestens am Ende des Aufenthalts oder des Mietzeitraums Ihres Kunden/Ihrer Kundin erfassen. ### Netzwerke mit eingeschränktem Support (Beta) Die folgenden Kartennetzwerke bieten eingeschränkte Unterstützung für die erweiterte Autorisierung: | Marke der Karte | Land der Händlerin/des Händlers | Händlerkategorie | Erweitertes Autorisierungs-Gültigkeitsfenster | | --------------- | ------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------- | | **Diners Club** | USA (über Discover) | Alle Händlerkategorien | 30 Tage | | **UnionPay** | Global, ohne USA und Kanada | Alle Händlerkategorien | 27 bis 29 Tage | | | USA und Kanada (über Discover) | Fluggesellschaft, Bus-Charter/Bustour, Autovermietung, Kreuzfahrtschiffe, Nah-/Vorstadtpendler, Personenbeförderung einschließlich Fähren, Hotel, Unterkunft und Schienenpersonenverkehr | 30 Tage | ### Kürzlich geänderte Verfügbarkeit - **September 2023**: Für die folgenden Händlerkategorien sind entsprechend der vom Netzwerk bereitgestellten Informationen erweiterte Genehmigungen für Discover nicht mehr verfügbar: Restaurants und Gaststätten, Bootsverleih, Wohnmobil-Verleih, LKW-Verleih, Ferienwohnrecht (Timesharing), Taxiunternehmen/Limousinenservice, Wohnwagensiedlung, Campingplatz, Geräte- und Mobiliarverleih sowie Verleih von Hausgeräten, Freizeitparks, Zirkusse, Wahrsager, Vergnügungsparks, Freizeiteinrichtungen. - **September 2023**: Die Gültigkeitsdauer der Autorisierung für Visa wurde von 31 auf 30 Tage verkürzt, um Netzwerkgebühren aufgrund fehlender Konformität zu vermeiden. Um sicherzustellen, dass Transaktionen innerhalb dieses Zeitfensters abgewickelt werden, haben wir einen Puffer von 6 Stunden hinzugefügt, wodurch das effektive Autorisierungsfenster auf 29 Tage und 18 Stunden festgelegt wird. ## Best Practices Die Gelder von Kundinnen und Kunden werden länger zurückgehalten, wenn Sie erweiterte Autorisierungen verwenden. Verwenden Sie klare [Zahlungsbeschreibungen in der Abrechnung](https://docs.stripe.com/get-started/account/statement-descriptors.md), um erhöhte Anfechtungen durch nicht zugeordnete Zahlungen zu vermeiden. Sie können das Feld [custom_text](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-custom_text) verwenden, wenn Sie eine neue [CheckoutSession](https://docs.stripe.com/api/checkout_sessions.md) 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 bei der Nutzung der erweiterten Autorisierung verantwortlich. Lesen Sie die Netzwerkspezifikationen der Kartennetzwerke, die Sie mit dieser Funktion akzeptieren möchten, um sicherzustellen, dass Ihre Verkäufe den geltenden Regeln entsprechen, die je nach Netzwerk variieren. Beispielsweise gelten für viele Netzwerke erweiterte Gültigkeitsfenster nur für Fälle, in denen Ihnen der endgültige Betrag, den Sie zum Zeitpunkt der Autorisierung erfassen werden, noch nicht bekannt ist. > > Die auf dieser Seite bereitgestellten Informationen bezüglich Ihrer Einhaltung dieser Anforderungen dienen Ihrer allgemeinen Orientierung und stellen keine rechtliche, steuerliche, buchhalterische oder andere professionelle Beratung dar. Wenden Sie sich an eine Fachperson, wenn Sie sich bezüglich Ihrer Verpflichtungen unsicher sind. ## CheckoutSession erstellen Erstellen Sie auf Ihrem Server eine *Checkout-Session* (A Checkout Session represents your customer's session as they pay for one-time purchases or subscriptions through Checkout. After a successful payment, the Checkout Session contains a reference to the Customer, and either the successful PaymentIntent or an active Subscription) und legen Sie den [Nutzeroberflächen_Modus](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-ui_mode) auf `embedded_page` fest. Sie können die [Checkout-Session](https://docs.stripe.com/api/checkout/sessions/create.md) so konfigurieren, dass [Posten](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-line_items) und Optionen wie die [Währung](https://docs.stripe.com/api/checkout/sessions/object.md#checkout_session_object-currency) enthalten sind. Um Kundinnen/Kunden zu einer nutzerdefinierten Seite zurückzuleiten, die Sie auf Ihrer Website hosten, geben Sie die URL dieser Seite im Parameter [return_url](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-return_url) an. Fügen Sie die Vorlagenvariable `{CHECKOUT_SESSION_ID}` in die URL ein, um den Status der Sitzung auf der Rückgabeseite abzurufen. Checkout ersetzt die Variable vor der Weiterleitung automatisch durch die Checkout-Sitzungs-ID. Erfahren Sie mehr über die [Konfiguration der Rückgabeseite](https://docs.stripe.com/payments/accept-a-payment.md?payment-ui=checkout&ui=embedded-form#return-page) und andere Optionen zum [Anpassen des Weiterleitungsverhaltens](https://docs.stripe.com/payments/checkout/custom-success-page.md?payment-ui=embedded-form). Nachdem Sie die Checkout-Sitzung erstellt haben, verwenden Sie das `client_secret`, das in der Antwort auf [Checkout verbinden](https://docs.stripe.com/payments/extended-authorization.md#mount-checkout) zurückgegeben wurde. Um die erweiterte Autorisierungsfunktion zu aktivieren, legen Sie [request_extended_authorization](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-payment_method_options-card-request_extended_authorization) auf `if_available` fest. #### Ruby ```ruby # This example sets up an endpoint using the Sinatra framework. require 'json' require 'sinatra' require 'stripe' # Don't put any keys in code. See https://docs.stripe.com/keys-best-practices. # Find your keys at https://dashboard.stripe.com/apikeys. Stripe.api_key = '<>' post '/create-checkout-session' do session = Stripe::Checkout::Session.create({ line_items: [{ price_data: { currency: 'usd', product_data: { name: 'T-shirt', }, unit_amount: 2000, }, quantity: 1, }], mode: 'payment', ui_mode: 'embedded_page',payment_method_options: { card: { request_extended_authorization: 'if_available', }, }, return_url: 'https://example.com/checkout/return?session_id={CHECKOUT_SESSION_ID}' }) {clientSecret: session.client_secret}.to_json end ``` Das Feld [capture_before field](https://docs.stripe.com/api/charges/object.md#charge_object-payment_method_details-card-capture_before) bestätigt Ihnen das Gültigkeitsfenster für eine bestimmte Zahlung. Nachdem die CheckoutSession abgeschlossen ist, ändert sich das Gültigkeitsfenster nicht mehr. Um nach Abschluss der CheckoutSession festzustellen, ob es sich um eine verlängerte Autorisierung handelt, sehen Sie sich [extended_authorization.status field](https://docs.stripe.com/api/charges/object.md#charge_object-payment_method_details-card-extended_authorization-status) für die zugehörige Zahlung an. ```json { "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,"capture_before": 1696524701, "extended_authorization": { "status": "enabled", // or "disabled" } } } ... } ... } ``` ## Checkout verbinden #### HTML + JS Checkout ist als Teil von [Stripe.js](https://docs.stripe.com/js.md) verfügbar. Nehmen Sie das Stripe.js-Skript in Ihre Seite auf, indem Sie es zum Header Ihrer HTML-Datei hinzufügen. Als Nächstes erstellen Sie einen leeren DOM-Knoten (Container), der zum Verbinden verwendet wird. ```html
``` Initialisieren Sie Stripe.js mit Ihrem veröffentlichbaren API-Schlüssel. Erstellen Sie eine asynchrone `fetchClientSecret`-Funktion, die eine Anfrage an Ihren Server stellt, um eine Checkout-Sitzung zu erstellen und das Client-Geheimnis abzurufen. Übergeben Sie diese Funktion an `options`, wenn Sie die Checkout-Instanz erstellen: ```javascript // Initialize Stripe.js const stripe = Stripe('<>'); initialize(); // Fetch Checkout Session and retrieve the client secret async function initialize() { const fetchClientSecret = async () => { const response = await fetch("/create-checkout-session", { method: "POST", }); const { clientSecret } = await response.json(); return clientSecret; }; // Initialize Checkout const checkout = await stripe.createEmbeddedCheckoutPage({ fetchClientSecret, }); // Mount Checkout checkout.mount('#checkout'); } ``` #### React Installieren Sie [react-stripe-js](https://docs.stripe.com/sdks/stripejs-react.md) und den Stripe.js-Loader von npm: ```bash npm install --save @stripe/react-stripe-js @stripe/stripe-js ``` Um die eingebettete Checkout-Komponente zu verwenden, erstellen Sie einen `EmbeddedCheckoutProvider`. Rufen Sie `loadStripe` mit Ihrem veröffentlichbaren API-Schlüssel auf und übergeben Sie das zurückgegebene `Promise` an den Anbieter. Erstellen Sie eine asynchrone `fetchClientSecret`-Funktion, die eine Anfrage an Ihren Server stellt, um eine Checkout-Sitzung zu erstellen und das Client-Geheimnis abzurufen. Übergeben Sie diese Funktion an die vom Anbieter akzeptierte Eigenschaft `options`. ```jsx import * as React from 'react'; import {loadStripe} from '@stripe/stripe-js'; import { EmbeddedCheckoutProvider, EmbeddedCheckout } from '@stripe/react-stripe-js'; // Make sure to call `loadStripe` outside of a component’s render to avoid // recreating the `Stripe` object on every render. const stripePromise = loadStripe('pk_test_123'); const App = () => { const fetchClientSecret = React.useCallback(() => { // Create a Checkout Session return fetch("/create-checkout-session", { method: "POST", }) .then((res) => res.json()) .then((data) => data.clientSecret); }, []); const options = {fetchClientSecret}; return (
) } ``` Checkout wird in einem iFrame gerendert, der Zahlungsdaten sicher über eine HTTPS-Verbindung an Stripe sendet. > Vermeiden Sie es, Checkout in einem anderen iFrame zu platzieren, da bei einigen Zahlungsmethoden die Weiterleitung an eine andere Seite zur Zahlungsbestätigung erforderlich ist. ### Erscheinungsbild anpassen Passen Sie Checkout an das Design Ihrer Website an, indem Sie Hintergrundfarbe, Schaltflächenfarbe, Rahmenradius und Schriftarten in den [Branding-Einstellungen](https://dashboard.stripe.com/settings/branding) Ihres Kontos festlegen. Checkout wird standardmäßig ohne externes Padding oder Ränder gerendert. Um Ihren gewünschten Rand hinzuzufügen (z. B. 16px auf allen Seiten), empfehlen wir, ein Container-Element zu verwenden. ## Eine Rückgabeseite anzeigen Nachdem Ihre Kundinnen/Kunden einen Zahlungsversuch unternommen haben, leitet Stripe sie zu einer Rückgabeseite weiter, die Sie auf Ihrer Website hosten. Beim Erstellen der Checkout-Sitzung haben Sie die URL der Rückgabeseite im Parameter [return_url](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-return_url) angegeben. Erfahren Sie mehr über andere Optionen zum [Anpassen des Weiterleitungsverhaltens](https://docs.stripe.com/payments/checkout/custom-success-page.md?payment-ui=embedded-form). Rufen Sie beim Rendern Ihrer Rückgabeseite den Status der Checkout-Sitzung mithilfe der Checkout-Sitzungs-ID in der URL ab. Verarbeiten Sie das Ergebnis entsprechend dem Sitzungsstatus wie folgt: - `complete`: Die Zahlung war erfolgreich. Verwenden Sie die Informationen aus der Checkout-Sitzung, um eine Bestätigungsseite zu rendern. - `open`: Die Zahlung ist fehlgeschlagen oder wurde storniert. Stellen Sie erneut eine Verbindung zu Checkout her, damit Ihre Kundinnen/Kunden es erneut versuchen können. #### Ruby ```ruby get '/session-status' do session = Stripe::Checkout::Session.retrieve(params[:session_id]) {status: session.status, customer_email: session.customer_details.email}.to_json end ``` ```javascript const session = await fetch(`/session_status?session_id=${session_id}`) if (session.status == 'open') { // Remount embedded Checkout } else if (session.status == 'complete') { // Show success page // Optionally use session.payment_status or session.customer_email // to customize the success page } ``` #### Auf Weiterleitung basierende Zahlungsmethoden Während der Zahlung leiten einige Zahlungsmethoden die Kundin/den Kunden auf eine Zwischenseite weiter, zum Beispiel eine Bankautorisierungsseite. Wenn sie diese Seite ausgefüllt haben, leitet Stripe sie zu Ihrer Rückgabeseite weiter. Erfahren Sie mehr über [auf Weiterleitung basierende Zahlungsmethoden und das Weiterleitungsverhalten](https://docs.stripe.com/payments/checkout/custom-success-page.md?payment-ui=embedded-form#redirect-based-payment-methods). ## 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 erweiterte Autorisierungen anzufordern. Wenn erweiterte Autorisierungen für Zahlungen für ein bestimmtes Netzwerk während des Testens verfügbar sind, sind sie auch für Live-Zahlungen verfügbar. | Marke der Karte | Die Nummer | Zahlungsmethode | | --------------- | ---------------- | -------------------- | | Visa | 4242424242424242 | `pm_card_visa` | | Mastercard | 5555555555554444 | `pm_card_mastercard` | | Amex | 378282246310005 | `pm_card_amex` | | Discover | 6011111111111117 | `pm_card_discover` | # Erweiterte Integration > This is a Erweiterte Integration for when platform is web and ui is elements. View the full page at https://docs.stripe.com/payments/extended-authorization?platform=web&ui=elements. Erweiterte Autorisierungen haben eine längere Gültigkeitsdauer für Autorisierungen, sodass Sie Kundengelder länger als in den Standard-Gültigkeitsfenstern für Autorisierungen aufbewahren können. Für die meisten Kartennetzwerke beträgt die standardmäßige Gültigkeitsdauer der Autorisierung 7 Tage für Online-Zahlungen und 2 Tage für persönliche [Terminal](https://docs.stripe.com/terminal.md)-Zahlungen, während die verlängerte Gültigkeitsdauer je nach Kartennetzwerk bis zu 30 Tage betragen kann. Weitere Informationen zu den Gültigkeitsfenstern für Autorisierungen finden Sie unter [Zurückstellen einer Zahlungsmethode](https://docs.stripe.com/payments/place-a-hold-on-a-payment-method.md). ## Verfügbarkeit Wenn Sie erweiterte Autorisierungen verwenden, gibt es keine regionalen Einschränkungen. Beachten Sie jedoch die folgenden Einschränkungen: - Diese sind nur mit Visa, Mastercard, American Express und Discover verfügbar. - Für bestimmte Kartenmarken gelten Beschränkungen hinsichtlich der Händlerkategorie. Weitere Informationen finden Sie in der folgenden Tabelle zur Netzwerkverfügbarkeit. - Auf dieser Seite werden erweiterte Autorisierungen für Online-Kartenzahlungen beschrieben. Informationen zu persönlichen Kartenzahlungen mit erweiterten Autorisierungen finden Sie in der [Terminal-Dokumentation](https://docs.stripe.com/terminal/features/extended-authorizations.md). - [capture_method](https://docs.stripe.com/api/payment_intents/create.md#create_payment_intent-capture_method) ist für den [PaymentIntent](https://docs.stripe.com/api/payment_intents/.md) auf `manual` eingestellt. > #### IC+-Funktion > > Mit dem Preismodell *IC+* (A pricing plan where businesses pay the variable network cost for each transaction plus the Stripe fee rather than a flat rate for all transactions. This pricing model provides more visibility into payments costs) erhalten Nutzer/innen Zugriff auf erweiterte Autorisierungen. Wenn Sie ein kombiniertes Preismodell von Stripe nutzen und auf diese Funktion zugreifen möchten, kontaktieren Sie uns unter [support.stripe.com](https://support.stripe.com). ### Verfügbarkeit nach Kartennetzwerk und Händlerkategorie Jedes Kartennetzwerk hat andere Regeln, die bestimmen, für welche Zahlungen erweiterte Autorisierungen möglich sind und wie lange sie gültig sind. Die folgende Tabelle zeigt die Gültigkeitsfenster und Transaktionsarten, für die die erweiterte Autorisierung mit Visa, Mastercard, American Express und Discover verfügbar ist. Wir empfehlen Ihnen jedoch, sich auf das [capture_before field](https://docs.stripe.com/api/charges/object.md#charge_object-payment_method_details-card-capture_before) zu verlassen, um das Gültigkeitsfenster für eine beliebige Zahlung zu bestätigen, da sich diese Regeln ohne vorherige Ankündigung ändern können. | Kartenmarke | Händlerkategorie | Erweitertes Gültigkeitsfenster der Autorisierung | | ------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------ | | **Visa** | Hotel, Unterkunft, Autovermietung und Kreuzfahrtlinie Alle anderen Händlerkategorien* | 30 Tage** | | **Mastercard** (schließt Maestro und Cirrus-Karten nicht ein) | Alle Händlerkategorien | 30 Tage | | **American Express** | Unterkünfte und Mietfahrzeuge | 30 Tage*** | | **Discover** | Fluggesellschaft, Bus-Charter/Bustour, Autovermietung, Kreuzfahrtschiffe, Nah-/Vorstadtpendler, Personenbeförderung einschließlich Fähren, Hotel, Unterkunft und Schienenpersonenverkehr | 30 Tage | Für andere Händlerkategorien erhebt Stripe eine zusätzliche Gebühr von 0,08 % pro Transaktion. Das erweiterte Zeitfenster gilt nur für [von Kundinnen/Kunden initiierte Transaktionen](https://docs.stripe.com/payments/cits-and-mits.md) und nicht für Transaktionen mit Unternehmen in Japan oder Transaktionen im Zusammenhang mit dem Gesundheitswesen, der Bezahlung von Rechnungen und der Tilgung von Schulden. ** Das genaue erweiterte Autorisierungsfenster für Visa umfasst 29 Tage und 18 Stunden, um Zeit für Clearing-Prozesse einzuräumen.*** Obwohl Ihr Gültigkeitsfenster auf 30 Tage verlängert wurde, dürfen Sie die autorisierten Gelder spätestens am Ende des Aufenthalts oder des Mietzeitraums Ihres Kunden/Ihrer Kundin erfassen. ### Netzwerke mit eingeschränktem Support (Beta) Die folgenden Kartennetzwerke bieten eingeschränkte Unterstützung für die erweiterte Autorisierung: | Marke der Karte | Land der Händlerin/des Händlers | Händlerkategorie | Erweitertes Autorisierungs-Gültigkeitsfenster | | --------------- | ------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------- | | **Diners Club** | USA (über Discover) | Alle Händlerkategorien | 30 Tage | | **UnionPay** | Global, ohne USA und Kanada | Alle Händlerkategorien | 27 bis 29 Tage | | | USA und Kanada (über Discover) | Fluggesellschaft, Bus-Charter/Bustour, Autovermietung, Kreuzfahrtschiffe, Nah-/Vorstadtpendler, Personenbeförderung einschließlich Fähren, Hotel, Unterkunft und Schienenpersonenverkehr | 30 Tage | ### Kürzlich geänderte Verfügbarkeit - **September 2023**: Für die folgenden Händlerkategorien sind entsprechend der vom Netzwerk bereitgestellten Informationen erweiterte Genehmigungen für Discover nicht mehr verfügbar: Restaurants und Gaststätten, Bootsverleih, Wohnmobil-Verleih, LKW-Verleih, Ferienwohnrecht (Timesharing), Taxiunternehmen/Limousinenservice, Wohnwagensiedlung, Campingplatz, Geräte- und Mobiliarverleih sowie Verleih von Hausgeräten, Freizeitparks, Zirkusse, Wahrsager, Vergnügungsparks, Freizeiteinrichtungen. - **September 2023**: Die Gültigkeitsdauer der Autorisierung für Visa wurde von 31 auf 30 Tage verkürzt, um Netzwerkgebühren aufgrund fehlender Konformität zu vermeiden. Um sicherzustellen, dass Transaktionen innerhalb dieses Zeitfensters abgewickelt werden, haben wir einen Puffer von 6 Stunden hinzugefügt, wodurch das effektive Autorisierungsfenster auf 29 Tage und 18 Stunden festgelegt wird. ## Best Practices Die Gelder von Kundinnen und Kunden werden länger zurückgehalten, wenn Sie erweiterte Autorisierungen verwenden. Verwenden Sie klare [Zahlungsbeschreibungen in der Abrechnung](https://docs.stripe.com/get-started/account/statement-descriptors.md), um erhöhte Anfechtungen durch nicht zugeordnete Zahlungen zu vermeiden. > #### Compliance > > Sie sind für die Einhaltung aller geltenden Gesetze, Vorschriften und Netzwerkregeln bei der Nutzung der erweiterten Autorisierung verantwortlich. Lesen Sie die Netzwerkspezifikationen der Kartennetzwerke, die Sie mit dieser Funktion akzeptieren möchten, um sicherzustellen, dass Ihre Verkäufe den geltenden Regeln entsprechen, die je nach Netzwerk variieren. Beispielsweise gelten für viele Netzwerke erweiterte Gültigkeitsfenster nur für Fälle, in denen Ihnen der endgültige Betrag, den Sie zum Zeitpunkt der Autorisierung erfassen werden, noch nicht bekannt ist. > > Die auf dieser Seite bereitgestellten Informationen bezüglich Ihrer Einhaltung dieser Anforderungen dienen Ihrer allgemeinen Orientierung und stellen keine rechtliche, steuerliche, buchhalterische oder andere 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 Standardmäßig ist für die meisten Kartennetzwerke eine Autorisierung für eine Online-Kartenzahlung 7 Tage lang gültig. Um die Gültigkeitsdauer zu verlängern, können Sie mithilfe von `if_available` mit dem Parameter [request_extended_authorization](https://docs.stripe.com/api/payment_intents/confirm.md#confirm_payment_intent-payment_method_options-card-request_extended_authorization) eine erweiterte Autorisierung anfordern. ```curl curl https://api.stripe.com/v1/payment_intents \ -u "<>:" \ -d amount=1099 \ -d currency=usd \ -d payment_method=pm_card_visa \ -d confirm=true \ -d capture_method=manual \ -d "expand[]=latest_charge" \ -d "payment_method_options[card][request_extended_authorization]=if_available" ``` Das Feld [capture_before field](https://docs.stripe.com/api/charges/object.md#charge_object-payment_method_details-card-capture_before) bestätigt Ihnen das Gültigkeitsfenster für eine bestimmte Zahlung. Nachdem der PaymentIntent bestätigt ist, ändert sich das Gültigkeitsfenster nicht mehr. Um nach der Bestätigung des PaymentIntent festzustellen, ob es sich um eine verlängerte Autorisierung handelt, sehen Sie sich [extended_authorization.status field](https://docs.stripe.com/api/charges/object.md#charge_object-payment_method_details-card-extended_authorization-status) für die zugehörige Zahlung an. ```json // 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,"capture_before": 1696524701, "extended_authorization": { "status": "enabled", // or "disabled" } } } ... } ... } ``` ## 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 erweiterte Autorisierungen anzufordern. Wenn erweiterte Autorisierungen für Zahlungen für ein bestimmtes Netzwerk während des Testens verfügbar sind, sind sie auch für Live-Zahlungen verfügbar. | Marke der Karte | Die Nummer | Zahlungsmethode | | --------------- | ---------------- | -------------------- | | Visa | 4242424242424242 | `pm_card_visa` | | Mastercard | 5555555555554444 | `pm_card_mastercard` | | Amex | 378282246310005 | `pm_card_amex` | | Discover | 6011111111111117 | `pm_card_discover` | ## See also - [Eine Zahlungsmethode zurückstellen](https://docs.stripe.com/payments/place-a-hold-on-a-payment-method.md)