Events · Verificatie
verification.expired
Verificatie verlopen
Het verificatie-interval van een betrouwbare kaart is verstreken.
- Objecttype
- card
- Geleverd aan
- Webhooks die het object mogen zien: op basis van rol, dataprofiel en collecties
Payload
Object: EventVerificationExpired
idstringverplichtID van het event (
evt_…), ook meegestuurd als headerwebhook-id. Gebruik die om dubbele leveringen te negeren.typestringverplichtToegestane waarden:
verification.expiredcreated_atstring (date-time)verplichtWanneer de wijziging plaatsvond (UTC).
org_idintegerverplichtapi_versionstringverplichtContractversie van het schema van
data.sequenceintegerVolgnummer van de levering binnen de webhook (ontbreekt bij een testevent).
payloadstringverplichtthinbetekent geendata: lees het object via de API.Toegestane waarden:
fullthindataobjectVelden
expired_atstring (date-time)verplicht
testbooleanverplichtEen testevent, verstuurd door
POST /v1/webhooks/{webhook_id}/test.
Voorbeeldlevering
{
"id": "evt_0123456789abcdef0123456789abcdef",
"type": "verification.expired",
"created_at": "2026-10-24T10:00:03Z",
"org_id": 1,
"api_version": "1.62.0",
"sequence": 1042,
"object": {
"type": "card",
"id": "c_9f2e41"
},
"payload": "full",
"data": {
"card": {
"id": "c_9f2e41",
"title": "Refund policy",
"collection": "support",
"collection_id": 3,
"version": 4,
"kind": "text",
"status": "ready",
"verification_state": "needs_verification",
"owner_id": 7,
"tags": [
"billing"
],
"external_id": null,
"metadata": {}
},
"expired_at": "2026-10-24T00:00:00Z"
},
"test": false
}Events ontvangen
Elke levering is een POST-request met deze JSON-body naar het ontvangstadres van je webhook. Controleer de header webhook-signature (Standard Webhooks) voordat je de body vertrouwt, antwoord binnen een paar seconden met een 2xx-status en doe het werk daarna. Leveringen aan één webhook behouden de volgorde van de events; een mislukte levering wordt met steeds langere pauzes opnieuw geprobeerd.
Er kunnen op elk moment nieuwe eventtypes en nieuwe velden bij komen: sla de types en velden over die je niet kent.