Gracias a los disparadores web, puede notificar a sus propios servidores sobre ciertos eventos que ocurren en Fonzip y registrar estos eventos en su propio sistema.
¿Qué es un disparador web? ¿Cómo puedo crearlo?
Los disparadores web son una característica que envía notificaciones a la dirección deseada cuando ocurre un evento en el sistema. Puede crear un disparador web yendo a la sección Configuración > Avanzado > Disparadores Web desde el menú de la izquierda y luego haciendo clic en Crear Disparador Web.
En la pantalla de creación, introduzca el nombre del disparador y la dirección a la que desea que vaya la solicitud. Seleccione las condiciones que desea recibir y guarde.
Puede probar el disparador web relevante desde la sección de operaciones de la derecha.
¿Cuál es el contenido de un disparador web?
Se envía un JSON a la URL que especifique para el disparador web, como se indica en la sección https://fonzip.com/api/v2/docs#operation/createWebhook.
{
"id": 0,
"webhook_id": 0,
"operation": 1,
"status": 0
}
id: Número de registro del objeto relacionado
webhook_id: ID de su disparador web
operation: tipo de operación ( 1: Donación, 2: Cuota de membresía, 3: Boleto, 4: Formulario, 5: Tarjeta electrónica, 6: Campaña de donación)
status: estado de la operación (0: campaña creada, 3: exitoso, 4: reembolso, 5: error)
He recibido una solicitud de disparador web, ¿qué debo hacer?
Una vez que la solicitud del disparador web llega a su sistema, puede conectarse a la API con el número de registro de la operación correspondiente y extraerla a su sistema.
Por ejemplo, if recibe una solicitud en su sistema cuando se realiza una donación, puede llamar los detalles de la donación con la función Obtener Detalles de Donación ( https://fonzip.com/api/v2/docs#operation/getDonationDetails ) y guardarlos en su sistema.
El disparador web no llegó / Llegó pero hubo un error, ¿qué debo hacer?
Fonzip intenta activar una operación 3 veces y, si falla, no lo intenta más. Para posibles problemas, puede listar las operaciones diarias una vez al día, comparar el número total de operaciones con su propio sistema y extraer las que falten de la lista.
Por ejemplo, puede comparar el parámetro total de la lista de todas las donaciones del día anterior con la función Listar Donaciones https://fonzip.com/api/v2/docs#operation/getDonationList con su propio sistema. Al realizar estas solicitudes, no olvide consultar según el huso horario.