For the complete documentation index, see llms.txt. This page is also available as Markdown.

Iniciar validação

Inicia uma validação DAF enviando as fileKeys dos assets previamente enviados ao armazenamento. A DAF responde imediatamente com um transactionId. O resultado é obtido por meio de polling.

O diagnóstico final (APROVADO / RECUSADO), o motivo de rejeição (rejectionReason) e os sinais de verificação individuais (diagnostics[]) são detalhados na resposta de resultado, que inclui o catálogo completo de códigos de motivo (geral e granular).

Endpoint

POST /v2/daf/validate

Cabeçalhos

Nome
Tipo
Obrigatório
Descrição

Authorization

string

Sim

Token do consumer no formato Bearer <token> (ver Autenticação).

consumer-id

string

Sim

Identificador do consumer.

operation-id

string

Sim

Identificador da operação/sessão de negócio.

Corpo da solicitação

Content-Type: application/json

Cada asset é referenciado por uma chave de função fixa (document_front, document_back, face), junto com seu type de storage e seu fileKey:

Parâmetros

Parâmetro
Tipo
Obrigatório
Descrição

document_front

object

Sim

Asset da frente do documento.

document_front.type

string

Sim

Deve ser TOKEN_FRONT_DOCUMENT.

document_front.fileKey

string

Sim

fileKey retornada por POST /storage.

document_back

object

Não

Asset do verso do documento.

document_back.type

string

Não

Deve ser TOKEN_BACK_DOCUMENT.

document_back.fileKey

string

Não

fileKey retornada por POST /storage.

face

object

Não

Asset da selfie do titular.

face.type

string

Não

Deve ser TOKEN_FACE_IMAGE.

face.fileKey

string

Não

fileKey retornada por POST /storage.

Exemplo de solicitação

Validações de entrada

  • document_front é obrigatório, com type = TOKEN_FRONT_DOCUMENT e uma fileKey resolúvel.

  • Se forem incluídos document_back ou face, seu type deve coincidir exatamente com o esperado.

  • consumer-id e operation-id não podem estar vazios.

  • Se a solicitação for inválida (bad request), ela é rejeitada com um erro 4xx e a transação não é criada. Outras falhas ao iniciar o processamento criam a transação com status = ERROR.

Respostas

202 Accepted

Parâmetros de resposta

Parâmetro
Tipo
Descrição

transactionId

string

Identificador único da transação DAF.

status

string

PROCESSED (aceita corretamente) ou ERROR (não foi possível iniciar).

timestamp

string

Marca de tempo de criação da transação no formato ISO 8601.

Exemplo de resposta

400 Requisição inválida

A solicitação não passa pelas validações de entrada (asset obrigatório ausente, type não coincidente, cabeçalho vazio). A transação não é criada.

Atualizado