Webhooks API

Objetivo

Ingerir eventos Stripe con verificación de firma, deduplicación por evento y replay controlado para recuperación de incidentes.

Endpoints principales

Modelo de procesamiento

1. 11) Recibir evento

   Validar firma y estructura mínima del payload.

2. 22) Deduplicar

   Usar event.id del proveedor como clave idempotente.

3. 33) Encolar proceso

   Ejecutar handlers asíncronos con retries seguros.

4. 44) Confirmar estado

   Actualizar estado funcional y métricas de entrega.

Ejemplo de evento recibido

{
  "id": "evt_123",
  "type": "invoice.paid",
  "created": 1710492000,
  "data": {
    "object": {
      "id": "in_123",
      "customer": "cus_123"
    }
  }
}

Política de retries y replay

• Los retries automáticos deben preservar el contexto original.
• El replay manual debe limitarse por ventana temporal y organización.
• Evita replay masivo sin priorización por impacto y criterios de validación explícitos.

Señales operativas