WWooshPayment docs
Marketing

Codici sconto

Crea codici sconto percentuale, valore fisso, BOGO o spedizione gratuita. Con regole avanzate per categoria, importo minimo, scadenza.

3 min di lettura

I codici sconto sono uno strumento conversione potente. WooshPayment supporta 4 tipologie con regole flessibili.

Tipologie disponibili

TipoEsempioDashboard label
Percentuale-15% su tuttoPERCENTAGE
Valore fisso-€10FIXED_AMOUNT
BOGOCompra 2 paghi 1BUY_X_GET_Y
Spedizione gratisFree shippingFREE_SHIPPING

1. Crea un codice

  1. Dashboard → Marketing → Codici sconto
  2. Clicca "Nuovo codice"
  3. Compila:
    • Codice: es. BENVENUTO15 (case-insensitive, max 50 caratteri)
    • Tipo: scegli da dropdown
    • Valore: es. 15 per percentuale, 1000 (centesimi) per €10
    • Importo minimo cart (opzionale): es. €30
    • Usi massimi totali (opzionale): es. 1000
    • Usi per cliente (opzionale, default 1): per evitare abuso
    • Validità: data inizio / data fine (opzionale)
  4. Salva

Il codice è subito attivo. Cliente lo inserisce nel campo "Hai un codice sconto?" del checkout.

Regole avanzate

Limita a specifici prodotti / categorie

  • Prodotti inclusi: lista di product ID Shopify/WooCommerce. Solo questi accumulano sconto.
  • Prodotti esclusi: lista di product ID. Non possono usare il codice.
  • Categorie: stessa logica, lavora su tag/category dello store.

Importo minimo

  • Es. MINIMO50 → applica solo se cart.total >= €50
  • Se cliente prova con cart €40, vede errore inline "Sconto valido sopra i €50"

Combinabilità

Default: non combinabile con altri codici. Solo un codice attivo alla volta. Per renderlo combinabile (raro), attiva flag "Stackable" in dashboard.

Single-use

Se vuoi che un codice sia usato da UN solo cliente, UNA sola volta:

  • Genera codici univoci (es. WELCOMEABCD1234)
  • Setta usi massimi = 1
  • Manda via email mail-merge

WooshPayment ha già protezione contro race-condition (claim atomico via updateMany).

Esempi pratici

Acquisizione: BENVENUTO15

  • Tipo: PERCENTAGE
  • Valore: 15%
  • Importo minimo: €0
  • Usi per cliente: 1
  • Validità: 60 giorni dal signup mail
  • Stima: lift +18% conversione su prima visita

Recupero carrello: SCONTO10ORE

  • Tipo: PERCENTAGE
  • Valore: 10%
  • Validità: 48h dal momento mail (gestito automaticamente con abandoned cart)
  • Usi: 1

Stagionale: SALDI30

  • Tipo: PERCENTAGE
  • Valore: 30%
  • Validità: 1-15 luglio
  • Categorie incluse: saldi
  • Senza minimo

BOGO: 2x1 su accessori

  • Tipo: BUY_X_GET_Y
  • Compra 2 → 1 gratis
  • Categoria: accessori
  • Stack: NO (non sommabile con altri)

Free shipping over €50

  • Tipo: FREE_SHIPPING
  • Importo minimo: €50
  • Validità: sempre
  • Codice: FREESHIP50 (oppure auto-applica via regola in Shipping)

Analytics

Dashboard → Codici sconto → vedi dettaglio mostra:

  • Usi totali
  • Revenue generato (con codice vs senza)
  • Tasso conversione cart-with-code vs senza
  • Top 10 sconti per ROI

Best practice

  • Non sovrapporre troppi codici attivi: confonde i clienti e svaluta il prezzo pieno
  • Scadenza chiara: "Solo fino a domenica" funziona meglio di "Per i prossimi 7 giorni"
  • Codice "memorabile": BLACK25 > DSC-XYZ-77
  • Trace UTM: aggiungi ?utm_campaign= quando promuovi un codice via newsletter

API: applicare programmaticamente

Roadmap: endpoint POST /api/checkout/:token/apply-discount per applicare codice via custom integration.

Domande frequenti

Cliente vede "Codice non valido"

Cause comuni:

  • Codice scaduto / non ancora attivo (controlla date)
  • Cart sotto importo minimo
  • Codice già usato max volte da quel cliente
  • Codice limitato a prodotti che NON sono nel carrello

Posso fare un codice gratuito (100% off)?

Tecnicamente sì, ma WooshPayment rifiuta se discountedTotal === 0 per evitare ordini fraudolenti gratis (bug coperto in BUG #8 risolto). Se vuoi davvero, usa valore fisso uguale al cart subtotal - €0.01.

Quanti codici posso creare?

Illimitati su tutti i piani.

Prossimi step