Skip to main content

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​

EventDescription
invoice.paidPlatform account invoice paid
checkout.session.*Connected account checkout events; a completed checkout settles the matching entry of the booking's payment overview
charge.refundedConfirms 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,
)