Pular para o conteúdo principal

Visão Geral

Para atualizar usuários para níveis KYC mais altos (L2+), você precisa enviar documentos de suporte como imagens de ID, comprovante de endereço e documentação de origem de fundos.
Documentos devem ser imagens claras e não alteradas em formato JPG, PNG ou PDF, máximo 10MB por arquivo.

Tipos de Documento

Documentos de Pessoa

ID emitido pelo governo com foto
  • PASSPORT - Passaporte
  • DRIVER_LICENSE - Carteira de motorista
  • CPF - CPF brasileiro
  • RG - RG brasileiro
  • NUIP - ID colombiano
  • INE - ID eleitoral mexicano
Requisitos:
  • Imagem frontal (sempre obrigatória)
  • Imagem traseira (se aplicável)
  • Texto claro e legível
  • Todos os cantos visíveis
  • Sem reflexos ou sombras

Enviando Documentos de Pessoa

POST /api/v2/users/person/document
Content-Type: multipart/form-data
const uploadDocument = async (userId, documentType, frontFile, backFile = null) => {
  const formData = new FormData();
  formData.append('userId', userId);
  formData.append('documentType', documentType);
  formData.append('frontDocument', frontFile);
  
  if (backFile) {
    formData.append('backDocument', backFile);
  }
  
  const response = await fetch(
    'https://teste-94u93qnn.uc.gateway.dev/api/v2/users/person/document',
    {
      method: 'POST',
      headers: {
        'Authorization': `Bearer ${accessToken}`
      },
      body: formData
    }
  );
  
  return await response.json();
};

// Uso
const frontImage = new File([blob], 'passport-front.jpg', { type: 'image/jpeg' });
await uploadDocument(userId, 'PASSPORT', frontImage);

Diretrizes de Qualidade

Requisitos de Imagem

Bom:
  • Imagem clara e focada
  • Todo o texto legível
  • Todos os cantos visíveis
  • Boa iluminação
  • Cor original
  • Mínimo 300 DPI
Ruim:
  • Desfocado ou fora de foco
  • Reflexos ou sombras
  • Cantos cortados
  • Cópia em preto e branco
  • Screenshots
  • Baixa resolução
Usar a URL de compliance é o caminho de integração mais fácil. Os usuários completam KYC no portal da KillB e você recebe notificações via webhook.

Próximos Passos