# Prerrequisitos

Beta
Smart Collections está actualmente en Beta. Algunos contratos en esta página aún están siendo confirmados con nuestro equipo de ingeniería, por lo que deben considerarse provisionales y se esperan refinamientos antes de la disponibilidad general, incluyendo:

- Cargas útiles de webhook y códigos de eventos
- Actualizaciones de referencia de la API para los endpoints de Collection Instructions, Payment Authorization y Charge
- Nombres de campos y mejoras en la documentación (terminología, diagramas)


Contacta a tu gerente de cuenta de Belvo para unirte al programa Beta.

Para utilizar las Smart Collections de Belvo, debes haber integrado previamente ambos productos de Brasil en los que se basa: **Banking Aggregation** (para monitorear saldos) y **Smart Transfers**, de Payments Brazil (para recolectar fondos). Smart Collections funciona solo en **producción**.

Smart Collections utiliza dos productos de Belvo, uno para monitorear los saldos de las cuentas bancarias y otro para mover los fondos:

| Tarea | Lo que necesitas | Producto de Belvo |
|  --- | --- | --- |
| **Monitorear el saldo**: saber cuándo el usuario tiene suficiente dinero para recolectar | Un **Link** (`link_id`) que permite a Belvo leer el saldo de la cuenta del usuario en segundo plano | Banking Aggregation (Open Finance Data Aggregation, OFDA) |
| **Recaudar los fondos**: mueve fondos a través de Pix una vez que el saldo sea suficiente | Una **Autorización de Pago** de Smart Transfers contra la cual puedes cobrar | Pagos Brasil: Smart Transfers |


Configura cada producto por separado
La Agregación Bancaria y los Pagos son **productos de Belvo separados**. Cada uno tiene sus **propias claves de API** y su **propia configuración de webhook**, por lo que debes configurarlos **independientemente**. Las Smart Collections no funcionarán si reutilizas las claves de API o el endpoint de webhook de un producto para el otro.

## Agregación Bancaria (OFDA)

Para monitorear saldos, necesitas:

1. Completar la guía de inicio rápido de Agregación Bancaria.
2. Configurar el OFDA Widget para crear Links.
3. Habilitar un webhook para recibir eventos de webhook **`COLLECTIONS`** (ver Webhooks de Agregación).


Belvo necesita un **Link** para leer el saldo de la cuenta del usuario:

- Si ya agregas los datos de este usuario, **reutiliza su Link existente**. No necesitas crear uno nuevo para Smart Collections.
- De lo contrario, crea uno siguiendo la guía de integración del OFDA Widget.


## Transferencias Inteligentes (Pagos Brasil)

Para recolectar fondos, necesitas:

1. Completar los requisitos previos de Pagos Brasil.
2. Pedir a tu gerente de cuenta de Belvo que habilite las Transferencias Inteligentes para tu organización.
3. Configurar webhooks para recibir eventos de webhook **`Payments-BR.V2`** (ver Webhooks de Pagos (Brasil)).


La cuenta receptora debe ser del usuario
Las Transferencias Inteligentes solo mueven fondos entre cuentas que pertenecen a la misma persona (mismo CPF) o empresa (misma raíz de CNPJ). Por lo tanto, la cuenta beneficiaria en la Autorización de Pago debe ser del usuario del cual recolectas. Consulta la visión general de Transferencias Inteligentes.

Obtén el ID de la institución de pagos por separado
Cuando creas una Autorización de Pago, `payer.institution` es un ID de institución de **pagos** del endpoint Listar todas las instituciones de pago. **No** es lo mismo que la institución OFDA del Link del usuario, por lo que debes buscarlo por separado.

## Siguiente paso

Una vez que estos estén en su lugar, dirígete a Fase 1: Verificación de Saldo para crear tu primera Instrucción de Cobro.