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.
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.

- Overview traz o status atual da sessão e o motivo por trás dele.
- Cada verificação tem sua própria aba, com seu próprio resultado.
- Events é a linha do tempo: todos os status pelos quais essa sessão já passou, com data e hora.
#Os status, explicados
| Status | O que significa | Precisa de ação? |
|---|---|---|
| Not Started | Criada, mas o link ainda não foi aberto. | Não - espere, ou envie um lembrete. |
| In Progress | A pessoa está ativamente passando pelas verificações. | Não - se resolve sozinho. |
| Approved | Todas as verificações passaram - identidade verificada. | Não. |
| Declined | Uma ou mais verificações falharam. Veja por que uma verificação foi reprovada. | Só se você quiser solicitar um reenvio. |
| In Review | Sinalizada para uma decisão humana - pontuação baixa, divergência de dados, ocorrência de AML. | Sim - aprove, reprove, ou solicite um reenvio. |
| Resubmitted | Um revisor pediu que etapas específicas fossem refeitas; reavalia assim que estiverem prontas. | Não. |
| Awaiting User | Só em KYB - esperando as pessoas vinculadas terminarem a própria verificação. | Não. |
| Expired | O link expirou antes de ser aberto. | Sim - crie uma sessão nova. |
| Abandoned | Aberta, mas não terminada a tempo. | Opcional - envie um lembrete ou crie uma sessão nova. |
| Kyc Expired | Uma 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
| Categoria | Status | Significado |
|---|---|---|
| Decidida | Approved, Declined, Kyc Expired | Existe um veredito. Não necessariamente permanente - veja abaixo. |
| Ainda ativa | Not Started, In Progress, Resubmitted, Awaiting User | Esperando o usuário, sessões filhas, ou processamento. |
| Precisa de você | In Review | Exige uma decisão do seu time. |
| Terminou sem decisão | Expired, Abandoned | A pessoa nunca completou. |
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.
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
- In Review: veja sessões presas em revisão, e como reduzi-las.
- In Review ou Declined: veja deixando alguém tentar uma verificação de novo.
- Declined: veja por que uma verificação foi reprovada.
- Receba os status automaticamente no seu backend: veja obtendo resultados de verificação com webhooks.
