Saltar al contenido principal

​
¿Qué es un Usuario?

Un Usuario en KillB representa un individuo o entidad empresarial que puede realizar transacciones ramp. Los usuarios están obligados a completar la verificación Know Your Customer (KYC) o Know Your Business (KYB) antes de transaccionar.
Toda transacción en KillB debe estar asociada a un usuario verificado para cumplir con requisitos regulatorios.

​
Tipos de Usuario

Usuarios individuales (personas físicas)Información Requerida:
  • Nombre completo (primero, medio, último)
  • Fecha de nacimiento
  • Email y teléfono
  • Dirección física
  • ID emitido por el gobierno
  • Nacionalidad y ciudadanía
Casos de Uso:
  • Remesas personales
  • Inversiones individuales
  • Compras de cripto personales
Ejemplo:
{
  "type": "PERSON",
  "data": {
    "firstName": "Juan",
    "lastName": "García",
    "dateOfBirth": "1990-05-15",
    "email": "[email protected]",
    "phone": "+573001234567",
    "document": {
      "type": "NUIP",
      "number": "1234567890",
      "issuedCountryCode": "CO"
    }
  }
}

​
Estado del Usuario

Los usuarios pueden tener diferentes estados:
EstadoDescripción¿Puede Transaccionar?
ACTIVEUsuario verificado y aprobado✅ Sí
PENDINGDocumentos KYC bajo revisión❌ No
REJECTEDVerificación KYC falló❌ No
Controla las operaciones con status === ACTIVE. Si un usuario está PENDING, envíalo a complianceUrl para completar la verificación.

​
Documentos Requeridos

​
Documentos de Persona

  • NUIP (Número Único de Identificación Personal)
  • Cédula de Ciudadanía (CC)
  • Pasaporte
  • Licencia de Conducir

​
ID Externo

El campo externalId te permite vincular usuarios de KillB con tu propio sistema de usuarios: 
{
  "type": "PERSON",
  "externalId": "user_abc123_de_mi_sistema",
  "data": { ... }
}
Beneficios:
  • Mapear usuarios de KillB a tu base de datos
  • Evitar creación de usuario duplicado
  • Simplificar búsquedas de usuario
  • Mantener integridad referencial
Usa tu ID de usuario interno como externalId para fácil mapeo entre sistemas.

​
Gestionando Usuarios

​
Crear un Usuario

POST /api/v2/users
Ve la Guía de Creación de Usuario para ejemplos detallados.

​
Consultar Usuarios

GET /api/v2/users?type=PERSON&email=[email protected]
Opciones de Filtro:
  • type - PERSON o COMPANY
  • firstName, lastName, email
  • externalId - Tu ID de sistema
  • customerId - Filtrar por cliente

​
Actualizar Usuario

PATCH /api/v2/users/{userId}
Actualiza información del usuario, sube documentos adicionales o modifica datos de perfil.

​
Eliminar Usuario

DELETE /api/v2/users/{userId}
La eliminación de usuario es una eliminación suave. Los datos del usuario se retienen para compliance pero se marcan como inactivos.

​
Mejores Prácticas

  • Valida formatos de datos antes del envío
  • Asegura que los nombres coincidan exactamente con los IDs del gobierno
  • Usa formato correcto de número de teléfono (+[código de país][número])
  • Verifica direcciones de email
  • Confirma que las direcciones estén completas y precisas
  • Siempre proporciona un externalId
  • Usa tu ID de usuario interno
  • Permite búsquedas y reconciliación fáciles
  • Previene creación de usuario duplicado
  • Verifica status antes de permitir transacciones
  • Muestra a los usuarios su accessLevel y límites
  • Guía a los usuarios al siguiente paso de verificación
  • Monitorea complianceUrl para actualizaciones KYC

​
Próximos Pasos

Crea Tu Primer Usuario

Sigue la guía paso a paso para crear usuarios

Comprendiendo Cuentas

Aprende sobre cuentas bancarias y billeteras

Referencia API

Ve la documentación completa de la API de Usuarios