Skip to main content
Un webhook es un mecanismo que nos permite notificar a tu servidor sobre una acción específica que ocurrió del lado de Fintoc para que tu aplicación pueda reaccionar a ella, manteniendo un “estado sincronizado” con Fintoc. Usamos webhooks para notificar a tu aplicación cuando ocurren eventos importantes en las cuentas bancarias de tus usuarios. Por ejemplo, cuando un usuario cambia su contraseña y ya no es posible obtener nuevos movimientos, o cuando un cheque es protestado y el movimiento correspondiente a dicho cheque deja de existir en el banco. También usamos webhooks para notificar sobre eventos que ocurren en el propio Fintoc. Por ejemplo, cuando una cuenta termina de sincronizarse con los últimos datos disponibles del banco. Para usar los webhooks de Fintoc, debes seguir tres pasos:
  1. Crear un webhook endpoint en tu servidor (un endpoint que recibirá los webhooks).
  2. Probar el webhook endpoint con algunos eventos de prueba.
  3. Registrar el webhook endpoint en Fintoc.
Cuando tu endpoint ya corre en modo live, recupera los eventos que perdiste para ponerte al día con los eventos que tu endpoint no procesó durante una caída. Un webhook endpoint son solo unas pocas líneas de código dentro de tu aplicación. Debe estar asociado a una URL que se usará para notificarte sobre nuevas acciones. Estas notificaciones enviadas por Fintoc corresponden a objetos del tipo Event, que contiene toda la información relevante sobre lo que acaba de ocurrir. El webhook endpoint debe usar esta información para realizar cualquier acción necesaria para mantener el estado correcto en la aplicación. Por ejemplo, requerir que un usuario reconecte su cuenta bancaria con Fintoc después de cambiar la contraseña de la cuenta bancaria.