Connect-Webhooks

Stripe nutzt Webhooks, um Ihre Anwendung bei einem Ereignis in Ihrem Konto zu benachrichtigen. Alle Connect-Integrationen sollten einen Webhook-Endpoint einrichten, um auf Connect-Ereignisse aufmerksam gemacht zu werden.

Connect-Webhooks

Eine Connect-Plattform verwendet zwei Arten von Webhooks:

• Account-Webhooks beziehen sich auf Aktivitäten in Ihrem eigenen Konto (zum Beispiel die meisten Anforderungen, die mit Ihren API-Schlüsseln und ohne Authentifizierung als anderes Stripe-Konto erfolgen). Dies umfasst alle Arten von Zahlungen, bis auf solche, die direkt für ein verbundenes Konto getätigt werden.
• Connect-Webhooks beziehen sich auf Aktivitäten in einem beliebigen verbundenen Konto. Wir senden alle Ereignisse für das verbundene Konto (einschließlich Kontoaktualisierungen und Direct Charges) an die Connect-Webhooks.

Wenn Sie einen Connect-Webhook erstellen, müssen Sie ihn für den Empfang von Connect-Webhook-Ereignissen konfigurieren. Wenn Sie ihn in der Dashboard erstellen, wählen Sie für Überwachen die Option Ereignisse in verbundenen Konten aus. Setzen Sie bei der Erstellung mit der API den Connect-Parameter auf „true“.

Bei Connect-Webhooks empfangen Ihre Entwicklungs-Webhook-URLs nur Test-Webhooks, Ihre Produktions-Webhook-URLs empfangen jedoch sowohl Live- als auch Test-Webhooks. Dies liegt daran, dass Sie in einer Produktionsanwendung sowohl Live- als auch Testtransaktionen durchführen können. Wir empfehlen Ihnen, den Wert für den livemode zu überprüfen, wenn Sie einen Ereignis-Webhook erhalten, um festzustellen, ob Nutzer/innen Maßnahmen ergreifen müssen.

Jedes Ereignis für ein verbundenes Konto enthält eine Top-Level-Eigenschaft account, die das verbundene Konto identifiziert. Da das verbundene Konto das Objekt, das das Ereignis ausgelöst hat besitzt, müssen Sie als verbundenes Konto API-Anfragen für dieses Objekt stellen.

{
  "id": 
"{{EVENT_ID}}",
  "livemode": true,
  "object": "event",
  "type": "customer.created",
  "account": 
"{{CONNECTED_ACCOUNT_ID}}",
  "pending_webhooks": 2,
  "created": 1349654313,
  "data": {...}
}

In der folgenden Tabelle werden einige der häufigsten und wichtigsten Ereignisse im Zusammenhang mit verbundenen Konten beschrieben:

# Using Sinatra.
require 'sinatra'
require 'stripe'

set :port, 4242

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

# If you're testing your webhook locally with the Stripe CLI, you
# can find the endpoint's secret by running `stripe listen`
# Otherwise, find your endpoint's secret in your webhook settings in
# the Developer Dashboard
endpoint_secret = 'whsec_...'

post '/webhook' do
  payload = request.body.read
  sig_header = request.env['HTTP_STRIPE_SIGNATURE']

  event = nil

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

  if event['type'] == 'account.application.deauthorized'
    application = event['data']['object']
    connected_account_id = event['account']
    handle_deauthorization(connected_account_id, application)
  end

  status 200
end

def handle_deauthorization(connected_account_id, application)
  # Clean up account state.
  puts 'Connected account ID: ' + connected_account_id
  puts application.to_s
end

Webhooks lokal testen

Sie können die Stripe-CLI verwenden, um Webhooks lokal zu testen.

1. Falls noch nicht vorhanden, installieren Sie die Stripe-CLI auf Ihrem Rechner.

2. Melden Sie sich in Ihrem Stripe-Konto an und richten Sie die CLI ein, indem Sie in der Befehlszeile stripe login ausführen.

3. Lassen Sie Ihren lokalen Host ein simuliertes Ereignis in Ihrem verbundenen Konto empfangen, indem Sie in einem Terminalfenster stripe listen --forward-to localhost:{PORT}/webhook und in einem anderen stripe trigger {{EVENT_NAME}} ausführen.