Вы можете сообщать об определенных событиях, происходящих в Fonzip, на свои серверы с помощью веб-триггеров и сохранять соответствующие события в своей собственной системе.
Что такое веб-триггер? Как я могу его создать?
Веб-триггеры - это функция, которая отправляет уведомление на нужный адрес, когда в системе происходит событие. Перейдя в Настройки > Дополнительно > Веб-триггеры в левом меню, вы можете создать веб-триггер, щелкнув «Создать веб-триггер».
На экране создания введите имя триггера и адрес, на который будет направлен запрос. Выберите, в какие штаты вы хотите приехать и сохранить.
Вы можете протестировать соответствующий веб-триггер в разделе действий справа.
Что такое контент веб-триггера?
Как указано в https://fonzip.com/api/v2/docs#operation/createWebhook, JSON отправляется на URL-адрес, указанный вами для веб-триггера.
{
"id": 0,
"webhook_id": 0,
"operation": 1,
"status": 0
}
id: Регистрационный номер соответствующего объекта
webhook_id: идентификатор вашего веб-триггера.
operation: тип транзакции (1: пожертвование, 2: комиссия, 3: билет, 4: форма, 5: электронная карта, 6: благотворительная кампания)
status: статус транзакции (0: кампания создана, 3: успешна, 4: возвращена, 5: ошибка)
Получен запрос веб-триггера, что мне делать?
После того, как запрос веб-триггера поступит в вашу систему, вы можете подключиться к API и загрузить его в свою систему с регистрационным номером соответствующей транзакции.
Например, если запрос поступает в вашу систему, когда делается пожертвование, вы можете вызвать деталь пожертвования с помощью функции Получить детали пожертвования (https://fonzip.com/api/v2/docs#operation/getDonationDetails) и сохранить его. в вашу систему.
Веб-триггер не пришел / пришел, но произошла ошибка, что мне делать?
Fonzip 3 раза пытается инициировать транзакцию, и если это не удается, повторная попытка не выполняется. В случае возможных проблем вы можете перечислять ежедневные транзакции один раз в день, сравнивать общее количество транзакций с вашей собственной системой и снимать недостающие без внесения в список.
Например, с помощью функции «Список пожертвований» (https://fonzip.com/api/v2/docs#operation/getDonationList) вы можете сравнить общий параметр с вашей системой, когда вы перечисляете все пожертвования за предыдущий день. Делая эти запросы, не пренебрегайте запросами по часовому поясу.