Clearfi
Functies → Webhooks

Koppel ClearFi aan uw eigen systemen

Ontvang real-time, beveiligde meldingen zodra er iets verandert in ClearFi — van een betaalde factuur tot een nieuwe klant.

Gratis starten

Beveiligd, betrouwbaar en te verifiëren

  • Elk verzoek wordt ondertekend met HMAC-SHA256, meegestuurd in de X-ClearFi-Signature header
  • Kies zelf op welke events uw endpoint reageert, per webhook afzonderlijk in te stellen
  • Uw signing secret wordt eenmalig getoond direct na aanmaken
  • Volledig bezorgingslog van de laatste 100 meldingen, inclusief HTTP-statuscode
  • Mislukte bezorgingen met één klik opnieuw versturen

Beschikbare events

invoice.created
invoice.sent
invoice.paid
invoice.overdue
quote.accepted
quote.rejected
customer.created
expense.created
payment.received
1

Endpoint koppelen

Voeg een https-endpoint toe en selecteer één of meerdere events waarop het moet reageren.

2

HMAC-ondertekend

Elke payload wordt met SHA-256 ondertekend, zodat u kunt verifiëren dat de melding echt van ClearFi komt.

3

Bezorgingslog

Bekijk per melding het event, de status (gelukt of mislukt), de HTTP-code en het tijdstip.

4

Automatische retry

Mislukte bezorgingen kunt u met één klik opnieuw laten versturen, met dezelfde payload en handtekening.

5

Activeren of pauzeren

Zet een webhook tijdelijk uit zonder de configuratie te verliezen, of verwijder hem volledig.

6

Direct te implementeren

Een kant-en-klaar codevoorbeeld laat zien hoe u de handtekening in uw eigen systeem verifieert.

Handtekening verifiëren

Elke webhook bevat een X-ClearFi-Signature header. Verifieer dit met uw signing secret:

const sig = req.headers['x-clearfi-signature']
const expected = 'sha256=' + crypto
  .createHmac('sha256', YOUR_SECRET)
  .update(JSON.stringify(req.body))
  .digest('hex')
if (sig !== expected) return res.status(401).end()

Bouw uw eigen integraties op ClearFi-events

30 dagen gratis, betaalmethode vereist bij start.

Gratis starten