Sconti

Crea codici promozionali per aumentare le conversioni, gestire campagne e premiare i clienti con sconti fissi o percentuali su acquisti una tantum e in abbonamento.

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 uno o più codici impilati durante il checkout ospitato con discount_codes 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
• Codici impilabili: Applica fino a 20 codici per checkout, pagamento o abbonamento — combina campagne (ad es. WELCOME10 + BLACKFRIDAY20) senza creare codici su misura
• Controllo mirato: Restrizioni per prodotto e cicli di abbonamento
• Gestione delle campagne: 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_codes (un array) per pre-applicare uno o più codici, e imposta feature_flags.allow_discount_code per mostrare il campo di input. I codici vengono applicati nell’ordine dell’array, fino a un massimo di 20.

​

Impilamento dei Codici Sconto

Le sessioni di checkout, i pagamenti e gli abbonamenti accettano fino a 20 codici impilati tramite l’array discount_codes (massimo 20 voci). I codici vengono applicati nell’ordine dell’array, quindi il primo codice idoneo riduce per primo il prezzo base, il codice successivo riduce il prezzo già scontato e così via. L’insieme completo degli sconti applicati viene restituito nella risposta sotto discount_ids (su pagamenti/abbonamenti) e discounts (dettaglio più ricco per sconto, inclusa posizione e cicli di abbonamento rimanenti).

const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'prod_abc', quantity: 1 }],
  discount_codes: ['WELCOME10', 'BLACKFRIDAY20'], // applied in this order
  customer: { email: '[e-mail]' },
  return_url: 'https://yoursite.com/return'
});

Il campo singolare discount_code è deprecato ma ancora pienamente supportato per la compatibilità con le versioni precedenti — le integrazioni esistenti continuano a funzionare senza modifiche. Non può essere combinato con discount_codes nella stessa richiesta. Raccomandiamo di migrare a discount_codes (la forma array) quando conveniente, anche per singoli codici, per sfruttare l’impilamento e la forma di risposta più ricca.

​

Gestione API

Create discounts

Crea codici sconto programmaticamente con tipo e importo.

API Reference

Visualizza l’API per creare sconti.

List and retrieve

Elenca tutti gli sconti o recupera i dettagli per gestione e revisione.

API Reference

Sfoglia le API di elenco e recupero.

Get discount by code

Cerca uno sconto usando il suo codice leggibile dall’uomo (es. “SAVE20”) invece dell’ID interno.

API Reference

Recupera lo sconto tramite il nome del codice.

Update discounts

Modifica la configurazione dello sconto come importo, scadenza o restrizioni.

API Reference

Scopri come aggiornare i dettagli degli sconti.

Validate discounts

Verifica se uno sconto è valido e applicabile prima di applicarlo.

API Reference

Convalida l’uso dello sconto.

Delete discounts

Disattiva o rimuovi 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
• Bulk o B2B: Sconti contrattati per insiemi selezionati di prodotti
• Strategie di ritenzione: Codici per il recupero in flussi di prevenzione del churn
• Campagne stagionali: Promozioni basate su festività o eventi

​

Esempi di Integrazione

​

Crea uno sconto con metadati

Allega coppie chiave-valore personalizzate per la tracciabilità interna.

const discount = await client.discounts.create({
  type: 'percentage',
  amount: 1500, // 15%
  code: 'SUMMER2025',
  metadata: {
    campaign: 'summer_promo',
    source: 'email_blast'
  }
});

Usa i metadati per etichettare gli sconti per campagna, sorgente o ID di riferimento interno per poter conciliare l’utilizzo e misurare il ROI in seguito.

​

Applica sconti nelle Sessioni di Checkout

Pre-applica uno o più sconti impilati e mostra l’interfaccia di input del codice.

const session = await client.checkoutSessions.create({
  product_cart: [
    { product_id: 'prod_abc', quantity: 1 }
  ],
  discount_codes: ['BLACKFRIDAY2024', 'NEWUSER5'], // stacked in array order
  customer: { email: '[e-mail]', name: 'Jane Doe' },
  return_url: 'https://yoursite.com/return'
});

​

Applica sconti durante i cambi di 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_codes: ['UPGRADE20']
});

discount_codes value	Comportamento sul cambio di piano
undefined / null (non fornito)	Gli sconti esistenti con preserve_on_plan_change=true sono mantenuti se applicabili al nuovo prodotto.
[] (array vuoto)	Tutti gli sconti esistenti sono rimossi dall’abbonamento.
['CODE_A', 'CODE_B', ...]	Sostituisce eventuali sconti esistenti con questo set impilato, applicato nell’ordine dell’array.

Leggi tutti gli sconti applicati dall’abbonamento tramite il nuovo array discounts nella risposta dell’abbonamento. Ogni voce include discount_id, position, cycles_remaining (per abbonamenti), e il codice originale.

​

Abilita l’inserimento del codice senza pre-applicazione

Permetti ai clienti di inserire un codice al checkout senza passarlo 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

• Nomina chiaramente: Usa codici riconoscibili che corrispondano ai nomi delle campagne
• Limita nel tempo: Aggiungi scadenze per stimolare l’urgenza e prevenire usi impropri
• Definisci bene l’ambito: Limita a prodotti specifici per evitare la perdita di margine
• Convalida presto: 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 ritenzione. Inizia con offerte semplici e ben denominate, convalida accuratamente e sviluppa in base alle prestazioni.