Verificar la cuenta

Cómo funciona

1. Pide el código con send-verification-code.
2. El cliente recibe un código de 6 cifras por correo o por SMS.
3. Confírmalo con validate-verification-code.

El código:

• vale 30 minutos;
• admite 3 intentos fallidos; en el cuarto, la solicitud se anula y hay que pedir otro código;
• se puede reenviar con reenviar el código, esperando 30 segundos entre envíos.

Las dos rutas piden el token del cliente y admiten 10 peticiones por minuto.

Parámetro	Dónde	Valores
type	Ruta	email para el correo, phone para el teléfono

Pedir el código

POST /api/v1/ecommerce/send-verification-code/{type}

No lleva cuerpo. El código se envía al correo o al teléfono que el cliente tiene en su cuenta. Cada llamada anula el código anterior y genera uno nuevo.

{
  "success": true,
  "message": "Se ha enviado un código a la siguiente cuenta de correo electrónico [email protected], revise y siga las instrucciones por favor.",
  "data": null
}

Si algo sale mal

HTTP	code	Cuándo	Qué hacer
400	BAD_REQUEST	type no es email ni phone	Usa uno de los dos
409	ACCOUNT_ALREADY_VERIFIED	El correo y el teléfono ya están verificados	Nada
409	EMAIL_ALREADY_VERIFIED	El correo ya está verificado	Nada
409	PHONE_ALREADY_VERIFIED	El teléfono ya está verificado	Nada
422	PHONE_NOT_REGISTERED	Se pidió por teléfono y la cuenta no tiene teléfono	Pide al cliente que lo añada en su perfil
422	COUNTRY_INVALID	El país del cliente no es válido	Corrige el país en el perfil
422	COUNTRY_PHONE_CODE_MISSING	El país no tiene prefijo telefónico configurado	Avisa a la tienda
500	INTERNAL_ERROR	No se pudo enviar el correo o el SMS	Reintenta. Si se repite, reporta la reference

Confirmar el código

POST /api/v1/ecommerce/validate-verification-code/{type}

Cuerpo

Campo	Tipo	Obligatorio	Reglas
code	texto	Sí	Exactamente 6 cifras

{ "code": "482913" }

Respuesta

{ "success": true, "message": "El correo electrónico se ha validado de forma correcta.", "data": null }

Si algo sale mal

HTTP	code	Cuándo	Qué hacer
422	VALIDATION_ERROR	Falta el código o no tiene 6 cifras. No gasta intento	Corrige el código
404	VERIFICATION_NOT_FOUND	No hay ningún código pedido	Pide el código
422	VERIFICATION_CODE_INVALID	El código es incorrecto. Gasta un intento	Revisa el código
422	VERIFICATION_EXPIRED	Pasaron los 30 minutos	Pide un código nuevo
422	VERIFICATION_TOO_MANY_ATTEMPTS	Se agotaron los 3 intentos	Pide un código nuevo
409	ACCOUNT_ALREADY_VERIFIED	El correo y el teléfono ya están verificados	Nada
422	PHONE_NOT_REGISTERED	Se pidió por teléfono y la cuenta no tiene teléfono	Pide al cliente que lo añada en su perfil