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
- 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.").
- Lo sconto si calcola prima della commissione: la commissione della piattaforma si applica all'importo già scontato.
- 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.
- Nessun articolo può scendere sotto R$ 1,00 dopo lo sconto.
- 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.
- Nei rinnovi, i coupon per sempre e ripetuto continuano a valere per il tempo previsto.
- Con un 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.
- Monetizzazione › Coupon › Crea Coupon.
- Codice *: quello che digita il cliente (es.:
LANCAMENTO20). Unico nella community. - Nome *: per il team (es.: Lancio di marzo — 20%).
- Tipo * e Valore dello Sconto *.
- Durata *: una volta, per sempre o ripetuto (con i Mesi).
- Data di Inizio * e, se vuoi, Data di Fine.
- Massimo Utilizzi e Massimo per Utente, se vuoi porre un limite.
- In Prodotti Applicabili, seleziona dove vale, oppure lascia vuoto perché valga su tutto.
- Crea.

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.
INSTAGRAM20eNEWSLETTER20con 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.