Verificación KYC

Proceso de validación de identidad requerido para operar en la plataforma. El usuario debe subir sus documentos de identidad para ser revisados por el equipo de compliance.

Flujo

1. Subir archivo

Sube el archivo del documento a almacenamiento usando POST /base/upload_file/ y obtén la URL resultante.

2. Enviar documentos al perfil

Envía las URLs obtenidas al perfil del usuario mediante POST /profile_documents/.

3. Esperar aprobación

El equipo de compliance revisa los documentos. El estado se refleja en GET /profile_documents/. Una vez aprobado, el usuario pasa al nivel 5 (completamente validado).

Endpoint 1 — Subir archivo

POST /base/upload_file/

Headers requeridos:

Authorization: Bearer [ACCESS_TOKEN]
x-api-key: [API_KEY]
Content-Type: multipart/form-data

FormData:

Campo	Descripción
`file`	Objeto del archivo con `uri`, `name` y `type`
`sign`	Firma de seguridad
`file_type`	Tipo de archivo (ej. `documents`)
`file_name`	Nombre del archivo

Respuesta exitosa: URL del archivo subido al almacenamiento.

Endpoint 2 — Enviar documentos al perfil

POST /profile_documents/

Headers requeridos:

Authorization: Bearer [ACCESS_TOKEN]
x-api-key: [API_KEY]
Content-Type: application/json

Body:

{
  "documents": [
    {
      "code_name": "national_id_front",
      "url": "https://storage.colurs.co/documents/archivo.jpg",
      "type_document_id": 1
    }
  ]
}

Endpoint 3 — Consultar estado de documentos

GET /profile_documents/

Headers requeridos:

Authorization: Bearer [ACCESS_TOKEN]
x-api-key: [API_KEY]

Query params opcionales: by_validation3=false, type_document=1

Respuesta: Lista de documentos enviados con su estado de revisión.

Niveles de validación

El campo level en el perfil del usuario (GET /user/) indica el estado de la verificación:

Nivel	Estado	Descripción
`0`	Sin validar	Usuario recién creado, no puede realizar transacciones
`1`	Pendiente	Documentos enviados, en revisión por compliance
`2`	Con errores	Documentos rechazados, debe reenviar documentación
`5`	Validado	Verificación completa, acceso a todas las funciones

Solo los usuarios en nivel 5 pueden realizar operaciones financieras en la plataforma (fondeo, pagos, intercambio).

Verificar teléfono Cómo consultar el balance