Integrazione · Webhook
Nulla si perde perché il vostro endpoint ha avuto un brutto pomeriggio.
La consegna è tentata cinque volte con intervalli crescenti. Dopo l'ultimo, l'evento attende nel giornale: un webhook mancato diventa un recupero anziché una perdita.
- 5tentativi
- 2 hintervallo massimo
- 30 giorniconservazione del giornale
Payload
Che aspetto ha una decisione sul vostro endpoint
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"
}Le firme sono HMAC su momento e corpo. Rifiutate tutto ciò il cui momento disti più di cinque minuti dal vostro orologio: in questo consiste l'intera difesa dalla ripetizione.
Eventi
Che cosa viene emesso
| Evento | Quando | Porta |
|---|---|---|
check.decided | Si è raggiunto un esito | esito, motivi, identificativo del fascicolo |
check.expired | La raccolta non è mai stata completata | ultimo stato, motivo |
monitoring.hit | Una variazione di lista o registro tocca un giocatore esistente | segnale, identificativo della verifica originale |
evidence.sealed | Un fascicolo è chiuso e immutabile | identificativo, inizio del periodo di conservazione |
policy.published | Una nuova versione di policy entra in vigore | mercato, versione, in vigore dal |
Ogni evento porta il vostro reference: la correlazione non dipende mai dal fatto che conserviate i nostri identificativi.