Zahlungen für bestehende Kundinnen/Kunden

Erfahren Sie, wie Sie eine bestehende Zahlungsmethode belasten, während ein Kunde/eine Kundin On-Session ist.

Eine Checkout-Sitzung ermöglicht es Käuferinnen und Käufern, ihre Zahlungsinformationen einzugeben. Wenn der/die Käufer/in ein/e bestehende/r Kunde/Kundin ist, können Sie die Checkout-Sitzung so konfigurieren, dass die Details mit einer der gespeicherten Karten des Kunden/der Kundin vorausgefüllt werden.

Checkout-Sitzung erstellen
Clientseitig
Serverseitig

Fügen Sie Ihrer Website eine Schaltfläche zum Bezahlen hinzu, die einen serverseitigen Endpoint aufruft, um eine Checkout-Sitzung zu erstellen.

index.html
<html>
  <head>
    <title>Checkout</title>
  </head>
  <body>
    <form action="/create-checkout-session" method="POST">
      <button type="submit">Checkout</button>
    </form>
  </body>
</html>

Checkout unterstützt die Wiederverwendung vorhandener Kundenobjekte mit customer-Parameter. Bei der Wiederverwendung bestehender Kundinnen/Kunden werden alle von Checkout erstellten Objekte, wie Payment Intents und Subscriptions, diesem Kundenobjekt zugeordnet.

Hängen Sie die Vorlagenvariable {CHECKOUT_SESSION_ID} an die success_url an, um Zugriff auf die Sitzungs-ID zu erhalten, sobald Ihre Kundin/Ihr Kunde eine Checkout-Sitzung erfolgreich abgeschlossen hat. Leiten Sie Ihren Kunden/Ihre Kundin nach Erstellen der Checkout-Sitzung an die in der Antwort zurückgegebene URL weiter.

OptionalWeitere gespeicherte Zahlungsmethoden anzeigen
Serverseitig

Felder auf der Zahlungsseite vorab ausfüllen

If all the following conditions are true, Checkout prefills the email, name, card, and billing address fields on the payment page using details from the Customer’s saved card:

Checkout befindet sich im Modus payment oder subscription. Im Modus setup wird das Vorausfüllen von Feldern nicht unterstützt.
Die Kundin/der Kunde verfügt über eine gespeicherte Karte. Checkout unterstützt nur das Vorabausfüllen von Kartenzahlungsmethoden.
Bei der gespeicherten Karte ist allow_redisplay auf always festgelegt oder Sie haben die Standardeinstellung für die Anzeige angepasst.
Die Zahlungsmethode beinhaltet billing_details, die vom Wert billing_address_collection der Checkout-Sitzung benötigt werden:
- auto erfordert Werte für email, name und address[country]. Für Rechnungsadressen in den USA, Kanada und Großbritannien ist auch address[postal_code] erforderlich.
- required erfordert Werte für email, name und alle address-Felder.

If your Customer has multiple saved cards, Checkout prefills details from the card matching the following prioritization:

In payment mode, Stripe prefills the fields using the Customer’s newest saved card.
In subscription mode, Stripe prefills the Customer’s default payment method if it’s a card. Otherwise, Stripe prefills the newest saved card.

When Checkout is collecting a shipping address, Checkout prefills shipping address fields if the Customer’s shipping.address meets the Checkout Session’s supported countries.

Zeitüberschreitung beim vorab Ausfüllen

Die vorausgefüllte Zahlungsmethode wird nach Erstellung der Checkout-Sitzung 30 Minuten lang angezeigt. Nach Ablauf wird die Zahlungsmethode aus Sicherheitsgründen nicht mehr vorab ausgefüllt, wenn dieselbe Checkout-Sitzung geladen wird.

Ereignisse nach der Zahlung verarbeiten
Serverseitig

Stripe sendet das Ereignis checkout.session.completed, wenn ein Kunde/eine Kundin eine Zahlung in der Checkout-Sitzung abschließt. Verwenden Sie das Webhook-Tool des Dashboards oder befolgen Sie die Webhook-Anleitung, um diese Ereignisse zu empfangen und zu verarbeiten. Dies kann zu Folgendem führen:

Senden Sie eine Bestellbestätigung per E-Mail an Ihre Kundinnen/Kunden.
Protokollieren Sie den Verkauf in einer Datenbank.
Starten Sie einen Versand-Workflow.

Überwachen Sie diese Ereignisse, anstatt darauf zu warten, dass Ihre Kundinnen/Kunden auf Ihre Website zurückgeleitet werden. Es ist unzuverlässig, die Ausführung nur über die Landingpage Ihrer Zahlungsseite auszulösen. Wenn Sie Ihre Integration so einrichten, dass sie asynchrone Ereignisse überwacht, können Sie verschiedene Arten von Zahlungsmethoden mit einer einzelnen Integration akzeptieren.

Weitere Informationen finden Sie in unserem Fulfillment-Leitfaden für Checkout.

Verarbeiten Sie die folgenden Ereignisse, wenn Sie Zahlungen mit Checkout einziehen:

Ereignis	Beschreibung	Aktion
checkout.session.completed	Wird gesendet, wenn ein Kunde/eine Kundin eine Checkout-Sitzung erfolgreich abschließt.	Senden Sie den Kundinnen/Kunden eine Auftragsbestätigung und wickeln Sie die Bestellung ab.
checkout.session.async_payment_succeeded	Wird gesendet, wenn eine Zahlung mit einer Zahlungsmethode mit Verzögerung, wie z. B. ACH-Lastschriftverfahren, erfolgreich ausgeführt wird.	Senden Sie den Kundinnen/Kunden eine Auftragsbestätigung und wickeln Sie die Bestellung ab.
checkout.session.async_payment_failed	Wird gesendet, wenn eine Zahlung mit einer Zahlungsmethode mit Verzögerung, wie z. B. ACH-Lastschriftverfahren, fehlschlägt.	Benachrichtigen Sie die Kundin/den Kunden über den Fehler und bitten Sie ihn/sie, für einen erneuten Zahlungsversuch zur Sitzung zurückzukehren.