Lista de Verificación de Integración (Empleos México)

Para ayudarte durante tu proceso de integración, hemos creado una lista de verificación para que la sigas 😉. Por favor, asegúrate de abordar todos los elementos antes de solicitar acceso al entorno de Producción.

Implementar el widget

Mientras integras el widget, asegúrate de que:

• Tus usuarios primero registren una cuenta con tu aplicación antes de pedirles que conecten sus cuentas con Belvo.
• Estás utilizando el parámetro external_id para proporcionar tu propio ID único para un enlace (o grupo de enlaces) en tu sistema. Nota: Este parámetro también es buscable dentro del sistema de Belvo.
• Si usas enlaces individuales, utilizas el parámetro fetch_resources para recibir de manera asincrónica datos históricos sobre tu usuario.
• Puedes generar un token de access.
• Has implementado correctamente tus URLs de callback.
• Puedes manejar eventos de Success, Exit, Error y Warning del Hosted Widget.

Manejo de Errores

Asegúrate de que tu integración pueda manejar y registrar el request_id de:

• Errores 400 y 401
• Errores 500
• Errores de tiempo de espera

Te pedimos que registres el request_id por si necesitas comunicarte con nuestro equipo de soporte. Con este ID, podemos acelerar el proceso de resolución de problemas y encontrar una solución para ti.

Manejo de Solicitudes

¿Puede su integración manejar:

• Respuestas de Éxito 200, 201 y 202
• Respuestas de Éxito 204 (cuando elimina algunos datos)
• Paginación

Además, asegúrese de que con las respuestas exitosas, almacene:

• El identificador único para el objeto (por ejemplo, el transaction.id). Esto le permitirá evitar tener objetos duplicados (como transacciones) en su base de datos.

Webhooks

Ya sea que estés utilizando enlaces únicos o recurrentes, asegúrate de:

• Configurar una URL de webhook en el dashboard para que puedas recibir eventos de webhook. Por favor recuerda que necesitarás configurar diferentes URLs de webhook dependiendo del entorno en el que estés trabajando.
• Si usas enlaces recurrentes, que hayas configurado tu frecuencia de actualización según tus necesidades (diaria, semanal o mensual) (contacta a nuestro equipo de ventas).
• Solo envía solicitudes GET después de recibir un evento de webhook.
• Responde dentro de cinco segundos de recibir un webhook con un 200 OK.
• Incluye en la lista blanca las siguientes direcciones IP:

Puedes recibir eventos de webhook desde las siguientes direcciones IP:

• 3.130.254.46
• 18.220.61.186
• 18.223.45.212

Creación y gestión de enlaces

¿Tu integración:

• ¿Tiene un mecanismo para evitar que se creen enlaces duplicados?
• ¿Monitorea los estados de enlace invalid y token_required, y si es necesario, solicita a tus usuarios que actualicen sus credenciales?

Cambios que no rompen la compatibilidad

Si realizamos los siguientes cambios que no rompen la compatibilidad en nuestra API, ¿estás seguro de que no afectará tu integración?

• Nuevos campos o un orden diferente en el cuerpo de la respuesta.
• Cambiar el número de caracteres para una cadena.
• Devolver marcas de tiempo yyyy-MM-ddTHH:mm:ss.SSSZ, donde S son microsegundos (de 3 a 6 dígitos) y Z es ya sea +00:00 o Z.
• Agregar nuevos endpoints.

URL y API Keys

Cuando cambies a Producción, asegúrate de que:

• Estás llamando a la versión de producción de la API de Belvo (https://api.belvo.com).
• Estás usando tus API Keys de Producción de Belvo.
• Estás almacenando tus API keys de forma segura.

Suscribirse a las actualizaciones

Asegúrate de haberte suscrito a los siguientes servicios para estar al día sobre el estado de nuestra API e instituciones:

• Estado de la API de Belvo
• Estado de las instituciones (consulta nuestra guía dedicada)