Saltar al contenido principal

Visión General

Para actualizar usuarios a niveles KYC más altos (L2+), necesitas subir documentos de soporte como imágenes de ID, comprobante de domicilio y documentación de origen de fondos.
Los documentos deben ser imágenes claras y no alteradas en formato JPG, PNG o PDF, máximo 10MB por archivo.

Tipos de Documento

Documentos de Persona

ID emitido por el gobierno con foto
  • PASSPORT - Pasaporte
  • DRIVER_LICENSE - Licencia de conducir
  • NUIP - ID colombiano
  • INE - ID electoral mexicano
  • RFC - ID fiscal mexicano
  • DNI - ID nacional
Requisitos:
  • Imagen frontal (siempre requerida)
  • Imagen trasera (si aplica)
  • Texto claro y legible
  • Todas las esquinas visibles
  • Sin reflejos o sombras

Subiendo Documentos de Persona

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);

Directrices de Calidad

Requisitos de Imagen

Bueno:
  • Imagen clara y enfocada
  • Todo el texto legible
  • Todas las esquinas visibles
  • Buena iluminación
  • Color original
  • Mínimo 300 DPI
Malo:
  • Borroso o desenfocado
  • Reflejos o sombras
  • Esquinas cortadas
  • Copia en blanco y negro
  • Capturas de pantalla
  • Baja resolución
Usar la URL de compliance es el camino de integración más fácil. Los usuarios completan KYC en el portal de KillB y recibes notificaciones vía webhook.

Próximos Pasos