Skip to main content
Met een webhook laat Zippendo een ander systeem weten dat er een gebeurtenis heeft plaatsgevonden, zoals Zending verzonden of Track & trace bijgewerkt. Je stelt webhooks in onder Instellingen → Webhooks (open het organisatiemenu en klik op Beheren). Voor elke gebeurtenis stuurt Zippendo een bericht naar de Endpoint-URL die je hebt ingevuld. Dit zijn geen track-&-tracewebhooks van vervoerders. Daarvoor, zie Tracking-webhooks van vervoerders.

​
Wat je ziet

  • Je systeem ontvangt helemaal niets.
  • Het Afleverlog van een webhook toont rode statuscodes of tekst in de kolom Fout.
  • Je systeem ontvangt dezelfde gebeurtenis meer dan één keer.

​
Controleer eerst het afleverlog

Klik bij Webhooks op Afleverlog bij de webhook. Elke rij is één poging, met de Gebeurtenis, de Status waarmee je systeem antwoordde, de Duur en eventuele Fout.
  • Nog geen afleveringen: Zippendo heeft nog niets geprobeerd te verzenden. Zie “Er wordt niets verzonden” hieronder.
  • Een groene status: je systeem heeft het bericht ontvangen. Zoek het probleem in je eigen systeem.
  • Een rode status of n.v.t. met een fout: je systeem heeft het bericht niet geaccepteerd. Zie “Afleveringen mislukken” hieronder.

​
Er wordt niets verzonden

​
Afleveringen mislukken

Zippendo telt een aflevering alleen als geslaagd als je systeem binnen 10 seconden antwoordt met een succesvolle status (200-299). Anders probeert het binnen ongeveer een minuut nog een paar keer opnieuw, in totaal 5 pogingen. Daarna wordt de gebeurtenis niet meer verzonden. Klik nadat je de oorzaak hebt verholpen bij de webhook op Test verzenden. Je ziet Testgebeurtenis verzonden en er verschijnt een nieuwe rij in het Afleverlog.
Zippendo verzendt mislukte gebeurtenissen later niet opnieuw. Was je systeem een tijdje offline, zoek de zendingen of bestellingen die je hebt gemist dan op in de Zippendo-app, of haal ze op via de API.

​
Je systeem weigert de handtekening

Elk bericht heeft een X-Webhook-Signature-header, zodat je systeem kan controleren dat het echt van Zippendo komt. Het is een HMAC-SHA256 van de ruwe berichtinhoud, gemaakt met het secret van de webhook. Veelgemaakte fouten:
  • De handtekening wordt berekend over het bericht nadat het is verwerkt en herschreven, in plaats van over de ruwe inhoud precies zoals ontvangen.
  • Het secret van een andere webhook wordt gebruikt. Elke webhook heeft zijn eigen secret.
Details en codevoorbeelden: Snelstart voor webhooks.

​
Dezelfde gebeurtenis komt twee keer binnen

Antwoordde je systeem te traag of met een fout, dan probeert Zippendo het opnieuw, ook als je systeem de eerste poging wel heeft verwerkt. Gebruik de header X-Webhook-Id om een bericht te herkennen dat je al hebt verwerkt. Gerelateerd: Webhooks, Webhookinstellingen.