DAF (Document Anti-Fraud)

DAF (Document Anti-Fraud) é um serviço que analisa o Documento de identidade (e, opcionalmente, uma selfie) e determina se são autênticos e consistentes entre si. O serviço se integra como parte do ecossistema de APIs da Facephi.

A partir do documento (e, se for fornecida, da selfie), DAF executa um conjunto de validações antifraude e retorna um diagnóstico único:

• APROVADO: o documento (e, no seu caso, a correspondência com a selfie) supera as validações.

• RECUSADO: é detectada uma inconsistência, manipulação ou não conformidade de qualidade/formato que impede a validação do documento.

Natureza assíncrona

DAF é um serviço assíncrono: a chamada que inicia a validação não bloqueia enquanto aguarda o resultado. Responde imediatamente com um identificador de transação (transactionId) e o consumidor obtém o resultado por meio de consultas de estado (polling).

Fluxo de Integração

A integração típica segue estas etapas:

1. Obter um Token do consumidor válido para autenticar todas as chamadas.

2. Fazer upload dos arquivos do documento (e, opcionalmente, da selfie) para o serviço de armazenamento, obtendo uma fileKey para cada um.

3. Iniciar a validação no DAF enviando as fileKeys obtidas. O DAF responde imediatamente com um transactionId.

4. Consultar o estado da transação por polling até obter um estado terminal.

Resumo dos endpoints

Endpoint	Método	Descrição
/consumer/token	POST	Emite o Token JWT do consumidor (validade de 1 h). Requer os cabeçalhos platform-id e platform-api-key.
/storage	POST	Faz upload de um arquivo (documento ou selfie) e retorna sua fileKey.
/v2/daf/validate	POST	Inicia uma validação DAF. Responde 202 com transactionId.
/v2/daf/{transactionId}	GET	Consulta o estado/resultado de uma transação (polling).