Documentación

API de verificación de X·Check

Verifica la identidad y los antecedentes de una persona desde tu sistema. X·Check toma la identificación, la selfie con prueba de vida y el consentimiento en su propia liga; tú recibes el resultado.

Cómo funciona
  1. Creas una verificación con el nivel, el nombre de la persona y tu referencia.
  2. Recibes una liga. Se la das a la persona, o le pides a X·Check que se la mande por correo o WhatsApp.
  3. La persona acepta el aviso y entrega su INE y una selfie con prueba de vida en su celular. Tu sistema nunca toma esas fotos.
  4. X·Check corre las revisiones del nivel y te avisa por webhook cuando está listo.
  5. Consultas el resultado y descargas el reporte en PDF.
Cuenta y llaves

Pide el acceso desde tu cuenta, en Background Checker → API, aceptando los usos permitidos: el resultado no se usa para discriminar y la decisión siempre la toma una persona. Las llaves de prueba funcionan de inmediato y no cobran; las llaves reales se activan cuando revisamos tu cuenta.

Cada solicitud lleva tu llave en el encabezado:

Authorization: Bearer xc_live_…
Crear una verificación
curl -X POST https://nucleo.ia-automatizaciones.com/api/v1/verificaciones \
  -H "Authorization: Bearer xc_test_…" -H "Content-Type: application/json" \
  -d '{"nivel": "intermedio", "nombre": "Daniel", "apellidos": "Soto Ruiz",
       "correo": "daniel@ejemplo.com", "whatsapp": "5512345678",
       "referencia": "candidato-123", "enviar": true}'
CampoQué es
nivelbasico (identidad), intermedio (más antecedentes y referencias laborales), profundo (más documentos, fuentes legales y expedientes judiciales del estado donde nació y donde vive) o nacional (lo del profundo, con expedientes judiciales de todo el país). Dónde se buscan los expedientes
nombre, apellidosNombre de la persona
correo, whatsappA dónde mandarle la liga si pides enviar
referenciaTu propio identificador; puedes buscar por él
enviartrue para que X·Check le mande la liga; si no, tú se la das
Consultar el resultado
GET https://nucleo.ia-automatizaciones.com/api/v1/verificaciones/ver_…
GET https://nucleo.ia-automatizaciones.com/api/v1/verificaciones?referencia=candidato-123
GET https://nucleo.ia-automatizaciones.com/api/v1/verificaciones/ver_…/reporte.pdf
estadopendiente, en_proceso, listo, no_acepto o vencido
identidadSi se verificó, con qué identificación y cuándo
nivel_cumplidoEl nivel, la fecha y hasta cuándo está vigente
resultadosin_hallazgos o revisar, con el detalle en hallazgos
hallazgosFuente, qué se encontró, nivel y tipo de coincidencia. Una coincidencia por nombre siempre es «posible coincidencia»: puede ser otra persona con el mismo nombre

Un resultado ayuda a decidir; no es un dictamen ni una condena. La decisión la toma una persona de tu equipo.

Webhooks

Registra la dirección de tu webhook en Background Checker → API. Te avisamos con verificacion.lista, verificacion.vencida y verificacion.no_acepto. Cada aviso trae la verificación completa y se firma:

X-XCheck-Signature: t=1730000000,v1=<HMAC-SHA256 de "t.cuerpo" con tu secreto>

Responde con un código 2xx. Si no, reintentamos a los 1, 5, 30 y 120 minutos, a las 12 horas y al día siguiente.

Pruebas

Con una llave de prueba, la verificación se crea sin mandar nada ni cobrar. Simula el resultado que quieras y recibe su webhook:

curl -X POST https://nucleo.ia-automatizaciones.com/api/v1/verificaciones/ver_…/simular \
  -H "Authorization: Bearer xc_test_…" -d '{"resultado": "revisar"}'

Resultados: sin_hallazgos, revisar, no_acepto y vencido.

Precio y límites

El precio de cada nivel te lo damos al cotizar (escríbenos a contacto@xcheck.com.mx) y lo ves siempre en tu cuenta, en Background Checker → API.

Pagas con créditos que recargas por adelantado. Solo se cobra la verificación completada: si la persona no acepta o no termina, no se cobra. Cada llave admite 60 solicitudes por minuto; si pasas el límite, responde 429.

Errores
{"error": {"codigo": "saldo", "mensaje": "No tienes saldo…"}}

401 llave inválida · 402 sin saldo · 403 cuenta en revisión o suspendida · 404 no existe · 409 todavía no está lista · 429 demasiadas solicitudes.