Rechargement automatique

Où dans l'administration : Finance › Payment channels › Fees & limits (/payments/fees), carte Wallet & top-up (Billing › Policy), section Auto top-up (Stripe / PayPal). Où dans le portail : Billing › Settings (/billing?settings=1).

Description

Lorsque le solde du portefeuille d'un client devient trop bas, NexCMP débite sa méthode de paiement enregistrée et crédite le portefeuille, afin que les services en cours ne soient pas suspendus par manque de fonds. Une tâche de fond vérifie tous les clients activés toutes les 5 minutes.

Prérequis

Élément	Prérequis
Canal	Stripe et/ou PayPal configurés.
Méthode enregistrée	Le client possède une carte ou un compte PayPal enregistré.
Site	Site principal ou site de revendeur dont le canal Stripe/PayPal est encaissé par la plateforme.
Interrupteur global	Auto top-up enabled est activé (activé par défaut).

Comment ça fonctionne

Après le premier rechargement Stripe ou PayPal d'un client, le serveur enregistre le mode de paiement et active le rechargement automatique en mode By usage, uniquement si le client ne l'a jamais configuré lui-même. Aucune case à cocher supplémentaire n'apparaît sur l'écran de dépôt ; le serveur consigne l'heure, l'adresse IP et la méthode comme justificatifs. Si le client désactive ultérieurement le rechargement automatique, il ne sera jamais réactivé de lui-même.

Mode	Déclencheur (lorsque le solde est inférieur à...)	Montant facturé
By usage (par défaut après le premier rechargement)	le coût des 24 prochaines heures de services actifs (VM facturées à l'heure plus renouvellements prépayés dus dans les 24 heures), mais jamais en dessous de $5	le coût sur 24 heures arrondi au dollar supérieur, au moins le minimum top-up, au plus le maximum top-up et le plafond journalier
Fixed amount	le seuil personnalisé du client ($1 à $500)	le montant personnalisé du client (du minimum de rechargement à $1,000, et supérieur au seuil)

S'il n'y a aucun service actif en mode By usage, aucun montant n'est facturé.

Le solde comparé au seuil correspond à l'argent réel dans le portefeuille. Les crédits de service issus de codes promotionnels sont conservés séparément et ne sont pas pris en compte (voir Promotions).

Les frais sont traités comme un rechargement normal : si l'option Customer pays top-up fee est activée, la carte est débitée du montant augmenté des frais et le portefeuille reçoit le montant intégral ; si elle est désactivée, le portefeuille reçoit le montant moins les frais.

Configurer les limites globales

1. Ouvrez Finance › Payment channels › Fees & limits (/payments/fees).

2. Dans Auto top-up (Stripe / PayPal), définissez :

   Paramètre	Valeur par défaut	Plage	Description
   Auto top-up enabled	On	activé ou désactivé	La position désactivée arrête immédiatement tout prélèvement en arrière-plan.
   Seuil de rechargement automatique par défaut (USD, repli en mode fixe)	$5.00	$0 à $10,000	Utilisé uniquement comme seuil initial en mode fixe.
   Nombre max. de rechargements auto. par 24 h et par client	3	1 à 50	Compte les tentatives réussies et en attente.
   Plafond du montant de rechargement auto. par 24 h et par client (USD)	$500.00	$0 à $1,000,000	Total des prélèvements automatiques sur une période glissante d'un jour.

3. Cliquez sur Save Wallet & top-up.

Ce que voit le client

1. Dans le portail, le client ouvre Billing et clique sur Settings.
2. Le panneau affiche le ou les modes de paiement enregistrés, l'interrupteur marche/arrêt, le mode (By usage ou Fixed amount), l'estimation de l'utilisation actuelle et du prochain prélèvement, ainsi que la section Recent automatic top-ups.
3. Passer au mode Fixed amount lui permet de saisir le seuil et le montant. Désactiver l'interrupteur arrête les prélèvements.

Vérification

1. En tant que client test, effectuez un premier rechargement avec une carte de test (Stripe). Ouvrez Billing › Settings: le rechargement automatique est activé.
2. Démarrez une petite machine virtuelle pour générer de l'utilisation et réduisez le solde en dessous du seuil (par exemple via Customers › customer › Credit / debit).
3. Un prélèvement est effectué dans les 5 minutes environ. Dans la carte Overview › Payment du client, Auto top-up history affiche la tentative avec le statut Done, et une notification Top-up received est envoyée.

Limites et notes

• Un seul débit par seuil franchi. Après un débit, la tâche attend que le solde remonte au-dessus du seuil ou que le délai d'attente expire : 1 heure après un succès, 24 heures après un débit en attente, 30 minutes après une erreur système.
• Limites quotidiennes. Lorsque l'une ou l'autre des limites quotidiennes est atteinte, aucun débit n'est effectué et une ligne Daily limit reached est enregistrée (au maximum toutes les 6 heures).
• Échecs. Une carte refusée, expirée ou un solde insuffisant compte comme un échec de carte. La tâche réessaie après 1 heure, puis 6 heures, puis 24 heures. Après 3 échecs consécutifs de carte, le rechargement automatique est désactivé et le client est notifié (Auto top-up failed). Un paiement nécessitant une confirmation du client (par exemple 3-D Secure) n'est pas comptabilisé comme un échec ; il est demandé au client de le confirmer.
• Pas de double débit. Chaque débit est revendiqué de manière atomique par franchissement de seuil à la baisse et utilise une clé d'idempotence auprès de la passerelle.
• La suppression de la carte désactive le rechargement automatique.
• Revendeurs. Si un revendeur utilise son propre canal de paiement, le client ne peut pas activer le rechargement automatique (HTTP 403 feature_disabled).

Dépannage

Symptôme	Cause	Solution
Le client ne peut pas l'activer : "Top up once with a card or PayPal"	Aucun moyen enregistré	Effectuez d'abord un premier rechargement par carte ou PayPal.
Erreur no_card (422)	La passerelle choisie n'a aucune méthode enregistrée	Sélectionnez une passerelle qui en possède une ou enregistrez une méthode.
Erreur invalid_argument sur le montant	Mode fixe hors des plages autorisées	Seuil $1–$500, montant entre le rechargement minimum et $1,000, montant supérieur au seuil.
Aucun débit effectué malgré un solde bas	Commutateur global désactivé, aucun service en cours d'exécution en mode À l'usage, limite quotidienne atteinte ou débit précédent toujours en attente	Vérifiez le commutateur, l'historique et les limites.
"N tentatives consécutives échouées — le rechargement automatique se désactive après 3"	La carte continue d'échouer	Le client remplace la carte par un nouveau dépôt.
Statut Nécessite votre confirmation	La banque exige 3-D Secure	Le client effectue un rechargement normal une fois.