Events · Facturering
invoice.paid
Factuur betaald
Een factuur is betaald.
- Objecttype
- invoice
- Geleverd aan
- Webhooks met de rol admin
Payload
idstringverplichtID van het event (
evt_…), ook meegestuurd als headerwebhook-id. Gebruik die om dubbele leveringen te negeren.typestringverplichtToegestane waarden:
invoice.paidcreated_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
actor_idinteger | nullverplichtDe gebruiker die de actie heeft uitgevoerd;
nullbij een API-sleutel van de organisatie of het platform zelf.
testbooleanverplichtEen testevent, verstuurd door
POST /v1/webhooks/{webhook_id}/test.
Voorbeeldlevering
{
"id": "evt_0123456789abcdef0123456789abcdef",
"type": "invoice.paid",
"created_at": "2026-10-24T10:00:03Z",
"org_id": 1,
"api_version": "1.62.0",
"sequence": 1042,
"object": {
"type": "invoice",
"id": "301"
},
"payload": "full",
"data": {
"invoice": {
"id": 301,
"number": "INV-2026-000301",
"amount": 1250,
"currency": "EUR",
"status": "paid",
"period_start": "2026-10-01T00:00:00Z",
"period_end": "2026-11-01T00:00:00Z",
"issued_at": "2026-10-24T10:00:00Z",
"due_at": "2026-11-07T10:00:00Z",
"paid_at": "2026-10-25T09:00:00Z"
},
"actor_id": null
},
"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.