Pular para o conteúdo principal

Cabeçalhos

X-IDSAAS-Signature
string
obrigatório

Assinatura HMAC (pode trazer mais de um v1 durante rotação de segredo).

x-idsaas-event
string
obrigatório

Tipo do evento (verification.). Com a cifra da carga ligada no destino, chega verification.event e o tipo fica só dentro do corpo cifrado.

Corpo

application/json

Envelope entregue ao seu endpoint. schema_version só sobe em mudança INCOMPATÍVEL (que também exigiria /v2); adição de campo mantém a versão. Corpo acima de 262144 bytes chega podado e marcado com truncated.

id
string
obrigatório

Id estável do evento (deduplique por ele): evt_<verification_id>_, com sufixo _rN em reemissão manual.

schema_version
integer
obrigatório
event
enum<string>
obrigatório
Opções disponíveis:
verification.completed,
verification.blocked,
verification.failed,
verification.pending,
verification.monitoring,
verification.test,
verification.pix_device_revoked,
verification.subject_erased,
verification.verification_link_claimed
livemode
boolean
obrigatório
created
string<date-time>
obrigatório
data
object
obrigatório

Conteúdo da verificação decidida. Campo novo pode surgir sem subir schema_version (adição compatível): o parser tem que ignorar chave desconhecida. check_details é omitido quando o endpoint está em modo minimal; truncated marca corpo podado acima do teto (a decisão nunca é podada).

Resposta

200

Confirmação de recebimento. Qualquer 2xx conta; processar depois, responder já.