Aktionen mit Webhooks auslösen

Fügen Sie einen neuen Endpoint in Ihrer Anwendung hinzu. Sie können auf bestimmte Ereignisse reagieren, indem Sie das Feld type des Ereignisses auswählen, das im Haupttext der Anfrage gesendet wurde. Dann können Sie die Standardausgabe drucken, um sich zu vergewissern, dass der Webhook funktioniert.

Starten Sie nach Hinzufügen des neuen Endpoints Ihren Server.

# 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'

require 'stripe'
require 'sinatra'
require 'json'

# Using the Sinatra framework
set :port, 4242

post '/webhook' do
  payload = request.body.read
  event = nil

  begin
    event = Stripe::Event.construct_from(
      JSON.parse(payload, symbolize_names: true)
    )
  rescue JSON::ParserError => e
    # Invalid payload
    status 400
    return
  end

  # Handle the event
  case event.type
  when 'payment_intent.succeeded'
    payment_intent = event.data.object # contains a Stripe::PaymentIntent
    puts 'PaymentIntent was successful!'
  when 'payment_method.attached'
    payment_method = event.data.object # contains a Stripe::PaymentMethod
    puts 'PaymentMethod was attached to a Customer!'
  # ... handle other event types
  else
    puts "Unhandled event type: #{event.type}"
  end

  status 200
end

# Install Homebrew to run this command: https://brew.sh/
brew install stripe/stripe-cli/stripe

# Connect the CLI to your dashboard
stripe login

Weitere Installationsoptionen finden Sie unter Mit der Stripe-CLI loslegen.

Führen Sie nach Installieren der Stripe-CLI in der Kommandozeile stripe login aus, um einen Kopplungscode zu generieren, der eine Verknüpfung zu Ihrem Stripe-Konto herstellt. Drücken Sie auf Eingabe, um Ihren Browser zu starten und sich in Ihrem Stripe-Konto anzumelden, um den Zugriff zu genehmigen. Der erstellte API-Schlüssel ist 90 Tage lang gültig. Sie können den Schlüssel unter API-Schlüssel im Dashboard ändern oder löschen.

Test

stripe login
Your pairing code is: humour-nifty-finer-magic
Press Enter to open up the browser (^C to quit)

Wenn Sie einen bestehenden API-Schlüssel nutzen möchten, verwenden Sie die Markierung --api-key:

stripe login --api-key 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
Your pairing code is: humour-nifty-finer-magic
Press Enter to open up the browser (^C to quit)

Verwenden Sie die CLI, um Ereignisse an Ihren lokalen Webhook-Endpoint mithilfe des Befehls listen weiterzuleiten.

Sofern Ihre Anwendung auf dem Port 4242 ausgeführt wird, führen Sie Folgendes aus:

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

Verwenden Sie in einer anderen Terminal-Registerkarte den CLI-Befehl trigger, um ein Probe-Webhook-Ereignis auszulösen.

stripe trigger payment_intent.succeeded

Das folgende Ereignis wird in Ihrer Registerkarte listen angezeigt:

[200 POST] OK payment_intent.succeeded

„PaymentIntent war erfolgreich!“ erscheint auf der Terminal-Registerkarte, auf der Ihr Server ausgeführt wird, sehen.

Wenn Sie bereit sind, Ihren Webhook-Endpoint für die Produktion bereitzustellen, müssen Sie Folgendes beachten:

1. Verwenden Sie Ihre Live-Modus-API-Schlüssel, nicht Ihre Testschlüssel.

2. Konfigurieren Sie Ihren Webhook-Endpoint im Stripe Dashboard oder mit der API.

Um Ihren Endpoint im Dashboard zu konfigurieren, gehen Sie zu Ihren Webhook-Einstellungen.

Klicken Sie auf Endpoint hinzufügen und geben Sie die URL Ihres Endpoints, die Stripe-API-Version sowie die spezifischen Ereignisse, die Stripe senden soll, ein.

Ersetzen Sie das Webhook-Endpoint-Geheimnis in Ihrer Anwendung durch das neue Ereignis, das in der Dashboard-Ansicht Ihres Endpoints erscheint.

Ihre Anwendung kann jetzt Live-Ereignisse empfangen. Weitere Informationen zum Konfigurieren Ihres Webhook-Endpoints finden Sie in der Webhook Endpoint API. Informationen zum Testen in einer Sandbox finden Sie in unserem Entwicklungsleitfaden.