Zum Hauptinhalt springen

Interne Stripe-Webhooks

Die öffentliche API bietet derzeit keine ausgehenden Buchungs-Webhooks und keine allgemeine Webhook- Registrierung. Die folgenden Endpunkte sind interne Stripe-Empfänger der Plattform; sie sind keine Endpunkte, die API-Nutzer für Buchungsupdates aufrufen sollen.

Stripe-Endpunkte​

POST https://api.my-playrooms.de/api/StripeWebhook/Handle
POST https://api.my-playrooms.de/api/StripeWebhook/HandleConnected

Die Plattform erhält den rohen Stripe-Event-Body und prüft die Stripe-Signature mit getrennten Webhook-Secrets für Plattform- und verbundene Konten.

Vom Backend verarbeitete Ereignisse​

EreignisBeschreibung
invoice.paidRechnung des Plattformkontos bezahlt
checkout.session.*Checkout-Ereignisse verbundener Konten; ein abgeschlossener Checkout verbucht den passenden Schritt der Zahlungsübersicht der Buchung
charge.refundedBestätigt eine für einen Zahlungsschritt ausgelöste Erstattung; der Erstattungsschritt wird als bezahlt markiert, sobald Stripe sie bestätigt

PayPal-Benachrichtigungen​

Die Plattform empfängt außerdem PayPal-Sofortbenachrichtigungen (IPN) unter POST https://api.my-playrooms.de/api/paypalipn/{companyId}. Jede Firma hat eine eigene URL, die Hosts in ihrem PayPal-Konto hinterlegen (siehe Zahlungsmethoden und PayPal). Jede Nachricht wird vor der Verwendung bei PayPal verifiziert. Auch das ist ein interner Empfänger und kein Endpunkt für API-Nutzer.

Alternative über die öffentliche API​

Frage GET /v1/orders/{orderId} mit dem zugehörigen X-API-Key ab, wenn deine Integration den aktuellen Buchungs- oder Zahlungsstatus braucht.

Verifizierungsbeispiel für deinen eigenen Stripe-Endpunkt​

import stripe

event = stripe.Webhook.construct_event(
payload=raw_request_body,
sig_header=request.headers["Stripe-Signature"],
secret=webhook_secret,
)