# Coupon

> Codici sconto in percentuale o a importo fisso, per il primo addebito, per sempre o per N mesi, con validità, limite di utilizzi e prodotti applicabili. Come entra lo sconto nel checkout e nei rinnovi, e i messaggi che l'acquirente può vedere.

Un **coupon** è un codice che l'acquirente digita al pagamento per ottenere uno sconto: **LANCAMENTO20**, **BEMVINDO10**, **ALUNO2026**. Serve per lanci, partnership, campagne e per recuperare chi ha rinunciato.

## A cosa serve

| Community | Coupon | Cosa fa |
|---|---|---|
| Scuola online | `LANCAMENTO20` | 20% sulla prima mensilità del piano Studente, fino a 100 utilizzi |
| Coworking | `PARCEIRO30` | R$ 30 al mese nei primi 3 mesi del piano Residente, solo per il partner |
| SaaS | `ANUAL10` | 10% per sempre, solo sulle opzioni annuali |
| Evento | `GRUPO15` | 15% sul biglietto, valido fino al giorno prima |

## Come funziona

### Tipi

| Tipo | Sconto | Esempio |
|---|---|---|
| **Percentuale** | Una percentuale dell'importo | 20% di R$ 129 = R$ 25,80 |
| **Importo Fisso** | Un importo in reais, per ordine | R$ 30 di sconto |
| **Prova Gratuita** | Giorni extra di prova | +7 giorni di prova |

### Durata (per gli abbonamenti)

| Durata | Sullo schermo | Lo sconto vale |
|---|---|---|
| **una volta** | *Sconto applicato solo al primo pagamento* | Solo sul primo addebito |
| **per sempre** | *Sconto applicato a tutti i pagamenti* | Su tutti gli addebiti, rinnovi compresi |
| **ripetuto** | *Sconto applicato per N mesi* | Sui primi N addebiti |

Su un prodotto venduto una volta sola, la durata non fa differenza: l'addebito è uno solo.

### Limiti

| Campo | A cosa serve |
|---|---|
| **Data di Inizio** \* | Da quando vale il codice |
| **Data di Fine** | Fino a quando. Se vuota, non scade |
| **Massimo Utilizzi** | Quante volte in totale si può usare il codice. Se vuoto, illimitato |
| **Massimo per Utente** | Quante volte la stessa persona può usarlo |
| **Prodotti Applicabili** | Su quali prodotti e opzioni vale. Vuoto: su tutti |

Tramite l'API, un coupon accetta anche: importo minimo dell'ordine, sconto massimo, solo sul primo acquisto nella community, solo per abbonamenti, solo per acquisti singoli, prodotti esclusi e se si può combinare con un altro coupon.

### Come entra lo sconto nel pagamento

1. Nel checkout, l'acquirente fa clic su **Ho un coupon**, digita il codice e fa clic su **Applica**. La schermata mostra *"Coupon LANCAMENTO20 applicato · −R$ 25,80"* e la durata (*"Sconto solo sul primo addebito."*).
2. Lo sconto si calcola **prima della commissione**: la commissione della piattaforma si applica all'importo già scontato.
3. In un ordine con piano e componenti aggiuntivi, un coupon a **importo fisso** si sottrae **una volta dall'ordine**, ripartito tra gli articoli in proporzione al valore di ciascuno; una **percentuale** vale allo stesso modo su ogni articolo a cui si applica.
4. Nessun articolo può scendere sotto **R$ 1,00** dopo lo sconto.
5. L'utilizzo viene registrato **quando il pagamento è confermato**. Un ordine aperto (un boleto non ancora pagato, per esempio) trattiene un utilizzo per un massimo di 7 giorni.
6. Nei rinnovi, i coupon **per sempre** e **ripetuto** continuano a valere per il tempo previsto.
7. Con un [downsell](/monetizacao/downsell), prima si applica lo sconto del downsell, poi quello del coupon.

Il tipo **Prova Gratuita** non è accettato al pagamento (*"Questo tipo di coupon non può essere usato al pagamento"*).

### Stato

L'elenco mostra ogni coupon con utilizzi, validità e stato:

| Stato | Significato |
|---|---|
| **Attivo** | Vale |
| **Inattivo** | Messo in pausa da te |
| **Scaduto** | Ha superato la data di fine |
| **Esaurito** | Ha raggiunto il massimo di utilizzi |

### Chi può

Creare, modificare, mettere in pausa ed eliminare: **proprietario** e **admin**. **Finanza** vede i coupon e lo storico di utilizzo.

## Passo per passo: creare un coupon

*Ruolo: proprietario o admin.*

1. **Monetizzazione › Coupon › Crea Coupon**.
2. **Codice** \*: quello che digita il cliente (es.: `LANCAMENTO20`). Unico nella community.
3. **Nome** \*: per il team (es.: *Lancio di marzo — 20%*).
4. **Tipo** \* e **Valore dello Sconto** \*.
5. **Durata** \*: una volta, per sempre o ripetuto (con i **Mesi**).
6. **Data di Inizio** \* e, se vuoi, **Data di Fine**.
7. **Massimo Utilizzi** e **Massimo per Utente**, se vuoi porre un limite.
8. In **Prodotti Applicabili**, seleziona dove vale, oppure lascia vuoto perché valga su tutto.
9. **Crea**.

![Crea Coupon](/screens/cupom-novo.png "Codice, nome, tipo, valore, durata, validità, limiti e prodotti applicabili (interfaccia in portoghese).")

