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.
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_…
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}'
| Campo | Qué es |
|---|---|
nivel | basico (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, apellidos | Nombre de la persona |
correo, whatsapp | A dónde mandarle la liga si pides enviar |
referencia | Tu propio identificador; puedes buscar por él |
enviar | true para que X·Check le mande la liga; si no, tú se la das |
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
estado | pendiente, en_proceso, listo, no_acepto o vencido |
identidad | Si se verificó, con qué identificación y cuándo |
nivel_cumplido | El nivel, la fecha y hasta cuándo está vigente |
resultado | sin_hallazgos o revisar, con el detalle en hallazgos |
hallazgos | Fuente, 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.
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.
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.
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.
{"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.