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.

3 min de lecturaActualizado el 30 de setiembre de 2026

Cómo funciona

  1. Pide el código de borrado con send.
  2. El cliente recibe un código de 6 cifras por correo o, si no tiene correo, por SMS.
  3. 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.

  • send crea una solicitud nueva con un código nuevo.
  • resend reenví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, usa send.

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