O que cada status de sessão significa

Uma sessão de verificação passa por status como Not Started, In Progress, In Review, Approved e Declined - veja o que cada um significa, o que fazer a respeito, e por que até uma sessão já decidida pode mudar de novo.

Short answer

Existem dez status. Approved, Declined e Kyc Expired significam que uma decisão foi tomada - mas nenhum deles é permanentemente imutável: um revisor pode reabrir uma decisão, e o monitoramento contínuo de AML pode mover uma sessão aprovada mais tarde. In Review é o único status que precisa de uma pessoa. Continue tratando atualizações mesmo depois que uma sessão for decidida.

Toda sessão de verificação tem um status que te diz onde ela está no processo. Veja o que cada um significa em linguagem simples, e se ele precisa de alguma ação sua.

#Onde encontrar o status de uma sessão

No Business Console, acesse Verifications na barra lateral e abra a sessão que você quer checar. O status aparece no topo, junto com os resultados de cada verificação que rodou.

Uma página de detalhe de sessão no console da Didit mostrando o status geral e o resultado de cada verificação
  1. Overview traz o status atual da sessão e o motivo por trás dele.
  2. Cada verificação tem sua própria aba, com seu próprio resultado.
  3. Events é a linha do tempo: todos os status pelos quais essa sessão já passou, com data e hora.
O status de uma sessão fica acima dos resultados por verificação que o produziram.

#Os status, explicados

StatusO que significaPrecisa de ação?
Not StartedCriada, mas o link ainda não foi aberto.Não - espere, ou envie um lembrete.
In ProgressA pessoa está ativamente passando pelas verificações.Não - se resolve sozinho.
ApprovedTodas as verificações passaram - identidade verificada.Não.
DeclinedUma ou mais verificações falharam. Veja por que uma verificação foi reprovada.Só se você quiser solicitar um reenvio.
In ReviewSinalizada para uma decisão humana - pontuação baixa, divergência de dados, ocorrência de AML.Sim - aprove, reprove, ou solicite um reenvio.
ResubmittedUm revisor pediu que etapas específicas fossem refeitas; reavalia assim que estiverem prontas.Não.
Awaiting UserSó em KYB - esperando as pessoas vinculadas terminarem a própria verificação.Não.
ExpiredO link expirou antes de ser aberto.Sim - crie uma sessão nova.
AbandonedAberta, mas não terminada a tempo.Opcional - envie um lembrete ou crie uma sessão nova.
Kyc ExpiredUma sessão previamente aprovada passou do período de reverificação.Sim - peça para a pessoa se verificar de novo.

#Quais deles já foram decididos

CategoriaStatusSignificado
DecididaApproved, Declined, Kyc ExpiredExiste um veredito. Não necessariamente permanente - veja abaixo.
Ainda ativaNot Started, In Progress, Resubmitted, Awaiting UserEsperando o usuário, sessões filhas, ou processamento.
Precisa de vocêIn ReviewExige uma decisão do seu time.
Terminou sem decisãoExpired, AbandonedA pessoa nunca completou.
Important

Uma sessão decidida ainda pode mudar. Não pare de processar atualizações para uma sessão assim que ela chegar a Approved ou Declined:

  • Declined pode virar Resubmitted quando um revisor pede para a pessoa refazer uma etapa, e depois Approved.
  • Approved pode virar In Review ou Declined mais tarde, quando o monitoramento contínuo de AML encontra uma nova ocorrência que ultrapassa o seu limiar.
  • Approved pode virar Kyc Expired se você definiu uma política de expiração.

Os únicos status que genuinamente nunca mudam de novo são Expired e Abandoned - a pessoa nunca completou o fluxo, então não há nada para revisitar. Todo o resto é um estado para o qual a sua integração deve continuar disposta a receber uma atualização.

#Como uma sessão se move entre eles

  • Not Started → In Progress (a pessoa abre o link), ou → Expired (ela nunca abre).
  • In Progress → Approved, Declined, In Review, ou Abandoned. Em KYB também pode ir para Awaiting User assim que a etapa de pessoas-chave é enviada.
  • In Review → Approved, Declined, ou Resubmitted, sempre por ação de um revisor.
  • Declined → Resubmitted, se um revisor pedir outra tentativa.
  • Resubmitted → Approved, Declined, ou In Review, assim que a pessoa refizer as etapas.
  • Awaiting User → Approved, Declined, ou In Review, assim que cada parte necessária for decidida.
  • Approved → Kyc Expired, se uma política de expiração de KYC se aplicar.
Note

Pela API ou por um webhook, os status são strings exatas, sensíveis a maiúsculas/minúsculas, com espaços - por exemplo "In Review", e não "in_review" ou "IN_REVIEW". Use igualdade estrita ao compará-los. Uma peculiaridade a observar: o status de expiração é "Kyc Expired", com um único K maiúsculo, não "KYC Expired". Referência completa: status de verificação.

#Status que parecem problemas, mas não são

  • In Progress que não está avançando. A pessoa simplesmente ainda não terminou. Não existe forma de adiantar uma sessão; ela atualiza quando a pessoa completa as etapas restantes.
  • Awaiting User em uma sessão de KYB. Esperado. A empresa enviou a lista de pessoas dela, e a sessão pai está esperando por cada uma delas. Acompanhe as sessões filhas, não a sessão pai.
  • Resubmitted voltando para Awaiting User. Em KYB, se uma sessão filha é reenviada, a sessão pai volta para Awaiting User até que ela seja concluída.

#Mapeando isso para os seus próprios estados

Se você guarda um status próprio, dois mapeamentos valem a pena acertar:

  • Abandoned e Awaiting User não são reenvios. Resubmitted significa especificamente que um revisor pediu para refazer etapas; Abandoned significa que a pessoa foi embora; Awaiting User significa que outras partes ainda estão se verificando.
  • Expired e Kyc Expired são diferentes. Expired significa que o link nunca foi aberto. Kyc Expired significa que uma verificação aprovada envelheceu além da sua política - então a pessoa foi verificada uma vez, e agora precisa ser de novo.

#Próximos passos