---
title: Ricaricamento automatico
description: Mantieni i crediti dei clienti sempre attivi con carta o PayPal salvati: modalità a consumo o fissa, limiti globali e gestione errori.
url: https://nexcmp.com/it/docs/billing/auto-top-up/
applies_to: NexCMP 1.6.1
updated: 2026-11-02
---

# Ricaricamento automatico {#auto-top-up}

> **Dove nell'amministrazione:** Finance › Payment channels › Fees & limits (`/payments/fees`), scheda **Wallet & top-up (Billing › Policy)**, sezione **Auto top-up (Stripe / PayPal)**. **Dove nel portale:** Billing › Settings (`/billing?settings=1`).

## Descrizione {#what-it-does}

Quando il saldo del portafoglio di un cliente scende troppo, NexCMP addebita il suo [metodo di pagamento salvato](https://nexcmp.com/it/docs/billing/saved-payment-methods/) e accredita il portafoglio, in modo che i servizi in esecuzione non vengano sospesi per mancanza di fondi. Un'attività in background controlla tutti i clienti abilitati **ogni 5 minuti**.

## Requisiti {#requirements}

| Elemento | Requisito |
|---|---|
| Canale | [Stripe](https://nexcmp.com/it/docs/billing/stripe/) e/o [PayPal](https://nexcmp.com/it/docs/billing/paypal/) configurati. |
| Metodo salvato | Il cliente dispone di una carta o di un account PayPal salvati. |
| Sito | Sito principale o sito rivenditore il cui canale Stripe/PayPal viene riscosso dalla piattaforma. |
| Interruttore globale | **Auto top-up enabled** è attivo (predefinito attivo). |

## Come funziona {#how-it-works}

Dopo la **prima ricarica Stripe o PayPal** di un cliente, il server salva il metodo di pagamento e attiva la ricarica automatica in modalità **By usage**, a condizione che il cliente non l'abbia mai configurata autonomamente. Non è presente alcuna casella di spunta aggiuntiva nella schermata di deposito; il server registra orario, indirizzo IP e metodo come prova. Se in seguito il cliente disattiva la ricarica automatica, questa non verrà mai riattivata autonomamente.

| Modalità | Attivazione (quando il saldo è inferiore a...) | Importo addebitato |
|---|---|---|
| **By usage** (predefinita dopo la prima ricarica) | il costo delle successive 24 ore di esecuzione dei servizi (VM orarie più rinnovi prepagati in scadenza entro 24 ore), ma mai inferiore a **$5** | il costo calcolato sulle 24 ore arrotondato all'intero dollaro, pari almeno alla [ricarica minima](https://nexcmp.com/it/docs/billing/minimum-top-up/) e al massimo alla ricarica massima e al limite giornaliero |
| **Fixed amount** | la soglia personalizzata del cliente (da $1 a $500) | importo scelto dal cliente (dalla ricarica minima a $1,000, superiore alla soglia) |

Se non vi sono servizi in esecuzione in modalità **By usage**, non viene addebitato alcun importo.

Il saldo confrontato con la soglia è il **denaro effettivo nel portafoglio**. I crediti di servizio derivanti da codici promozionali sono tenuti separati e non vengono conteggiati (vedi [Promotions](https://nexcmp.com/it/docs/billing/promotions/)).

La commissione viene gestita come una normale ricarica: con **Customer pays top-up fee** attivo, alla carta viene addebitato l'importo più la commissione e il portafoglio riceve l'importo totale; con l'opzione disattivata, il portafoglio riceve l'importo al netto della commissione.

## Configurazione dei limiti globali {#configure-the-global-limits}

1. Apri **Finance › Payment channels › Fees & limits** (`/payments/fees`).
2. In **Auto top-up (Stripe / PayPal)** imposta:

   | Impostazione | Predefinito | Intervallo | Significato |
   |---|---|---|---|
   | Auto top-up enabled | On | attivo o disattivo | L'impostazione disattivata interrompe immediatamente qualsiasi addebito in background. |
   | Soglia di ricarica automatica predefinita (USD, fallback in modalità fissa) | $5.00 | $0 a $10,000 | Utilizzata solo come soglia di partenza in modalità fissa. |
   | Numero massimo di ricariche automatiche ogni 24 h per cliente | 3 | Da 1 a 50 | Conta i tentativi riusciti e in sospeso. |
   | Limite massimo di importo per le ricariche automatiche ogni 24 h per cliente (USD) | $500.00 | $0 a $1,000,000 | Totale degli addebiti automatici in un giorno mobile. |

3. Fai clic su **Save Wallet & top-up**.

![Sezione della ricarica automatica nella pagina Commissioni e limiti con l'interruttore globale e i limiti giornalieri](https://nexcmp.com/it/docs/images/billing/auto-top-up-01-limits.webp)

## Cosa vede il cliente {#what-the-customer-sees}

1. Nel portale il cliente apre **Billing** e fa clic su **Settings**.
2. Il pannello mostra il metodo o i metodi salvati, l'interruttore di attivazione/disattivazione, la modalità (**By usage** o **Fixed amount**), l'utilizzo corrente stimato, il prossimo addebito e le **Recent automatic top-ups**.
3. Passando a **Fixed amount** è possibile inserire la soglia e l'importo. Disattivando l'interruttore si bloccano gli addebiti.

![Impostazioni di fatturazione del cliente con ricarica automatica in modalità By usage e ultime ricariche automatiche](https://nexcmp.com/it/docs/images/billing/auto-top-up-02-portal.webp)

## Verifica {#verify}

1. Come cliente di prova, effettua una prima ricarica con una carta di test ([Stripe](https://nexcmp.com/it/docs/billing/stripe/#verify)). Apri **Billing › Settings**: la ricarica automatica è attiva.
2. Avvia una piccola VM per generare del traffico e riduci il saldo al di sotto della soglia (ad esempio tramite **Customers › customer › Credit / debit**).
3. Entro circa 5 minuti viene effettuato un addebito. Nella scheda **Overview › Payment** del cliente, **Auto top-up history** mostra il tentativo con stato *Done* e viene inviata una notifica di *Top-up received*.

## Limiti e note {#limits-notes}

- **Un addebito per calo.** Dopo un addebito, il processo attende che il saldo torni a salire sopra la soglia o che termini il tempo di attesa: 1 ora dopo un successo, 24 ore dopo un addebito in sospeso, 30 minuti dopo un errore di sistema.
- **Limiti giornalieri.** Quando viene raggiunto uno dei limiti giornalieri, non viene effettuato alcun addebito e viene registrata una riga *Daily limit reached* (al massimo una volta ogni 6 ore).
- **Errori.** Una carta rifiutata, scaduta o con fondi insufficienti viene conteggiata come errore della carta. Il processo riprova dopo 1 ora, poi 6 ore, poi 24 ore. **Dopo 3 errori di carta consecutivi, la ricarica automatica viene disattivata** e il cliente riceve una notifica (*Auto top-up failed*). Un pagamento che richiede la conferma del cliente (ad esempio 3-D Secure) non viene conteggiato come errore; al cliente viene chiesto di confermarlo.
- **Nessun doppio addebito.** Ogni addebito viene richiesto in modo atomico per ogni calo al di sotto della soglia e utilizza una chiave di idempotenza presso il gateway.
- **La rimozione della carta** disattiva la ricarica automatica.
- **Rivenditori.** Se un rivenditore utilizza il proprio canale di pagamento, il cliente non può abilitare la ricarica automatica (HTTP 403 `feature_disabled`).

## Troubleshooting {#troubleshooting}

| Sintomo | Causa | Soluzione |
|---|---|---|
| Il cliente non può attivarla: "Top up once with a card or PayPal" | Nessun metodo salvato | Effettua prima una ricarica con carta o PayPal. |
| Errore `no_card` (422) | Il gateway scelto non ha alcun metodo salvato | Scegli un gateway che ne ha uno o salva un metodo. |
| Errore `invalid_argument` sull'importo | Modalità fissa al di fuori degli intervalli consentiti | Soglia $1–$500, importo compreso tra la ricarica minima e $1,000, importo superiore alla soglia. |
| Non viene effettuato alcun addebito nonostante il saldo sia basso | Interruttore globale disattivato, nessun servizio in esecuzione in modalità A consumo, limite giornaliero raggiunto o addebito precedente ancora in attesa | Controlla l'interruttore, la cronologia e i limiti. |
| "N tentativi falliti consecutivi — la ricarica automatica si disattiva dopo 3" | La carta continua a fallire | Il cliente sostituisce la carta con un nuovo deposito. |
| Stato *Needs your confirmation* | La banca richiede il 3-D Secure | Il cliente completa una normale ricarica una volta. |