Zahlungskanäle
Im Admin-Bereich: Finance › Payment channels (
/payments). Schalter und Gebühren: Finance › Payment channels › Fees & limits (/payments/fees).
NexCMP verwendet ein Prepaid-Guthaben in USD. Kunden laden Geld über einen Zahlungskanäle auf das Guthaben; alle Dienste werden anschließend davon bezahlt. Ein Kanal wird Kunden nur angezeigt, wenn er sowohl aktiviert als auch konfiguriert ist.
Funktion
Zahlungskanäle verbinden Ihre Zahlungskonten (Stripe, PayPal, Binance, eine vietnamesische Bank) mit dem Kundenkonto. Eine bestätigte Zahlung wird exakt zu einer Guthabenbuchung — jede Buchung ist über die Gateway-Zahlungs-ID eindeutig, sodass ein wiederholter Webhook niemals doppelt Geld hinzufügen kann. Auf dieser Seite sehen Sie, welche Kanäle bereit sind, wie sie in den letzten 30 Tagen abgeschnitten haben und welche Aufmerksamkeit erfordern.
Anforderungen
| Komponente | Anforderung |
|---|---|
| Öffentliche HTTPS-Adresse | Gateways senden Webhooks an https://<domain>/v1/billing/..., daher muss Ihr Panel über ein gültiges TLS-Zertifikat aus dem Internet erreichbar sein (siehe DNS and Cloudflare). |
| Konten | Ihr eigenes Konto bei jedem gewünschten Anbieter. Zugangsdaten werden im Admin-Bereich eingegeben und niemals erneut angezeigt (nur die letzten 4 Zeichen). |
| Admin-Rolle | Ein Administrator-Konto. |
| Abhängigkeiten | Keine. Der VN-Bank-Kanal benötigt zusätzlich einen Wechselkurs. |
Die Kanäle
| Kanal | Was der Kunde sieht | Einrichtung in | Artikel |
|---|---|---|---|
| Karte (Stripe) | Kartenformular, gespeicherte Karte | Payment channels › Stripe | Stripe |
| Apple Pay, Google Pay, Link | Wallet-Schaltflächen (Stripe Express Checkout) | Stripe sowie Domain-Registrierung | Stripe |
| Alipay | Weiterleitung zu Alipay (Abrechnung in JPY über Stripe) | Stripe sowie Fees & limits | Stripe |
| PayPal | PayPal-Schaltflächen, gespeichertes PayPal-Konto | Payment channels › PayPal | PayPal |
| USDT | Einzahlungsadresse und genauer Betrag | Payment channels › USDT | USDT |
| VN-Banküberweisung | QR-Code und Überweisungsdetails (nur vietnamnesische Oberfläche) | Payment channels › VN bank transfer | Banküberweisung (Vietnam) |
Infrastruktur vorbereiten
Nicht erforderlich. Alles wird im Admin-Bereich konfiguriert; auf dem Server muss nichts installiert werden.
In NexCMP verbinden
- Öffnen Sie Finance › Payment channels (
/payments). Die Übersichtstabelle listet jeden Kanal mit seinem Status auf. - Öffnen Sie die Kanaltab (Stripe, PayPal, USDT, VN bank transfer) und folgen Sie dem dazugehörigen Artikel. Jedes Tab endet mit einer Save-Schaltfläche und – sofern verfügbar – einer Test-Schaltfläche.
- Öffnen Sie Fees & limits (
/payments/fees), suchen Sie die Karte Payment gateways & fees (wallet top-up), aktivieren Sie den Kanal mit dem Schalter und klicken Sie auf Save channels & fees.
Schalter und Gebühren (Fees & limits)
| Einstellung | Standard | Bedeutung |
|---|---|---|
| Karte (Stripe) | An | Kartenformular auf dem Einzahlungsbildschirm. Bis zur Hinterlegung eines Stripe-Geheimschlüssels ausgeblendet. |
| Apple Pay, Google Pay, Link | An | Wallet-Schaltflächen. Diese werden nur angezeigt, wenn die Domain bei Stripe verifiziert ist. |
| Alipay | Aus | Erfordert ein in Ihrem Stripe Dashboard aktiviertes Alipay. |
| PayPal | Aus | Wird nur angezeigt, wenn PayPal konfiguriert ist. |
| USDT (Binance) | Aus | Der Schalter ist gesperrt, bis die Einzahlungsadresse gegen Binance verifiziert wurde. |
| Stripe-Gebühr % / fix (Cents) | 3.6 % und 0 | Wird verwendet, um dem Kunden die Gebühr anzuzeigen und den gutzuschreibenden Betrag zu berechnen. Stellen Sie hier Ihren tatsächlichen Stripe-Tarif ein. |
| PayPal-Gebühr % / fix | 4.4 % und 30 Cent | Entsprechend für PayPal. |
| USDT-Gebühr % | 1 % | Entsprechend für USDT. |
| Kunde zahlt Aufladegebühr | Aus | On: Der Kunde zahlt Betrag + Gebühr und das Guthaben erhält den vollen Betrag. Off: Die Gebühr wird abgezogen und das Guthaben erhält den Betrag abzüglich der Gebühr. |
Der Kunde sieht vor der Zahlung stets die Gebühr und das finale Guthaben. Das Deaktivieren eines Kanals blendet den Button aus und der Server verweigert neue Zahlungen mit method_disabled (HTTP 403).
Aufladelimits
Der Mindest- und Höchstbetrag pro Aufladung befinden sich auf derselben Seite — siehe Mindestaufladung.
Verifizierung
- In der Übersichtstabelle zeigt der Kanal Enabled und Configured an; die Spalte Last test wird ausgefüllt, nachdem Sie auf dem Reiter des Kanals auf Test geklickt haben.
- Melden Sie sich als Testkunde im Portal an und öffnen Sie Billing › Deposit. Der Kanal-Button ist vorhanden.
- Tätigen Sie eine kleine Zahlung (siehe Artikel des Kanals für Testkarten oder Sandbox-Konten). Der Kontostand steigt, eine Benachrichtigung Top-up received erscheint und die Zahlung wird unter Finance › Billing › Top-ups (
/billing/deposits) aufgeführt.
Limits & Hinweise
- Übersichtsspalten: 30 days (Anzahl der Zahlungen, erfolgreiche und fehlgeschlagene Zahlungen sowie Volumen), Stuck 24h (Zahlungen, die nach einem Tag noch ausstehen) und Unmatched (USDT- oder Banküberweisungen, die eingegangen sind, aber zu keiner Bestellung passen). Die KPI-Zeile ergänzt das 30-Tage-Volumen, die Anzahl fehlerhafter Kanäle (aktiviert, aber nicht konfiguriert oder hängende Zahlungen) sowie die Summe der nicht zugeordneten Beträge.
- Webhook-Ereignisse sind unter Payment channels › Gateway events (
/payments/events) aufgelistet. Stripe hat einen eigenen Reiter; PayPal und USDT teilen sich einen. Ein fehlgeschlagenes Ereignis kann erneut abgespielt werden – das Kontobuch ist idempotent, sodass eine Wiederholung niemals doppelt gutgeschrieben wird. - Resellers können eigene Stripe-, PayPal-, USDT- und Bankkanäle nutzen. Ihre Zeilen erscheinen ebenfalls hier, und die Site-Auswahl im Header filtert diese. Siehe Resellers.
- Rückerstattungen: Stripe- und PayPal-Zahlungen können aus der Zahlungsliste heraus erstattet werden; USDT-Zahlungen können nicht an die Quelle erstattet werden (der Server antwortet mit
usdt_no_refund). - Wartungsmodus akzeptiert weiterhin Gateway-Webhooks, sodass eine kurz vor der Wartung getätigte Zahlung nicht verloren geht.
Fehlerbehebung
| Symptom | Ursache | Behebung |
|---|---|---|
| Kanal auf dem Einzahlungsbildschirm des Kunden fehlt | Ausgeschaltet, nicht konfiguriert oder (bei vietnamesischen Banken) die Benutzeroberfläche ist nicht auf Vietnamesisch eingestellt | Überprüfen Sie Fees & limits und den Kanalreiter; siehe Bank transfer (Vietnam). |
| Der KPI Faulty channels ist größer als 0 | Ein Kanal ist ohne Anmeldedaten aktiviert oder Zahlungen sind seit mehr als 24 Stunden ausstehend | Öffnen Sie die Zeile und klicken Sie auf Configure; öffnen Sie bei hängenden Zahlungen Gateway events und spielen Sie diese erneut ab. |
| Kunde hat bezahlt, aber das Guthaben hat sich nicht geändert | Der Webhook ist nicht eingetroffen | Überprüfen Sie die Webhook-URL auf dem Kanalreiter und spielen Sie das Ereignis dann unter Gateway events erneut ab. |
Server antwortet mit method_disabled | Der Schalter ist ausgeschaltet | Schalten Sie ihn unter Fees & limits ein und speichern Sie. |
| USDT-Schalter ist ausgegraut | Einzahlungsadresse nicht verifiziert | Klicken Sie auf dem USDT-Reiter auf Test & verify address. |