---
title: Rechargement automatique
description: Rechargez automatiquement les soldes clients par carte ou PayPal (modes à l'usage et fixe), avec limites et gestion des échecs.
url: https://nexcmp.com/fr/docs/billing/auto-top-up/
applies_to: NexCMP 1.6.1
updated: 2026-11-02
---

# Rechargement automatique {#auto-top-up}

> **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 {#what-it-does}

Lorsque le solde du portefeuille d'un client devient trop bas, NexCMP débite sa [méthode de paiement enregistrée](https://nexcmp.com/fr/docs/billing/saved-payment-methods/) 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 {#requirements}

| Élément | Prérequis |
|---|---|
| Canal | [Stripe](https://nexcmp.com/fr/docs/billing/stripe/) et/ou [PayPal](https://nexcmp.com/fr/docs/billing/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 {#how-it-works}

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](https://nexcmp.com/fr/docs/billing/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](https://nexcmp.com/fr/docs/billing/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 {#configure-the-global-limits}

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

![Section de rechargement automatique de la page des frais et limites avec l'interrupteur global et les limites journalières](https://nexcmp.com/fr/docs/images/billing/auto-top-up-01-limits.webp)

## Ce que voit le client {#what-the-customer-sees}

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.

![Paramètres de facturation client avec le rechargement automatique en mode By usage et les rechargements automatiques récents](https://nexcmp.com/fr/docs/images/billing/auto-top-up-02-portal.webp)

## Vérification {#verify}

1. En tant que client test, effectuez un premier rechargement avec une carte de test ([Stripe](https://nexcmp.com/fr/docs/billing/stripe/#verify)). 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 {#limits-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 {#troubleshooting}

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