Vai al contenuto principale
Discount codes overview cover
I codici sconto ti permettono di gestire promozioni e incentivi mirati. Crea sconti percentuali o a importo fisso, imposta limiti e scadenze, restringi a prodotti specifici e applicali senza problemi al checkout.

Checkout Sessions

Applica i codici durante il checkout ospitato con discount_code e controlli UI.

Validate Discount

Verifica se uno sconto è valido tramite il suo ID.

Get Discount by Code

Cerca e convalida uno sconto usando il suo nome di codice (es. “SAVE20”).

Create Discount (API)

Crea programmaticamente nuovi codici sconto.

List & Update Discounts

Sfoglia e gestisci gli sconti esistenti; aggiorna o elimina secondo necessità.

Plan Change Discounts

Applica i codici sconto quando si aggiornano o si modificano i piani di abbonamento.

​
Cosa sono i codici sconto?

I codici sconto sono token promozionali che riducono i totali degli ordini al checkout. Sono ideali per:
  • Campagne stagionali: Black Friday, lanci di prodotti o anniversari
  • Offerte di acquisizione: Incentivi per il primo acquisto o premi di referenza
  • Retention: Premi di riconquista o fedeltà per i clienti esistenti
  • Offerte B2B: Prezzi contrattati o negoziati tramite codici privati

​
Vantaggi principali

  • Sconti flessibili: Percentuale o importo fisso
  • Controllo mirato: Restrizioni per prodotto e cicli di abbonamento
  • Governance della campagna: Date di scadenza e limiti di utilizzo
  • Checkout senza problemi: Campo UI e supporto API tramite sessioni di checkout

​
Creazione di codici sconto

Crea codici sconto nel tuo dashboard di Dodo Payments, quindi applicali nel checkout ospitato o tramite API.

​
Configurazione del dashboard

  • Nome sconto (obbligatorio): Nome di visualizzazione interno e nel dashboard
  • Codice (obbligatorio): La stringa che i clienti inseriscono al checkout
  • Tipo e importo (obbligatorio): Imposta un valore in percentuale o a importo fisso, oppure genera un codice casuale usando il pulsante fornito
  • Data di scadenza (opzionale): Data dopo la quale il codice diventa invalido
  • Limite di utilizzo (opzionale): Massimo di riscatti totali tra tutti i clienti
  • Restrizione del prodotto (opzionale): Limita l’applicabilità a prodotti selezionati
  • Limite del ciclo di abbonamento (opzionale): Numero di cicli di fatturazione a cui si applica lo sconto
Usa i limiti dei cicli per prezzi introduttivi sugli abbonamenti (ad es., “50% di sconto per 3 mesi”).

​
Esperienza di checkout

  1. Gli acquirenti inseriscono il codice nel campo del checkout.
  2. Gli sconti idonei vengono applicati e i totali si aggiornano immediatamente.
Nelle sessioni di checkout, passa discount_code per pre‑applicare un codice e imposta feature_flags.allow_discount_code per mostrare il campo di input.

​
Gestione API

Crea codici sconto programmaticamente con tipo e importo.

API Reference

Visualizza l’API crea sconto.
Elenca tutti gli sconti o recupera i dettagli per la gestione e la verifica.

API Reference

Sfoglia le API di elenco e recupero.
Cerca uno sconto usando il suo codice leggibile (ad es., “SAVE20”) invece dell’ID interno.

API Reference

Recupera lo sconto per nome codice.
Modifica la configurazione dello sconto come importo, scadenza o restrizioni.

API Reference

Scopri come aggiornare i dettagli dello sconto.
Verifica se uno sconto è valido e applicabile prima di applicarlo.

API Reference

Convalida l’utilizzo dello sconto.
Disattiva o rimuovi gli sconti che non sono più necessari.

API Reference

Elimina uno sconto.

​
Casi d’uso comuni

  • Offerte introduttive: Promozioni di lancio a tempo limitato per nuovi prodotti
  • Sconti di massa o B2B: Sconti contrattati per set di prodotti selezionati
  • Strategie di retention: Codici di riconquista nei flussi di prevenzione del churn
  • Campagne stagionali: Promozioni basate su festività o eventi

​
Esempi di integrazione

​
Applicare uno sconto nelle sessioni di checkout

Pre‑applica uno sconto e mostra l’interfaccia di input del codice. 
const session = await client.checkoutSessions.create({
  product_cart: [
    { product_id: 'prod_abc', quantity: 1 }
  ],
  discount_code: 'BLACKFRIDAY2024',
  customer: { email: 'user@example.com', name: 'Jane Doe' },
  return_url: 'https://yoursite.com/return'
});

​
Applicare uno sconto durante le modifiche del piano

Offri prezzi promozionali quando i clienti aggiornano o declassano il loro abbonamento. 
await client.subscriptions.changePlan('sub_123', {
  product_id: 'prod_pro',
  quantity: 1,
  proration_billing_mode: 'prorated_immediately',
  discount_code: 'UPGRADE20'
});
Se l’abbonamento ha già uno sconto con preserve_on_plan_change=true e non passi un nuovo codice, lo sconto esistente viene automaticamente preservato se applicabile al nuovo prodotto.

​
Abilitare l’inserimento di sconti senza pre‑applicazione

Consenti ai clienti di inserire un codice al checkout senza passarne uno in anticipo. 
const session = await client.checkoutSessions.create({
  product_cart: [
    { product_id: 'prod_abc', quantity: 1 }
  ],
  feature_flags: {
    allow_discount_code: true
  },
  return_url: 'https://yoursite.com/return'
});

​
Migliori pratiche

  • Nome chiaro: Usa codici riconoscibili che corrispondono ai nomi delle campagne
  • Tempo limitato: Aggiungi scadenze per creare urgenza e prevenire abusi
  • Ambito saggio: Limita a prodotti specifici per evitare perdite di margine
  • Convalida precoce: Verifica l’applicabilità del codice prima di confermare il checkout
  • Monitora l’impatto: Traccia uso e conversione per campagna
I codici sconto sono potenti leve per acquisizione e retention. Inizia con offerte semplici e ben denominate, convalida accuratamente e iterai in base alle prestazioni.
Last modified on March 24, 2026