Como coletar declarações de clientes com a Toden

Charles Archibong, Cofundador
Reúna as declarações necessárias para a sua apólice, como a origem dos fundos ou a atividade prevista. Um questionário fornece respostas registradas do cliente; ele não verifica essas respostas de forma independente.

Pontos principais
- Todas as perguntas necessárias podem ser respondidas pelo celular.
- Questões opcionais não respondidas não se disfarçam de resultados negativos.
- As regras utilizam o tipo de resposta efetivamente registrado.
- Uma atualização vincula-se à referência de cliente existente pretendida.
Reúna as declarações necessárias para a sua apólice, como a origem dos fundos ou a atividade prevista. Um questionário fornece respostas registradas do cliente; ele não verifica essas respostas de forma independente.
Antes de começar
Perguntas obrigatórias e política de revisão
Consentimento do cliente
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: Escolha o escopo de fluxo de trabalho correto
Abra a Configuração → Fluxos de Trabalho no Ambiente de Teste. Utilize um fluxo de trabalho de verificação completa existente quando as declarações pertencerem ao processo de integração. Para uma atualização periódica, escolha o modelo de atualização de Declarações com o escopo do questionário. Os envios com escopo são vinculados à referência do cliente existente e não substituem as informações do cliente. KYC Status. O escopo pode ser editado antes da primeira publicação; posteriormente, utilize uma versão com escopo definido para um escopo diferente.

Exemplo de painel: Escolha o escopo de fluxo de trabalho correto
Etapa 2: Abra o questionário.
Habilite o Questionário e selecione-o na lista de etapas. Abra a Configuração . Um fluxo de trabalho sem perguntas ignora completamente esta etapa; portanto, apenas habilitar o cabeçalho não coleta declarações. Selecione " Adicionar da biblioteca" para uma pergunta fornecida ou "Pergunta personalizada" para uma pergunta própria. Escreva a pergunta em palavras que o cliente possa responder sem precisar interpretar sua terminologia interna de risco.

Exemplo de painel: Abra a etapa do questionário
Passo 3: Atribua um propósito estável a cada pergunta.
Defina o tipo de resposta e as opções oferecidas para a pergunta. Mantenha a chave estável quando sua integração ou regras a utilizarem. Exija apenas as respostas que sua política realmente precisa e teste a pré-visualização para o cliente para garantir clareza. Se você mapear uma pergunta para um campo de perfil canônico, entenda esse mapeamento primeiro; por exemplo, uma resposta de endereço de carteira pode adicionar uma carteira declarada ao conjunto da entidade e inscrever a verificação de carteira.

Referência de integração: Complementos de captura
Etapa 4: Direcione as respostas com regras explícitas
Revise as regras e o seu gráfico de decisão. Utilize o questionário documentado. O campo <chave> contém a pergunta exata. Teste uma resposta relevante, uma resposta permitida e uma resposta ausente, quando opcional. Mantenha uma etapa de revisão humana quando uma resposta precisar de explicação. Não considere uma declaração que diga "verificado" como verificação independente nem assuma que toda resposta coletada altera uma decisão.

Referência de integração: Tomada de decisões
Etapa 5: Salvar e publicar o fluxo de trabalho
Aguarde a confirmação de "Salvo" no editor. Selecione "Publicar" ou "Publicar alterações" para um fluxo de trabalho existente. Na revisão da publicação, verifique o ambiente de destino, o ID do fluxo de trabalho, o preço e os avisos de prontidão. Resolva os problemas que estão impedindo a publicação e confirme a versão . Um rascunho salvo não é a versão que os clientes usam. Novas sessões usam o novo snapshot publicado; sessões já criadas mantêm sua versão original.

Exemplo de painel: Salvar e publicar o fluxo de trabalho
Etapa 6: Conecte o fluxo de trabalho publicado ao seu aplicativo
Copie o ID do fluxo de trabalho. Forneça esse ID ao seu desenvolvedor Web, React Native ou Flutter compatível. SDK , com uma chave publicável da mesma organização e ambiente e uma referência de cliente estável. Como alternativa, crie uma sessão hospedada vinculada ao cliente em seu backend com POST /api/kyc/sessions , usando uma chave secreta. Retorne a sessão. URL Apenas para o cliente pretendido. Uma pré-visualização da câmera não executa uma verificação nem comprova que seu sistema processa o resultado corretamente.

Referência de integração: Solicitação
Etapa 7: Leia o resultado final no seu painel administrativo.
Após a captura, armazene o ID de verificação associado à sua própria referência de cliente. Acompanhe as atualizações de status ou recupere o status atual. Leia o status para obter o resultado e verifique o status (checkStatus) , o motivo (reason ) e o código do motivo (reasonCode) para obter a explicação. Quando um fluxo de trabalho possui regras de decisão, um evento de verificação concluída pode ocorrer antes da decisão final do fluxo de trabalho. Mantenha os resultados de processamento e revisão humana pendentes; não aprove uma conta apenas porque o cliente concluiu as verificações da câmera.

Referência de integração: Status e checkStatus
Tire o máximo proveito dessa capacidade.
Utilize um fluxo de trabalho de atualização de declarações para alterações ao longo do tempo, em vez de pedir aos clientes que repitam toda a captura de identidade.
Mantenha as perguntas e as opções consistentes com a interpretação do seu sistema. Trate as alterações de redação que alteram o significado como uma mudança de política versionada.
Analise respostas inesperadas considerando o contexto do cliente; utilize-as como alegações até que sejam corroboradas por outras evidências.
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.
Todas as perguntas necessárias podem ser respondidas pelo celular.
Questões opcionais não respondidas não se disfarçam de resultados negativos.
As regras utilizam o tipo de resposta efetivamente registrado.
Uma atualização vincula-se à referência de cliente existente pretendida.
Solução de problemas
Nenhuma tela de questionário é exibida.
Verifique se a etapa possui pelo menos uma pergunta salva e se a versão do fluxo de trabalho está publicada.
Uma regra nunca se aplica
Confira o gabarito da pergunta, o tipo de resposta e a ordem das regras em relação à resposta retornada.
Declarações revigorantes mudaram minhas expectativas de KYC
O fluxo de dados delimitado registra as declarações; ele não toma uma nova decisão completa de verificação de identidade.
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.


