Stuur gebeurtenissen naar uw eigen systeem met webhooks

Een webhook laat IDup een webadres van u aanroepen op het moment dat er iets gebeurt, bijvoorbeeld wanneer een factuur is betaald. Elke levering is ondertekend en wordt herhaald als uw systeem niet antwoordt.

Voeg een eindpunt toe

1. Open de Webhooks tab en druk op Voeg eindpunt toe.
2. Voer een Naam en de URL. Het moet openbaar bereikbaar zijn. Adressen binnen een privénetwerk worden om veiligheidsredenen geweigerd.
3. Vink de Evenementen u wilt.
4. Optioneel: kies een API-sleutel. Het eindpunt ontvangt dan alleen gebeurtenissen die deze sleutel mag lezen.
5. Pers Opslaan. IDup toont Uw ondertekeningsgeheim eenmaal. Bewaar het veilig.

Evenementen

• Factuur aangemaakt, Factuur betaald, Betaling ontvangen
• Nieuwe klant, Nieuw contact, Nieuwe lead, Nieuw ticket
• Aanbod geaccepteerd — een prijsopgave die een klant heeft geaccepteerd

Elke levering heeft drie koppen: de naam van het evenement, een leveringsnummer en de handtekening. Een herhaling behoudt hetzelfde leveringsnummer, zodat uw systeem duplicaten kan herkennen.

Controleer de handtekening

Uw systeem moet een HMAC-SHA256 berekenen over de tijd en de ruwe body met uw geheim, het vergelijken met de handtekening, en een tijd ouder dan 5 minuten weigeren. Druk op Handtekening verifiëren en voorbeelden voor kant-en-klare code.

Testen, pauzeren en vernieuwen

• Verstuur test stuurt een testevenement en toont de HTTP-code en de tijd die het kostte.
• Pauze stopt leveringen; Activeren start ze opnieuw.
• Geheim onthullen maakt een nieuw geheim aan. Het oude werkt onmiddellijk niet meer.
• Verwijderen verwijdert het eindpunt. Het logboek wordt bewaard.

Herhalingen en het logboek

Uw adres moet binnen 5 seconden met een 2xx-code antwoorden. Omleidingen worden niet gevolgd. Als het mislukt, probeert IDup het opnieuw na 1 minuut, 5 minuten, 30 minuten, 2 uur en 12 uur. Na de zesde poging wordt de levering gemarkeerd Opgegeven.

Het logboek toont elke poging met gebeurtenis, eindpunt, poging, HTTP-code, duur en het begin van het antwoord. Status is Wachten, Geleverd, Mislukt of Opgegeven. Gebruik Opnieuw verzenden om een levering opnieuw te verzenden.