Bestellungen abwickelnBeta

Erstellen Sie eine Funktion auf Ihrem Server, um erfolgreiche 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 folgende Bedingungen erfüllen:

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. Führen Sie die Ausführung der Einzelposten durch.
6. Zeichnen Sie den Ausführungsstatus für die bereitgestellte Checkout-Sitzung auf.

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 während des Bezahlvorgangs anzupassen.
• Aktualisieren Sie Inventar oder Bestandsaufzeichnungen.

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

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

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. Sie können die Startseite konfigurieren, indem Sie return_url beim Erstellen der Checkout-Sitzung übergeben oder returnUrl an confirm im Frontend übergeben.

Verwenden Sie die ID der Checkout-Sitzung aus der 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 Logistikdetails für physische Waren.