Pular para o conteúdo principal

Documentation Index

Fetch the complete documentation index at: https://docs.killb.com/llms.txt

Use this file to discover all available pages before exploring further.

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

POST /api/v2/users
{
  "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

1

Armazenar ID do Usuário

Salve o id retornado em seu banco de dados mapeado para seu externalId
2

Verificar Status KYC

Monitore o campo status
3

Iniciar/Continuar Verificação

Se o status for PENDING, redirecione o usuário para complianceUrl para completar a verificação
4

Criar Contas

Adicione contas bancárias ou carteiras para este usuário

Enviar Documentos

Enviar imagens de ID e documentos de prova

Gerenciar Usuários

Consultar, atualizar e excluir usuários

Referência da API

Documentação completa da API de Usuários