Como adicionar verificação ao seu aplicativo com o Toden
Charles Archibong, Cofundador
Adicione verificação ao seu aplicativo usando um fluxo de trabalho publicado e um SDK compatível ou uma sessão hospedada. Mantenha a captura na jornada do cliente e o processamento do resultado final no seu backend.
Pontos principais
- O aplicativo abre o fluxo de trabalho publicado pretendido.
- As credenciais secretas permanecem no servidor.
- Viagens canceladas, expiradas e abandonadas são tratadas.
- Os resultados finais correspondem ao cliente pretendido.
- A produção utiliza seu próprio fluxo de trabalho, chaves e receptor.
Adicione verificação ao seu aplicativo usando um fluxo de trabalho publicado e um recurso compatível. SDK ou sessão hospedada. Mantenha a captura na jornada do cliente e o processamento do resultado final no seu backend.
Antes de começar
Um fluxo de trabalho publicado
O apoiado SDK ou caminho de sessão hospedada
Seu servidor recupera o resultado final.
Use um membro da equipe com permissão para este controle. Verifique a organização e o ambiente antes de alterar qualquer configuração. Revise o preço atual antes de efetuar um pagamento ou renovar a assinatura. As capturas de tela mostram um exemplo de espaço de trabalho ou a referência de integração pública; elas não mostram um cliente real nem um pagamento efetuado.
Configure e utilize a funcionalidade.
Etapa 1: Publique o fluxo de trabalho que os clientes devem usar.
Abra a Configuração → Fluxos de Trabalho no Sandbox. Crie ou abra o fluxo de trabalho individual, empresarial ou com escopo apropriado. Configure apenas as verificações de captura e revisão necessárias. Salve e publique o fluxo de trabalho e, em seguida, copie o ID do fluxo de trabalho. Verifique a organização e o ambiente antes de integrá-lo. Um fluxo de trabalho não publicado não é uma configuração de captura ativa reutilizável.
Exemplo de painel: Publique o fluxo de trabalho que os clientes devem usar.
Etapa 2: Escolha entre captura incorporada ou sessão hospedada.
Use a Web SDK Para captura via navegador, React Native ou Flutter para captura nativa em dispositivos móveis e uma sessão hospedada quando você precisar de um link para um candidato conhecido. Recursos exclusivos para dispositivos nativos, como NFC É necessário um caminho nativo. Um link de fluxo de trabalho compartilhado atende a vários candidatos; uma sessão criada pelo servidor pertence a um único candidato. Escolha o caminho que corresponda ao seu produto, em vez de misturar as credenciais.
Referência de integração: Três maneiras de executar um fluxo de trabalho
Passo 3: Instale a versão suportada atual SDK e configurar a captura
Siga as instruções da sua plataforma. SDK Consulte o guia para obter informações sobre o pacote compatível, as dependências de pares necessárias e as declarações de permissão. Passe o `workflowId` , a chave de API publicável correspondente e seu `userId` estável . O fluxo de trabalho fornece as etapas configuradas; os dados do sujeito em tempo de execução permanecem com seu aplicativo. Verifique a versão mínima documentada com suporte a fluxo de trabalho antes de solucionar problemas em um fluxo que ignora o ID do fluxo de trabalho.
Referência de integração: Fluxos de trabalho
Passo 4: Para captura hospedada, crie a sessão no seu backend.
Chamar POST /api/kyc/sessions com uma chave secreta, ID do fluxo de trabalho publicado e externalUserId pretendido. Adicione pré-preenchimentos e metadados permitidos somente quando necessário. Armazene a referência da sessão e forneça o private URL Ao candidato pretendido. O instantâneo do fluxo de trabalho é fixado no momento da criação. Não coloque uma chave secreta em uma WebView, versão para dispositivos móveis ou pacote de navegador.
Referência de integração: Solicitação
Etapa 5: Registre o envio e aguarde o resultado.
O SDK O callback de submissão identifica uma submissão; não é o callback de aprovação final. Armazene sua referência de verificação no seu backend. Leia o status atual com o parâmetro permitido. API ou receber webhooks assinados. Mantenha os status de processamento, revisão humana, aguardando reenvio, erro e resultados finais distintos. Leia o status final com checkStatus e sua explicação, especialmente quando a decisão depende de outras verificações.
Referência de integração: Estados
Etapa 6: Teste todo o percurso e prepare a Produção separadamente.
Use IDs e fixtures de Sandbox compatíveis para testes de captura, status e recepção. Pratique permissões de recusa, abandono, novas tentativas, revisão e desistência. Para Produção, obtenha aprovação comercial, publique o fluxo de trabalho de Produção, configure chaves e receptores de resultados compatíveis com o ambiente e revise os preços atuais. A aprovação no Sandbox valida seu manuseio; não é uma prova de que todas as verificações ou dispositivos em produção funcionarão corretamente.
Referência de integração: Lista de verificação para entrada em operação
Tire o máximo proveito dessa capacidade.
Permita que a publicação do fluxo de trabalho capture alterações na configuração de captura sem duplicar essa configuração em cada compilação do aplicativo.
Utilize metadados para correlações permitidas, como referências de aplicativos, mantendo-as dentro dos limites documentados.
Teste a transferência de dados do telefone, a recuperação de permissões e os eventos hospedados no navegador para a jornada que você realmente enviar.
Faça o teste antes de confiar nele.
Execute os cenários de Sandbox ou simulador compatíveis com este produto. Quando uma ferramenta for exclusiva para Produção, verifique primeiro o acesso e o escopo e, em seguida, use apenas um teste de Produção permitido e cuidadosamente revisado. Uma captura de tela da documentação ou o carregamento bem-sucedido de uma página não constituem um teste de integração de ponta a ponta.
O aplicativo abre o fluxo de trabalho publicado pretendido.
As credenciais secretas permanecem no servidor.
Viagens canceladas, expiradas e abandonadas são tratadas.
Os resultados finais correspondem ao cliente pretendido.
A produção utiliza seu próprio fluxo de trabalho, chaves e receptor.
Solução de problemas
O SDK ignora workflowId
Verifique se a versão do pacote instalado corresponde à versão mínima documentada e confirme o fluxo de trabalho publicado.
O fluxo de trabalho não foi encontrado.
A correspondência inclui chave, organização, ambiente e ID publicado.
Meu aplicativo foi integrado imediatamente após o onSubmit.
Aguarde a confirmação final e definitiva em vez de considerar o envio da captura como aprovação.
Abra as referências de configuração e integração.
Fluxos de trabalho abertos (abre num novo separador)
Leia a referência de integração. (abre num novo separador)
Voltar para Soluções (abre num novo separador) . Escolha a funcionalidade que deseja ativar e siga o guia correspondente.
Fontes
Charles Archibong
Cofundador
Charles Archibong é cofundador da Toden. Ele escreve sobre verificação de identidade, tecnologia financeira e o trabalho prático de construção de serviços digitais confiáveis.
