Un flujo, tres responsabilidades
Su servidor crea una transacción mediante la API. La persona realiza la verificación en el recorrido alojado, al que accede mediante el enlace devuelto. Su sistema consulta el resultado y recibe eventos para continuar el proceso de negocio.
- Crear: utilice
POST /v1/face-auth/transactionsconX-API-Keydesde su backend. - Derivar: utilice la URL devuelta; la clave nunca debe llegar al navegador de la persona.
- Acompañar: vincule
transaction_ida su proceso, valide webhooks y concilie el estado mediante GET.
Qué representa el resultado
La verificación de identidad es una etapa de su flujo. Una identidad aprobada no aprueba automáticamente crédito, una compra, una cuenta ni facultades de representación. Su sistema conserva la responsabilidad sobre las reglas comerciales, los casos pendientes y la decisión de continuar.
status describe la etapa operativa; decision indica pending, approved o rejected. No convierta una etapa intermedia en aprobación. Los recorridos vencidos también requieren un tratamiento específico.
Elija cómo empezar
Utilice el simulador local para comprender el flujo sin credenciales ni datos personales. Para integrar su backend, siga el inicio rápido y consulte la referencia.
Los ejemplos utilizan datos sintéticos y una dirección reservada para documentación. La URL de API, las credenciales y los accesos de su entorno se definen al habilitar la integración.