Pular para as operações

Bancário

Plaid em um fluxo de decisão.

6 Plaid 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
Cabeçalhos de chave de API
Ambiente de teste
Host de sandbox separado

Quem são

Conexão com contas bancárias: saldo, transações e renda.

Plaid connects an applicant's bank accounts, with their consent, and returns balances, transaction history, account and identity details, and income derived from them. It is the common route to evidencing affordability from what actually moves through an account rather than from a stated figure.

O que um fluxo pode chamar

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

  1. POST/link/token/create

    Iniciar uma conexão bancária (token do Link)

    First step. Creates the short-lived token that initialises Plaid Link in the member's browser or app; the member picks their bank and logs in there, so credentials never touch us.

  2. POST/item/public_token/exchange

    Trocar o public token

    Segundo passo. O Link entrega ao front-end um public_token de curta duração; esta chamada o troca pelo access_token de longa duração de que toda chamada de dados precisa.

  3. POST/transactions/sync

    Puxar transações (sync)

    A forma atual de ler transações. Devolve os lançamentos adicionados, alterados e removidos desde o cursor que você viu por último; omita cursor na primeira chamada e guarde body.next_cursor para a próxima.

  4. POST/transactions/get

    Puxar transações de um período

    Alternativa ao sync por janela de datas — use quando quiser exatamente os últimos N meses para um cálculo de capacidade de pagamento, e não um feed incremental.

  5. POST/credit/bank_income/get

    Obter renda estimada pelo extrato

    Renda inferida a partir do histórico de depósitos — a resposta de análise por fluxo de caixa para quem tem cadastro magro.

  6. POST/credit/payroll_income/get

    Obter renda da folha de pagamento

    Renda vinda de o cliente conectar o provedor de folha ou enviar um comprovante — evidência mais forte do que a inferência por depósitos, quando está disponível.

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 Plaid 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 Plaid as a connection authenticating with API key headers.
  • 02A Plaid 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 — “Iniciar uma conexão bancária (token do Link)” 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 Plaid em um fluxo.

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

Adicione a Plaid como uma conexão no seu workspace, autenticando com cabeçalhos de chave de API, 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 Plaid em uma decisão sem nunca ver o segredo.

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

Dá. A Plaid 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 Plaid?

6 operações, incluindo “Iniciar uma conexão bancária (token do Link)”, “Trocar o public token”, “Puxar transações (sync)”. 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 “Iniciar uma conexão bancária (token do Link)”. 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 Plaid 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 Plaid 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