Visión General
Antes de que los usuarios puedan realizar transacciones ramp, deben ser registrados en KillB con información KYC apropiada. Esta guía cubre la creación de usuarios individuales (PERSON) y empresariales (COMPANY).
Todos los usuarios comienzan en nivel KYC L0 o L1 y pueden actualizarse enviando documentación adicional.
Prerrequisitos
- Token de acceso válido de
/api/v2/auth/login
- Información del usuario para enviar
- Detalles de ID del gobierno
Creando un Usuario Persona
Ejemplo Básico
{
"type": "PERSON",
"externalId": "user-12345",
"data": {
"firstName": "Juan",
"lastName": "García",
"email": "[email protected]",
"phone": "+573001234567",
"dateOfBirth": "1990-05-15",
"address": {
"street1": "Calle 123 #45-67",
"city": "Bogotá",
"state": "Cundinamarca",
"zipCode": "110111",
"countryCode": "CO"
},
"document": {
"type": "NUIP",
"number": "1234567890",
"issuedCountryCode": "CO"
}
}
}
Validación
Valida datos antes del envío:
const validateUserData = (data) => {
const errors = [];
// Formato de email
if (!/^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(data.email)) {
errors.push('Formato de email inválido');
}
// Formato de teléfono (E.164)
if (!/^\+[1-9]\d{10,14}$/.test(data.phone)) {
errors.push('Teléfono debe estar en formato: +[código país][número]');
}
// Fecha de nacimiento (18+ años)
const dob = new Date(data.dateOfBirth);
const age = (Date.now() - dob.getTime()) / (365.25 * 24 * 60 * 60 * 1000);
if (age < 18) {
errors.push('Usuario debe tener 18 años o más');
}
return errors;
};
Próximos Pasos Después de Creación
Almacenar ID del Usuario
Guarda el id retornado en tu base de datos mapeado a tu externalId
Verificar Estado KYC
Monitorea los campos status y accessLevel
Subir Documentos
Para L2+, sube imágenes de ID y documentos adicionales
Crear Cuentas
Agrega cuentas bancarias o billeteras para este usuario
