Kuenta Docs

Appearance

Registrar nuevo usuario​

POST
/auth/register

Registra un nuevo usuario en el sistema con información de perfil y documentos firmados.

⚠️ Importante: Este endpoint solo acepta personas naturales (individuos).
Si se envía un campo legal con datos de empresa, la solicitud será rechazada.
Para registrar empresas, use el endpoint de creación de entidades legales.

Funcionalidades principales:

  • Solo personas naturales: No acepta datos de entidades legales (empresas)
  • Registro flexible: Acepta desde datos mínimos hasta perfil completo
  • Documentos firmados: Acepta términos y condiciones, políticas de privacidad
  • Perfil completo: Soporta todos los campos de persona natural (Natural)
  • Auditoría completa: Registra detalles de la solicitud HTTP e IP

Proceso de registro:

  1. Validar datos: Verifica formato de teléfono y datos del perfil
  2. Validar unicidad: Si se proporciona documento, verifica que no exista
  3. Procesar documentos: Valida documentos firmados digitalmente
  4. Crear usuario: Registra usuario en el sistema de autenticación
  5. Crear perfil: Genera perfil maestro y compartido
  6. Auditoría: Guarda detalles de la solicitud para compliance

Campos del perfil:

El endpoint acepta todos los campos del modelo Natural. Los campos mínimos
requeridos dependen de la configuración de la marca blanca, pero típicamente son:

Campos básicos (usados por el frontend):

  • firstName: Nombre(s) del usuario
  • lastName: Apellido(s) del usuario
  • email: Correo electrónico (opcional)

Campos opcionales para integraciones API:

  • Datos de identificación: idType, idNumber, birthdate, gender
  • Datos de contacto: homePhone, addressHome, addressHomeCityID
  • Datos laborales: company, companyPosition, incomeMonthly
  • Datos financieros: assets, liabilities, bankEntityID
  • Datos familiares: maritalStatus, spouse, spouseIncome, dependants
  • Y muchos más según el modelo Natural

Nota para integraciones API: Si ya tiene todos los datos del usuario,
puede enviarlos todos en el registro inicial en lugar de actualizar después.

Casos de uso:

  • Onboarding web/mobile: Registro con datos mínimos (nombre, apellido)
  • Integración API: Registro con perfil completo desde sistemas externos
  • Migración de datos: Importación de usuarios con toda su información
  • KYC completo: Registro incluyendo verificación de identidad

Seguridad:

  • Validación de formato de teléfono
  • Registro de IP y detalles de solicitud HTTP
  • Validación de firma digital de documentos
  • Prevención de registros duplicados por teléfono y documento

Authorizations​

test

OAuth 2.0 Client Credentials Grant (RFC 6749 §4.4).
Utilice este flow para autenticación de aplicación-a-aplicación sin intervención del usuario.
Ideal para servicios backend y integración entre sistemas.

clientCredentials Flow
Token URLhttps://test-api.kuenta.co/v1/oauth/token
Scopes:
  • *Acceso completo (administrador)
  • users:readLectura de usuarios
  • users:writeEscritura de usuarios
  • users.info:writeEscritura de información de usuarios
  • clients:readLectura de clientes OAuth
  • clients:writeEscritura de clientes OAuth
  • verifications:writeEscritura de verificaciones
  • passwords:writeEscritura de contraseñas
  • keys:readLectura de claves
  • settings:readLectura de configuraciones
  • settings:writeEscritura de configuraciones
or
stage

OAuth 2.0 Client Credentials Grant (RFC 6749 §4.4).
Utilice este flow para autenticación de aplicación-a-aplicación sin intervención del usuario.
Ideal para servicios backend y integración entre sistemas.

clientCredentials Flow
Token URLhttps://stage-api.kuenta.co/v1/oauth/token
Scopes:
  • *Acceso completo (administrador)
  • users:readLectura de usuarios
  • users:writeEscritura de usuarios
  • users.info:writeEscritura de información de usuarios
  • clients:readLectura de clientes OAuth
  • clients:writeEscritura de clientes OAuth
  • verifications:writeEscritura de verificaciones
  • passwords:writeEscritura de contraseñas
  • keys:readLectura de claves
  • settings:readLectura de configuraciones
  • settings:writeEscritura de configuraciones
or
demo

OAuth 2.0 Client Credentials Grant (RFC 6749 §4.4).
Utilice este flow para autenticación de aplicación-a-aplicación sin intervención del usuario.
Ideal para servicios backend y integración entre sistemas.

clientCredentials Flow
Token URLhttps://demo-api.kuenta.co/v1/oauth/token
Scopes:
  • *Acceso completo (administrador)
  • users:readLectura de usuarios
  • users:writeEscritura de usuarios
  • users.info:writeEscritura de información de usuarios
  • clients:readLectura de clientes OAuth
  • clients:writeEscritura de clientes OAuth
  • verifications:writeEscritura de verificaciones
  • passwords:writeEscritura de contraseñas
  • keys:readLectura de claves
  • settings:readLectura de configuraciones
  • settings:writeEscritura de configuraciones
or
prod

OAuth 2.0 Client Credentials Grant (RFC 6749 §4.4).
Utilice este flow para autenticación de aplicación-a-aplicación sin intervención del usuario.
Ideal para servicios backend y integración entre sistemas.

clientCredentials Flow
Token URLhttps://api.kuenta.co/v1/oauth/token
Scopes:
  • *Acceso completo (administrador)
  • users:readLectura de usuarios
  • users:writeEscritura de usuarios
  • users.info:writeEscritura de información de usuarios
  • clients:readLectura de clientes OAuth
  • clients:writeEscritura de clientes OAuth
  • verifications:writeEscritura de verificaciones
  • passwords:writeEscritura de contraseñas
  • keys:readLectura de claves
  • settings:readLectura de configuraciones
  • settings:writeEscritura de configuraciones

Request Body​

application/json

Registro con los campos mínimos que pide el formulario web

JSON
{
"phone": "3001234567",
"profile": {
"profileID": "123e4567-e89b-12d3-a456-426614174000",
"status": true,
"firstName": "Juan",
"lastName": "Pérez",
"email": "[email protected]"
},
"signedDocs": [
{
"checked": true,
"ID": "123e4567-e89b-12d3-a456-426614174000"
}
]
}

Responses​

Usuario registrado exitosamente. El usuario ha sido creado correctamente en el sistema. El siguiente paso típico es la verificación del número de teléfono.
application/json
JSON
{
"status": "string",
"data": {
"user": {
"id": "user_abc123",
"phone": "3001234567",
"email": "[email protected]"
}
}
}

Playground​

Server
Authorization
Body

Samples​

Powered by VitePress OpenAPI