# Cupones

> Códigos de descuento en porcentaje o en valor fijo, para el primer cobro, para siempre o durante N meses, con vigencia, límite de usos y productos aplicables. Cómo entra el descuento en el checkout y en las renovaciones, y los mensajes que puede ver el comprador.

Un **cupón** es un código que el comprador escribe al pagar para obtener un descuento: **LANCAMENTO20**, **BIENVENIDA10**, **ALUMNO2026**. Sirve para lanzamientos, colaboraciones, campañas y para recuperar a quien abandonó.

## Para qué sirve

| Comunidad | Cupón | Qué hace |
|---|---|---|
| Escuela online | `LANCAMENTO20` | 20 % en la primera mensualidad del plan Alumno, hasta 100 usos |
| Coworking | `PARCEIRO30` | R$ 30 al mes en los 3 primeros meses del plan Residente, solo para el socio |
| SaaS | `ANUAL10` | 10 % para siempre, solo en las opciones anuales |
| Evento | `GRUPO15` | 15 % en la entrada, válido hasta la víspera |

## Cómo funciona

### Tipos

| Tipo | Descuento | Ejemplo |
|---|---|---|
| **Porcentaje** | Un porcentaje del importe | 20 % de R$ 129 = R$ 25,80 |
| **Valor Fijo** | Un importe en reales, por pedido | R$ 30 de descuento |
| **Prueba Gratis** | Días extra de prueba | +7 días de prueba |

### Duración (para suscripciones)

| Duración | En la pantalla | El descuento vale |
|---|---|---|
| **una vez** | *Descuento aplicado solo en el primer pago* | Solo en el primer cobro |
| **para siempre** | *Descuento aplicado en todos los pagos* | En todos los cobros, incluidas las renovaciones |
| **recurrente** | *Descuento aplicado por N meses* | En los N primeros cobros |

En un producto que se vende una vez, la duración no importa: el cobro es uno solo.

### Límites

| Campo | Para qué |
|---|---|
| **Fecha de Inicio** \* | Desde cuándo vale el código |
| **Fecha de Fin** | Hasta cuándo. En blanco, no caduca |
| **Máximo de Usos** | Cuántas veces se puede usar el código en total. En blanco, ilimitado |
| **Máximo por Usuario** | Cuántas veces puede usarlo la misma persona |
| **Productos Aplicables** | En qué productos y opciones vale. Vacío: en todos |

Por la API, un cupón admite además: importe mínimo del pedido, descuento máximo, solo en la primera compra en la comunidad, solo para suscripciones, solo para compras únicas, productos excluidos y si se puede combinar con otro cupón.

### Cómo entra el descuento en el pago

1. En el checkout, el comprador hace clic en **Tengo un cupón**, escribe el código y hace clic en **Aplicar**. La pantalla muestra *"Cupón LANCAMENTO20 aplicado · −R$ 25,80"* y la duración (*"Descuento solo en el primer cobro."*).
2. El descuento se calcula **antes de la comisión**: la comisión de la plataforma se aplica sobre el importe ya con descuento.
3. En un pedido con plan y adicionales, un cupón de **valor fijo** se descuenta **una vez del pedido**, repartido entre los artículos en proporción al importe de cada uno; uno de **porcentaje** vale igual en cada artículo al que se aplica.
4. Ningún artículo puede quedar por debajo de **R$ 1,00** tras el descuento.
5. El uso se registra **cuando se confirma el pago**. Un pedido abierto (un boleto todavía sin pagar, por ejemplo) reserva un uso durante hasta 7 días.
6. En las renovaciones, los cupones **para siempre** y **recurrente** siguen valiendo durante el tiempo acordado.
7. Con un [downsell](/monetizacao/downsell), primero entra el descuento del downsell y después el del cupón.

El tipo **Prueba Gratis** no se acepta al pagar (*"Este tipo de cupón no se puede usar en el pago"*).

### Estado

La lista muestra cada cupón con sus usos, vigencia y estado:

| Estado | Significa |
|---|---|
| **Activo** | Vale |
| **Inactivo** | Pausado por ti |
| **Expirado** | Ha pasado la fecha de fin |
| **Agotado** | Ha alcanzado el máximo de usos |

### Quién puede

Crear, editar, pausar y eliminar: **propietario** y **administrador**. **Finanzas** ve los cupones y su historial de uso.

## Paso a paso: crear un cupón

*Rol: propietario o administrador.*

1. **Monetización › Cupones › Crear Cupón**.
2. **Código** \*: lo que escribe el cliente (ej.: `LANCAMENTO20`). Único en la comunidad.
3. **Nombre** \*: para el equipo (ej.: *Lanzamiento de marzo — 20 %*).
4. **Tipo** \* y **Valor del Descuento** \*.
5. **Duración** \*: una vez, para siempre o recurrente (con los **Meses**).
6. **Fecha de Inicio** \* y, si quieres, **Fecha de Fin**.
7. **Máximo de Usos** y **Máximo por Usuario**, si quieres limitarlo.
8. En **Productos Aplicables**, marca dónde vale, o déjalo vacío para que valga en todo.
9. **Crear**.

![Crear Cupón](/screens/cupom-novo.png "Código, nombre, tipo, valor, duración, vigencia, límites y productos aplicables (interfaz en portugués).")

