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

{
  "document_front": {
    "type": "TOKEN_FRONT_DOCUMENT",
    "fileKey": "consumerX/op-123"
  },
  "document_back": {
    "type": "TOKEN_BACK_DOCUMENT",
    "fileKey": "consumerX/op-123"
  },
  "face": {
    "type": "TOKEN_FACE_IMAGE",
    "fileKey": "consumerX/op-123"
  }
}

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

{
  "transactionId": "1c7d...e9",
  "status": "PROCESSED",
  "timestamp": "2026-06-26T12:00:00.000Z"
}

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.