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
| Ereignis | Beschreibung |
|---|---|
invoice.paid | Rechnung des Plattformkontos bezahlt |
checkout.session.* | Checkout-Ereignisse verbundener Konten; ein abgeschlossener Checkout verbucht den passenden Schritt der Zahlungsübersicht der Buchung |
charge.refunded | Bestä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,
)