Checkout- und Payment Link-Zahlungen ausführen

Erstellen Sie eine Funktion auf Ihrem Server, um Checkout-Zahlungen durchzuführen. Webhooks lösen diese Funktion aus und werden aufgerufen, wenn Kundinnen/Kunden nach Abschluss des Bezahlvorgangs zu Ihrer Website weitergeleitet werden. In diesem Leitfaden wird diese Funktion als fulfill_checkout bezeichnen. Sie können die Funktion aber beliebig benennen.

Ihre fulfill_checkout-Funktion muss:

1. Korrekte Handhabung von mehrfachen Aufrufen mit der gleichen Checkout-Sitzungs-ID.
2. Akzeptieren Sie die ID einer Checkout-Sitzung als Argument.
3. Rufen Sie die Checkout-Sitzung von der API ab, wobei die Eigenschaft line_items erweitert ist.
4. Überprüfen Sie die Eigenschaft payment_status, um zu ermitteln, ob eine Ausführung erforderlich ist.
5. Ausführung der Einzelposten durchführen.
6. Ausführungsstatus für die bereitgestellte Checkout-Sitzung aufzeichnen.

Verwenden Sie den folgenden Code als Ausgangspunkt für Ihre fulfill_checkout-Funktion. Die TODO-Kommentare geben alle Funktionen an, die Sie implementieren müssen.

def fulfill_checkout(session_id)
  # 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_4eC39HqLyjWDarjtT1zdp7dc'

  puts "Fullfilling Checkout Session #{session_id}"

  # TODO: Make this function safe to run multiple times,
  # even concurrently, with the same session ID

  # TODO: Make sure fulfillment hasn't already been
  # peformed for this Checkout Session

  # Retrieve the Checkout Session from the API with line_items expanded
  checkout_session = Stripe::Checkout::Session.retrieve({
    id: session_id,
    expand: ['line_items'],
  })

  # Check the Checkout Session's payment_status property
  # to determine if fulfillment should be peformed
  if checkout_session.payment_status != 'unpaid'
    # TODO: Perform fulfillment of the line items

    # TODO: Record/save fulfillment status for this
    # Checkout Session
  end
end

Abhängig von den von Ihnen akzeptierten Zahlungsmethoden und Ihren geschäftlichen Anforderungen sollten Sie Ihre fulfill_checkout-Funktion wie folgt ausführen:

• Stellen Sie Zugang zu Dienstleistungen bereit.
• Lösen Sie den Warenversand aus.
• Speichern Sie eine Kopie der Zahlungsangaben und der Einzelposten in Ihrer eigenen Datenbank.
• Senden Sie dem Kunden/der Kundin einen nutzerdefinierten E-Mail-Beleg, wenn Sie die Zahlungsbelege von Stripe nicht aktiviert haben.
• Gleichen Sie die Posten und die gekauften Mengen ab, wenn Sie Kundinnen/Kunden gestatten, die Mengen in Checkout anzupassen.
• Inventar oder Bestandsaufzeichnungen aktualisieren.

Um die Ausführung auszulösen, erstellen Sie einen Webhook-Ereignis-Handler, um Zahlungsereignisse zu überwachen und Ihre Funktion fulfill_checkout auszulösen.

Wenn jemand Sie mit Checkout bezahlt, erstellt er/sie das ein Ereignis des Typs checkout.session.completed. Richten Sie auf Ihrem Server einen Endpoint ein, um diese Ereignisse zu akzeptieren, zu verarbeiten und den Empfang zu bestätigen.

Einige Zahlungsmethoden sind nicht sofort verfügbar, zum Beispiel ACH-Lastschriften und andere Banküberweisungen. Die Gelder sind nicht sofort verfügbar, wenn der Bezahlvorgang abgeschlossen ist. Verzögerte Zahlungsmethoden generieren das Ereignis checkout.session.async_payment_succeeded, wenn die Zahlung später erfolgreich ist.

require 'sinatra'

# Use the secret provided by Stripe CLI for local testing
# or your webhook endpoint's secret.
endpoint_secret = 'whsec_...'

post '/webhook' do
  event = nil

  # Verify webhook signature and extract the event
  # See https://stripe.com/docs/webhooks#verify-events for more information.
  begin
    sig_header = request.env['HTTP_STRIPE_SIGNATURE']
    payload = request.body.read
    event = Stripe::Webhook.construct_event(payload, sig_header, endpoint_secret)
  rescue JSON::ParserError => e
    # Invalid payload
    return status 400
  rescue Stripe::SignatureVerificationError => e
    # Invalid signature
    return status 400
  end

  if event['type'] == 'checkout.session.completed' ||
  event['type'] == 'checkout.session.async_payment_succeeded'
    fulfill_checkout(event['data']['object']['id'])
  end

  status 200
end

Möglicherweise möchten Sie auch fehlgeschlagene checkout.session.async_payment_failed-Ereignisse überwachen und verarbeiten. Sie können beispielsweise eine E-Mail an Ihre Kundinnen/Kunden senden, wenn eine verzögerte Zahlung fehlschlägt.

Am schnellsten lässt sich Ihr Webhook-Ereignis-Handler mit der Stripe-CLI entwickeln und testen. Wenn Sie die Stripe-CLI nicht haben, befolgen Sie die Installationsanleitung, um zu beginnen.

