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

   Completa onboarding Connect Standard y valida charges_enabled en dashboard.

2. 22) Configurar webhooks

   Registra endpoints, guarda signing secret en vault y prueba firma.

3. 33) Crear checkout

   Genera sesión con Idempotency-Key y redirige al usuario.

4. 44) Confirmar resultado

   Tras callback de retorno, confirma suscripción y evento asociado.

5. 55) Validar operación

   Comprueba estado final en dashboard, logs y métricas clave.

Ejemplo API

curl -X POST https://api.beacon.pt/v1/billing/subscription-checkouts \
  -H "Authorization: Bearer <access_token>" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: chk_<operation_id>" \
  -d '{"organizationId":"<organization_id>","plan":"plus","billingCycle":"monthly","mode":"test"}'

Validación final

• Checkout completado y suscripción confirmada sin conflicto idempotente.
• Webhook procesado con correlación por event.id.
• Estado de dashboard coherente con la línea temporal operativa.
• Sin alertas críticas en observabilidad.

Troubleshooting rápido