---
title: Promozioni
description: Emetti codici ricarica: bonus wallet, credito solo servizi e sconti percentuali con limite e ordine minimo — creali, distribuiscili e monitorali.
url: https://nexcmp.com/it/docs/billing/promotions/
applies_to: NexCMP 1.6.1
updated: 2026-11-02
---

# Promozioni {#promotions}

> **Dove trovarlo nell'admin:** Finance › Billing › Vouchers (`/billing/vouchers`). **Dove trovarlo nel portale:** Billing › Redeem code (anche all'interno del pannello dei depositi).

## Descrizione {#what-it-does}

Un **codice di ricarica** (voucher) è un segreto usa e getta da fornire ai clienti. A seconda di come lo crei, può:

| Tipo | Cosa riceve il cliente | Dove va il valore |
|---|---|---|
| **Bonus credit** per tutti i servizi | Denaro aggiunto al portafoglio | Saldo del portafoglio. Utilizzabile per qualsiasi cosa. |
| **Bonus credit** per i servizi scelti | Un credito per i servizi | Un taschino separato che può pagare solo quei servizi. |
| **Discount %** | Una percentuale di sconto sul primo ordine dei servizi scelti | Non viene accreditato nulla; lo sconto viene applicato al momento del pagamento. |

Usali per campagne, crediti di cortesia, offerte per partner o sconti sul primo ordine.

## Requisiti {#requirements}

