--- title: Auto top-up description: Guthaben über gespeicherte Karte oder PayPal automatisch aufladen — verbrauchs- und fixbasiert, Limits und Fehlerbehandlung. url: https://nexcmp.com/de/docs/billing/auto-top-up/ applies_to: NexCMP 1.6.1 updated: 2026-11-02 --- # Auto top-up {#auto-top-up} > **Im Admin-Bereich:** Finance › Payment channels › Fees & limits (`/payments/fees`), Karte **Wallet & top-up (Billing › Policy)**, Abschnitt **Auto top-up (Stripe / PayPal)**. **Im Portal:** Billing › Settings (`/billing?settings=1`). ## Funktion {#what-it-does} Wenn das Wallet-Guthaben eines Kunden zu niedrig wird, belastet NexCMP seine [saved payment method](https://nexcmp.com/de/docs/billing/saved-payment-methods/) und schreibt das Guthaben auf dem Wallet gut, sodass laufende Dienste nicht mangels Funds ausgesetzt werden. Ein Hintergrundprozess überprüft alle aktivierten Kunden **alle 5 Minuten**. ## Anforderungen {#requirements} | Komponente | Anforderung | |---|---| | Kanal | [Stripe](https://nexcmp.com/de/docs/billing/stripe/) und/oder [PayPal](https://nexcmp.com/de/docs/billing/paypal/) konfiguriert. | | Saved method | Der Kunde verfügt über eine gespeicherte Karte oder ein PayPal-Konto. | | Site | Hauptwebsite oder Reseller-Website, deren Stripe-/PayPal-Kanal über die Plattform abgewickelt wird. | | Global switch | **Auto top-up enabled** ist eingeschaltet (standardmäßig aktiv). | ## Wie es funktioniert {#how-it-works} Nach der **ersten Stripe- oder PayPal-Aufladung** eines Kunden speichert der Server die Zahlungsmethode und aktiviert die automatische Aufladung im Modus **By usage** — jedoch nur, wenn der Kunde die automatische Aufladung nicht zuvor selbst konfiguriert hat. Auf dem Einzahlungsbildschirm gibt es kein zusätzliches Kontrollkästchen; der Server protokolliert Uhrzeit, IP-Adresse und Methode als Nachweis. Schaltet der Kunde die automatische Aufladung später aus, wird sie von selbst nie wieder eingeschaltet. | Modus | Auslöser (wenn das Guthaben unter ... liegt) | Belasteter Betrag | |---|---|---| | **By usage** (Standard nach der ersten Aufladung) | die Kosten für die nächsten 24 Stunden laufender Dienste (stündliche VMs plus in 24 Stunden fällige Prepaid-Verlängerungen), jedoch nie unter **$5** | die auf einen ganzen Dollar aufgerundeten 24-Stunden-Kosten, mindestens die [minimum top-up](https://nexcmp.com/de/docs/billing/minimum-top-up/), höchstens die maximale Aufladung und das Tageslimit | | **Fixed amount** | die eigene Schwelle des Kunden ($1 bis $500) | der vom Kunden gewählte Betrag (vom Mindestaufladebetrag bis zu $1,000 und über dem Schwellenwert) | Wenn im Modus **By usage** keine Dienste laufen, erfolgt keine Belastung. Das mit der Schwelle verglichene Guthaben ist das **echte Geld im Wallet**. Dienstguthaben aus Gutscheincodes werden separat verwahrt und fließen nicht ein (siehe [Promotions](https://nexcmp.com/de/docs/billing/promotions/)). Die Gebühr wird wie eine normale Aufladung behandelt: Bei aktiviertem **Customer pays top-up fee** wird der Karte der Betrag zuzüglich Gebühr belastet und dem Wallet der volle Betrag gutgeschrieben; bei Deaktivierung erhält das Wallet den Betrag abzüglich der Gebühr. ## Globale Limits konfigurieren {#configure-the-global-limits} 1. Öffnen Sie **Finance › Payment channels › Fees & limits** (`/payments/fees`). 2. Legen Sie unter **Auto top-up (Stripe / PayPal)** Folgendes fest: | Einstellung | Standard | Bereich | Bedeutung | |---|---|---|---| | Auto top-up enabled | An | ein oder aus | „Aus“ stoppt jede Hintergrundbelastung sofort. | | Standard-Schwelle für automatische Aufladungen (USD, Fallback für festen Modus) | $5.00 | $0 bis $10,000 | Wird im Festbetrag-Modus nur als Startschwelle verwendet. | | Max. automatische Aufladungen pro 24 h und Kunde | 3 | 1 bis 50 | Zählt erfolgreiche und ausstehende Versuche. | | Obergrenze für automatische Aufladungen pro 24 h und Kunde (USD) | $500.00 | $0 bis $1,000,000 | Summe der automatischen Belastungen an einem rollierenden Tag. | 3. Klicken Sie auf **Save Wallet & top-up**. ![Bereich für das automatische Aufladen auf der Seite Gebühren und Limits mit dem globalen Schalter und täglichen Limits](https://nexcmp.com/de/docs/images/billing/auto-top-up-01-limits.webp) ## Was der Kunde sieht {#what-the-customer-sees} 1. Im Portal öffnet der Kunde **Billing** und klickt auf **Settings**. 2. Das Panel zeigt die gespeicherte(n) Methode(n), den Ein/Aus-Schalter, den Modus (**By usage** oder **Fixed amount**), die geschätzte aktuelle Nutzung sowie die nächste Belastung und die **Recent automatic top-ups**. 3. Ein Wechsel zu **Fixed amount** ermöglicht die Eingabe von Schwelle und Betrag. Das Ausschalten des Schalters stoppt Belastungen. ![Abrechnungseinstellungen des Kunden mit automatischem Aufladen im Nutzungsmodus und den letzten automatischen Aufladungen](https://nexcmp.com/de/docs/images/billing/auto-top-up-02-portal.webp) ## Verifizierung {#verify} 1. Führen Sie als Testkunde eine erste Aufladung mit einer Testkarte durch ([Stripe](https://nexcmp.com/de/docs/billing/stripe/#verify)). Öffnen Sie **Billing › Settings**: Die automatische Aufladung ist aktiv. 2. Starten Sie eine kleine VM, um Nutzung zu erzeugen, und senken Sie das Guthaben unter den Schwellenwert (z. B. über **Customers › customer › Credit / debit**). 3. Innerhalb von ca. 5 Minuten erfolgt eine Belastung. In der Karte **Overview › Payment** des Kunden zeigt **Auto top-up history** den Versuch mit dem Status *Done* an, und eine Benachrichtigung *Top-up received* wird versendet. ## Limits & Hinweise {#limits-notes} - **Eine Belastung pro Unterschreitung.** Nach einer Belastung wartet der Job, bis der Saldo wieder über den Schwellenwert gestiegen ist oder die Wartezeit abläuft: 1 Stunde nach einem Erfolg, 24 Stunden nach einer ausstehenden Belastung, 30 Minuten nach einem Systemfehler. - **Tägliche Limits.** Wenn eines der täglichen Limits erreicht ist, erfolgt keine Belastung und es wird eine Zeile *Tägliches Limit erreicht* geschrieben (höchstens alle 6 Stunden). - **Fehler.** Eine abgelehnte Karte, eine abgelaufene Karte oder unzureichende Guthaben gelten als Kartenfehler. Der Job versucht es nach 1 Stunde, dann nach 6 Stunden und dann nach 24 Stunden erneut. **Nach 3 aufeinanderfolgenden Kartenfehlern wird die automatische Aufladung abgeschaltet** und der Kunde wird benachrichtigt (*Automatische Aufladung fehlgeschlagen*). Eine Zahlung, die eine Bestätigung des Kunden erfordert (zum Beispiel 3-D Secure), gilt nicht als Fehler; der Kunde wird aufgefordert, sie zu bestätigen. - **Keine Doppelbelastungen.** Jede Belastung wird pro Unterschreitung des Schwellenwerts atomar beansprucht und verwendet einen Idempotenzschlüssel beim Gateway. - **Das Entfernen der Karte** schaltet die automatische Aufladung aus. - **Reseller.** Wenn ein Reseller seinen eigenen Zahlungskanal verwendet, kann der Kunde die automatische Aufladung nicht aktivieren (HTTP 403 `feature_disabled`). ## Fehlerbehebung {#troubleshooting} | Symptom | Ursache | Behebung | |---|---|---| | Kunde kann es nicht einschalten: "Einmalig mit Karte oder PayPal aufladen" | Keine gespeicherte Methode | Führen Sie zuerst eine Karten- oder PayPal-Aufladung durch. | | Fehler `no_card` (422) | Das gewählte Gateway hat keine gespeicherte Methode | Wählen Sie das Gateway, das eine hat, oder speichern Sie eine Methode. | | Fehler `invalid_argument` beim Betrag | Fester Modus außerhalb der zulässigen Bereiche | Schwellenwert $1–$500, Betrag zwischen dem Mindestguthaben und $1,000, Betrag größer als der Schwellenwert. | | Es wird nichts belastet, obwohl der Saldo niedrig ist | Globaler Schalter aus, kein laufender Dienst im Modus Nach Nutzung, tägliches Limit erreicht oder die vorherige Belastung wartet noch | Prüfen Sie den Schalter, den Verlauf und die Limits. | | "N aufeinanderfolgende fehlgeschlagene Versuche — automatische Aufladung schaltet sich nach 3 ab" | Karte schlägt weiterhin fehl | Der Kunde ersetzt die Karte durch eine neue Einzahlung. | | Status *Benötigt Ihre Bestätigung* | Die Bank erfordert 3-D Secure | Der Kunde führt einmalig eine normale Aufladung aus. |