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
Wenn das Wallet-Guthaben eines Kunden zu niedrig wird, belastet NexCMP seine saved payment method 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
| Komponente | Anforderung |
|---|---|
| Kanal | Stripe und/oder 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
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, 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).
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
Öffnen Sie Finance › Payment channels › Fees & limits (
/payments/fees).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. Klicken Sie auf Save Wallet & top-up.
Was der Kunde sieht
- Im Portal öffnet der Kunde Billing und klickt auf Settings.
- 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.
- Ein Wechsel zu Fixed amount ermöglicht die Eingabe von Schwelle und Betrag. Das Ausschalten des Schalters stoppt Belastungen.
Verifizierung
- Führen Sie als Testkunde eine erste Aufladung mit einer Testkarte durch (Stripe). Öffnen Sie Billing › Settings: Die automatische Aufladung ist aktiv.
- Starten Sie eine kleine VM, um Nutzung zu erzeugen, und senken Sie das Guthaben unter den Schwellenwert (z. B. über Customers › customer › Credit / debit).
- 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
- 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
| 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. |