Descripción general
Esta sección documenta el contrato de API (conocido internamente como TCA / Check.Integration), utilizado cuando la aplicación cliente es responsable del paso de captura y envía la imagen directamente a la plataforma.
Usa el contrato de API cuando:
- Tu aplicación ya ha capturado el selfie o la imagen (a través del SDK nativo de Unico o una solución propia — Capture Standard).
- Quieres resultados síncronos en la propia respuesta de creación del proceso.
- No quieres redirigir al usuario a un flujo hospedado.
- Tu arquitectura prefiere llamadas tradicionales servidor a servidor (solicitud → respuesta con el resultado).
Si quieres que Unico gestione el flujo, usa Web & SDK en su lugar.
Crea un proceso de verificación enviando la imagen capturada directamente. Retorna un resultado síncrono.
Recupera un proceso existente del contrato de API por su identificador.
Verifica si un usuario ya tiene un documento reutilizable registrado antes de iniciar un nuevo flujo de captura.
Captura un nuevo documento o reutiliza uno capturado previamente vinculado a un proceso biométrico.
Consulta datos de registro, cribado PEP/AML y relación con apuestas deportivas para un CPF dado.
Bibliotecas nativas para Android, iOS y Flutter para capturar el selfie dentro de tu aplicación móvil.
Requisitos técnicos que debe cumplir tu captura propia cuando no utilizas el SDK de Unico — resolución, formato, iluminación y más.
Diferencias con Web & SDK
| Aspecto | API | Web & SDK |
|---|---|---|
| Cuándo se crea el proceso | Después de la captura | Antes de la captura |
| Retorno de imagen | Inmediato (tras la captura en el cliente) | A través de endpoint dedicado |
| Control del flujo | Cliente | Unico |
| Control de captura | Cliente (con o sin SDK) | Unico |
| Identificación | subject.code | person.duiType + person.duiValue |
| Headers | Authorization + APIKEY | Solo Authorization |
| Esquema de resultado | Plano (unicoId.result, liveness, etc.) | Anidado (process.authenticationInfo.*Result) |
Próximos pasos
- Crear proceso — contrato de Onboarding completo.
- Códigos de error — manejo de respuestas 4xx y 5xx.