Vai al contenuto principale
Copertina panoramica dei codici sconto
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 visualizzato internamente e nel dashboard
  • Codice (obbligatorio): La stringa che i clienti inseriscono al checkout
  • Tipo & Importo (obbligatorio): Imposta un valore in percentuale o importo fisso, o genera un codice casuale usando il pulsante fornito
  • Data di Scadenza (opzionale): Data dopo la quale il codice diventa invalido
  • Limite di Utilizzo (opzionale): Numero massimo di utilizzi totali da parte di tutti i clienti
  • Restrizione Prodotti (opzionale): Limita l’applicabilità ai prodotti selezionati
  • Limite Ciclo di Abbonamento (opzionale): Numero di cicli di fatturazione a cui si applica lo sconto
  • Metadata (opzionale): Allegare coppie chiave-valore personalizzate per il tracciamento interno o integrazioni
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

​
Crea uno sconto con metadata

Allega coppie chiave–valore personalizzate per il tracciamento interno. 
const discount = await client.discounts.create({
  type: 'percentage',
  amount: 1500, // 15%
  code: 'SUMMER2025',
  metadata: {
    campaign: 'summer_promo',
    source: 'email_blast'
  }
});
Usa i metadata per etichettare gli sconti per campagna, fonte o ID di riferimento interno in modo da poter riconciliare l’uso e misurare il ROI in seguito.

​
Applica uno sconto nelle Sessioni di Checkout

Applica anticipatamente uno sconto e mostra l’interfaccia di inserimento 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'
});

​
Applica uno sconto durante i cambiamenti di piano

Offri prezzi promozionali quando i clienti effettuano un upgrade o un downgrade del 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 si inserisce un nuovo codice, lo sconto esistente viene automaticamente mantenuto quando applicabile al nuovo prodotto.

​
Abilita l’inserimento del codice sconto senza applicazione anticipata

Permetti ai clienti di inserire un codice al checkout senza fornirlo 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'
});

​
Pratiche Migliori

  • Nomina chiaramente: Usa codici riconoscibili che corrispondano ai nomi delle campagne
  • Limita temporalmente: Aggiungi scadenze per generare urgenza e prevenire abusi
  • Definisci bene l’ambito: Limita a prodotti specifici per evitare perdite di margine
  • Valida precocemente: Verifica l’applicabilità del codice prima di confermare il checkout
  • Monitora l’impatto: Traccia l’uso e la conversione per campagna
I codici sconto sono potenti strumenti per l’acquisizione e la fidelizzazione. Inizia con offerte semplici e ben nominate, valida accuratamente e iterare in base alle prestazioni.
Last modified on April 20, 2026