Verificar email

Confirma el email del usuario mediante un código de 6 dígitos enviado al correo. Este paso es obligatorio antes de realizar cualquier operación financiera.


Flujo

1. Solicitar código

Llama a /request_confirmation/ con email: true para enviar el código al correo del usuario.

2. Verificar código

Envía el código recibido a /verify_email/ con by_phone: false para confirmar el email. El campo email_verified del perfil se actualiza a true.


Paso 1 — Solicitar código de verificación por email

Solicitar Código de Verificación (email)

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

CampoTipoRequeridoDescripción
emailbooleanDebe ser true para enviar el código al correo
phonebooleanDebe ser false al verificar email

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": false, "email": true}'

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 email

Verificar Email

Autorización

Se requieren el header x-api-key y Authorization: Bearer <token>.

Endpoint

POSThttps://dev.backend.colurs.co/verify_email/

Headers Requeridos

Content-Type: application/jsonAccept: application/jsonx-api-key: [API_KEY]Authorization: Bearer [ACCESS_TOKEN]

Request Body

CampoTipoRequeridoDescripción
codestringCódigo de 6 dígitos recibido por email
by_phonebooleanDebe ser false para verificación de email

Ejemplo cURL

curl -X POST https://dev.backend.colurs.co/verify_email/ \
-H "Authorization: Bearer [ACCESS_TOKEN]" \
-H "x-api-key: [API_KEY]" \
-H "Content-Type: application/json" \
-d '{"code": "123456", "by_phone": false}'

Respuesta

response.json
El campo email_verified del perfil se actualiza a true en éxito.

Verifica también el teléfono para desbloquear todas las funcionalidades. Consulta Verificar teléfono.