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]
Comentarios
0 comentarios
Inicie sesión para dejar un comentario.