Integration · Webhooks

Nichts geht verloren, nur weil Ihr Endpunkt einen schlechten Nachmittag hatte.

Die Zustellung wird fünfmal mit wachsenden Abständen versucht. Danach wartet das Ereignis im Journal — ein verpasster Webhook wird zum Abruf statt zum Verlust.

5Versuche
2 hlängster Abstand
30 TageJournal-Aufbewahrung

Datenpaket

Wie eine Entscheidung auf Ihrem Endpunkt aussieht

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"
}

Signaturen sind HMAC über Zeitstempel und Rumpf. Weisen Sie alles zurück, dessen Zeitstempel mehr als fünf Minuten von Ihrer Uhr abweicht — darin besteht die gesamte Abwehr gegen Wiedereinspielung.

Ereignisse

Was ausgelöst wird

Ereignis	Wann	Trägt
`check.decided`	Ein Ergebnis liegt vor	Ergebnis, Gründe, Nachweispaket-ID
`check.expired`	Die Erfassung wurde nie abgeschlossen	letzter Zustand, Grund
`monitoring.hit`	Eine Listen- oder Registeränderung betrifft einen bestehenden Spieler	Signal, ursprüngliche Prüfungs-ID
`evidence.sealed`	Ein Paket ist geschlossen und unveränderlich	Paket-ID, Beginn der Aufbewahrungsfrist
`policy.published`	Eine neue Richtlinienversion tritt in Kraft	Markt, Version, gültig ab

Jedes Ereignis trägt Ihre eigene reference — die Zuordnung hängt also nie daran, dass Sie unsere Kennungen speichern.

Verwandt