Resumen del backend de identidad
Un backend de identidad es tu propia copia de la API de un proveedor de identidad. Corre la verificación como la corre el proveedor, en las mismas rutas, y responde con las formas de informe del propio proveedor.
KYC y KYB son un solo producto acá, porque los proveedores los tratan así. La misma maquinaria de casos verifica a una persona o a una empresa, y lo que cambia son las revisiones, no la API.
Qué lleva registrado
- Un sujeto es la persona o la empresa que se verifica. Sobrevive a cualquier caso puntual, así que un cliente que vuelve es el mismo sujeto.
- Un documento es evidencia presentada contra un sujeto. Se presenta una vez y lo puede citar más de un caso.
- Un caso es una verificación, y las revisiones viven dentro de él.
- Una sesión es una captura alojada, para los pasos que el sujeto completa por su cuenta.
Todo eso dura poco a propósito. Los sujetos, los casos y los documentos se quedan alrededor de un día, y un enlace alojado se puede abrir durante 30 minutos. Es una ventana de prueba, no un almacén de registros.
Las revisiones
Un caso corre las revisiones que pidas, y cada una vuelve con su propio resultado:
- Documentos y biometría:
document,facial_similarity,liveness - Datos declarados:
identity_database,proof_of_address,phone,email,device - Cruce con listas:
watchlist, que cubre sanciones, personas políticamente expuestas y prensa adversa - Empresas:
business_registration,business_ownership,tax_id
Los proveedores se diferencian en lo que ofrecen, y el backend sigue al proveedor en lugar de aplanarlos. Cada marca declara sus capacidades versión por versión, y la app las muestra en la pestaña Resumen de la marca.
Qué responde un caso
Un caso terminado lleva una decisión: approved, declined, o review cuando se supone que lo mire una persona. Antes de eso puede estar procesando, esperando al sujeto, en pausa para un revisor, retirado, o vencido porque nadie lo terminó a tiempo.
La decisión no es toda la respuesta. Cada revisión informa su propio resultado, con los subresultados y desgloses que publica el proveedor, y una revisión de listas lleva las coincidencias que encontró. Un rechazo aterriza en la revisión que lo habría atrapado, así que un impacto en sanciones hace fallar la revisión de listas y no la de documentos. El código de parseo escrito para el proveedor sigue funcionando.
Empresas además de personas
Una empresa es un sujeto como cualquier otro. Las consultas a registros, la verificación de titularidad y las revisiones de identificación fiscal corren en la misma maquinaria de casos que un documento o una selfie, y vuelven con la misma forma de informe. Nada de tu integración cambia entre verificar a un director y verificar a la empresa que dirige.
Flujos que termina el sujeto
Algunos pasos le entregan al sujeto un enlace o un token y esperan: un token de SDK, la URL de un formulario, un enlace de un solo uso. El backend sirve esa página, así que un test la puede abrir, completar y seguir. Hasta que el sujeto envía la página, el caso no tiene resultado. Cuando la envía, lo tiene.
No se te empuja nada, así que un test consulta. Leer un caso que todavía está esperando es lo que lo termina, así que la lectura siguiente recibe la respuesta.
Después de la decisión
Las partes del ciclo de vida que vienen después de una respuesta también están modeladas, donde el proveedor las tiene: cruce continuo que reporta un impacto nuevo sobre un caso viejo, un revisor que da vuelta una decisión, reiniciar un caso que se frenó a mitad de camino, volver a correr una revisión terminada sobre la misma evidencia, y borrar los datos personales de un sujeto en su lugar.
Qué puedes recorrer
Identidad guarda cuatro cosas que puedes leer en la app: casos, sujetos, documentos y sesiones. Un caso se refiere al sujeto del que trata, así que son listas separadas y no una sola.
Consulta Actividad del backend.
Decidir qué pasa
Nombra a la persona o a la empresa según el resultado que quieras, y el caso vuelve así, en la revisión que le corresponde.
Consulta Escenarios de identidad.
Dónde responde
Cada versión de un proveedor responde bajo su propia ruta, que lleva la marca y la versión. En un backend alojado, esa ruta está en el propio host del backend:
https://<hostname>.kyx.mockz.io/onfido/v3.6/applicantsTodo lo que va después de esa ruta es la ruta propia del proveedor.
Consulta Crear un backend alojado.