Webhooks firmados
Contrato de entrega
Sección titulada «Contrato de entrega»Emissary produce eventos mediante una frontera duradera de outbox y registra intentos. Para el consumidor la entrega puede repetirse: el receptor debe ser idempotente y deduplicar los eventos de forma persistente.
- Lee los bytes originales del cuerpo antes de parsear o serializar de nuevo el JSON.
- Verifica Webhook-Timestamp y Webhook-Signature con el secreto y la entrada HMAC documentada.
- Aplica la tolerancia temporal y la comparación de firma en tiempo constante.
- Persiste el ID del evento y el resultado de procesamiento antes de confirmar éxito.
- Consulta entregas e intentos para diagnosticar resultados.
Soporte de SDK
Sección titulada «Soporte de SDK»Cada SDK oficial incluye un ejemplo de verificación webhook. La firma autentica el cuerpo del evento; no autoriza por sí misma la acción de negocio en tu aplicación.