Sessões e estados

Descubra o que é uma sessão de validação de identidade, quais são as etapas do processo e seus diferentes estados.


O que é uma sessão de validação de identidade?

Para verificar a identidade de uma pessoa, é necessário concluir o processo de KYC e para validar uma empresa, usamos a verificação KYB.

Ao iniciar qualquer um desses dois processos, uma nova sessão de validação de identidade é criada, onde armazenaremos todas as informações dessa verificação. Em outras palavras, as sessões são a entidade principal da Identidade.

O objetivo principal dessa solução é:

  • Coletar todos os dados e documentos necessários.
  • Verificar a autenticidade de todas essas informações.
  • Comparar os dados para prevenir atividades ilegais, como lavagem de dinheiro, financiamento ao terrorismo e fraude.

Como é composta uma sessão de validação de identidade?

Cada sessão é composta por diversos steps, ou seja, diferentes estágios no processo de verificação. Cada um indica um dos diferentes check-ups que realizamos para fazer uma verificação.

Os steps variam entre o processo de validação de um usuário ou de uma empresa:

KYCKYB
Aceitação de T&CAceitação de T&C
Prova de vidaFormulário completo
Correspondência selfie / documentoValidação da empresa
OCRValidação de sócios
Formulário completoValidação de documentação
Validação de dadosValidação de risco
Validação de foto-
Validação de risco-

Quais estados os steps podem ter?

O estado da sessão é determinado pelo estado dos steps. Os steps têm seu próprio estado e todos esses estados juntos definem o estado geral da sessão. Os estados dos steps são os seguintes:

PENDINGIndica que existem steps ou informações pendentes no processo de validação.
SUCCESSIndica que o cliente concluiu com sucesso o step.
PROCESSINGIndica que estamos aguardando uma resposta de nosso provedor.
FAILEDIndica que o cliente não concluiu corretamente o step.
NOT AVAILABLEIndica que não podemos acessar um dos serviços que usamos.
Para que a sessão seja válida, todos os steps devem estar no estado SUCCESS.

O que é o estado de uma sessão?

Existem dois tipos de estados da sessão:

  • Estados temporários: são aqueles que mostram o progresso da sessão.
  • Estados terminais: são aqueles em que uma sessão foi concluída, sem possibilidade de retorno.

Neste gráfico, você pode ver os estados pelos quais uma sessão passa e seus possíveis estados finais.

Modelo de estados

Quais estados uma sessão pode ter?

Conforme os steps avançam, a sessão passará por diferentes estados:

CREATEDEstado inicial que indica que uma nova sessão de validação foi criada.
IN PROGRESSIndica que o usuário iniciou o processo de validação de identidade. A mudança de CREATED para IN PROGRESS ocorre quando seu cliente realiza a primeira ação no fluxo.
PROCESSINGÉ um estado transitório ativado quando aguardamos informações para realizar verificações de forma assíncrona ou quando algum provedor apresenta atrasos. Esse estado permite fornecer aos usuários uma mensagem mais contextualizada e oportuna.
MANUAL REVIEWIndica que pelo menos um step do fluxo requer revisão manual, pois não pode ser resolvido automaticamente.
REJECTEDIndica que, após uma análise detalhada, foi determinado que a sessão não atende aos critérios de validação. Uma vez confirmado esse estado, não será permitida a criação de uma nova sessão para o mesmo usuário ou empresa.
NOT VALIDATEDIndica que não conseguimos validar um ou mais steps do fluxo, o que impede a confirmação da identidade do usuário. Nesse caso, você pode criar outra sessão para o mesmo usuário ou empresa. Conheça os motivos de falha que podem causar esse estado.
VERIFIEDIndica que todos os steps da sessão foram validados.
EXPIREDIndica que a sessão não pode ser concluída porque o tempo estabelecido para acessar o fluxo foi cumprido.
CANCELLEDIndica que a sessão não pode ser concluída por um dos seguintes motivos:
     - Foi criada uma nova sessão para o mesmo usuário. Nesse caso, a sessão anterior passa para o estado CANCELLED e seu cliente continua o fluxo na nova sessão.
     - Você decide cancelar a sessão por motivos de segurança ou prevenção a fraudes.
Um usuário pode ter várias sessões associadas ao longo do tempo, mas só pode ter uma sessão em estado temporário por vez. Cada sessão possui um código único de referência, você pode encontrar um exemplo em nossa Referência da API.
Após criar uma sessão, você receberá notificações sobre as transições e alterações de estado por meio de webhooks em um endpoint que você pode configurar durante o processo de integração. Você também pode obter informações da sessão por meio da API.

O conteúdo desta documentação foi útil?