Productos · Identitas

Crear una verificación

Inicia una verificación de identidad y recibe un enlace de consentimiento. La constancia firmada llega por webhook cuando se completa.

POST /v1/identitas/verifications

Requiere una clave secreta del bufete. Nunca la expongas en el navegador.

Cuerpo de la solicitud

Campo	Tipo	Descripción
`level` requerido	string	Nivel KYC: L0 (correo) a L3 (ampliada + sanciones).
`matter_id` opcional	string	Expediente al que se asocia la constancia.
`redirect_url` opcional	string	A dónde vuelve la persona al terminar.
`link_ttl_hours` opcional	integer	Vigencia del enlace, en horas. Máximo 72.

Ejemplo · solicitud

request

curl https://api.novalex.io/v1/identitas/verifications \
  -H "Authorization: Bearer sk_live_••••••" \
  -H "Idempotency-Key: 7c4e21b1" \
  -d level="L2" \
  -d matter_id="NX-2419" \
  -d redirect_url="https://app.bufete.mx/listo" \
  -d link_ttl_hours=24

Respuesta · 201 Creada

response

{
  "id": "vrf_8841",
  "status": "pending",
  "level": "L2",
  "matter_id": "NX-2419",
  "consent_url": "https://novalex.io/c/8f2a…",
  "expires_at": "2026-05-23T14:42:00Z"
}

El webhook al completarse

Cuando la persona termina, NovaLex hace POST a tu endpoint con la constancia firmada — nunca con el documento crudo.

webhook

{
  "event": "verification.completed",
  "id": "vrf_8841",
  "result": "passed",
  "assertion": {
    "country": "MX",
    "level": "L2",
    "signed_at": "2026-05-22T15:10:00Z",
    "signature": "5cL39pZv…M7gM1q"
  }
}