Visão Geral da Agregação Bancária (Brasil)

Introdução

Desbloqueie pontos de dados financeiros padronizados e aprimorados da rede de open finance do Brasil com o produto de Agregação de Dados de Open Finance da Belvo para o Brasil, permitindo insights mais ricos e aplicações financeiras aprimoradas.

Dados Que Você Pode Acessar

Nosso produto de Agregação Bancária (Brasil) fornece acesso aos seguintes recursos:

Owner

Informações sobre o proprietário da conta bancária, como nome, informações de contato, documentos de identidade e mais. Para uma descrição detalhada de todos os campos disponíveis para este recurso, consulte nossa referência de API ou dicionários de dados.

Account

Informações sobre as contas que o usuário possui em uma determinada instituição, juntamente com informações de saldo, cheque especial, empréstimo e cartão de crédito. Para uma análise detalhada de todos os campos disponíveis para este recurso, consulte nossa referência de API ou dicionários de dados.

Transação

Informações transacionais, incluindo a data da transação, valor, descrição e muito mais. Para uma análise detalhada de todos os campos disponíveis para este recurso, consulte nossa referência de API ou dicionários de dados.

Bill

Para cada conta de cartão de crédito que o usuário possui, você também pode extrair as informações da fatura do cartão de crédito mensalmente. Para uma descrição detalhada de todos os campos disponíveis para este recurso, consulte nossa referência de API ou dicionários de dados.

Available Institutions

Para uma lista abrangente de todas as instituições financeiras disponíveis através da Agregação de Dados de Open Finance da Belvo no Brasil, consulte nossa página dedicada de Instituições de Agregação Bancária (Brasil OFDA).

Conectando Usuários (Consents e Links)

No OFDA, o conceito de consentimento e link são muito importantes:

Um consentimento representa o acordo do seu usuário para compartilhar seus dados de Open Finance de uma determinada instituição com sua aplicação. Este termo é padronizado dentro da Rede de Open Finance do Brasil. Somente os usuários podem gerenciar seus consentimentos, o que significa que são eles que podem renovar ou revogar essa permissão.
Um link é a representação interna da Belvo de um usuário. Após um usuário fornecer seu consentimento, a Belvo cria um link, que você pode usar para acessar os dados do usuário.

Para cada consentimento que é estabelecido, um link correspondente é criado, resultando em uma relação de um para um. Enquanto apenas o usuário pode gerenciar seu consentimento (por exemplo, para renová-lo ou revogá-lo), você tem a capacidade de deletar o link.

Quando você deleta um link (e todos os dados associados do sistema da Belvo), a Belvo desconecta permanentemente o link do consentimento. Esta ação é irreversível, o que significa que a conexão entre os dados do usuário e sua aplicação é permanentemente rompida. Por exemplo, se um usuário decidir parar de usar sua aplicação e você deletar o link dele como parte do processo de offboarding, todos os dados associados a esse usuário serão removidos da Belvo. No entanto, o consentimento original permanece intacto e o usuário deve revogá-lo ele mesmo usando o Portal My Belvo.

Se o seu usuário decidir retornar à sua aplicação, ele precisará conceder seu consentimento novamente, levando à criação de um novo link. Quando o usuário revisa seus consentimentos no Portal My Belvo (MBP), ele verá que concedeu consentimento à sua aplicação várias vezes.

Como os usuários dão consentimento?

Para obter o consentimento do seu usuário para acessar seus dados, ele precisa fornecer isso em sua instituição. A Belvo criou um hosted widget compatível com Open-Finance que você pode facilmente adicionar em seu aplicativo, o qual guiará seu usuário no processo de concessão de consentimento.

No diagrama abaixo, você pode ver um fluxo de alto nível de como a Belvo deve ser usada em seu aplicativo:

Dentro do seu aplicativo, solicite que seu usuário conecte sua conta bancária.
Nota: Seu aplicativo precisará ter recebido o CPF (ou CNPJ) e o nome completo do usuário para fins de concessão de consentimento.
Usando os dados fornecidos, inicie o Belvo Hosted Widget dentro do seu aplicativo.
O Belvo Hosted Widget guia seu usuário por todas as etapas para conceder ao seu aplicativo o consentimento para acessar seus dados. Isso inclui: escolher a instituição à qual eles querem dar acesso para leitura de dados, quais informações eles compartilharão com seu aplicativo, redirecionamento para sua instituição para confirmar o compartilhamento de dados e, finalmente, redirecionamento de volta para o widget em seu aplicativo.
Usuário concede consentimento dentro de sua instituição.
Após o usuário conceder seu consentimento em sua instituição, ele é redirecionado de volta para o Belvo Hosted Widget.
Usuário redirecionado para seu aplicativo
No widget, o usuário clica em Finalizar e é redirecionado para uma página específica dentro do seu aplicativo.

Assim que seu usuário concede seu consentimento e um link é criado, a Belvo automaticamente recupera os últimos 12 meses de informações de Conta, Proprietário, Transação e Fatura de Cartão de Crédito para o usuário.

Guia de Integração Dedicado

Para detalhes sobre como configurar o hosted widget dentro do seu aplicativo para obter o consentimento do usuário para acessar seus dados, consulte nosso guia dedicado Extrair Dados Bancários no Brasil (API com Hosted Widget).

Opções de Integração

Para extrair dados bancários no Brasil usando a Open Finance Network, você pode usar as seguintes opções de integração:

Limites de Recuperação e Requisitos Regulatórios

Limites de Recuperação Integrar-se à rede de Open Finance do Brasil envolve entender a frequência com que você pode recuperar dados do usuário devido a limitações da rede, bem como o aspecto crucial de gerenciar os consentimentos dos usuários. Para informações detalhadas sobre esses tópicos, consulte nossos artigos dedicados sobre Entendendo os Limites de Recuperação de Dados no Brasil OFDA e Gerenciando Consentimentos de Usuários no Brasil OFDA.

Requisitos Regulatórios De acordo com as regulamentações do Open Finance, seus usuários devem ter uma maneira de fácil acesso para gerenciar seus consentimentos dentro do seu aplicativo ou site. A Belvo criou o Meu Portal Belvo (MBP) que permite aos usuários gerenciar seus consentimentos de maneira simples e direta, atendendo a todos os requisitos das regulamentações.

O MBP pode ser configurado de três maneiras diferentes:

MBP Público
No site da Belvo, hospedamos uma instância universal do MBP que qualquer usuário pode usar para gerenciar seus consentimentos. Esta instância consolida todos os consentimentos que eles concederam usando o produto OFDA da Belvo. Você simplesmente precisa redirecionar seu usuário para https://meuportal.belvo.com/?mode=landing, onde eles podem inserir seus detalhes. Seu usuário poderá ver todos os consentimentos que concederam usando a Belvo (incluindo outras aplicações que usam a Belvo para extrair dados da Rede de Open Finance do Brasil).
MBP Personalizado
Você pode personalizar o MBP para exibir apenas os consentimentos que seu usuário concedeu à sua aplicação, facilitando o gerenciamento dos consentimentos.
Modo de Renovação de Consentimento
O MBP também pode ser usado para renovar um consentimento expirado. A Belvo enviará um webhook quando o consentimento de um dos seus usuários expirar.

Para aplicativos nativos móveis, criamos uma versão hosted do nosso widget que simplifica significativamente seu processo de desenvolvimento e integração. Tudo o que é necessário é que você crie uma webview em seu aplicativo e tenha algum conhecimento sobre o manuseio de redirecionamentos deeplink.