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

Autorisierung erhöhen

Erhöhen Sie eine bestehende Autorisierung für einen bestätigten PaymentIntent, bevor Sie diesen erfassen.

Mit der inkrementellen Autorisierung können Sie den autorisierten Betrag für einen bestätigten PaymentIntent erhöhen, bevor Sie diesen erfassen. Vor der Erfassung wird jede inkrementelle Autorisierung auf der Kreditkartenabrechnung Ihrer Kundin/Ihres Kunden als zusätzlicher ausstehender Eintrag angezeigt (z. B. erscheinen eine auf von 10 USD auf 15 USD erhöhte Autorisierung als jeweils ausstehende Einträge über 10 USD und 5 USD). Nach der Erfassung werden die ausstehenden Autorisierungen entfernt und der erfasste Gesamtbetrag wird als ein einziger endgültiger Eintrag angezeigt.

Verfügbarkeit

Beachten Sie bei der Verwendung von inkrementellen Autorisierungen folgende Einschränkungen:

  • Nur mit Visa, Mastercard oder Discover verfügbar.
  • Für bestimmte Kartenmarken gelten Beschränkungen hinsichtlich der Händlerkategorie (siehe unten).

Weitere Informationen zu inkrementellen Autorisierungen und persönlichen Zahlungen mit Terminal finden Sie unter Inkrementelle Autorisierungen.

IC+-Funktion

Mit dem Preismodell IC+ erhalten Nutzerinnen und Nutzer Zugriff auf inkrementelle Autorisierungen. Wenn Sie ein Standard-Stripe-Preismodell nutzen und auf diese Funktion zugreifen möchten, erfahren Sie mehr unter support.stripe.com.

Verfügbarkeit nach Kartennetzwerk und Händlerkategorie

Verwenden Sie inkrementelle Autorisierungen für Zahlungen, die die nachfolgenden Kriterien erfüllen. Sie finden Ihre Nutzerkategorie im Dashboard.

Der Versuch, eine inkrementelle Autorisierung für eine Zahlung durchzuführen, die die folgenden Kriterien nicht erfüllt, resultiert in einem Fehler.

