Weiter zum Inhalt
Konto erstellen
 oder
anmelden
Das Logo der Stripe-Dokumentation
/
Konto erstellen
Anmelden
ÜbersichtAktualisieren Sie Ihre Integration
Online-Zahlungen
ÜbersichtIhren Use case findenZahlungen verwalten
Zahlungsmethoden
Zahlungsschnittstellen
Zahlungsszenarien
Präsenzzahlungen
Mehr als Zahlungen

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.

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-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.

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.

IC+-Funktion

Mit dem Preismodell IC+ erhalten Nutzerinnen und Nutzer Zugriff auf erweiterte Autorisierungen. Wenn Sie ein gemischtes Stripe-Preismodell anbieten und auf diese Funktion zugreifen möchten, kontaktieren Sie uns unter 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 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.

KartenmarkeHändlerkategorieErweitertes 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ändlerkategorien30 Tage
American ExpressUnterkünfte und Mietfahrzeuge30 Tage***
DiscoverFluggesellschaft, Bus-Charter/Bustour, Autovermietung, Kreuzfahrtschiffe, Nah-/Vorstadtpendler, Personenbeförderung einschließlich Fähren, Hotel, Unterkunft und Schienenpersonenverkehr30 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 und nicht für Transaktionen mit Händlern/Händlerinnen in Japan. ** 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)

    Kürzlich geänderte Verfügbarkeit

    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, um erhöhte Anfechtungen durch nicht zugeordnete Zahlungen zu vermeiden.

    Sie können das Feld custom_text verwenden, wenn Sie eine neue CheckoutSession 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 von Ihrem Server aus eine Checkout-Sitzung und setzen Sie den ui_mode-Endpoint auf embedded. Sie können die Checkout-Sitzung mit den aufzunehmenden Posten und Optionen wie Währung konfigurieren.

    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 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 das Konfigurieren der Rückgabeseite und andere Optionen zum Anpassen des Weiterleitungsverhaltens.

    Nachdem Sie die Checkout-Sitzung erstellt haben, verwenden Sie das client_secret, das in der Antwort auf Checkout verbinden zurückgegeben wurde.

    Um die erweiterte Autorisierungsfunktion zu aktivieren, legen Sie request_extended_authorization auf if_available fest.

    # This example sets up an endpoint using the Sinatra framework.
# To learn more about Sinatra, watch this video: https://youtu.be/8aA9Enb8NVc.
require 'json'
require 'sinatra'
require 'stripe'

# Set your secret key. Remember to switch to your live secret key in production.
# See your keys here: https://dashboard.stripe.com/apikeys
Stripe.api_key = 
    'sk_test_BQokikJOvBiI2HlWgH4olfQ2'
    

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',
    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 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 für die zugehörige Zahlung an.

    {
  "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

    Checkout ist als Teil von Stripe.js 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.

    index.html
    <head>
  <script src="https://js.stripe.com/basil/stripe.js"></script>
</head>
<body>
  <div id="checkout">
    <!-- Checkout will insert the payment form here -->
  </div>
</body>

    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:

    index.js
    // Initialize Stripe.js
const stripe = Stripe(
    'pk_test_TYooMQauvdEDq54NiTphI7jx'
    );

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.initEmbeddedCheckout({
    fetchClientSecret,
  });

  // Mount Checkout
  checkout.mount('#checkout');
}

    Checkout wird in einem iFrame gerendert, der Zahlungsdaten sicher über eine HTTPS-Verbindung an Stripe sendet.

    Häufiger Fehler

    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 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 angegeben. Erfahren Sie mehr über andere Optionen zum Anpassen des Weiterleitungsverhaltens.

    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.
    get '/session-status' do
  session = Stripe::Checkout::Session.retrieve(params[:session_id])

  {status: session.status, customer_email:  session.customer_details.email}.to_json
end
    client.js
    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.

    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 KarteDie NummerZahlungsmethode
    Visapm_card_visa
    Mastercardpm_card_mastercard
    Amexpm_card_amex
    Discoverpm_card_discover

    Siehe auch

    War diese Seite hilfreich?
    JaNein
    Benötigen Sie Hilfe? Kontaktieren Sie den Kundensupport.
    Nehmen Sie an unserem Programm für frühzeitigen Zugriff teil.
    Schauen Sie sich unser Änderungsprotokoll an.
    Fragen? Sales-Team kontaktieren.
    LLM? Lesen Sie llms.txt.
    Unterstützt von Markdoc