Verificar teléfono
Confirma el número de teléfono del usuario mediante un código de 6 dígitos enviado por SMS. Este paso es obligatorio antes de realizar cualquier operación financiera.
Flujo
1. Solicitar código
Llama a /request_confirmation/ con phone: true para enviar el código al teléfono del usuario por SMS.
2. Verificar código
Envía el código recibido a /verify_phone/ con by_phone: true para confirmar el teléfono.
El campo phone_verified del perfil se actualiza a true.
Paso 1 — Solicitar código de verificación por SMS
Solicitar Código de Verificación (teléfono)
Autorización
Se requieren el header
x-api-key y Authorization: Bearer <token>.Endpoint
POSThttps://dev.backend.colurs.co/request_confirmation/Headers Requeridos
Content-Type: application/jsonAccept: application/jsonx-api-key: [API_KEY]Authorization: Bearer [ACCESS_TOKEN]Request Body
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| phone | boolean | Debe ser true para enviar el código por SMS | |
| boolean | Debe ser false al verificar teléfono |
Ejemplo cURL
curl -X POST https://dev.backend.colurs.co/request_confirmation/ \
-H "Authorization: Bearer [ACCESS_TOKEN]" \
-H "x-api-key: [API_KEY]" \
-H "Content-Type: application/json" \
-d '{"phone": true, "email": false}'Respuesta
response.json
{
"message":
"Verification code sent"}⏱️
El código expira en 5 minutos. Si expira, solicita uno nuevo.
Paso 2 — Verificar el código de teléfono
Verificar Teléfono
Autorización
Se requieren el header
x-api-key y Authorization: Bearer <token>.Endpoint
POSThttps://dev.backend.colurs.co/verify_phone/Headers Requeridos
Content-Type: application/jsonAccept: application/jsonx-api-key: [API_KEY]Authorization: Bearer [ACCESS_TOKEN]Request Body
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| code | string | Código de 6 dígitos recibido por SMS | |
| by_phone | boolean | Debe ser true para verificación de teléfono |
Ejemplo cURL
curl -X POST https://dev.backend.colurs.co/verify_phone/ \
-H "Authorization: Bearer [ACCESS_TOKEN]" \
-H "x-api-key: [API_KEY]" \
-H "Content-Type: application/json" \
-d '{"code": "123456", "by_phone": true}'Respuesta
response.json
El campo phone_verified del perfil se actualiza a true en éxito.Con email y teléfono verificados, el siguiente paso es completar la Verificación KYC para operar en la plataforma.