● Sell · Payments
Stripe webhook.
So payments are recorded.
Stripe tells the studio about payments by calling a webhook. Without it, a customer pays and the studio never gives them the plan or the credits. Set it up before you turn selling on.
01Add the endpoint
- Stripe dashboard, Developers, Webhooks, Add endpoint.
- Endpoint URL:
https://your-address/webhooks/stripe(your public URL plus/webhooks/stripe). Events to send:
checkout.session.completedcheckout.session.async_payment_succeededinvoice.paidcustomer.subscription.updatedcustomer.subscription.deleted
- Save, then reveal the Signing secret (
whsec_…) and paste it in the console under Settings, Integrations, Stripe webhook signing secret (orSTRIPE_WEBHOOK_SECRETin.env). - Paste the Secret key (
sk_live_…orsk_test_…) in the same section. Its "Test" button says whether it is a live or a test key.
02What each event does
| Event | Effect |
|---|---|
checkout.session.completed (credit pack, paid) | Adds the pack's credits and records the payment |
checkout.session.completed (plan) | Puts the workspace on the plan and links the subscription |
invoice.paid | Records the payment, adds the plan's monthly credits, marks the subscription active |
customer.subscription.updated | Stores the subscription status (for example past_due) |
customer.subscription.deleted | Marks it canceled and moves the workspace to the free plan |
Every event is recorded once, so Stripe's retries never add credits twice. Payments recorded this way are what the console's revenue figures show.
03Test it first
Test first with test keys (sk_test_…) and a test-mode webhook, buy a credit pack in the studio with Stripe's test card, and check the workspace's credits on the Workspaces page. Then switch to the live keys and a live-mode webhook (it has its own signing secret).