Saltar al contenido principal
Obtener procesoGET

Recupere un proceso existente por su identificador. Según el contrato de la API, el resultado ya se devuelve de forma sincrónica al crear el proceso — utilice este endpoint para reconsultas, auditoría y soporte.

MarkdownChatGPTClaude
advertencia

Antes de recuperar el proceso, revise la configuración de nuestro webhook y las estrategias de fallback — haga clic aquí.

Endpoint​

EntornoURL
ProducciónGET https://api.id.unico.app/processes/v1/{processId}
SandboxGET https://api.id.uat.unico.app/processes/v1/{processId}

Solicitud​

Encabezados
EncabezadoValor
AuthorizationBearer <access_token>
APIKEYClave API provisionada.
Parámetros de ruta
ParámetroTipoRequeridoDescripción
processIdstring (UUID)síIdentificador del proceso devuelto por Crear proceso.

Ejemplo​

curl -X GET https://api.id.unico.app/processes/v1/$PROCESS_ID \
  -H "Authorization: Bearer $TOKEN" \
  -H "APIKEY: $API_KEY"

Respuestas​

200 OK

El contrato es único — el campo idCloud.result contiene el veredicto consolidado de las capacidades utilizadas.

Unico consolida los resultados de las capacidades ejecutadas en un único idCloud.result, listo para decidir el siguiente paso de su flujo — sin necesidad de orquestar resultados individuales.

{
  "id": "80371b2a-3ac7-432e-866d-57fe37896ac6",
  "status": 3,
  "idCloud": {
    "result": "approved"
  }
}
CampoTipoDescripción
idstring (UUID)Identificador del proceso.
statusinteger1 (procesando), 2 (divergencia), 3 (finalizado con éxito), 4 (cancelado), 5 (error).
Valores de resultado posibles
idCloud.resultSignificadoAcción recomendada
approvedPersona real e identidad validada.Continuar con el flujo.
deniedIdentidad no validada, falló la verificación de vida o se identificó un riesgo extremo.Finalizar el flujo o redirigir a un flujo alternativo.
critical-riskSe identificó un nivel de riesgo crítico.Finalizar el flujo o enviar a revisión manual.
high-riskSe identificó un nivel de riesgo alto.Enviar a revisión manual o a un flujo alternativo.
retryCaptura o score insuficiente para evaluar.Solicitar al usuario una nueva captura.
inconclusiveEvidencia insuficiente para un veredicto.Enviar a revisión manual o a un flujo alternativo.

Los valores devueltos dependen de la receta configurada en su APIKey. Consulte Flujos para conocer los valores de resultado que puede devolver cada receta.

BrazilLos clientes en Brasil pueden recibir la respuesta por capacidad

La estructura general de la respuesta se mantiene igual — el resultado único es el valor predeterminado.

Las integraciones en Brasil pueden recibir los resultados abiertos por capacidad. Cada capacidad habilitada en la APIKey agrega su propio bloque a la respuesta — los campos de las capacidades deshabilitadas se omiten.