Per metterlo in pausa, passa lo stato a **Inattivo**. Eliminare un coupon già usato incide sui report: la schermata avvisa quante volte è stato usato.

## Esempi con i numeri

La commissione della piattaforma è 6,99% + R$ 2,49 sull'importo addebitato, già scontato.

**`LANCAMENTO20`: 20% una volta, sul Growth Mensile (R$ 129).**
Prima mensilità: R$ 129,00 − R$ 25,80 = **R$ 103,20**. Commissione: R$ 7,21 + R$ 2,49 = R$ 9,70. Restano R$ 93,50. Dalla seconda in poi, R$ 129,00.

**`ANUAL10`: 10% per sempre, sullo Studente Mensile (R$ 49).**
Ogni mese: **R$ 44,10**. Commissione: R$ 3,08 + R$ 2,49 = R$ 5,57. Restano R$ 38,53 al mese, finché dura l'abbonamento.

**`PARCEIRO30`: R$ 30 ripetuto per 3 mesi, sul Residente (R$ 890).**
Mesi da 1 a 3: **R$ 860,00**. Dal quarto in poi: R$ 890,00.

**R$ 50 a importo fisso su un ordine di piano + componente aggiuntivo (R$ 129 + R$ 450 = R$ 579).**
Lo sconto è di R$ 50 sull'ordine, ripartito in proporzione: R$ 11,14 sul piano e R$ 38,86 sul componente aggiuntivo. Totale: **R$ 529,00**.

**R$ 100 a importo fisso su un piano da R$ 49.**
Rifiutato: l'articolo scenderebbe sotto R$ 1,00.

## Buone pratiche

- **Un codice per campagna.** `INSTAGRAM20` e `NEWSLETTER20` con lo stesso sconto mostrano da dove arriva ogni vendita, grazie alla colonna **Utilizzi**.
- **Sempre con una data di fine** nelle campagne: un coupon dimenticato diventa uno sconto per sempre.
- **Massimo Utilizzi** nelle partnership, perché un codice trapelato non diventi la regola.
- **Preferisci "una volta" o "ripetuto"** a "per sempre": il "per sempre" riduce ogni rinnovo finché la persona resta.
- **Prova prima di pubblicizzare**: applica il codice nel checkout con un account da membro e controlla il totale.

## Messaggi che l'acquirente può vedere

| Messaggio | Perché |
|---|---|
| *Codice coupon non valido* | Il codice non esiste |
| *Il coupon è scaduto* | Ha superato la data di fine |
| *Il coupon non è ancora valido* | Prima della data di inizio |
| *Questo coupon non è attivo* | È in pausa |
| *Il limite di utilizzo del coupon è stato raggiunto* | Esaurito |
| *Hai già usato questo coupon il numero di volte consentito* | Massimo per utente |
| *Questo coupon non vale per questo prodotto* | Il prodotto non è tra quelli applicabili |
| *Questo coupon vale per ordini a partire da R$ X* | Importo minimo |
| *Questo coupon vale solo per il primo acquisto in questa community* | Limitazione al primo acquisto |
| *Con questo coupon un articolo costerebbe meno di R$ 1,00, il minimo addebitabile* | Sconto superiore al prezzo |
| *Troppi codici coupon non validi. Riprova tra qualche minuto.* | 10 codici rifiutati in 15 minuti |
| *Il coupon non è più valido ed è stato rimosso. Non è stato addebitato nulla; controlla il nuovo totale e riprova.* | Il coupon è scaduto o si è esaurito tra l'applicazione e il pagamento |

## Errori comuni nella creazione

| Messaggio | Cosa fare |
|---|---|
| *Esiste già un coupon con questo codice in questa community* | Usa un altro codice |
| *Indica per quanti mesi vale il coupon ricorrente* | Con **ripetuto**, compila i **Mesi** |
| *I giorni extra di prova valgono solo per i coupon di prova gratuita* | Togli i giorni extra, oppure cambia tipo |

## Domande frequenti

**Il coupon vale al rinnovo?**
I coupon **per sempre** e **ripetuto**, sì, per il tempo previsto. **Una volta**, solo sul primo addebito.

**Si possono usare due coupon?**
Solo se entrambi sono combinabili. Per impostazione predefinita, un coupon per ordine.

**Il coupon riduce la commissione della piattaforma?**
La commissione si calcola sull'importo scontato: un prezzo più basso significa anche una commissione più bassa in reais.

**Il membro può usare un coupon quando aggiunge un'estensione in seguito, da Fatturazione?**
Per ora no; il coupon vale nell'acquisto del piano e nell'offerta di ultima occasione.

**Come so quante volte è stato usato un coupon?**
Nella colonna **Utilizzi** dell'elenco, e nello storico di utilizzo del coupon.

## Nell'API

`POST /api/coupons`, `PUT .../coupons/{id}`, `PATCH .../coupons/{id}/status`, `GET .../coupons/{id}/usage` e `POST .../coupons/validate` (`code`, `productId`, `amount`). Nel checkout, `couponCode` in `POST /api/checkout/calculate-price` e in `POST /api/checkout`. Vedi [Coupons](/api/referencia/coupons).

## Correlati

- [Downsell](/monetizacao/downsell)
- [Checkout](/pagamentos/checkout)
- [Commissione della piattaforma](/pagamentos/taxa-da-plataforma)