AucoFace

For each document state, a request is generated with the following body, varying in the description of the status.

You have 10 seconds to respond

Auco closes the connection if your endpoint does not respond within 10 seconds. Both a timeout and a 4xx or 5xx response are retried up to 3 times before the notification is discarded. Return 200 immediately, process in the background, and make your handler idempotent. See Response Time and Retries.

---

Notified States

Name	Description
APPROVED	This status is notified when the process has been successfully validated.
BLOCKED	This status is notified when the process could not be automatically validated and is in a blocked state.
VALIDATED	This status is notified when a process is manually validated.
INVALIDATED	This status is notified when a process is manually rejected.

---

🧪 Notification Examples

tip

You can copy any of the examples according to your preferred language.

Response Parameters

Name	Type	Description
code	String	Document code.
type	String	Type of notified process veriface.
finish	Boolean	Returns whether the process is in a finished state.
status	String	Current status of the process (e.g., APPROVED, BLOCKED, VALIDATED, INVALIDATED).
message	String	Text content associated with the process status. If the status is BLOCKED, contains the error reason for blocking.
data	Object	Object with the OCR extracted from the document submitted by the participant.

Process Completion

JSON

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

Process Block

JSON

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

Manually Validated Process

JSON

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

Manually Rejected Process

JSON

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