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"
    }
  }
}

​
Niveles KYC

KillB implementa un sistema KYC por niveles (L0-L4) que determina límites de transacción:

L0 - Verificación de Email

Requisitos:
  • Solo dirección de email
  • Verificación de email
Límites:
  • Diario: $500
  • Mensual: $1.000
Mejor Para:
  • Pruebas iniciales
  • Transacciones pequeñas
  • Incorporación de nuevos usuarios
Requisitos:
  • Nombre completo
  • Fecha de nacimiento
  • Número de ID del gobierno
  • Número de teléfono
  • Dirección
Límites:
  • Diario: $2.500
  • Mensual: $10.000
Mejor Para:
  • Usuarios regulares
  • Transacciones estándar
  • Caso de uso más común
Requisitos:
  • Todos los requisitos L1
  • Imágenes de documento de ID (frente/reverso)
  • Comprobante de domicilio
  • Verificación de selfie
Límites:
  • Diario: $10.000
  • Mensual: $50.000
Mejor Para:
  • Power users
  • Traders frecuentes
  • Transacciones de mayor valor
Requisitos:
  • Todos los requisitos L2
  • Documentación de origen de fondos
  • Estados de cuenta bancarios
  • Due diligence mejorada
Límites:
  • Diario: $50.000
  • Mensual: $250.000
Mejor Para:
  • Individuos de alto patrimonio
  • Cuentas empresariales
  • Transacciones grandes
Requisitos:
  • Verificación personalizada
  • Licencias comerciales
  • Documentos corporativos
  • Revisión de compliance
Límites:
  • Límites personalizados
  • Tasas negociadas
Mejor Para:
  • Clientes institucionales
  • Operaciones de alto volumen
  • Integraciones white-label

​
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

​
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

Profundización en Niveles KYC

Guía detallada sobre requisitos KYC

Referencia API

Ve la documentación completa de la API de Usuarios