Wenn die Stripe-CLI installiert ist, können Sie Ihren Ereignis-Handler lokal testen. Führen Sie Ihren Server aus (zum Beispiel auf localhost:4242) und führen Sie dann den Befehl stripe listen aus, damit die Stripe-CLI Ereignisse an Ihren lokalen Server weiterleitet:

stripe listen --forward-to localhost:4242/webhook

Ready! Your webhook signing secret is 'whsec_<REDACTED>' (^C to quit)

Fügen Sie den Webhook-Geheimschlüssel (whsec_...) zu Ihrem Code für die Ereignisbehandlung hinzu, und testen Sie dann die Ausführung, indem Sie den Bezahlvorgang als Kunde/Kundin durchlaufen:

• Klicken Sie auf die Schaltfläche zum Bezahlen, über die Sie zum Bezahlvorgang gelangen, oder rufen Sie Ihren Zahlungslink auf
• Geben Sie die folgenden Testdaten in Checkout ein:
  • Geben Sie als Kartennummer 4242 4242 4242 4242 ein
  • Geben Sie für die Karte ein beliebiges Ablaufdatum in der Zukunft ein
  • Geben Sie für die Prüfziffer eine 3-stellige Ziffer ein
  • Geben Sie eine beliebige Postleitzahl für die Rechnungsstellung ein (90210)
• Klicken Sie auf die Schaltfläche Bezahlen

Überprüfen Sie nach Abschluss der Zahlung Folgendes:

• In Ihrer Befehlszeile, in der stripe listen ausgeführt wird, wird das an Ihren lokalen Server weitergeleitete Ereignis checkout.session.completed angezeigt.
• Ihre Serverprotokolle zeigen die erwartete Ausgabe Ihrer fulfill_checkout-Funktion.

Nachdem Sie einen lokalen Test durchgeführt haben, richten Sie Ihren Webhook-Handler auf Ihrem Server ein und starten ihn. Als Nächstes erstellen Sie einen Webhook-Endpoint, um die checkout.session.completed-Ereignisse an Ihren Server zu senden, und testen Sie dann den Bezahlvorgang erneut.

Konfigurieren Sie Checkout so, dass Ihre Kundinnen/Kunden nach Abschluss des Bezahlvorgangs an eine Seite auf Ihrer Website gesendet werden. Fügen Sie den Platzhalter {CHECKOUT_SESSION_ID} in die URL Ihrer Seite ein. Dieser wird durch die ID der Checkout-Sitzung ersetzt, wenn Ihr Kunde/Ihrer Kundin von Checkout weitergeleitet wird.

Gehosteter Bezahlvorgang

Bei Checkout-Sitzungen mit dem standardmäßigen ui_mode hosted legen Sie die success_url fest.

curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d "line_items[0][price]"=
{{PRICE_ID}} \
  -d "line_items[0][quantity]"=1 \
  -d mode=payment \
  --data-urlencode success_url="https://example.com/after-checkout?session_id={CHECKOUT_SESSION_ID}"

Checkout mit einem nicht standardmäßigen ui_mode

Bei Checkout-Sitzungen mit ui_mode, die nicht auf hosted gesetzt sind, legen Sie die return_url fest.

curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d "line_items[0][price]"=
{{PRICE_ID}} \
  -d "line_items[0][quantity]"=1 \
  -d mode=payment \
  -d ui_mode=embedded \
  --data-urlencode return_url="https://example.com/after-checkout?session_id={CHECKOUT_SESSION_ID}"

Payment Links

Für Payment Links, die Sie mit der API erstellen, legen Sie die after_completion.redirect.url fest.

curl https://api.stripe.com/v1/payment_links \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d "line_items[0][price]"=
{{PRICE_ID}} \
  -d "line_items[0][quantity]"=1 \
  -d "after_completion[type]"=redirect \
  --data-urlencode "after_completion[redirect][url]"="https://example.com/after-checkout?session_id={CHECKOUT_SESSION_ID}"

Für Payment Links, die Sie im Dashboard erstellen:

1. Gehen Sie zur Registerkarte Nach der Zahlung.
2. Wählen Sie Sie Bestätigungsseite nicht anzeigen aus.
3. Geben Sie die URL Ihrer Zielseite an, die den Platzhalter {CHECKOUT_SESSION_ID} enthält (zum Beispiel https://example.com/after-checkout?session_id={CHECKOUT_SESSION_ID})

Die Überwachung von Webhooks ist erforderlich, um sicherzustellen, dass Sie immer die Ausführung für jede Zahlung auslösen, aber Webhooks können manchmal verzögert werden. Um Ihren Zahlungsablauf zu optimieren und eine sofortige Ausführung zu gewährleisten, wenn Ihr Kunde/Ihre Kundin anwesend ist, lösen Sie die Ausführung auch von Ihrer Zielseite aus.

Verwenden Sie die ID der Checkout-Sitzung aus der im vorherigen Schritt angegebenen URL, um Folgendes zu tun:

1. Wenn Ihr Server eine Anfrage für Ihre Checkout-Zielseite erhält, extrahieren Sie die ID der Checkout-Sitzung aus der URL.
2. Führen Sie Ihre fulfill_checkout-Funktion` mit der angegebenen ID aus.
3. Rendern Sie die Seite, nachdem der Auführungversuch abgeschlossen ist.

Wenn Sie Ihre Zielseite rendern, können Sie Folgendes anzeigen:

• Details des Ausführungsvorgangs.
• Links oder Informationen zu Dienstleistungen, auf die der Kunde/die Kundin nun Zugriff hat.
• Versand- oder logistische Details für physische Waren.