Webhook-first architecture

Why webhook-first

External providers (Stripe) are source-of-truth for critical events. Beacon prioritizes fast ingestion and minimal-entry validation to avoid timeouts and event loss.

Processing flow

1. 11) Ingestion

   Receive webhook, validate signature, and persist event.

2. 22) Fast ack

   Return 2xx as soon as event is safely persisted.

3. 33) Async execution

   Run business logic in workers with controlled retries.

4. 44) Observability

   Publish final state and queue/latency/failure metrics.

Operational guarantees

• Deduplication by event.id for provider re-delivery.
• Safe reprocessing through business idempotency rules.
• Failure isolation by event type and organization.

Minimum metrics