Coupon

Crea codici sconto che i clienti possono applicare al checkout. Percentuale o importo fisso, a tempo limitato o con un massimale, monouso o ricorrenti.

I coupon vengono gestiti nell’area Admin > Commerce > Products della tua app, nella sezione Coupons, e nella scheda Cupones del pannello di amministrazione della tua app pubblicata.

Struttura di un coupon

Campo	Note
code	Il codice promozionale che i clienti digitano al checkout (es. LAUNCH20)
percent_off o amount_off	Si escludono a vicenda. La percentuale va da 1 a 100. L’importo è espresso nella più piccola unità della valuta (centesimi).
currency	Obbligatorio per gli sconti amount_off (codice ISO a tre lettere). Accettato alla creazione e inoltrato a Stripe, ma non memorizzato né restituito dall’API in seguito.
duration	once (solo il primo pagamento), repeating (per duration_in_months), oppure forever
duration_in_months	Obbligatorio quando duration è repeating
max_redemptions	Limite totale di utilizzi su tutti i clienti
redeem_by	Data di scadenza dopo la quale il coupon smette di funzionare
name	Nome visualizzato ai clienti
active	Interruttore per abilitare/disabilitare senza eliminare

Creare un coupon

Dalla sotto-scheda Coupons, clicca su Add coupon e compila i campi. Alcuni esempi comuni:

Obiettivo	Impostazioni
20% di sconto per sempre	percent_off: 20, durata forever
$10 di sconto, monouso, scade in 30 giorni	amount_off: 1000, valuta USD, durata once, max utilizzi 1, scadenza tra 30 giorni
50% di sconto per i primi 3 mesi di un abbonamento	percent_off: 50, durata repeating, durata in mesi 3

Oppure chiedi all’AI: "Create a LAUNCH20 coupon for 20% off forever."

Applicare un coupon al checkout

I clienti possono usare un codice in due modi:

• Nella pagina di checkout di Stripe — il campo del codice promozionale viene mostrato automaticamente, quindi il cliente può digitare il codice lì senza alcuna configurazione da parte tua.
• Nel tuo carrello personalizzato — aggiungi un campo per il codice promozionale al tuo carrello e passa il valore digitato nella chiamata al checkout come couponCode. Il server valida il codice e calcola lo sconto dai tuoi dati di commerce (mai da un importo fornito dal browser), lo registra sull’ordine e associa il coupon Stripe corrispondente affinché l’addebito sia corretto.

Chiedi all’AI: "Add a promo code field to the cart and apply it at checkout."

Elenco, modifica e disattivazione

La sotto-scheda Coupons elenca tutti i coupon con il numero di volte in cui sono stati utilizzati rispetto al loro limite, così puoi monitorare le performance delle campagne a colpo d’occhio. La modifica è deliberatamente limitata — vedi di seguito — ma puoi disattivare qualsiasi coupon senza eliminarlo, il che lo rende immediatamente inutilizzabile al checkout.

Note e limitazioni

• I codici e gli importi di sconto sono immutabili. Puoi aggiornare il name visualizzato e il valore di active, ma non percent_off, amount_off o code stesso. Crea un nuovo coupon se hai bisogno di condizioni diverse.
• times_redeemed si incrementa automaticamente ed è in sola lettura — utile per monitorare le performance delle campagne.
• I coupon si applicano per cliente, non per ordine — se un coupon è forever e un cliente si abbona, ogni rinnovo riceve lo sconto.