Sconti

​

Cosa sono i codici sconto?

​

Vantaggi principali

• Sconti flessibili: sconti basati su percentuale o su importo fisso
• Codici cumulabili: applica fino a 20 codici per checkout, pagamento o abbonamento
• Controllo mirato: limita per prodotto, cicli di abbonamento e idoneità del cliente
• Gestione delle campagne: date di inizio programmate, date di scadenza, limiti di utilizzo complessivi e per cliente
• Prezzi per valuta: imposta la detrazione fissa, il limite massimo e il subtotale minimo per ogni valuta

​

Creazione di codici sconto

​

Configurazione nella Dashboard

• Nome dello sconto (obbligatorio): Etichetta interna per la dashboard.
• Codice (obbligatorio): La stringa che i clienti inseriscono al checkout. Genera un codice casuale o inseriscine uno personalizzato (minimo 3 caratteri, convertito automaticamente in maiuscolo).
• Tipo (obbligatorio): Percentuale (una percentuale di sconto) o Importo (una detrazione fissa).
• Importo (obbligatorio): Per la percentuale, la percentuale di sconto nella dashboard (ad esempio, 15 per il 15%). Tramite API, lo stesso valore è espresso in punti base (1500). Per l’importo, la detrazione fissa nella valuta predefinita del codice.
• Data di inizio (facoltativo): Pianifica l’attivazione del codice per una data futura. Lascia vuoto per attivarlo immediatamente.
• Data di scadenza (facoltativo): Data dopo la quale il codice non sarà più utilizzabile.
• Limite di utilizzo (facoltativo, in Avanzate): Numero massimo totale di utilizzi da parte di tutti i clienti. Un carrello con più abbonamenti conta come un unico utilizzo.
• Limite di utilizzo per cliente (facoltativo, in Avanzate): Numero massimo di utilizzi da parte di un singolo cliente. Se entrambi sono impostati, deve essere minore o uguale al limite di utilizzo complessivo.
• Idoneità del cliente (facoltativo): Limita chi può utilizzare il codice — tutti i clienti, i clienti al primo acquisto, i clienti esistenti o un elenco selezionato manualmente.
• Opzioni di valuta (facoltativo): L’importo dello sconto per ogni valuta in cui vendi. Consulta Opzioni per valuta.
• Limitazione del prodotto (facoltativo): Limita il codice a prodotti specifici.
• Limite del ciclo di abbonamento (facoltativo, in Avanzate): Numero di cicli di fatturazione per i quali si applica lo sconto. Lascia vuoto per una durata indefinita.
• Mantieni al cambio di piano (facoltativo): Mantiene attivo lo sconto quando un abbonamento cambia piano (preserve_on_plan_change).
• Metadati (facoltativo): Aggiungi coppie chiave-valore personalizzate per il monitoraggio interno.
• Richiedi un valore minimo dell’ordine (facoltativo, in Avanzate): Subtotale minimo del carrello (per valuta) affinché il codice venga applicato.

​

Tipi di sconto

​

Idoneità del cliente

​

Opzioni per valuta

• Importo — per uno sconto di tipo Importo, la detrazione fissa in quella valuta; per uno sconto Percentuale, il limite massimo dello sconto. Nell’API corrisponde a max_amount_possible.
• Predefinita — indica una valuta come predefinita. Le valute non configurate vengono convertite a partire da quella predefinita.

• Subtotale minimo — il codice viene applicato solo quando il carrello raggiunge questo subtotale nella valuta indicata. 0 indica che non è previsto alcun minimo.

​

Esperienza di checkout

​

Combinazione di codici sconto

const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'pdt_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 concordati per determinati set di prodotti
• Strategie di fidelizzazione: Codici per riconquistare i clienti nei flussi di prevenzione del churn
• Campagne stagionali: Promozioni legate a festività o eventi

​

Esempi di integrazione

​

Crea uno sconto con metadati

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

​

Applica sconti nelle Checkout Sessions

const session = await client.checkoutSessions.create({
  product_cart: [
    { product_id: 'pdt_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'
});

​

Applica sconti durante i cambi di piano

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

​

Nascondi il campo del codice sconto

const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'pdt_abc', quantity: 1 }],
  feature_flags: {
    allow_discount_code: false
  },
  return_url: 'https://yoursite.com/return'
});

​

Best practice

• Scegli nomi chiari: Usa codici riconoscibili e coerenti con i nomi delle campagne.
• Limita la durata: Aggiungi date di scadenza per creare urgenza e prevenire abusi.
• Definisci l’ambito con criterio: Limita gli sconti a prodotti specifici per evitare perdite di margine.
• Convalida in anticipo: Verifica l’applicabilità del codice prima di confermare il checkout.
• Monitora l’impatto: Tieni traccia di utilizzi e conversioni per campagna.