Vai al contenuto principale
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.

Sessioni di Checkout

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

Valida Sconto

Controlla se un codice è valido e applicabile prima di applicarlo.

Crea Sconto (API)

Crea programmaticamente nuovi codici sconto.

Elenca & Aggiorna Sconti

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

​
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 per referral
  • Fidelizzazione: Premi per il recupero o la fedeltà dei clienti esistenti
  • Offerte B2B: Prezzi contrattati o negoziati tramite codici privati

​
Vantaggi Chiave

  • Sconti flessibili: Percentuale o importo fisso di sconto
  • Controllo mirato: Restrizioni per prodotto e cicli di abbonamento
  • Governance delle campagne: Date di scadenza e limiti di utilizzo
  • Checkout senza soluzione di continuità: Supporto per campo UI e 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 interno e di visualizzazione nel dashboard
  • Codice (obbligatorio): La stringa che i clienti inseriscono al checkout
  • Tipo & Importo (obbligatorio): Imposta un valore percentuale o a importo fisso, oppure genera un codice casuale utilizzando il pulsante fornito
  • Data di Scadenza (opzionale): Data dopo la quale il codice diventa non valido
  • Limite di Utilizzo (opzionale): Numero massimo di riscatti totali per tutti i clienti
  • Restrizione Prodotto (opzionale): Limita l’applicabilità a prodotti selezionati
  • Limite Ciclo di Abbonamento (opzionale): Numero di cicli di fatturazione a cui si applica lo sconto
Utilizza i limiti di ciclo per prezzi introduttivi sugli abbonamenti (ad es., “50% di sconto per 3 mesi”).

​
Esperienza di Checkout

  1. Gli acquirenti inseriscono il codice nel campo di 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.

Riferimento API

Visualizza l’API per la creazione di sconti.
Elenca tutti gli sconti o recupera dettagli per gestione e auditing.

Riferimento API

Sfoglia le API di elenco e recupero.
Modifica la configurazione dello sconto come importo, scadenza o restrizioni.

Riferimento API

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

Riferimento API

Valida l’uso dello sconto.
Disattiva o rimuovi sconti che non sono più necessari.

Riferimento API

Elimina uno sconto.

​
Casi d’Uso Comuni

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

​
Esempi di Integrazione

​
Applica uno sconto nelle Sessioni di Checkout

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

​
Abilita l’inserimento dello sconto 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

  • Nomina chiaramente: Usa codici riconoscibili che corrispondano ai nomi delle campagne
  • Limita nel tempo: Aggiungi scadenze per creare urgenza e prevenire abusi
  • Limita saggiamente: Limita a prodotti specifici per evitare perdite di margine
  • Valida in anticipo: Controlla l’applicabilità del codice prima di confermare il checkout
  • Monitora l’impatto: Tieni traccia dell’uso e della conversione per campagna
I codici sconto sono potenti leve per l’acquisizione e la fidelizzazione. Inizia con offerte semplici e ben nominate, valida a fondo e itera in base alle prestazioni.