Para pausarlo, cambia el estado a **Inactivo**. Eliminar un cupón que ya se ha usado afecta a los informes: la pantalla avisa de cuántas veces se usó.

## Ejemplos con números

La comisión de la plataforma es 6,99 % + R$ 2,49 sobre el importe cobrado, ya con el descuento.

**`LANCAMENTO20`: 20 % una vez, en Growth Mensual (R$ 129).**
Primera mensualidad: R$ 129,00 − R$ 25,80 = **R$ 103,20**. Comisión: R$ 7,21 + R$ 2,49 = R$ 9,70. Quedan R$ 93,50. De la segunda en adelante, R$ 129,00.

**`ANUAL10`: 10 % para siempre, en Alumno Mensual (R$ 49).**
Cada mes: **R$ 44,10**. Comisión: R$ 3,08 + R$ 2,49 = R$ 5,57. Quedan R$ 38,53 al mes, mientras dure la suscripción.

**`PARCEIRO30`: R$ 30 recurrente durante 3 meses, en Residente (R$ 890).**
Meses 1 a 3: **R$ 860,00**. Del cuarto en adelante: R$ 890,00.

**R$ 50 de valor fijo en un pedido de plan + adicional (R$ 129 + R$ 450 = R$ 579).**
El descuento es de R$ 50 en el pedido, repartido en proporción: R$ 11,14 en el plan y R$ 38,86 en el adicional. Total: **R$ 529,00**.

**R$ 100 de valor fijo en un plan de R$ 49.**
Rechazado: el artículo quedaría por debajo de R$ 1,00.

## Buenas prácticas

- **Un código por campaña.** `INSTAGRAM20` y `NEWSLETTER20` con el mismo descuento muestran de dónde vino cada venta, en la columna **Usos**.
- **Siempre con fecha de fin** en las campañas: un cupón olvidado se convierte en un descuento para siempre.
- **Máximo de Usos** en las colaboraciones, para que un código filtrado no se convierta en la norma.
- **Mejor "una vez" o "recurrente"** que "para siempre": el "para siempre" reduce cada renovación mientras la persona siga.
- **Pruébalo antes de difundirlo**: aplica el código en el checkout con una cuenta de miembro y revisa el total.

## Mensajes que puede ver el comprador

| Mensaje | Por qué |
|---|---|
| *Código de cupón no válido* | El código no existe |
| *El cupón ha expirado* | Ha pasado la fecha de fin |
| *El cupón aún no es válido* | Antes de la fecha de inicio |
| *Este cupón no está activo* | Está pausado |
| *Se ha alcanzado el límite de uso del cupón* | Agotado |
| *Ya has usado este cupón el número de veces permitido* | Máximo por usuario |
| *Este cupón no vale para este producto* | El producto no está entre los aplicables |
| *Este cupón vale para pedidos desde R$ X* | Importe mínimo |
| *Este cupón solo vale para la primera compra en esta comunidad* | Restricción de primera compra |
| *Con este cupón, un artículo quedaría por debajo de R$ 1,00, el mínimo que se puede cobrar* | Descuento mayor que el precio |
| *Demasiados intentos de cupón. Vuelve a intentarlo en unos minutos.* | 10 códigos rechazados en 15 minutos |
| *El cupón dejó de ser válido y se quitó. No se cobró nada; revisa el nuevo total e inténtalo de nuevo.* | El cupón caducó o se agotó entre aplicarlo y pagar |

## Errores comunes al crear

| Mensaje | Qué hacer |
|---|---|
| *Ya existe un cupón con este código en esta comunidad* | Usa otro código |
| *Indica durante cuántos meses vale el cupón recurrente* | Con **recurrente**, rellena los **Meses** |
| *Los días extra de prueba solo valen para cupones de prueba gratis* | Quita los días extra, o cambia el tipo |

## Preguntas frecuentes

**¿El cupón vale en la renovación?**
Los cupones **para siempre** y **recurrente**, sí, durante el tiempo acordado. **Una vez**, solo en el primer cobro.

**¿Se pueden usar dos cupones?**
Solo si los dos son combinables. Por defecto, un cupón por pedido.

**¿El cupón reduce la comisión de la plataforma?**
La comisión se calcula sobre el importe con descuento: un precio más bajo es también una comisión más baja en reales.

**¿Puede el miembro usar un cupón al sumar una extensión después, desde la Facturación?**
No, por ahora; el cupón vale en la compra del plan y en la oferta de última oportunidad.

**¿Cómo sé cuántas veces se ha usado un cupón?**
En la columna **Usos** de la lista, y en el historial de uso del cupón.

## En la API

`POST /api/coupons`, `PUT .../coupons/{id}`, `PATCH .../coupons/{id}/status`, `GET .../coupons/{id}/usage` y `POST .../coupons/validate` (`code`, `productId`, `amount`). En el checkout, `couponCode` en `POST /api/checkout/calculate-price` y en `POST /api/checkout`. Consulta [Coupons](/api/referencia/coupons).

## Relacionados

- [Downsell](/monetizacao/downsell)
- [Checkout](/pagamentos/checkout)
- [Comisión de la plataforma](/pagamentos/taxa-da-plataforma)