{
  "id": "80371b2a-3ac7-432e-866d-57fe37896ac6",
  "status": 3,
  "unicoId": {
    "result": "yes"
  },
  "riskLevel": {
    "result": "inconclusive"
  },
  "idFace": {
    "personId": "a1b2c3d4e5f67890a1b2c3d4e5f67890a1b2c3d4e5f67890a1b2c3d4e5f67890",
    "result": "FOUND"
  },
  "identityFraudsters": {
    "result": "inconclusive"
  },
  "government": {
    "serpro": 87
  },
  "liveness": 1,
  "idAge": {
    "result": "yes"
  },
  "cardholderVerification": {
    "result": "approved"
  }
}
CampoTipoDescripción
unicoId.resultstringyes, no, inconclusive — consulte Verificación de Identidad.
riskLevel.resultstringnot_approved, critical_risk, high_risk, inconclusive — consulte Clasificación de Riesgo de Fraude.
idFace.resultstringFOUND — consulte Identificador Facial.
idFace.personIdstringIdentificador opaco estable para el rostro, devuelto junto con idFace.result = FOUND. Cuando no se puede identificar ningún rostro en la imagen, el proceso devuelve el error 20532 en lugar de un bloque idFace.
identityFraudsters.resultstringObsoleto. Utilice riskLevel en su lugar. Los clientes con integraciones en curso pueden seguir utilizándolo mientras coordinan la migración con el equipo de su proyecto.
government.serprointegerPuntuación de similitud Serpro (0–100, -1, -2). Disponible solo en Brasil. Consulte Retorno de Similitud Serpro.
livenessinteger1 (aprobado), 2 (fallido) — consulte Detección de Vida.
idAge.resultstringyes, no, inconclusive — consulte Verificación de Edad. Disponible solo en Brasil.
scoreintegerPuntuación de riesgo probabilística. Presente cuando unicoId.result = inconclusive y la orquestación del score de riesgo está activa. Los valores positivos indican mayor probabilidad de ser el titular; los valores negativos indican mayor riesgo. Disponible solo en Brasil.
cardholderVerification.resultstringapproved, unsure — consulte Cardholder Verification. Ausente mientras status aún no sea 3 (finalizado). Disponible solo en Brasil.
MexicoLos clientes en México pueden recibir el bloque de Verificación RENAPO

La respuesta mantiene la misma estructura y agrega el bloque idGov.

Las integraciones en México con Verificación RENAPO habilitada reciben un bloque adicional idGov con el registro que RENAPO tiene para la CURP del usuario. Es una respuesta independiente del resultado de identidad.

{
  "id": "11111111-2222-3333-4444-555555555555",
  "status": 3,
  "idCloud": { "result": "approved" },
  "idGov": {
    "government_valid": true,
    "curp": "PUEA880304MDFRJN04",
    "government_name": "ANA PRUEBA EJEMPLO",
    "date_of_birth": "1988-03-04",
    "age": 38,
    "gender": "F",
    "deceased": false,
    "is_mexican": true,
    "citizenship": "MEXICO",
    "state_of_birth": "Ciudad de México",
    "state_iso": "MX-CMX",
    "issuing_entity_code": "DF",
    "municipality_registration": ""
  }
}
CampoTipoDescripción
idGovobjectRegistro de RENAPO para la CURP. Ausente cuando la capacidad no está habilitada. {} cuando RENAPO no respondió. Solo México. Consulte Verificación RENAPO.

Cuándo usar este endpoint​

El contrato de la API devuelve los resultados de forma sincrónica, por lo que la mayoría de las integraciones no necesitan este endpoint. Utilícelo cuando:

  • Solo persistió el processId y necesita recuperar el resultado completo más adelante (auditoría, soporte).
  • Sospecha que la respuesta original se perdió en tránsito (error de red después de que la plataforma completó el trabajo).
  • Está creando una herramienta de back-office que revisa procesos históricos.

Códigos de error​

CódigoMensajeDescripción
20023O parâmetro processId não foi informado.Falta el parámetro de ID del proceso.
20002O parâmetro APIKey não foi informado.Falta el parámetro APIKEY en el encabezado de la solicitud.
20001O parâmetro authtoken não foi informado.Falta el parámetro del token de integración en el encabezado de la solicitud.

Flujos​

Una receta es la combinación de capacidades (detección de vida, verificación de identidad, señales de riesgo, documentos...) configurada en la APIKey de su proyecto. Define lo que Unico ejecuta en cada proceso y cómo los resultados se consolidan en el único result — no necesita orquestar nada de su lado.

Unico mantiene un catálogo de recetas preestablecidas, nombradas y versionadas (por ejemplo, byunico-idlive-idunico-oneresponse-std). Algunas son exclusivas de Brasil, como las que incluyen Score, Serpro o verificación de edad.

¿Qué capacidades ejecuta su proceso?

La combinación de capacidades — el flujo de su proyecto — se define en la configuración de su APIKey. Consulte las recetas preestablecidas o hable con su contacto de proyecto de Unico para personalizarla.

Última actualización el