Pular para as operações

Bancário

Belvo em um fluxo de decisão.

6 Belvo operations a decision flow can call directly, with the credentials your own contract issued. The response is data the rest of the flow reads, branches on, and keeps in the trace.

Categoria
Bancário
Tipo
Integração
Autenticação
HTTP basic auth
Ambiente de teste
Host de sandbox separado

Quem são

Dados de Open Finance em toda a América Latina.

A Belvo se conecta a bancos e instituições financeiras no Brasil, no México e na Colômbia e devolve contas, transações, identidade e renda por uma interface só. Financiadoras e produtos de finanças pessoais a usam onde o cadastro no bureau é magro ou não existe, o que descreve boa parte dos solicitantes da região. Ela também deriva renda e pagamentos recorrentes do histórico bruto de transações.

O que um fluxo pode chamar

6 operações, cada uma um passo que você coloca no editor.

  1. GET/api/links/

    Listar conexões bancárias

    Every link the account holds. A link is one person's connection to one institution and it is what every read below is scoped to, so this is the first call when working out what a flow can actually see.

  2. GET/api/accounts/?link=$data.belvo_link_id

    Listar contas

    As contas por trás de um link, com saldos e tipo de conta.

  3. GET/api/transactions/?link=$data.belvo_link_id

    Listar transações

    Histórico de transações de um link. Essa é a entrada de capacidade de pagamento — o que chega, com que regularidade, e o que sai de novo.

  4. GET/api/owners/?link=$data.belvo_link_id

    Ler a identidade que o banco tem

    Nome, documento, endereço e dados de contato como a instituição os tem.

  5. GET/api/incomes/?link=$data.belvo_link_id

    Ler a renda calculada

    Belvo's own income analysis over the link's transactions — recurring streams, their regularity and their confidence.

  6. GET/api/institutions/

    Listar instituições

    Todas as instituições que a Belvo alcança, por país, com as credenciais que cada uma pede.

Onde isso entra na decisão

Banking calls have a natural place in a flow.

O dado bancário responde à pergunta que a renda declarada não responde: o que de fato entra, com que regularidade, e o que sai de novo. Normalmente é puxado uma vez por proposta e depois lido por vários nós — capacidade de pagamento, verificação de renda, qualquer regra sobre volatilidade de saldo — então vale buscá-lo cedo e derivar dele, em vez de chamá-lo repetidas vezes.

Whatever Belvo returns is part of the run, so it is part of the record. When someone asks months later why an applicant was declined, the answer cites what came back at the time rather than re-fetching from a service whose answer has since changed.

  • 01Add Belvo as a connection authenticating with HTTP basic auth.
  • 02A Belvo mantém um host de sandbox separado, então um fluxo no Sandbox consegue fazer a chamada real sem tocar em produção.
  • 03Coloque um nó de Conexão e escolha uma operação — “Listar conexões bancárias” costuma ser a primeira de que um fluxo precisa.
  • 04Mapeie a resposta nos campos que suas regras leem e depois teste o caminho inteiro antes de ele receber tráfego de produção.

Perguntas frequentes

Usando a Belvo em um fluxo.

Como conecto a Belvo a um fluxo de decisão?

Adicione a Belvo como uma conexão no seu workspace, autenticando com HTTP basic auth, com as credenciais que o seu próprio contrato emitiu — a ArboRule chama o provedor no seu lugar e nunca assume um contrato por você. Depois que a conexão existe, qualquer fluxo do workspace pode colocar um nó de Conexão e escolher uma das operações dela. As credenciais ficam na conexão, não no fluxo, então quem cuida da política usa a Belvo em uma decisão sem nunca ver o segredo.

Dá para testar a Belvo sem tocar em produção?

Dá. A Belvo mantém um host de sandbox separado, então um fluxo rodando no Sandbox faz a chamada real com credenciais de teste e você lê o formato verdadeiro da resposta na trilha antes de qualquer coisa chegar a um cliente. O fluxo não muda quando é promovido — muda só quais credenciais respondem.

O que um fluxo pode chamar na Belvo?

6 operações, incluindo “Listar conexões bancárias”, “Listar contas”, “Listar transações”. Cada uma é um passo que você coloca no editor e mapeia nos campos que suas regras leem, e a maioria dos fluxos começa por “Listar conexões bancárias”. A lista vem do mesmo manifesto que o motor usa para fazer a chamada, então esta página não consegue descrever uma operação que o produto não tem.

Em que ponto de uma decisão a Belvo deve ser chamada?

O dado bancário responde à pergunta que a renda declarada não responde: o que de fato entra, com que regularidade, e o que sai de novo. Normalmente é puxado uma vez por proposta e depois lido por vários nós — capacidade de pagamento, verificação de renda, qualquer regra sobre volatilidade de saldo — então vale buscá-lo cedo e derivar dele, em vez de chamá-lo repetidas vezes.

Also in Banking

Quando você quiser

Wire Belvo into a real decision.

Monte o fluxo no Sandbox, conecte sua conta e veja a decisão buscar o que precisa antes de responder.

Leia a documentação