Integración · Webhooks
No se pierde nada porque su extremo tuviera una mala tarde.
La entrega se intenta cinco veces con huecos crecientes. Tras el último, el evento espera en el diario: un webhook perdido se convierte en una recogida en vez de en una pérdida.
- 5intentos
- 2 hhueco mayor
- 30 díasretención del diario
Carga útil
Qué aspecto tiene una decisión en su extremo
check.decided
POST https://your-endpoint.example/hooks
X-NNW-Signature: t=1792…,v1=4f3a…
{
"event": "check.decided",
"check_id": "chk_3Qv8ks2mPb",
"reference": "signup-55218",
"verdict": "review",
"reasons": [
{ "code": "name_match_soft", "signal": "identity", "score": 0.81 },
{ "code": "pep_tier_3", "signal": "sanctions" }
],
"evidence_bundle_id": "evb_7t2Kd9",
"policy_version": "2026-09-01",
"occurred_at": "2026-10-20T09:14:48Z"
}Las firmas son HMAC sobre la marca de tiempo y el cuerpo. Rechace todo aquello cuya marca de tiempo diste más de cinco minutos de su reloj: en eso consiste toda la defensa frente a la repetición.
Eventos
Qué se emite
| Evento | Cuándo | Lleva |
|---|---|---|
check.decided | Se alcanza un veredicto | veredicto, motivos, identificador del expediente |
check.expired | La recogida no llegó a completarse | último estado, motivo |
monitoring.hit | Un cambio de lista o registro afecta a un jugador existente | señal, identificador de la comprobación original |
evidence.sealed | Un expediente queda cerrado e inmutable | identificador, inicio del plazo de conservación |
policy.published | Entra en vigor una nueva versión de política | mercado, versión, en vigor desde |
Cada evento lleva su propio reference: la correlación no depende nunca de que usted guarde nuestros identificadores.