Ricaricamento automatico

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

Quando il saldo del portafoglio di un cliente scende troppo, NexCMP addebita il suo metodo di pagamento salvato 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

Elemento	Requisito
Canale	Stripe e/o 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

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 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).

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

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.

Cosa vede il cliente

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.

Verifica

1. Come cliente di prova, effettua una prima ricarica con una carta di test (Stripe). 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

• 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

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.