# Lista de Verificación de Integración (Empleos Brasil)

Para ayudarte durante tu proceso de integración, 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 únicos, 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 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 obtener 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:

- [ ] 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 estás utilizando 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?


## 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](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:

- [ ]  Estado de la API de Belvo
- [ ]  Estado de la institución (consulta nuestra guía dedicada)