Marke der KarteLand des HändlersZahlungsartHändlerkategorie
VisaGlobalAlle KartenzahlungsartenAlle Nutzerkategorien
MastercardGlobal*Alle KartenzahlungsartenAlle Nutzerkategorien
DiscoverGlobalAlle KartenzahlungsartenAutovermietung, Hotels, Orts- und Pendlerverkehr, Personenbeförderung, einschließlich Fähren, Schienenpersonenverkehr, Buslinien-Charter, Tour, Dampf-/Kreuzfahrtschiffe, Vermietung und Leasing von Booten, Lebensmittelgeschäfte und Supermärkte, Laden von Elektrofahrzeugen, Gaststätten und Restaurants, Trinkhallen (alkoholische Getränke), Hotels, Motels, Resorts, Wohnwagenparks und Campingplätze, Vermietung und Leasing von Geräten/Werkzeugen/Möbeln/Haushaltsgeräten, Autovermietung, Vermietung von Lastkraftwagen und Nutzfahrzeugen, Vermietung von Wohnmobilen und Freizeitfahrzeugen, Parkplätze, Parkuhren und Parkhäuser, Vergnügungsparks, Zirkusse, Wahrsager, Freizeitdienstleistungen (nicht klassifiziert)
DiscoverGlobalCard Not PresentTaxifahrzeuge und Limousinen

  • MX-Nutzer/innen und JPY-Transaktionen für JP-Nutzer/innen ausgeschlossen

    • Netzwerke mit eingeschränktem Support (Beta)

    Inkrementelle Autorisierungen mit starker Kundenauthentifizierung (SCA)

    Wenn Sie und der/die Karteninhaber/in sich in einem Land mit SCA-Anforderungen befinden, müssen Sie bei der Verwendung der inkrementellen Autorisierung wichtige Dinge beachten.

    Wenn Sie die inkrementelle Autorisierung bei der Erstautorisierung anfordern, konfiguriert Stripe die Zahlungsmethode automatisch für zukünftige Off-Session-Nutzung. Obwohl dazu 3D Secure (3DS) für die anfängliche Autorisierung erforderlich ist, werden nachfolgende inkrementelle Autorisierungen für diese Zahlung als vom Händler initiiert angesehen, wodurch möglicherweise auf jede zusätzliche starke Kundenauthentifizierung verzichtet wird. Informieren Sie Ihre Kundinnen/Kunden bei der ersten Transaktion darüber, dass ihre Zahlung für zukünftige Off-Session-Nutzung mit den inkrementellen Autorisierungen gespeichert wird.

    Bei einigen 3DS-Transaktionen geht die Haftung für betrügerische Rückbuchungen (gestohlene oder gefälschte Karten) von Ihnen auf den/die Kartenaussteller/in über. Sie profitieren nicht von der Haftungsverlagerung, wenn Sie von Händlerinnen/Händlern initiierte Transaktionen übermitteln.

    Compliance

    Sie sind für die Einhaltung aller geltenden Gesetze, Vorschriften und Netzwerkregeln verantwortlich, wenn Sie die Zahlungsdaten eines Kunden/einer Kundin speichern. Zum Beispiel, wenn Sie ihre Zahlungsmethode für die zukünftige Verwendung speichern möchten, beispielsweise um Zahlungen zu tätigen, wenn sie Ihre Website oder App nicht aktiv nutzen. Fügen Sie Ihrer Website oder App Bedingungen hinzu, die angeben, wie Sie die Details zur Zahlungsmethode speichern und Kundinnen/Kunden die Möglichkeit geben, sich anzumelden.

    Wenn Sie Zahlungen offline vornehmen möchten, stellen Sie sicher, dass Ihre Bedingungen Folgendes enthalten:

    • Die kundenseitige Zustimmung, eine Zahlung oder mehrere Zahlungen für bestimmte Transaktionen in deren Namen einzuleiten.
    • Der erwartete Zeitpunkt und die voraussichtliche Häufigkeit von Zahlungen (z. B. Zahlungen für geplante Raten- oder Abonnementzahlungen oder für außerplanmäßige Aufstockungen).
    • Wie Sie den Zahlbetrag ermitteln.
    • Ihre Stornorichtlinie, wenn die Zahlungsmethode für einen Abonnementdienst ist.

    Dokumentieren Sie unbedingt die schriftliche Zustimmung Ihrer Kundinnen und Kunden zu diesen Bedingungen.

    Best Practices

    Wenn Sie die inkrementelle Autorisierung verwenden, sollten Sie Ihre Kundinnen und Kunden proaktiv über alle Autorisierungen für geschätzte Beträge benachrichtigen, die inkrementelle Autorisierungen nach sich ziehen können und die Beträge erhöhen. Im Folgenden finden Sie einige Best Practices.

    • Geben Sie an, dass eine Autorisierung für einen geschätzten Betrag erfolgt und dass während des Bezahlvorgangs bzw. vor dem Kaufabschluss weitere Autorisierungsanfragen folgen können.
    • Stützen Sie die geschätzten Beträge auf einer realistischen Schätzung des Gesamtbetrags der Transaktion.

    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 verantwortlich, wenn Sie inkrementelle Autorisierungen nutzen. Lesen Sie die Netzwerkregeln der Kartennetzwerke, für die Sie diese Funktion verwenden möchten, um sicherzustellen, dass Ihre Verkäufe den geltenden Regeln entsprechen, die je nach Netzwerk variieren. Beispielsweise schränken die meisten Kartennetzwerke die Berechnung der in der Erstautorisierung enthaltenen geschätzten Beträge ein. Sie verbieten die Verwendung von inkrementellen Autorisierungen für Transaktionen, bei denen der Transaktionsbetrag zum Zeitpunkt der Autorisierung bekannt sein sollte (z. B. bei wiederkehrenden Zahlungen für Abonnements).

    Die auf dieser Seite bereitgestellten Informationen im Zusammenhang mit der Einhaltung dieser Anforderungen dienen Ihrer allgemeinen Orientierung und stellen keine rechtliche, steuerliche, buchhalterische oder sonstige fachliche 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 zu erstellen.

    checkout.html
    <html>
  <head>
    <title>Buy cool new product</title>
  </head>
  <body>
    <!-- Use action="/create-checkout-session.php" if your server is PHP based. -->
    <form action="/create-checkout-session" method="POST">
      <button type="submit">Checkout</button>
    </form>
  </body>
</html>

    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 für die Zahlungsabwicklung
    • Zu verwendende Währungen

    Sie müssen success_url mit dem URL-Wert einer Seite auf Ihrer Website ausfüllen, an die Checkout Ihre Kundinnen und Kunden nach Abschluss der Zahlung zurückleitet. Optional können Sie auch einen cancel_url-Wert einer Seite auf Ihrer Website angeben, zu der Checkout Ihre Kundinnen/Kunden zurückleitet, wenn sie den Zahlungsvorgang vor Zahlungsabschluss abbrechen.

    Notiz

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

    Legen Sie abschließend request_incremental_authorization auf if_available fest, um die Funktion für inkrementelle Autorisierung zu aktivieren.

    # This example sets up an endpoint using the Sinatra framework.


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,
    }],
    payment_method_options: {
      card: {
        request_incremental_authorization: 'if_available',
      },
    },
    mode: 'payment',
    # These placeholder URLs will be replaced in a following step.
    success_url: 'https://example.com/success',
    cancel_url: 'https://example.com/cancel',
  })

  redirect session.url, 303
end

    Nachdem der Kunde/die Kundin den Bezahlvorgang abgeschlossen hat, enthält das Feld payment_method_details auf der latest_charge im PaymentIntent den Eintrag available oder unavailable, je nach der Kundenzahlungsmethode und den oben genannten Verfügbarkeitskriterien. Dadurch wird bestimmt, ob ein PaymentIntent für die inkrementelle Autorisierung infrage kommt oder nicht. (Wenn Sie beim Erstellen der CheckoutSession keine inkrementelle Autorisierung angefordert haben, ist diese unavailable.)

    {
  "id": "pi_ANipwO3zNfjeWODtRPIg",
  "object": "payment_intent",
  "amount": 1000,
  "amount_capturable": 1000,
  "amount_received": 0,
  ...
  // if latest_charge is expanded
  {
    "latest_charge": {
        "amount": 1000,
        "payment_method_details": {
          "card": {
            "incremental_authorization": {
                "status": "available" // or "unavailable"
            }
          }
        }
        ...
      }
  }

}

    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.

    Inkrementelle Autorisierung durchführen

    Um den autorisierten Betrag für einen PaymentIntent zu erhöhen, verwenden Sie den increment_authorization-Endpoint und geben Sie den aktualisierten Autorisierungsbetrag an, auf den erhöht werden soll. Dieser muss größer als der ursprünglich autorisierte Betrag sein. Dadurch wird versucht, einen höheren Betrag für die Karte Ihres Kunden/Ihrer Kundin zu autorisieren. Ein einzelner PaymentIntent kann diesen Endpoint mehrmals aufrufen, um den autorisierten Betrag weiter zu erhöhen.

    Sie haben maximal 10 inkrementelle Autorisierungsversuche pro PaymentIntent.

    Command Line
    curl https://api.stripe.com/v1/payment_intents/{{PAYMENT_INTENT_ID}}/increment_authorization \
  -u 
    sk_test_BQokikJOvBiI2HlWgH4olfQ2
    :     \
  -d "amount"=1500

    Wenn die inkrementelle Autorisierung erfolgreich war, wird das PaymentIntent-Objekt mit dem aktualisierten Betrag zurückgegeben. Schlägt die Autorisierung fehl, wird stattdessen der Fehler card_declined zurückgegeben. Das PaymentIntent-Objekt kann weiterhin für den zuvor autorisierten Betrag erfasst werden. Alle potenziellen Aktualisierungen anderer PaymentIntent-Felder (z. B. application_fee_amount, transfer_data, metadata, description, and statement_descriptor) werden nicht gespeichert, wenn die inkrementelle Autorisierung fehlschlägt.

    Die inkrementelle Autorisierung hat eine Obergrenze von entweder 500 USD (oder dem entsprechenden Betrag in lokaler Währung) oder 500 % über dem zuvor autorisierten Betrag (je nachdem, welcher Betrag höher ist) für jedes einzelne Inkrement.

    PaymentIntent erfassen

    Unabhängig davon, ob Sie den autorisierten Betrag für einen PaymentIntent mit einer inkrementellen Autorisierung erhöhen oder nicht, müssen Sie die Gelder erfassen, bevor die ursprüngliche Autorisierung abläuft. Inkrementelle Autorisierungen verlängern die Gültigkeitsdauer nicht. Um den autorisierten Betrag für einen PaymentIntent mit vorherigen inkrementellen Autorisierungen zu erfassen, verwenden Sie wie gewohnt den capture-Endpoint.

    Command Line
    curl https://api.stripe.com/v1/payment_intents/{{PAYMENT_INTENT_ID}}/capture \
  -u 
    sk_test_BQokikJOvBiI2HlWgH4olfQ2
    :

    Wenn die inkrementelle Autorisierung erfolgreich war, wird das erfasste PaymentIntent-Objekt mit dem aktualisierten Betrag zurückgegeben. Schlägt die Autorisierung fehl, wird stattdessen ein card_declined-Fehler zurückgegeben. Der PaymentIntent wird nicht erfasst, kann aber weiterhin für den zuvor autorisierten Betrag erfasst werden. Alle potenziellen Aktualisierungen an anderen PaymentIntent-Feldern (z. B. application_fee_amount, transfer_data, metadata, description and statement_descriptor) werden nicht gespeichert, wenn die inkrementelle Autorisierung fehlschlägt.

    Integration testen

    Verwenden Sie die Stripe-Testkarte für die inkrementelle Autorisierung mit einer beliebigen Prüfziffer (CVC), Postleitzahl und zukünftigem Ablaufdatum, um beim Testen inkrementelle Autorisierungen auszulösen:

    1. Erstellen Sie zunächst die CheckoutSession mit der Testkarte im obigen Schritt „CheckoutSession erstellen“.
    1. Führen Sie die inkrementelle Autorisierung mit den im obigen Schritt zur Durchführung einer inkrementellen Autorisierung angegebenen Parametern durch und verwenden Sie die Testkarte, um die inkrementelle Autorisierung auszulösen.
    Die NummerZahlungsmethodeBeschreibung
    pm_card_debit_incrementalAuthAuthorizedDadurch wird der Autorisierungsbetrag auf den in der Anfrage angegebenen Betrag erhöht.
    War diese Seite hilfreich?
    JaNein