Trust Center
Verifique a sus propios usuarios: documentos de identidad, cotejo facial y comprobaciones de empresa.
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.
Envía el enlace
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.
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.
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.