Registro Biométrico con ID
Registra un usuario nuevo con verificación documental — OCR del documento más comparación facial 1:1 contra la foto del documento.
Antes de integrar, instala el SDK en Getting Started → Instalar el SDK →
/api/kyc/onboard Apertura de cuenta, registro de usuario, activación de tarjetas — cualquier caso de onboarding donde necesitas verificar la identidad del usuario contra su documento físico.
Flujo
Validación de entorno
Controles RASP previos a la captura.
Captura facial
Captura del rostro con prueba de vida.
Captura de documento
OCR del documento de identidad y comparación facial 1:1 contra la foto del documento.
Datos cifrados
El SDK devuelve template + payload (rostro + datos del documento).
Solicitud de onboarding
Tu backend reenvía template + payload + DNI al endpoint /api/kyc/onboard.
Llamada del SDK
// Onboarding flow — also scans the ID document
SmartId
.getInstance()
.captureBiometric(getApplicationContext())
.withDocument()
.onSuccess { template, payload ->
// template + payload include the face capture
// AND the OCR data from the document
}
.onFailure { message, errorCode ->
// capture failed — surface a retry to the user
}
.start()SID.shared.startLocation()
SID.shared
.captureBiometric()
.withDocument()
.onSuccess(success: { template, payload in
// face + document captured
})
.onFailure(failure: { message, errorCode in
// capture failed
})
.start()Llamada al backend
curl -X POST https://<api-url>/api/kyc/onboard \\
-H "Content-Type: application/json" \\
-H "X-Api-Key: <your-api-key>" \\
-d '{
"User": "[email protected]",
"DNI": "23154613543134",
"Template": "<template from SDK>",
"PayLoad": "<payload from SDK>",
"OverWrite": "true"
}'Cuerpo de la solicitud
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
User | string | Requerido | Identificador único del usuario |
DNI | string | Requerido | Número del documento de identidad |
Template | string | Requerido | Template biométrico cifrado generado por el SDK |
PayLoad | string | Requerido | Datos del documento + metadata generados por el SDK |
OverWrite | string | Opcional | "true" para reemplazar un registro existente del usuario |
Códigos de respuesta
| Código | Significado |
|---|---|
200 | Onboarding exitoso |
403 | User o DNI no pueden ser nulos o vacíos |
407 | Validación del template falló |
408 | Usuario ya enrolado |
412 | Formato de template inválido |
413 | Similitud rostro↔documento por debajo del umbral |
420 | No se obtuvieron datos válidos del documento |
421 | Falló la generación del template desde la imagen del documento |
425/426 | Timestamp inválido / template expirado |
500/701 | Error interno / al llamar al servicio |