¿Cómo puedo usar webhooks?

Belvo proporciona un conjunto de webhooks para ayudarte a crear una experiencia más proactiva e inmersiva para sus usuarios.

Un webhook es una devolución de llamada web que Belvo puede usar para enviar alertas de eventos específicos a un link, por ejemplo, cuando hay nuevas transacciones disponibles o cuando los credenciales ya no funcionan.

Los webhooks solo funcionan para recurrent links con instituciones bancarias.

Actualmente solo tenemos webhooks en dos eventos:

• new_transactions_available: siempre que haya nuevas transacciones disponibles para un enlace recurrente
• invalid_credencials: siempre que las credenciales de un enlace recurrente ya no funcionen

1. Configura tus webhooks

Usando tu zona privada, puedes configurar uno o más webhooks.

Puede encontrar cómo configurar tus webhooks en nuestro artículo dedicado.

2. Recibir notificaciones

Una vez que se creen tus webhooks, comenzarás a recibir eventos en cada uno de tus enlaces recurrentes.

Estas notificaciones enviarán solicitudes a tu URL con una carga JSON dependiendo del evento. Por ejemplo:

{
 "webhook_type": "TRANSACTIONS",
 "webhook_code": "new_transactions_available",
 "link_id": "16f68516-bcbc-4cf7-b815-c500d4204e28",
 "data": {
 "new_transactions": 19
 }
}

3. Obtener datos

Después de recibir la notificación, puedes llamar a la API de Belvo utilizando tu Secret Key para acceder instantáneamente a los nuevos datos.

Por ejemplo, si deseas acceder a las nuevas transacciones (obtenido el 01-01-2020): 

curl --request GET 'https://api.belvo.co/api/transactions/?link=16f68516-bcbc-4cf7-b815-c500d4204e28&collected_at__range=2020-01-01,2020-01-02' \
-u [Secret Key ID]:[Secret Key PASSWORD]