Saltar al contenido

Trust Center

Verifique a sus propios usuarios: documentos de identidad, cotejo facial y comprobaciones de empresa.

Abrir Trust Center
Comprobado con el panel el 18 de noviembre de 2026

Tres métodos hacen desde código lo que hace la ventana Verificar a alguien: abrir una sesión, leer una sesión y listar sesiones. Cada uno actúa sobre el Trust Center de la cuenta cuya clave de API usas.

Abre una sesión

Llama a verify_session_create. Envía level (de 1 a 4, por defecto 2) y, si quieres, tu propio external_ref (200 caracteres como máximo). La respuesta incluye un session_id, una hosted_url para enviar a la persona y expires_at, que es 24 horas después.

Redirige a tu usuario a hosted_url, o envíasela.

Lee el resultado

Llama a verify_session_result con el session_id. Devuelve el status, tu external_ref, las horas y el result cuando la sesión está completa.

curl -s https://xuda.ai/cpi/verify_session_create \
  -H 'content-type: application/json' \
  -d '{"api_key":"YOUR_API_KEY","level":2,"external_ref":"user_482"}'
const res = await fetch('https://xuda.ai/cpi/verify_session_create', {
  method: 'POST',
  headers: { 'content-type': 'application/json' },
  body: JSON.stringify({ api_key: 'YOUR_API_KEY', level: 2, external_ref: 'user_482' }),
});
const { code, data } = await res.json();
// data.hosted_url is where you send this user next.
import requests

res = requests.post(
    'https://xuda.ai/cpi/verify_session_create',
    json={'api_key': 'YOUR_API_KEY', 'level': 2, 'external_ref': 'user_482'},
)

Qué decide la sesión

  • El modo. Una sesión es de prueba cuando el servicio funciona en modo de prueba, y en vivo cuando funciona En vivo. Las sesiones de prueba son gratis, nunca se cuentan y se pueden terminar desde el dashboard. Los enlaces en vivo todavía no se pueden completar.
  • El nivel. Un nivel superior al que permite tu plan se rechaza, indicando qué plan lo incluye. La solicitud nunca se reduce en silencio.
  • Pasada la asignación. Una sesión en vivo que supera la asignación mensual de tu plan se rechaza en Free, y en un plan de pago se crea y se marca como exceso.

Las claves se crean en Developers, y crear una necesita tu propio Nivel 2.

Rechazos

Webhooks

Desde Starter, fija una dirección en los ajustes de Trust Center y se envía una solicitud firmada cuando se decide una verificación, para que no tengas que consultar periódicamente. Cada una lleva una cabecera Xuda-Event y una cabecera Xuda-Signature formada por una marca de tiempo y un HMAC de la marca de tiempo y el cuerpo, firmado con el secreto que se muestra una sola vez en los ajustes. Una entrega que falla se reintenta, hasta cinco intentos.

¿Qué te parece esta guía?

Última actualización: 16 de noviembre de 2026