# Pré-requisitos

Beta
Smart Collections está atualmente em Beta. Alguns contratos nesta página ainda estão sendo confirmados com nossa equipe de engenharia, portanto, trate-os como provisórios e espere refinamentos antes da disponibilidade geral, incluindo:

- Payloads de webhook e códigos de eventos
- Atualizações de referência da API para os endpoints de Collection Instructions, Payment Authorization e Charge
- Nomes de campos e melhorias na documentação (terminologia, diagramas)


Entre em contato com seu gerente de conta da Belvo para participar do programa Beta.

Para usar o Smart Collections da Belvo, você deve ter integrado previamente os dois produtos do Brasil nos quais ele se baseia: **Agregação Bancária** (para monitorar saldos) e **Transferências Inteligentes**, do Payments Brasil (para coletar fundos). O Smart Collections opera apenas em **produção**.

O Smart Collections utiliza dois produtos da Belvo, um para monitorar saldos de contas bancárias e outro para movimentar os fundos:

| Tarefa | O que você precisa | Produto Belvo |
|  --- | --- | --- |
| **Monitorar o saldo**: saber quando o usuário tem dinheiro suficiente para coletar | Um **Link** (`link_id`) que permite à Belvo ler o saldo da conta do usuário em segundo plano | Agregação Bancária (Agregação de Dados do Open Finance, OFDA) |
| **Coletar os fundos**: mova fundos via Pix assim que o saldo for suficiente | Uma **Autorização de Pagamento** de Transferências Inteligentes contra a qual você pode cobrar | Pagamentos Brasil: Transferências Inteligentes |


Configure cada produto separadamente
Agregação Bancária e Pagamentos são **produtos Belvo separados**. Cada um possui suas **próprias chaves de API** e sua **própria configuração de webhook**, então você deve configurar ambos **independentemente**. Coletas Inteligentes não funcionarão se você reutilizar as chaves de API ou o endpoint de webhook de um produto para o outro.

## Agregação Bancária (OFDA)

Para monitorar saldos, você precisa:

1. Completar o guia de introdução à Agregação Bancária.
2. Configurar o OFDA Widget para criar Links.
3. Habilitar um webhook para receber eventos de webhook **`COLLECTIONS`** (veja Webhooks de Agregação).


A Belvo precisa de um **Link** para ler o saldo da conta do usuário:

- Se você já agrega os dados deste usuário, **reutilize o Link existente**. Não é necessário criar um novo para Smart Collections.
- Caso contrário, crie um seguindo o guia de integração do OFDA Widget.


## Transferências Inteligentes (Pagamentos Brasil)

Para coletar fundos, você precisa:

1. Completar os pré-requisitos de Pagamentos Brasil.
2. Solicitar ao seu gerente de conta da Belvo para habilitar Transferências Inteligentes para sua organização.
3. Configurar webhooks para receber eventos de webhook **`Payments-BR.V2`** (veja Webhooks de Pagamentos (Brasil)).


A conta receptora deve ser do usuário
Transferências Inteligentes movem fundos apenas entre contas pertencentes à mesma pessoa (mesmo CPF) ou empresa (mesma raiz do CNPJ). Portanto, a conta beneficiária na Autorização de Pagamento deve ser do usuário de quem você está coletando. Veja a visão geral das Transferências Inteligentes.

Obtenha o ID da instituição de pagamentos separadamente
Ao criar uma Autorização de Pagamento, `payer.institution` é um ID de instituição de **pagamentos** do endpoint Listar todas as instituições de pagamento. Não é o mesmo que a instituição OFDA do Link do usuário, então você deve consultá-lo separadamente.

## Próximo passo

Uma vez que estes estejam configurados, vá para Fase 1: Verificação de Saldo para criar sua primeira Instrução de Coleta.