Payment providers

The Stripe and manual adapters, the webhook, and test payments.

Route: /dashboard/platform/payment-providers. Needs canManagePayments.

Setup creates two providers: Stripe (pp_stripe) for cards and Manual for cash or comps at the door. The adapters live in features/integrations/payment.

Stripe

  1. Set NEXT_PUBLIC_STRIPE_KEY and STRIPE_SECRET_KEY.
  2. Create a webhook endpoint in Stripe at https://your-host/api/integrations/payment/pp_stripe/webhook with payment_intent.succeeded, payment_intent.payment_failed, payment_intent.canceled, charge.refunded and refund.updated.
  3. Put the endpoint's signing secret in STRIPE_WEBHOOK_SECRET.

The webhook verifies the signature, stores each event once in PaymentWebhookEvent, and completes or fails the matching checkout. Refunds go back through the provider that took the payment, with a stable idempotency key.

Use test keys and the card 4242 4242 4242 4242 until a test purchase and refund both work.

External storefronts

Give an LLM the Comedy Club storefront skill to adapt the built-in public site or create a separate client.

Run a show night

Open doors, check guests in, seat tables, run checks and close the night.

On this page

Stripe