Aggiungere sconti

puoi utilizzare gli sconti per ridurre l’importo addebitato a un cliente. I coupon e i codici promozionali ti permettono di:

• Applicare uno sconto a tutto il subtotale dell’acquisto
• Applicare uno sconto a prodotti specifici
• Ridurre il totale addebitato di una percentuale o di un importo fisso
• Creare codici promozionali visibili ai clienti in aggiunta ai coupon da condividere direttamente con i clienti

Creare un coupon

I coupon specificano uno sconto dal valore fisso. Puoi creare codici promozionali visibili ai clienti associati a un unico coupon corrispondente. Ciò significa che sia i codici FALLPROMO che SPRINGPROMO possono essere collegati a un unico coupon con uno sconto del 25%. Puoi creare coupon nella Dashboard o con l’API:

curl https://api.stripe.com/v1/coupons \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d percent_off=20 \
  -d duration=once

Usare un coupon

Per creare una sessione con uno sconto applicato, specifica l’ID del coupon nel parametro coupon della matrice sconti. Le sessioni di Checkout supportano al massimo un coupon o un codice promozionale.

curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "line_items[0][price]"=
{{PRICE_ID}} \
  -d "line_items[0][quantity]"=1 \
  -d "discounts[0][coupon]"=
{{COUPON_ID}} \
  -d mode=payment \
  -d ui_mode=custom \
  --data-urlencode return_url="https://example.com/checkout/return"

Configurare un coupon

I coupon hanno i seguenti parametri utilizzabili:

• currency
• percent_off o amount_off
• max_redemptions
• redeem_by, ultima data disponibile per l’utilizzo del coupon
• applies_to, che limita i prodotti a cui si applica il coupon

Limitare l’utilizzo

I valori max_redemptions e redeem_by si applicano ai coupon in tutte le applicazioni. Ad esempio, puoi limitare un coupon ai primi 50 utilizzi oppure far scadere un coupon entro una determinata data.

Limitare i prodotti idonei

Aggiungendo gli ID prodotto all’hash applies_to nell’oggetto Coupon, puoi definire con precisione quali articoli potranno beneficiare degli sconti tramite coupon. Gli eventuali codici promozionali associati a questo coupon si applicano solo all’elenco di prodotti idonei.

Eliminare un coupon

Puoi eliminare i coupon tramite la Dashboard o l’API. Una volta eliminato il coupon, non puoi più applicarlo a transazioni o clienti in futuro.

Creare un codice promozionale

I codici promozionali sono codici per i clienti creati in aggiunta ai coupon. Puoi anche specificare ulteriori limitazioni per controllare quando un cliente può applicare la promozione. Puoi condividere questi codici con i clienti in modo tale che possano inserirli durante il pagamento per applicare uno sconto.

per creare un codice promozionale, specifica un parametro coupon esistente ed eventuali limitazioni, ad esempio limitandolo a un parametro customer specifico. Se hai già un codice specifico per il cliente, ad esempio FALL25OFF, imposta il parametro code. Se lasci questo campo vuoto, generiamo un code casuale per te.

Il parametro code non fa distinzione tra maiuscole e minuscole ed è univoco per tutti i codici promozionali di qualsiasi cliente. Per esempio:

• Puoi creare più codici promozionali che limitano l’utilizzo a determinati clienti utilizzando lo stesso parametro code, ma non puoi utilizzare quel parametro code per un codice promozionale riscattabile da qualsiasi cliente.
• Se crei un codice promozionale riscattabile da qualsiasi cliente, non puoi creare un altro codice promozionale attivo con lo stesso parametro code.
• Puoi creare un codice promozionale con code: NEWUSER, disattivalo specificando active: false, quindi crea un nuovo codice promozionale con code: NEWUSER.

Puoi creare i codici promozionali nella sezione Coupon della Dashboard o con l’API:

curl https://api.stripe.com/v1/promotion_codes \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d coupon={{COUPON_ID}} \
  -d code=VIPCODE

Utilizzare un codice promozionale

Sul server, abilita i codici promozionali riscattabili dai clienti utilizzando il parametro allow_promotion_codes in una sessione di Checkout.

curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "line_items[0][price_data][unit_amount]"=2000 \
  -d "line_items[0][price_data][product_data][name]"=T-shirt \
  -d "line_items[0][price_data][currency]"=usd \
  -d "line_items[0][quantity]"=1 \
  -d mode=payment \
  -d ui_mode=custom \
  -d allow_promotion_codes=true \
  --data-urlencode return_url="https://example.com/checkout/return"

Sul client, utilizza applyPromotionCode per applicare un codice promozionale inserito dal cliente. Utilizza removePromotionCode per rimuovere tutti i codici promozionali precedentemente applicati.

<input type="text" id="promotion-code" />
<button id="apply-promotion-code">Apply</button>
<button id="remove-promotion-codes">Remove</button>
<div id="promotion-code-error"></div>

stripe.initCheckout({fetchClientSecret}).then((checkout) => {
  const input = document.getElementById('promotion-code');
  document.getElementById('apply-promotion-code').addEventListener('click', () => {
    checkout.applyPromotionCode(input.value).then((result) => {
      if (result.error) {
        // Display an error message
        document.getElementById('promotion-code-error').textContent = result.error.message;
      } else {
        // Clear the input if the promotion code was successfully applied
        input.value = '';
      }
    });
  });
  document.getElementById('remove-promotion-codes').addEventListener('click', () => {
    checkout.removePromotionCode();
  });
});

Configurare un codice promozionale

Per ogni codice promozionale puoi personalizzare i clienti idonei, il numero di utilizzi e altre limitazioni.

Limitare per cliente

Per limitare una promozione a un determinato cliente, specifica un cliente durante la creazione del codice promozionale. Se non specifichi alcun cliente, qualsiasi cliente può riscattare il codice.

Limitare al primo ordine

Puoi anche limitare il codice promozionale ai nuovi clienti con restrictions.first_time_transaction. Se il parametro customer non è definito o se un customer preciso non ha pagamenti precedenti o fatture non annullate, la transazione viene considerata nuova.

Impostare un importo minimo

Con i codici promozionali puoi impostare un importo minimo della transazione come condizione di idoneità per lo sconto configurando minimum_amount e minimum_amount_currency. Dato che le limitazioni dei codici promozionali vengono verificate al momento del riscatto, l’importo minimo della transazione si applica solo al pagamento iniziale di un abbonamento.

Personalizzare le scadenze

Puoi impostare una data di scadenza per il codice promozionale utilizzando expires_at. Se per il coupon corrispondente hai già impostato redeem_by, la data di scadenza del codice promozionale non può essere successiva a quella del coupon. Se non hai specificato promotion_code[expires_at], la voce redeem_by del coupon viene inserita automaticamente nel parametro expires_at.

Ad esempio, potresti offrire un coupon per un anno, ma volere che sia riscattabile solo per una settimana dopo che il cliente lo ha ricevuto. Puoi impostare coupon[redeem_by] su un anno a partire da oggi e promotion_code[expires_at] su una settimana dopo la creazione.

Limitare gli utilizzi

Puoi limitare il numero di utilizzi con max_redemptions, che funziona in modo analogo al parametro coupon. Se per il coupon corrispondente hai già impostato max_redemptions, il valore di max_redemptions del codice promozionale non può essere maggiore di quello del coupon.

Ad esempio, un coupon per i saldi di fine stagione potrebbe essere riscattabile dai primi 50 clienti, ma di questi utilizzi, solo 20 potrebbero valere per la promozione invernale. In questo scenario, puoi impostare coupon[max_redemptions]: 50 e promotion_code[max_redemptions]: 20.

Promozioni non attive

Puoi stabilire se un codice promozionale sia attualmente riscattabile utilizzando il parametro active. Tuttavia, se il coupon corrispondente a un codice promozionale non è più valido, tutti i codici promozionali diventano non attivi in modo permanente. Allo stesso modo, se un codice promozionale raggiunge max_redemptions o expires_at, diventa permanentemente non attivo. Questi codici promozionali non possono essere riattivati.

Elimina promozioni

Puoi eliminare le promozioni tramite la Dashboard o l’API. Una volta eliminata la promozione, non puoi più applicarla a transazioni o clienti in futuro.