Visão Geral
Antes que os usuários possam realizar transações ramp, eles devem ser registrados na KillB com informações KYC apropriadas. Este guia cobre a criação de usuários individuais (PERSON) e empresariais (COMPANY).
Todos os usuários começam no nível KYC L0 ou L1 e podem ser atualizados enviando documentação adicional.
Pré-requisitos
- Token de acesso válido de
/api/v2/auth/login
- Informações do usuário para enviar
- Detalhes de ID do governo
Criando um Usuário Pessoa
Exemplo Básico
{
"type": "PERSON",
"externalId": "user-12345",
"data": {
"firstName": "João",
"lastName": "Silva",
"email": "[email protected]",
"phone": "+5511987654321",
"dateOfBirth": "1990-05-15",
"address": {
"street1": "Rua 123, 45",
"city": "São Paulo",
"state": "SP",
"zipCode": "01234-567",
"countryCode": "BR"
},
"document": {
"type": "CPF",
"number": "12345678900",
"issuedCountryCode": "BR"
}
}
}
Validação
Valide dados antes do envio:
const validateUserData = (data) => {
const errors = [];
// Formato de email
if (!/^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(data.email)) {
errors.push('Formato de email inválido');
}
// Formato de telefone (E.164)
if (!/^\+[1-9]\d{10,14}$/.test(data.phone)) {
errors.push('Telefone deve estar no formato: +[código país][número]');
}
// Data de nascimento (18+ anos)
const dob = new Date(data.dateOfBirth);
const age = (Date.now() - dob.getTime()) / (365.25 * 24 * 60 * 60 * 1000);
if (age < 18) {
errors.push('Usuário deve ter 18 anos ou mais');
}
return errors;
};
Próximos Passos Após Criação
Armazenar ID do Usuário
Salve o id retornado em seu banco de dados mapeado para seu externalId
Verificar Status KYC
Monitore os campos status e accessLevel
Enviar Documentos
Para L2+, envie imagens de ID e documentos adicionais
Criar Contas
Adicione contas bancárias ou carteiras para este usuário
