AucoFace

Para cada estado do documento, é gerada uma requisição com o corpo a seguir, variando a descrição do status.

Você tem 10 segundos para responder

A Auco encerra a conexão se o seu endpoint não responder em até 10 segundos. Tanto um timeout quanto uma resposta 4xx ou 5xx são retentados até 3 vezes antes de a notificação ser descartada. Retorne 200 imediatamente, processe em segundo plano e torne o seu handler idempotente. Veja Tempo de resposta e novas tentativas.

---

Estados notificados

Nome	Descrição
APPROVED	Este status é notificado quando o processo foi validado com sucesso.
BLOCKED	Este status é notificado quando o processo não pôde ser validado automaticamente e está em estado bloqueado.
VALIDATED	Este status é notificado quando um processo é validado manualmente.
INVALIDATED	Este status é notificado quando um processo é rejeitado manualmente.

---

🧪 Exemplos de notificações

dica

Você pode copiar qualquer um dos exemplos de acordo com a sua linguagem preferida.

Parâmetros da resposta

Nome	Tipo	Descrição
code	String	Código do documento.
type	String	Tipo de processo notificado veriface.
finish	Boolean	Indica se o processo está em estado finalizado.
status	String	Status atual do processo (por exemplo, APPROVED, BLOCKED, VALIDATED, INVALIDATED).
message	String	Texto associado ao status do processo. Se o status for BLOCKED, contém o motivo de erro do bloqueio.
data	Object	Objeto com o OCR extraído do documento enviado pelo participante.
signals	Array	Sinais da proteção de identidade ([{ code, severity }]) da última tentativa, quando ela passou pela proteção. Veja Sinais da proteção de identidade.

Conclusão do processo

JSON

{
  "code": "XXXXXCODE",
  "type": "veriface",
  "status": "APPROVED",
  "finish": true,
  "data": {
      "name": "JUAN PEREZ GONZALEZ",
      "documentName": "DNI 12345678"
  },
  "similarity": 0.92,
  "signals": [{ "code": "ALERT_PHONE_CHANGED", "severity": "INFO" }]
}

Bloqueio do processo

JSON

{
  "code": "XXXXXCODE",
  "type": "veriface",
  "finish": true,
  "status": "BLOCKED",
  "message": "ERROR_IDENTIFICATION_NOT_DOCUMENT",
  "data": {
      "name": null,
      "documentName": ""
  }
}

Bloqueado pela proteção de identidade

JSON

{
  "code": "XXXXXCODE",
  "type": "veriface",
  "finish": true,
  "status": "BLOCKED",
  "message": "IDENTITY_GUARD_BLOCKED",
  "data": {
      "name": "JUAN PEREZ GONZALEZ",
      "documentName": "DNI 12345678"
  },
  "signals": [{ "code": "ALERT_FACE", "severity": "ALERT" }]
}

Processo validado manualmente

JSON

{
  "code": "XXXXXCODE",
  "type": "veriface",
  "finish": true,
  "status": "VALIDATED",
  "data": {
    "name": "JUAN PEREZ GONZALEZ",
    "documentName": "DNI 12345678"
  }
}

Processo rejeitado manualmente

JSON

{
  "code": "XXXXXCODE",
  "type": "veriface",
  "finish": true,
  "status": "INVALIDATED",
  "data": {
      "name": null,
      "documentName": ""
  }
}