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

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,
)