Pular para as operações

Bancário

Truv em um fluxo de decisão.

5 Truv 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
Somente host de produção

Quem são

Verificação de renda e vínculo direto dos sistemas de folha.

Truv connects to payroll and HR providers, with the applicant's consent, and returns employment status, income and pay history from the source rather than from an uploaded document. The same connections also support direct deposit switching.

O que um fluxo pode chamar

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

  1. POST/v1/users/$data.truv_user_id/tokens/

    Iniciar uma conexão com a folha (token do Bridge)

    Primeiro passo. Emite o token que inicializa o TruvBridge para um usuário, que então escolhe o empregador ou o provedor de folha e faz login ali.

  2. POST/v1/link-access-tokens/

    Trocar o public token

    Segundo passo. O Bridge entrega ao front-end um public_token; esta chamada o troca pelo access_token e, mais importante, pelo link_id que identifica todas as chamadas de relatório abaixo.

  3. GET/v1/links/$data.truv_link_id/income-employment-reports

    Obter renda e vínculo (VOIE)

    A verificação de renda e vínculo de uma conexão concluída — valor, periodicidade e situação do vínculo direto do registro da folha.

  4. GET/v1/links/$data.truv_link_id/employment-reports

    Obter apenas o vínculo (VOE)

    Empregador, cargo, data de admissão e situação, sem o detalhe de renda.

  5. GET/v1/links/$data.truv_link_id/statements

    Obter holerites

    Holerites individuais com bruto, líquido e a abertura de proventos e descontos.

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 Truv 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 Truv as a connection authenticating with API key headers.
  • 02A Truv tem um host só para os dois ambientes, então proteja as execuções de teste com credenciais e limites seus.
  • 03Coloque um nó de Conexão e escolha uma operação — “Iniciar uma conexão com a folha (token do Bridge)” 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 Truv em um fluxo.

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

Adicione a Truv 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 Truv em uma decisão sem nunca ver o segredo.

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

A Truv expõe um host só para os dois ambientes, então não existe um sandbox separado para apontar. As execuções de teste continuam rodando no Sandbox e ficam registradas à parte no histórico de decisões, mas a chamada vai para o mesmo lugar que a de produção — então proteja isso com credenciais de teste, limites de taxa ou dados seus.

O que um fluxo pode chamar na Truv?

5 operações, incluindo “Iniciar uma conexão com a folha (token do Bridge)”, “Trocar o public token”, “Obter renda e vínculo (VOIE)”. 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 com a folha (token do Bridge)”. 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 Truv 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.

Quando você quiser

Wire Truv 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