Skip to main content
Toda verificação tem um status. O conjunto é fechado, com seis valores.

Transitórios e decididos

Os seis se dividem em dois grupos, e a divisão importa:

Transitórios

not_opened e started. A jornada ainda pode mudar de rumo.

Decididos

approved, reproved, review e inconclusive. Há uma decisão persistida.
Só os decididos aparecem no corpo de verification.decided. Um evento de desfecho nunca anuncia uma verificação que não terminou.

review não é recusa

review é uma verificação que precisa de gente. Ela pode virar approved ou reproved depois que um analista decide no dashboard, e quando isso acontece, verification.decided dispara de novo. Trate review como pendência, nunca como negativa.

inconclusive é só do fluxo de biometria

inconclusive aparece apenas em fluxo só de biometria, sem envio de documento: a busca biométrica terminou sem confirmar nem descartar a identidade, e não há documento para desempatar. Num fluxo com documento, a busca inconclusiva pede o documento, e a verificação termina em approved, reproved ou review, conforme a regra do fluxo. É um desfecho final, mas um analista pode trocá-lo para approved ou reproved no dashboard. Quando isso acontece, verification.decided dispara de novo. Decida no seu produto o que fazer com ele, como pedir outra forma de comprovação. Não o trate como aprovação.

Expirado não é status

Uma verificação tem expires_at. Passado esse instante, ela não pode mais ser aberta, mas o status dela não muda. Uma verificação expirada sem ter sido aberta continua em not_opened. Para saber se ela ainda vale, compare expires_at com o agora; não procure um valor expired no enum, porque ele não existe.
Verificação expirada
Expiração como filtro por data, e não como status, evita um trabalho periódico que reescreve linhas, e evita que o status de uma verificação mude sozinho enquanto ninguém olha.

Próximo passo

verification.decided

Como o status chega ao seu backend.