Skip to content
Última actualización

Lista de Verificación de Integración (OFDA)

Para ayudarte durante tu proceso de integración OFDA, hemos creado una lista de verificación para que 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 access_token tanto para individuos como para empresas.
  • Has implementado correctamente tus URLs de callback.
  • Puedes manejar eventos de Success, Exit, Error y Warning desde el 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.

Para más información sobre la lógica de reintento que deberías implementar, consulta nuestras Notas generales sobre el manejo de errores.

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:

  • <a href="../../developer_resources/resources-webhooks-aggregation target="_blank" rel="noopener noreferrer">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 enviar solicitudes GET después de recibir un evento de webhook.
  • Responder dentro de cinco segundos de recibir un webhook con un 200 OK.
  • Poner en 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

Recomendamos encarecidamente que pongas en lista blanca estas direcciones IP para que puedas recibir eventos de webhook.

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?
  • ¿Te has familiarizado con los límites de red de Open finance Brasil?

Mi Portal Belvo

¿Has:

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 estés cambiando 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 Belvo Production API Keys.
  • 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: