Monte a verificação do seu caso de uso em um flow
Cada jornada junta, na ordem certa, os módulos que um caso de uso comum precisa, com o total calculado do catálogo e a receita pronta para criar o flow no sandbox.
Começar por uma jornada poupa a parte mais demorada da integração, que é decidir quais verificações ligar e em que ordem. Você parte de um desenho que já responde a um caso real e ajusta o que a sua política pedir.
- Documento (OCR)
- Face Match
- Liveness
- Detecção de Múltiplas Contas
"status": "approved"- KYC de pessoaDocumento, selfie com prova de vida, uma conta por pessoa, situação na Receita e PEP e sanções num flow só, com o resultado assinado no seu webhook.
- KYB de empresaDocumento societário em PDF, cadastro na Receita, quadro de sócios e dívida ativa da empresa num flow só de pessoa jurídica, sem câmera.
- Antifraude transacionalEnvie a transação na criação da sessão e receba na mesma resposta se ela passa, pede confirmação ou é barrada, sobre o histórico do próprio titular.
- Background checkPEP, sanções e mídia adversa sobre a pessoa verificada, com evidência para revisão humana. Não se destina a seleção de candidatos a emprego.
Como escolher
Se o cliente é pessoa física e você precisa saber quem ele é, comece pelo KYC de pessoa. Se é empresa, pelo KYB, que trabalha sobre o documento societário e o quadro de sócios, sem câmera. Quem vende produto proibido a menor encontra, nas páginas de setor, o flow curto com prova de vida e verificação de idade pela selfie.
Depois do cadastro, duas jornadas cobrem perguntas diferentes. O antifraude transacional julga cada pagamento no retorno da própria chamada, pelo costume do titular, e o background check reúne PEP, sanções e notícias negativas para a diligência sobre contraparte, nunca para seleção de emprego.
Se a dúvida é o setor, e não o caso de uso, as páginas de setor fazem o caminho inverso: partem do problema do negócio, como fintech, marketplace ou crédito, e indicam a jornada que cabe.
Como começar
Toda jornada tem uma receita na documentação com as três chamadas que a montam: o webhook do ambiente de teste, o flow e a primeira sessão. Os passos marcados como em breve ficam fora do flow e fora do total até a venda abrir, e a receita já nasce só com o que se vende hoje.
Uma jornada não é pacote fechado. Você pode acrescentar módulos ao flow, tirar passos que não se aplicam ou usar duas jornadas no mesmo produto, cada uma no seu flow, e o painel mostra o preço somado a cada escolha, com as dependências que cada módulo puxa.
Antes de ligar em produção, rode a jornada no sandbox com os desfechos simulados, escreva o tratamento de aprovado, reprovado e revisão, e só então troque a chave. A estrutura do evento é a mesma nos dois ambientes.
Perguntas frequentes
Ler a documentaçãoPreciso contratar a jornada inteira?
Não. O preço é por módulo, somado sobre o que o seu flow liga, e o total mostrado em cada jornada é essa soma para os passos que se vendem hoje. Nada é cobrado no sandbox. Dá para ligar só o documento e a selfie hoje e acrescentar listas ou antifraude amanhã.
Qual caminho serve para verificar só a idade, sem cadastro completo?
A jornada de KYC de pessoa pode somar a idade à identidade completa. Para uma porta de idade sem cadastro, o flow curto com prova de vida e verificação de idade está descrito nas páginas de setor de conteúdo restrito, delivery e games.
O resultado de todas as jornadas chega do mesmo jeito?
Sim, com uma diferença de tempo. As jornadas de cadastro terminam num evento assinado no webhook, e o antifraude transacional devolve o veredito já na resposta da chamada, com o laudo completo chegando depois pelo mesmo canal assinado.
Posso começar numa jornada e trocar de desenho depois?
Pode. Você edita o flow ou cria outro, e o reference_id do seu usuário continua sendo a chave que liga as verificações antigas às novas no seu sistema.
As jornadas atendem pessoa e empresa ao mesmo tempo?
Cada flow é de um tipo de sujeito, pessoa ou empresa. Quando o seu cliente é uma empresa com sócios a verificar, você usa as duas jornadas, cada uma no seu flow, e liga os resultados pela referência que o seu sistema escolher.
Onde está o código de exemplo de cada jornada?
Na documentação de integração, na seção de receitas: cada jornada tem os comandos prontos, com a credencial lida de variável de ambiente e marcadores que você troca pelos próprios valores, como a URL do webhook e o identificador do flow.
Crie a conta e monte a jornada no ambiente de teste, sem consumir saldo.
