Usa webhooks cuando tu sistema deba enterarse de los pagos y mensajes en el momento en que ocurren, en lugar de consultar a Hyfin una y otra vez.
Los webhooks permiten que Hyfin avise a tu sistema de los cambios en cuanto ocurren, para que no tengas que estar consultando constantemente. Una vez que los actives, Hyfin envía un mensaje a tu URL en cuanto ocurre un evento.
Activas los webhooks para un sitio completo o para una orden de compra enviando una URL de webhook al endpoint correspondiente. Este es el JSON que necesita cada endpoint.
{
"externalId": "12345678",
"webhook": {
"active": true,
"url": "https://mysoftware.com/webhook"
}
}
{
"_id": "39772921",
"webhookUrl": "https://mysoftware.com/webhook/{invoice_id}"
}
Cuando se establece una URL de webhook, Hyfin envía los siguientes mensajes.
Su URL de webhook debe responder con un código de estado HTTP exitoso (cualquier 2xx) dentro de 30 segundos. Un estado distinto de 2xx, un tiempo de espera agotado o una conexión que no se pueda establecer se considera una entrega fallida y el mensaje se reenvía según el siguiente calendario.
Hay un máximo de cinco intentos de reenvío. Cada retraso de la tabla se mide a partir del intento anterior y no del webhook inicial, por lo que el quinto y último intento se realiza unos 3.1 días después. Si ese también falla, el mensaje no se vuelve a enviar.