Quickstart end-to-end

Antes de começar

Mapa do fluxo end-to-end

1. Ligar Stripe Connect.
2. Registar e validar webhooks.
3. Criar checkout de subscrição.
4. Confirmar estado no dashboard.
5. Verificar emissão fiscal e observabilidade.

Passo a passo

1. 11) Ligar Stripe

   Conclui onboarding Connect Standard e valida charges_enabled no dashboard.

2. 22) Configurar webhooks

   Regista endpoints, guarda signing secret em cofre e testa assinatura.

3. 33) Criar checkout

   Gera sessão de checkout com Idempotency-Key e redireciona utilizador.

4. 44) Confirmar resultado

   Após retorno, confirma subscrição pela API e valida evento associado.

5. 55) Verificar operação

   Confirma estado final no dashboard, logs e métricas principais.

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

Validação final

• Checkout concluído e subscrição confirmada sem conflito idempotente.
• Webhook processado com correlação por event.id.
• Dashboard com estado consistente entre billing e operação.
• Alertas de observabilidade sem erros críticos.

Troubleshooting rápido