Internal Stripe webhooks
The public API currently provides no outgoing booking webhooks and no generic webhook registration API. The endpoints below are internal Stripe receivers used by the platform; they are not endpoints that API consumers should call for booking updates.
Stripe endpoints
POST https://api.my-playrooms.de/api/StripeWebhook/Handle
POST https://api.my-playrooms.de/api/StripeWebhook/HandleConnected
The platform receives the raw Stripe event body and validates its Stripe-Signature
with separate platform and connected-account webhook secrets.
Events handled by the backend
| Event | Description |
|---|---|
invoice.paid | Platform account invoice paid |
checkout.session.* | Connected account checkout events; a completed checkout settles the matching entry of the booking's payment overview |
charge.refunded | Confirms a refund started for a payment entry; the refund entry is marked paid once Stripe confirms it |
PayPal notifications
The platform also receives PayPal instant payment notifications (IPN) at
POST https://api.my-playrooms.de/api/paypalipn/{companyId}. Each company has its own URL, which hosts configure in
their PayPal account (see Payment methods and PayPal). Every message is verified with
PayPal before it is used. This is an internal receiver as well and not an endpoint for API consumers.
Public API alternative
Poll GET /v1/orders/{orderId} with the owning X-API-Key when your integration needs
the current booking or payment status.
Verification example for your own Stripe endpoint
import stripe
event = stripe.Webhook.construct_event(
payload=raw_request_body,
sig_header=request.headers["Stripe-Signature"],
secret=webhook_secret,
)