Sconti

​

Cosa sono i codici sconto?

• 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: sconti percentuali o di importo fisso
• Codici cumulabili: applica fino a 20 codici per checkout, pagamento o abbonamento — combina campagne (ad es. WELCOME10 + BLACKFRIDAY20) senza creare codici personalizzati
• Controllo mirato: limita per prodotto, cicli di abbonamento e idoneità del cliente
• Gestione delle campagne: date di inizio pianificate, date di scadenza e limiti di utilizzo complessivi e per cliente
• Prezzi per valuta: imposta la detrazione fissa, il limite massimo dell’importo e il subtotale minimo per valuta
• Checkout senza interruzioni: supporto per campo UI e API tramite sessioni di checkout

​

Creazione di codici sconto

​

Configurazione della dashboard

• Discount Name (obbligatorio): nome interno e nome visualizzato nella dashboard
• Code (obbligatorio): stringa inserita dai clienti al checkout, oppure genera un codice casuale utilizzando il pulsante fornito
• Type (obbligatorio): scegli Percentage (una percentuale di sconto) o Amount (una detrazione fissa)
• Amount (obbligatorio): valore percentuale oppure importo fisso per uno sconto di tipo Amount
• Start Date (facoltativo): pianifica l’attivazione successiva del codice; lascia vuoto per attivarlo immediatamente
• Expiration Date (facoltativo): data dopo la quale il codice diventa non valido
• Usage Limit (facoltativo): numero massimo di utilizzi complessivi per tutti i clienti
• Per-Customer Usage Limit (facoltativo): numero massimo di utilizzi da parte di un singolo cliente. Se entrambi sono impostati, deve essere minore o uguale al limite di utilizzo complessivo
• Customer Eligibility (facoltativo): limita chi può utilizzare il codice — tutti i clienti, i clienti al primo acquisto, i clienti esistenti oppure un elenco selezionato manualmente
• Currency Options (facoltativo): valori per valuta — consulta Opzioni per valuta
• Product Restriction (facoltativo): limita l’applicabilità ai prodotti selezionati
• Subscription Cycle Limit (facoltativo): numero di cicli di fatturazione a cui si applica lo sconto
• Preserve on Plan Change (facoltativo): mantiene attivo lo sconto quando cambia il piano dell’abbonamento (preserve_on_plan_change)
• Metadata (facoltativo): associa coppie chiave–valore personalizzate per il monitoraggio interno o le integrazioni

​

Tipi di sconto

​

Idoneità del cliente

​

Opzioni per valuta

• Amount — per uno sconto di tipo Amount è la detrazione stessa; per uno sconto Percentage limita l’importo massimo che il codice può detrarre. Tramite l’API corrisponde a max_amount_possible.
• Subtotale minimo — il codice si applica solo quando il carrello raggiunge questo subtotale. 0 significa nessun minimo.
• Predefinito — una voce può essere contrassegnata come predefinita, da cui vengono convertite le altre valute non configurate.

​

Esperienza di checkout

1. I clienti inseriscono il codice nel campo del checkout.
2. Gli sconti idonei vengono applicati e i totali si aggiornano immediatamente.

​

Accumulo dei codici sconto

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

​

Gestione tramite API

​

Casi d’uso comuni

• Offerte introduttive: promozioni di lancio a tempo limitato per nuovi prodotti
• Vendite all’ingrosso o B2B: sconti contrattuali per selezioni di prodotti
• Fidelizzazione: codici di recupero nei flussi di prevenzione del churn
• Campagne stagionali: promozioni legate a festività o eventi

​

Esempi di integrazione

​

Creare uno sconto con metadati

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

​

Applicare sconti nelle sessioni di checkout

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

​

Applicare sconti durante i cambi di piano

await client.subscriptions.changePlan('sub_123', {
  product_id: 'prod_pro',
  quantity: 1,
  proration_billing_mode: 'prorated_immediately',
  discount_codes: ['UPGRADE20']
});

​

Abilitare l’inserimento dello sconto senza applicarlo 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'
});

​

Best practice

• Nomi chiari: utilizza codici riconoscibili che corrispondano ai nomi delle campagne
• Limita nel tempo: aggiungi date di scadenza per creare urgenza e prevenire abusi
• Definisci l’ambito con criterio: limita ai prodotti specifici per evitare erosioni dei margini
• Convalida in anticipo: verifica l’applicabilità del codice prima di confermare il checkout
• Monitora l’impatto: monitora l’utilizzo e la conversione per campagna