End-to-end quickstart

Before you start

End-to-end flow map

1. Connect Stripe.
2. Register and validate webhooks.
3. Create subscription checkout.
4. Confirm final state in dashboard.
5. Validate fiscal and observability signals.

Step-by-step

1. 11) Connect existing Stripe

   Complete read-only OAuth and verify visible ingestion in the dashboard.

2. 22) Configure webhooks

   Register the Beacon endpoints in Stripe, store the environment secrets, and validate signatures.

3. 33) Create checkout

   Call the real checkout endpoint and redirect the user to redirectUrl.

4. 44) Confirm outcome

   After the checkout return, confirm the subscription with sessionId or the pending checkout state.

5. 55) Validate operations

   Check final state across dashboard, webhook processing, and fiscal/operational signals.

API example

curl -X POST "https://test.beacon.pt/api/billing/subscription/checkout?org=acme&mode=test" \
  -H "Authorization: Bearer <beacon_session_token>" \
  -H "Content-Type: application/json" \
  -d '{"plan":"plus","billingCycle":"monthly"}'

Final validation

• Checkout returns checkoutSessionId and redirectUrl.
• POST /api/billing/subscription/confirm returns subscription for the correct organization.
• Webhook processing stores webhookEventId without unexpected duplicates.
• Dashboard state matches billing and operational timeline.
• No critical alerts in observability.

Quick troubleshooting