Skip to main content
Toda verificação tem um status. O conjunto é fechado, com cinco valores: O mesmo valor aparece na verificação e no evento de webhook que ela dispara.

Por que expirado não é um status

Uma verificação que passou do prazo não muda de status — ela continua com o último valor que tinha, e a expiração é lida pelo campo expires_at, não por um sexto valor de status. Tratar expiração como status exigiria um job reescrevendo linhas depois do fato, e essa reescrita perderia a hora em que o desfecho de verdade aconteceu. Se você precisa saber se uma verificação expirou, compare expires_at com o horário atual; não espere um status chamado expired.

A fila de revisão manual

Quando status é review, o caso segue sub-estados próprios, também fechados: A decisão de um caso decided é approved ou reproved — os mesmos dois valores que fecham o status da verificação quando ela sai da revisão.

Quando o desfecho aconteceu

O campo decided_at guarda o horário exato em que a verificação chegou a approved ou reproved. Ele só é preenchido nesses dois casos — não use updated_at como aproximação: esse campo muda a cada atualização da linha, não só no desfecho, e degrada como medida de tempo de conclusão.

Webhooks

Receba estes valores automaticamente, sem precisar consultar a API.