Arquitectura webhook-first

Por qué webhook-first

El provider externo (Stripe) es la fuente de verdad de eventos críticos. Beacon prioriza ingestión rápida y validación mínima en entrada para reducir timeouts y pérdida de eventos.

Flujo de procesamiento

1. 11) Ingestión

   Recibir webhook, validar firma y persistir el evento.

2. 22) Ack rápido

   Responder 2xx lo antes posible tras persistencia segura.

3. 33) Ejecución asíncrona

   Procesar lógica de negocio en workers con retries controlados.

4. 44) Observabilidad

   Publicar estado final y métricas de cola, latencia y fallos.

Garantías operacionales

• Deduplicación por event.id en reentregas del provider.
• Reproceso seguro con idempotencia funcional.
• Aislamiento de fallos por tipo de evento y organización.

Métricas mínimas