Saltar al contenido principal
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 mismo 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:
  • Crear un endpoint de webhook en tu servidor (un endpoint que recibirá los webhooks).
  • Probar el endpoint de webhook con algunos eventos de prueba.
  • Registrar el endpoint de webhook en Fintoc.
Un endpoint de webhook es 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 contienen toda la información relevante sobre lo que acaba de ocurrir. El endpoint de webhook debe usar esta información para realizar cualquier acción necesaria que mantenga el estado correcto en la aplicación. Por ejemplo, requerir que un usuario vuelva a conectar su cuenta bancaria con Fintoc después de cambiar la contraseña de dicha cuenta.