Quickstart de extremo a extremo

Antes de empezar

Mapa del flujo end-to-end

1. Conectar Stripe.
2. Registrar y validar webhooks.
3. Crear checkout de suscripción.
4. Confirmar estado final en dashboard.
5. Validar señales fiscales y de observabilidad.

Paso a paso

1. 11) Conectar Stripe existente

   Completa OAuth read-only y valida la ingestión visible en el dashboard.

2. 22) Configurar webhooks

   Registra los endpoints Beacon en Stripe, guarda los secrets por entorno y valida la firma.

3. 33) Crear checkout

   Llama al endpoint real de checkout y redirige al usuario a redirectUrl.

4. 44) Confirmar resultado

   Tras el retorno del checkout, confirma la suscripción con sessionId o con el checkout pendiente.

5. 55) Validar operación

   Comprueba estado final en dashboard, procesamiento del webhook y señales fiscales/operativas.

Ejemplo API

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"}'

Validación final

• Checkout devuelve checkoutSessionId y redirectUrl.
• POST /api/billing/subscription/confirm devuelve subscription para la organización correcta.
• El procesamiento del webhook guarda webhookEventId sin duplicados inesperados.
• Estado de dashboard coherente con la línea temporal operativa.
• Sin alertas críticas en observabilidad.

Troubleshooting rápido