Vista previa de cupón
VERANO25
−25%
OP-AUTO-X7K2
−10€
Tipos de descuento
% PorcentajeEj: 20% de descuento sobre el precio del plan
€ Importe fijoEj: 5€ de descuento directo sobre la factura
Código aleatorioEl sistema genera un código único automáticamente con prefijo
OP-AUTO-. Evita duplicados garantizados.Código personalizadoDefine tu propio código (ej: BLACKFRIDAY, VERANO25). El sistema valida que no exista ya.
Crear un cupón
1
Ve a la pestaña CuponesEn el panel admin, sección Cupones → botón «Nuevo cupón».
2
Elige tipo y valorSelecciona % o € y escribe el valor del descuento.
3
Define restriccionesFecha de expiración (opcional), usos máximos (opcional) y plan mínimo requerido para canjearlo.
4
Activa o desactivaPuedes pausar y reactivar cualquier cupón desde la lista sin necesidad de eliminarlo.
Opciones disponibles
Fecha de expiraciónOpcional. El cupón queda inválido automáticamente al llegar la fecha. Sin fecha = sin expiración.
Usos máximosOpcional. Limita cuántas veces puede canjearse el cupón en total (no por usuario). 0 = sin límite.
Plan requeridoOpcional. Solo los usuarios con ese plan o superior pueden validar el cupón. Útil para upgrades.
Activar / PausarToggle instantáneo para habilitar o deshabilitar el cupón sin borrarlo. Conserva el historial de usos.
Endpoints API
# Listar cupones (admin)
GET /admin/discount-codes
# Crear cupón
POST /admin/discount-codes
{
"codigo": "VERANO25",
"tipo": "percent",
"valor": 25,
"max_usos": 50,
"expira_en": "2025-07-31",
"plan_requerido": "premium"
}
# Activar/desactivar
PATCH /admin/discount-codes/{id}
{ "activo": false }
# Eliminar
DELETE /admin/discount-codes/{id}
# Validar código (usuario)
POST /validate-code
{ "codigo": "VERANO25" }
Info rápida
Router: discount_codes.py
Solo admin (crear)
% y € fijo
Modelo: DiscountCode