Borrar la cuenta
Dar de baja la cuenta del cliente con un código de confirmación que se envía por correo o por SMS.
Cómo funciona
- Pide el código de borrado con
send. - El cliente recibe un código de 6 cifras por correo o, si no tiene correo, por SMS.
- Confirma el borrado enviando ese código a
verify.
El código:
- vale 3 minutos desde que se pide con
send; - solo sirve para borrar la cuenta: los de otras operaciones no valen aquí;
- admite 6 intentos fallidos; en el séptimo, la solicitud se anula y hay que pedir otra.
Pedir el código
POST /api/v1/ecommerce/delete-account/send-code/{sends}
| Parámetro | Dónde | Valores |
|---|---|---|
sends |
Ruta | send para pedirlo, resend para reenviarlo |
No lleva cuerpo.
sendcrea una solicitud nueva con un código nuevo.resendreenvía otro código para la solicitud existente. Hay que esperar 30 segundos desde el último envío, y no amplía los 3 minutos de validez: si ya pasaron, usasend.
Respuesta
{ "success": true, "message": "Código enviado de forma correcta.", "data": null }
Si algo sale mal
| HTTP | code | Cuándo | Qué hacer |
|---|---|---|---|
| 404 | VERIFICATION_NOT_FOUND |
Se usó resend sin haber pedido antes el código |
Usa send |
| 429 | RESEND_TOO_SOON |
Se usó resend antes de 30 segundos |
Espera y vuelve a intentarlo |
| 422 | COUNTRY_INVALID |
El código va por SMS y 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 |
| 404 | NOT_FOUND |
sends no es send ni resend |
Usa uno de los dos |
| 500 | INTERNAL_ERROR |
No se pudo enviar el mensaje, o la cuenta no tiene ni correo ni teléfono | Reporta la reference |
Confirmar el borrado
POST /api/v1/ecommerce/delete-account/verify
Cuerpo
| Campo | Tipo | Obligatorio | Reglas |
|---|---|---|---|
code |
texto | Sí | Exactamente 6 cifras |
{ "code": "482913" }
Respuesta
{ "success": true, "message": "Cuenta eliminada de forma correcta.", "data": null }
Qué se borra
- La cuenta del cliente, de forma definitiva.
- Sus tarjetas, destinatarios y valoraciones de productos.
- Los pedidos se conservan en el ERP, pero dejan de estar ligados al cliente.
- Sus direcciones, datos de facturación y favoritos, incluidos los que ya había quitado desde la tienda. La base los borra junto con la cuenta.
Después del borrado el token deja de valer: cualquier llamada responde 401 TOKEN_INVALID.
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 ninguna solicitud de borrado | Pide el código con send |
| 422 | VERIFICATION_CODE_INVALID |
El código es incorrecto. Gasta un intento | Revisa el código |
| 422 | VERIFICATION_EXPIRED |
Pasaron los 3 minutos | Pide un código nuevo con send |
| 422 | VERIFICATION_TOO_MANY_ATTEMPTS |
Se agotaron los intentos | Pide un código nuevo con send |
| 409 | ACCOUNT_HAS_RECORDS |
La cuenta tiene datos en la empresa que impiden borrarla | El cliente debe contactar con la tienda |