Pular para o conteúdo principal

​
O que é um Usuário?

Um Usuário na KillB representa um indivíduo ou entidade empresarial que pode realizar transações ramp. Os usuários são obrigados a completar a verificação Know Your Customer (KYC) ou Know Your Business (KYB) antes de transacionar.
Toda transação na KillB deve estar associada a um usuário verificado para cumprir requisitos regulatórios.

​
Tipos de Usuário

Usuários individuais (pessoas físicas)Informações Requeridas:
  • Nome completo (primeiro, meio, último)
  • Data de nascimento
  • Email e telefone
  • Endereço físico
  • ID emitido pelo governo
  • Nacionalidade e cidadania
Casos de Uso:
  • Remessas pessoais
  • Investimentos individuais
  • Compras de cripto pessoais
Exemplo:
{
  "type": "PERSON",
  "data": {
    "firstName": "João",
    "lastName": "Silva",
    "dateOfBirth": "1990-05-15",
    "email": "[email protected]",
    "phone": "+5511987654321",
    "document": {
      "type": "CPF",
      "number": "12345678900",
      "issuedCountryCode": "BR"
    }
  }
}

​
Níveis KYC

A KillB implementa um sistema KYC em camadas (L0-L4) que determina limites de transação:

L0 - Verificação de Email

Requisitos:
  • Apenas endereço de email
  • Verificação de email
Limites:
  • Diário: $500
  • Mensal: $1.000
Melhor Para:
  • Testes iniciais
  • Transações pequenas
  • Integração de novos usuários
Requisitos:
  • Nome completo
  • Data de nascimento
  • Número de ID do governo
  • Número de telefone
  • Endereço
Limites:
  • Diário: $2.500
  • Mensal: $10.000
Melhor Para:
  • Usuários regulares
  • Transações padrão
  • Caso de uso mais comum
Requisitos:
  • Todos os requisitos L1
  • Imagens de documento de ID (frente/verso)
  • Comprovante de endereço
  • Verificação de selfie
Limites:
  • Diário: $10.000
  • Mensal: $50.000
Melhor Para:
  • Power users
  • Traders frequentes
  • Transações de valor mais alto
Requisitos:
  • Todos os requisitos L2
  • Documentação de origem de fundos
  • Extratos bancários
  • Due diligence aprimorada
Limites:
  • Diário: $50.000
  • Mensal: $250.000
Melhor Para:
  • Indivíduos de alto patrimônio
  • Contas empresariais
  • Transações grandes
Requisitos:
  • Verificação personalizada
  • Licenças comerciais
  • Documentos corporativos
  • Revisão de compliance
Limites:
  • Limites personalizados
  • Taxas negociadas
Melhor Para:
  • Clientes institucionais
  • Operações de alto volume
  • Integrações white-label

​
Status do Usuário

Os usuários podem ter diferentes status:
StatusDescriçãoPode Transacionar?
ACTIVEUsuário verificado e aprovado✅ Sim
PENDINGDocumentos KYC sob revisão❌ Não
REJECTEDVerificação KYC falhou❌ Não

​
Documentos Requeridos

​
Documentos de Pessoa

  • NUIP (Número Único de Identificación Personal)
  • Cédula de Ciudadanía (CC)
  • Passaporte
  • Carteira de Motorista

​
ID Externo

O campo externalId permite que você vincule usuários KillB ao seu próprio sistema de usuários: 
{
  "type": "PERSON",
  "externalId": "user_abc123_do_meu_sistema",
  "data": { ... }
}
Benefícios:
  • Mapear usuários KillB para seu banco de dados
  • Evitar criação de usuário duplicado
  • Simplificar buscas de usuário
  • Manter integridade referencial
Use seu ID de usuário interno como externalId para fácil mapeamento entre sistemas.

​
Gerenciando Usuários

​
Criar um Usuário

POST /api/v2/users
Veja o Guia de Criação de Usuário para exemplos detalhados.

​
Consultar Usuários

GET /api/v2/users?type=PERSON&email=[email protected]
Opções de Filtro:
  • type - PERSON ou COMPANY
  • firstName, lastName, email
  • externalId - Seu ID de sistema
  • customerId - Filtrar por cliente

​
Atualizar Usuário

PATCH /api/v2/users/{userId}
Atualize informações do usuário, faça upload de documentos adicionais ou modifique dados de perfil.

​
Excluir Usuário

DELETE /api/v2/users/{userId}
A exclusão de usuário é uma exclusão suave. Os dados do usuário são retidos para compliance mas marcados como inativos.

​
Melhores Práticas

  • Valide formatos de dados antes do envio
  • Garanta que os nomes correspondam exatamente aos IDs do governo
  • Use formato correto de número de telefone (+[código do país][número])
  • Verifique endereços de email
  • Confirme que os endereços estão completos e precisos
  • Sempre forneça um externalId
  • Use seu ID de usuário interno
  • Permite buscas e reconciliação fáceis
  • Previne criação de usuário duplicado
  • Verifique status antes de permitir transações
  • Mostre aos usuários seu accessLevel e limites
  • Guie usuários para o próximo passo de verificação
  • Monitore complianceUrl para atualizações KYC

​
Próximos Passos

Crie Seu Primeiro Usuário

Siga o guia passo a passo para criar usuários

Entendendo Contas

Aprenda sobre contas bancárias e carteiras

Aprofundamento em Níveis KYC

Guia detalhado sobre requisitos KYC

Referência da API

Veja a documentação completa da API de Usuários