O que significa cada estado de sessão
Uma sessão de verificação passa por estados como Não Iniciada, Em Curso, Em Revisão, Aprovada e Recusada - aqui está o que cada um significa, o que fazer em relação a ele, e porque mesmo uma sessão decidida pode voltar a mudar.
Existem dez estados. Aprovada, Recusada e KYC Caducado significam que uma decisão foi alcançada - mas nenhum deles é permanentemente imutável: um revisor pode reabrir uma decisão, e a monitorização AML contínua pode mover uma sessão aprovada mais tarde. Em Revisão é o único estado que precisa de uma pessoa. Continua a processar atualizações depois de uma sessão ser decidida.
Cada sessão de verificação tem um estado que te diz onde está no processo. Aqui está o que cada um significa em linguagem simples, e se precisa de algo da tua parte.
#Onde encontrar o estado de uma sessão
Na Consola de Negócio, vai a Verificações na barra lateral e abre a sessão que queres consultar. O estado aparece no topo, junto com os resultados de cada comprovação que correu.

- Overview traz o estado atual da sessão e o motivo por trás dele.
- Cada comprovação tem o seu próprio separador, com o seu próprio resultado.
- Events é a linha do tempo: cada estado por que esta sessão passou, com marcas temporais.
#Os estados, explicados
| Estado | O que significa | Precisa de ação? |
|---|---|---|
| Não Iniciada | Criada, mas o link ainda não foi aberto. | Não - espera, ou envia um lembrete. |
| Em Curso | A pessoa está a fazer as comprovações ativamente. | Não - resolve-se sozinha. |
| Aprovada | Todas as comprovações passaram - identidade verificada. | Não. |
| Recusada | Uma ou mais comprovações falharam. Consulta porque uma verificação foi recusada. | Só se quiseres pedir um reenvio. |
| Em Revisão | Assinalada para uma decisão humana - pontuação baixa, discrepância de dados, ocorrência de AML. | Sim - aprova, recusa, ou pede um reenvio. |
| Reenviada | Um revisor pediu que passos específicos fossem refeitos; reavalia-se assim que estiver feito. | Não. |
| A Aguardar Utilizador | Só em KYB - à espera que as pessoas ligadas terminem a sua própria verificação. | Não. |
| Caducada | O link expirou antes de ser aberto. | Sim - cria uma nova sessão. |
| Abandonada | Aberta mas não terminada a tempo. | Opcional - lembra, ou cria uma nova sessão. |
| KYC Caducado | Uma sessão anteriormente aprovada ultrapassou o seu período de revalidação. | Sim - pede-lhes para se verificarem outra vez. |
#Quais estão decididos
| Categoria | Estados | Significado |
|---|---|---|
| Decidida | Aprovada, Recusada, KYC Caducado | Existe um veredito. Não necessariamente permanente - ver abaixo. |
| Ainda ativa | Não Iniciada, Em Curso, Reenviada, A Aguardar Utilizador | À espera do utilizador, de sessões filhas, ou de processamento. |
| Precisa de ti | Em Revisão | Exige uma decisão da tua equipa. |
| Terminada sem decisão | Caducada, Abandonada | A pessoa nunca a completou. |
Uma sessão decidida ainda pode mudar. Não deixes de processar atualizações de uma sessão assim que ela chega a Aprovada ou Recusada:
- Recusada pode passar a Reenviada quando um revisor pede à pessoa para refazer um passo, e depois a Aprovada.
- Aprovada pode passar a Em Revisão ou Recusada mais tarde, quando a monitorização AML contínua encontra uma nova ocorrência que ultrapassa o teu limiar.
- Aprovada pode passar a KYC Caducado se tiveres definido uma política de caducidade.
Os únicos estados que genuinamente nunca voltam a mudar são Caducada e Abandonada - a pessoa nunca completou o fluxo, por isso não há nada para rever. Tudo o resto é um estado para o qual a tua integração deve continuar disposta a receber uma atualização.
#Como uma sessão se move entre eles
- Não Iniciada → Em Curso (abrem o link), ou → Caducada (nunca o fazem).
- Em Curso → Aprovada, Recusada, Em Revisão, ou Abandonada. Em KYB também pode passar a A Aguardar Utilizador assim que o passo das pessoas-chave é submetido.
- Em Revisão → Aprovada, Recusada, ou Reenviada, sempre pela ação de um revisor.
- Recusada → Reenviada, se um revisor pedir outra tentativa.
- Reenviada → Aprovada, Recusada, ou Em Revisão, assim que a pessoa refizer os passos.
- A Aguardar Utilizador → Aprovada, Recusada, ou Em Revisão, assim que cada parte exigida estiver decidida.
- Aprovada → KYC Caducado, se se aplicar uma política de caducidade de KYC.
Via API ou webhook, os estados são strings exatas, sensíveis a
maiúsculas/minúsculas, com espaços - por exemplo "In Review", não
"in_review" nem "IN_REVIEW". Usa igualdade estrita ao compará-los. Uma
particularidade a vigiar: o estado de caducidade é "Kyc Expired" com um
único K maiúsculo, não "KYC Expired". Referência completa:
estados de verificação.
#Estados que parecem problemas mas não são
- Em Curso que não avança. A pessoa simplesmente ainda não terminou. Não há forma de adiantar uma sessão; atualiza-se quando completam os passos restantes.
- A Aguardar Utilizador numa sessão KYB. Esperado. A empresa submeteu a sua lista de pessoas e a sessão-mãe está à espera de cada uma delas. Vigia as sessões filhas, não a sessão-mãe.
- Reenviada a voltar a A Aguardar Utilizador. Em KYB, se uma sessão filha for reenviada, a sessão-mãe volta a A Aguardar Utilizador até se completar.
#Mapear isto para os teus próprios estados
Se guardas um estado teu, há dois mapeamentos que vale a pena acertar:
- Abandonada e A Aguardar Utilizador não são reenvios. Reenviada significa especificamente que um revisor pediu que passos fossem refeitos; Abandonada significa que a pessoa desistiu; A Aguardar Utilizador significa que outras partes ainda estão a verificar-se.
- Caducada e KYC Caducado são diferentes. Caducada significa que o link nunca foi aberto. KYC Caducado significa que uma verificação aprovada ultrapassou a tua política de antiguidade, portanto a pessoa verificou-se uma vez e agora precisa de o fazer outra vez.
#Próximos passos
- Em Revisão: consulta sessões presas em revisão e como reduzi-las.
- Em Revisão ou Recusada: consulta deixar alguém tentar a verificação outra vez.
- Recusada: consulta porque uma verificação foi recusada.
- Recebe os estados enviados automaticamente para o teu backend: consulta obter resultados de verificação com webhooks.
