Skip to main content
Real-Time Data Transfer with API

How do I export data from Fonzip to our own system? What is a web trigger? How to use?

Erdi avatar
Written by Erdi
Updated over 2 months ago

You can report certain events that occur in Fonzip to your own servers thanks to web triggers and save the relevant events to your own system.

What is a web trigger? How can I create?

Web triggers are a feature that sends a notification to the address you want when an event occurs in the system. After coming to Settings > Advanced > Web Triggers from the left menu, you can create a web trigger by clicking Create Web Trigger.

On the compose screen, enter the trigger name and the address you want the request to go to. Choose which states you want to arrive and save.

You can test the relevant web trigger in the actions section on the right.

What is web trigger content?

As stated in https://fonzip.com/api/v2/docs#operation/createWebhook, a JSON is sent to the URL you specified for the web trigger.

{

"id": 0,

"webhook_id": 0,

"operation": 1,

"status": 0

}

  • id: Registration number of the relevant object

  • webhook_id: The ID of your web trigger

  • operation: type of transaction ( 1: Donation, 2: Fee, 3: Ticket, 4: Form, 5: E-card, 6: Donation campaign)

  • status: transaction status (0: campaign created, 3: successful, 4: returned, 5: error)

Web trigger request arrived, what should I do?

After the web trigger request comes to your system, you can connect with the API and pull it to your system with the registration number of the relevant transaction.

For example, if a request comes to your system when a donation is made, you can call the donation detail with the Get Donation Detail function ( https://fonzip.com/api/v2/docs#operation/getDonationDetails ) and save it to your system.

Web trigger did not come / Arrived but an error occurred, what should I do?

Fonzip tries 3 times to trigger a transaction, and if it fails, it won't try again. Against possible problems, you can list daily transactions once a day, compare the total number of transactions with your own system, and withdraw the missing ones without listing.

For example, with the List Donations function ( https://fonzip.com/api/v2/docs#operation/getDonationList ) you can compare the total parameter with your system when you list all donations from the previous day. When making these requests, do not neglect to query according to the time zone.

Did this answer your question?