| Elemento | Requisito |
|---|---|
| Ruolo | Un amministratore. |
| Clienti | I clienti riscattano i codici dopo aver effettuato l'accesso al portale (non come ospiti). Per impostazione predefinita il cliente deve avere un'e-mail verificata. |
| Codici in VND | Un codice creato in VND viene convertito in USD al momento del riscatto utilizzando il tasso di cambio memorizzato (vedi [Currency and exchange rates](https://nexcmp.com/it/docs/catalog/currency-and-exchange-rates/)). |

## Crea un batch {#create-a-batch}

1. Apri **Finance › Billing › Vouchers** e fai clic su **Create vouchers**.
2. Compila il modulo. I valori di esempio sono tra parentesi.

   | Campo | Note |
   |---|---|
   | Nome del batch | 1–80 caratteri (`Spring welcome`). |
   | Destinazione | **Clienti del sito principale**, **Clienti di un singolo rivenditore** (richiede un elenco di clienti) o **Portafoglio rivenditore**. |
   | Utenti idonei | **All in target audience** o **Specified** — un'e-mail o un ID cliente per riga, fino a 1,000. Per i clienti di un reseller deve essere *Specified*. |
   | 1 codice per target | Con *Specified*, crea un codice per ciascun cliente elencato. |
   | Tipo di codice | **Bonus credit** o **Discount %**. |
   | Si applica a | Scegli uno o più servizi; vuoto = **All services**. |
   | Valuta, Valore nominale | USD a partire da $1.00 o VND da 10,000 in multipli di 1,000 (solo credito bonus). |
   | Sconto (%) | Da 1 a 100 (solo per Sconto %). |
   | Limite massimo di sconto (USD) | Richiesto per Sconto %, a partire da $1.00. Rappresenta inoltre l'importo massimo di perdita per ciascun riscatto. |
   | Ordine minimo (USD) | `0` = nessuno. Il primo ordine deve raggiungere almeno questo importo. |
   | Numero di codici | Da 1 a 1,000 codici casuali. |
   | Uszi per codice | Da 1 a 100,000. `1` indica una persona per codice; aumentalo per un codice condiviso. |
   | Uzi max per account | Almeno 1. Per Sconto % deve essere `1`. |
   | Ora di inizio (opzionale), Scadenza | La scadenza deve essere successiva a oggi e all'inizio, al massimo 2 anni nel futuro. |
   | Prefisso codice (0–6 caratteri) | Solo lettere; vuoto usa il prefisso del sito. |
   | Codice personalizzato (solo quando count = 1) | Da 6 a 32 caratteri A–Z e 0–9. Facile da condividere ma da indovinare: mantieni gli usi bassi. |
   | Richiedi email verificata | Attivo per impostazione predefinita. |
   | Nota interna, Motivo | Il motivo è obbligatorio e va nel registro di audit. |

3. Il modulo mostra **Maximum exposure** (valore nominale x codici x usi) per conoscere il caso peggiore. Clicca su **Generate codes**.
4. **Copia i codici adesso.** Vengono mostrati una sola volta: NexCMP memorizza solo un hash e gli ultimi 4 caratteri. Usa **Copy all** o **Download CSV**, spunta la conferma e chiudi la finestra.



## Come si comporta ciascun tipo {#how-each-type-behaves}

### Bonus portafoglio (nessun servizio selezionato) {#wallet-bonus-no-service-selected}

Il portafoglio viene accreditato con una voce di **adjustment** (riferimento `vch:...`). Non è rimborsabile su carta, non genera commissioni di affiliazione, non crea fattura e conta come saldo del portafoglio per le quote. I codici in VND usano il tasso di cambio al momento del riscatto.

### Credito servizio (servizi selezionati) {#service-credit-services-selected}

- Il credito si trova in un **pocket separato**, può pagare solo i costi dei servizi scelti (nuovi ordini, rinnovi, tariffe orarie o giornaliere, upgrade) e viene speso **prima** del portafoglio.
- Non può essere prelevato, trasferito o convertito in denaro e scade con il codice.
- Il registro mostra l'addebito completo più una riga di credito corrispondente, in modo che il ricavo per servizio rimanga corretto mentre il portafoglio diminuisce solo di quanto realmente pagato dal cliente.
- Non **alza** un livello di [quota](https://nexcmp.com/it/docs/billing/quotas/) ed è ignorato dal [auto top-up](https://nexcmp.com/it/docs/billing/auto-top-up/).
- Se viene rimborsato un addebito pagato con credito o uno sconto, la parte pagata dal codice viene ripresa dal rimborso del portafoglio e restituita al pocket di credito.

### Sconto % {#discount}

1. Il cliente inserisce il codice: diventa **activated**. Un codice percentuale può essere usato una sola volta per account.
2. Il **primo addebito** di un servizio selezionato che non sia una tariffa oraria e che raggiunga almeno il **Minimum order** viene scontato della percentuale, mai oltre il **Maximum discount cap**.
3. Lo sconto viene ricalcolato dal server al momento dell'addebito; l'importo nel browser viene ignorato. La riga di riscatto viene scritta quando il codice viene effettivamente utilizzato, con lo sconto reale.
4. Gli addebiti per l'utilizzo orario non usano mai il codice.

## Cosa fa il cliente {#what-the-customer-does}

1. Apri **Billing** nel portale e clicca su **Redeem code**, oppure usa **Have a top-up code?** nel pannello di deposito.
2. Digita il codice (non distingue tra maiuscole e minuscole; trattini opzionali) e clicca su **Check**. Il portale indica cosa offre, ad esempio *Valid code: +$5.00*, *$5.00 credit for VPN* o *20% off voucher for Virtual Machines (up to $5.00)*, e *Valid for orders from $10.00*.
3. Clicca su **Redeem** e conferma. Ciascun codice può essere usato una volta per account.

I codici sono vincolati al sito: un codice di un sito non è "valido" su un altro, senza alcuna indicazione della sua esistenza altrove. I tentativi errati vengono limitati e, dopo diversi tentativi, l'account viene bloccato per qualche minuto ("N tentativi rimasti prima di un blocco temporaneo").

## Traccia e interrompi {#track-and-stop}

- **Batches** elenca ciascun batch con il suo stato (*active*, *disabled*, *expired*, *used up*), il conteggio dei riscatti e l'esposizione. Apri un batch per le schede **Codes** (mascherate) e **Redemptions**, e **Export CSV**.
- **Redemptions** elenca ogni riscatto tra i vari batch; **Reseller quotas** mostra quanta parte del limite di emissione mensile di ciascun rivenditore è stata utilizzata; **Settings** attiva o disattiva i codici dei rivenditori e imposta il limite mensile predefinito.
- **Disable batch** interrompe tutti i codici non utilizzati; i riscatti già effettuati rimangono validi. È anche possibile disabilitare un singolo codice.

## Verifica {#verify}

1. Crea un batch di 1 codice: Sconto % 20, limite $5, ordine minimo $10, servizio Virtual Machines.
2. Riscatta il codice come cliente di test. Il portale indica che è attivato.
3. Ordina una VM che costa almeno $10 (ciclo mensile): la fattura mostra lo sconto (al massimo $5).
4. Nel batch, il codice mostra 1 riscatto con lo sconto effettivo.

## Limiti e note {#limits-notes}

- I codici sono vincolati all'**audience** e al **site** al momento della creazione; non possono essere spostati in un secondo momento.
- I rivenditori possono emettere codici per i propri clienti entro un limite di esposizione mensile; vedi [Resellers](https://nexcmp.com/it/docs/customers/resellers/).
- Le diapositive promozionali della barra laterale per i clienti (**Marketing › Promo slides**) sono una funzione separata e non offrono alcun tipo di sconto.
- Poiché il codice in chiaro non viene mai memorizzato, un batch smarrito non può essere recuperato: disabilitalo e creane uno nuovo.

## Troubleshooting {#troubleshooting}

| Sintomo | Causa | Soluzione |
|---|---|---|
| "Codici percentuali: un utilizzo per account" (`percent_one_per_account`) | Utilizzi massimi per account superiori a 1 per Sconto % | Impostalo su `1`. |
| Il modulo indica che il limite massimo è obbligatorio | Sconto % senza limite massimo di sconto | Inserisci almeno $1.00. |
| Clienti non trovati | Un'e-mail o un ID nell'elenco non esiste | Correggi l'elenco (l'errore indica le voci sconosciute). |
| Il cliente riceve il messaggio "codice non valido" | Sito errato, scaduto, disabilitato, esaurito, cliente non destinatario o e-mail non verificata | Verifica il batch e il cliente. |
| Il credito non è stato utilizzato | L'addebito appartiene a un altro servizio | Il credito paga solo i servizi scelti nel batch. |
| Sconto non applicato | Ordine inferiore al minimo, addebito orario o codice attivato per un altro servizio | Effettua un primo ordine idoneo. |
| Cliente bloccato dal riscatto | Troppi tentativi errati | Attendi la scadenza del blocco. |