Met behulp van web-triggers kunt u uw eigen servers op de hoogte stellen van bepaalde gebeurtenissen die plaatsvinden in Fonzip en deze gebeurtenissen in uw eigen systeem vastleggen.
Wat is een web-trigger? Hoe kan ik er een aanmaken?
Web-triggers zijn een functie die meldingen naar het door u gewenste adres stuurt wanneer er een gebeurtenis in het systeem plaatsvindt. U kunt een web-trigger aanmaken door naar het menu aan de linkerkant te gaan, te klikken op Instellingen > Geavanceerd > Web-triggers en vervolgens op Web-trigger aanmaken.
Voer op het aanmaakscherm de naam van de trigger en het adres in waarnaar de aanvraag moet worden verzonden. Selecteer de statussen die u wilt ontvangen en sla op.
U kunt de betreffende web-trigger testen vanuit het gedeelte 'Acties' aan de rechterkant.
Wat is de inhoud van een web-trigger?
Zoals vermeld in het gedeelte https://fonzip.com/api/v2/docs#operation/createWebhook, wordt er een JSON naar de URL gestuurd die u voor de web-trigger hebt opgegeven.
{
"id": 0,
"webhook_id": 0,
"operation": 1,
"status": 0
}
id: Registratienummer van het betreffende object
webhook_id: ID van uw web-trigger
operation: transactietype (1: Donatie, 2: Contributie, 3: Ticket, 4: Formulier, 5: E-kaart, 6: Donatiecampagne)
status: transactiestatus (0: campagne aangemaakt, 3: succesvol, 4: terugbetaling, 5: fout)
Web-trigger aanvraag ontvangen, wat nu?
Nadat de web-trigger aanvraag in uw systeem is ontvangen, kunt u verbinding maken via de API met het registratienummer van de betreffende transactie en deze naar uw systeem halen.
Als er bijvoorbeeld een aanvraag in uw systeem binnenkomt wanneer een donatie plaatsvindt, kunt u de details van de donatie oproepen met de functie Haal Donatiedetails op ( https://fonzip.com/api/v2/docs#operation/getDonationDetails ) en deze in uw systeem opslaan.
Web-trigger niet ontvangen / Ontvangen maar er is een fout opgetreden, wat nu?
Fonzip probeert een trigger voor een transactie 3 keer, en als dit mislukt, probeert het niet opnieuw. Om mogelijke problemen te voorkomen, kunt u één keer per dag de dagelijkse transacties ophalen, het totale aantal transacties vergelijken met uw eigen systeem en ontbrekende items uit de lijst halen.
U kunt bijvoorbeeld de total parameter vergelijken van alle donaties van de vorige dag die u met de functie Lijst Donaties ( https://fonzip.com/api/v2/docs#operation/getDonationList ) heeft opgevraagd, met uw eigen systeem. Vergeet niet om deze verzoeken uit te voeren met een query op basis van de tijdzone.