Zum Inhalt

So verwenden Sie die 4Geeks Payments Sandbox-Umgebung zum Testen

🤖 Erklären mit KI

Die Bereitstellung von Zahlungslogik direkt in einer Live-Umgebung birgt erhebliche Risiken, wie z. B. versehentliche Belastungen echter Kreditkarten und überladene Finanzberichte. Die 4Geeks Payments Sandbox bietet eine sichere, isolierte Replik Ihrer Produktionsumgebung. Sie ermöglicht Entwicklern und Finanzmanagern, Transaktionen zu simulieren, API-Integrationen zu testen und komplexe Abrechnungsworkflows mit 4Geeks Payments zu validieren, ohne echtes Geld zu bewegen.

Dieser Artikel führt Sie durch den Zugriff auf die Sandbox, das Erhalten von Testanmeldeinformationen und die Durchführung simulierter Transaktionen, um sicherzustellen, dass Ihr System startklar ist.

Voraussetzungen

Bevor Sie mit dem Testen beginnen, stellen Sie sicher, dass Sie Folgendes haben:

  • Zugriff auf die 4Geeks Console: Sie müssen über ein aktives Konto mit Zugriff auf die 4Geeks Console verfügen.
  • Berechtigungen: Sie benötigen Berechtigungen der Stufe „Developer“ oder „Admin“, um API-Schlüssel anzuzeigen und Umgebungsmodi umzuschalten.
  • Zahlungsintegration: Idealerweise sollten Sie ein grundlegendes Verständnis davon haben, wie sich Ihre Anwendung mit 4Geeks Payments verbindet, oder bereit sein, manuelle Transaktionen über das Dashboard zu testen.

Schritt-für-Schritt-Anleitung

Befolgen Sie diese Schritte, um die Sandbox-Umgebung effektiv zu konfigurieren und zu nutzen.

Schritt 1: In den Testmodus wechseln

Die 4Geeks-Plattform trennt „Live“-Daten von „Test“-Daten, um Unfälle zu vermeiden.

  1. Melden Sie sich bei der 4Geeks Console an.
  2. Navigieren Sie zum Modul Payments in der linken Seitenleiste.
  3. Suchen Sie den Environment Toggle in der oberen Navigationsleiste (zeigt normalerweise „Live“ an).
  4. Klicken Sie auf den Umschalter, um ihn auf „Test“ oder „Sandbox“ zu ändern.
  5. Das Dashboard-Banner sollte die Farbe ändern (normalerweise zu orange oder blau), um anzuzeigen, dass Sie jetzt mit Dummy-Daten arbeiten.

Schritt 2: Test-API-Anmeldeinformationen erhalten

Ihre Live-API-Schlüssel funktionieren nicht in der Sandbox. Sie müssen spezifische Anmeldeinformationen für Tests generieren.

  1. Gehen Sie im Test Mode zu Settings > API & Webhooks.
  2. Suchen Sie die Abschnitte Public Key und Secret Key.
  3. Klicken Sie auf Reveal Keys, um Ihre Testanmeldeinformationen anzuzeigen. Diese Schlüssel beginnen normalerweise mit einem Präfix wie pk_test_ oder sk_test_.
  4. Kopieren Sie diese Schlüssel und aktualisieren Sie Ihre lokale Entwicklungsumgebung oder Staging-Server-Konfiguration.

Hinweis: Verwenden Sie niemals Ihre Live-Schlüssel (pk_live_...) in Ihrem Testcode, da dies zu fehlgeschlagener Authentifizierung oder ungewollten echten Transaktionen führt.

Schritt 3: Eine Transaktion simulieren

Sie können Ihre Integration überprüfen, indem Sie eine Zahlung mit Testkartennummern verarbeiten.

  1. Initiieren Sie einen Zahlungsfluss über Ihre Anwendung (z. B. eine Checkout-Seite oder einen Rechnungszahlungslink).
  2. Wenn Sie zur Eingabe von Zahlungsdetails aufgefordert werden, verwenden Sie eine der 4Geeks Testkartennummern. (Eine vollständige Liste finden Sie in der Dokumentation zu 4Geeks Payments).
    • Visa (Erfolgreich): 4242 4242 4242 4242
    • Mastercard (Abgelehnt): 5100 0000 0000 0051
    • Ablaufdatum: Ein beliebiges zukünftiges Datum.
    • CVC: Beliebige 3 Ziffern (z. B. 123).
  3. Schließen Sie den Checkout-Vorgang ab.

Schritt 4: Ergebnisse überprüfen

  1. Kehren Sie zur 4Geeks Console zurück (stellen Sie sicher, dass Sie sich noch im Testmodus befinden).
  2. Klicken Sie auf den Reiter Transactions.
  3. Sie sollten Ihre letzte simulierte Zahlung aufgelistet sehen.
  4. Klicken Sie auf die Transaktions-ID, um Details anzuzeigen, einschließlich Status (Erfolgreich/Fehlgeschlagen), rohen API-Antwortprotokollen und zugehörigen Metadaten.

Häufige Anwendungsfälle

Szenario 1: Testen des automatischen Dunning für Abonnements

Wenn Sie 4Geeks Payments verwenden, um wiederkehrende Abrechnungen zu verwalten, können Sie eine fehlgeschlagene Zahlung simulieren, um Ihre Dunning-Logik (Wiederholung) zu testen.

  • Aktion: Erstellen Sie ein Abonnement in der Sandbox mit einer spezifischen „Ablehnungs“-Testkartennummer.
  • Validierung: Überprüfen Sie, ob das System versucht, die Zahlung gemäß Ihrem Zeitplan zu wiederholen, und ob die korrekte E-Mail-Benachrichtigung „Zahlung fehlgeschlagen“ an die Dummy-Kunden-E-Mail ausgelöst wird.

Szenario 2: Validierung von Gehaltsauszahlungen

Für Unternehmen, die 4Geeks Payroll nutzen, ist die Sandbox für das Testen von Auszahlungen an Auftragnehmer unerlässlich.

  • Aktion: Richten Sie ein Test-Auftragnehmerprofil ein und initiieren Sie eine Massenauszahlung mit Testgeldern in Ihrer virtuellen Geldbörse.
  • Validierung: Überprüfen Sie, ob der Transaktionsstatus in der Konsole auf „Bezahlt“ aktualisiert wird und ob der entsprechende Webhook an Ihr Backend-System gesendet wird, was bestätigt, dass die Integration Auszahlungen korrekt handhabt.

Fehlerbehebung

Problem 1: Fehler „Ungültiger API-Schlüssel“

  • Ursache: Sie verwenden wahrscheinlich Ihre Live-API-Schlüssel, während Ihre Anwendung auf den Sandbox-Endpunkt verweist, oder umgekehrt.
  • Lösung: Überprüfen Sie Ihre .env-Datei oder Konfigurationseinstellungen. Stellen Sie sicher, dass Ihre Schlüssel zur Umgebung passen (Testschlüssel für Sandbox, Live-Schlüssel für Produktion).

Problem 2: Transaktionen erscheinen nicht im Dashboard

  • Ursache: Die Konsolenansicht ist möglicherweise auf den falschen Modus eingestellt.
  • Lösung: Sehen Sie sich den Umschalter in der Kopfzeile der 4Geeks Console an. Wenn Sie eine Testtransaktion verarbeitet haben, stellen Sie sicher, dass der Umschalter auf Test eingestellt ist. Live-Transaktionen werden niemals in der Testansicht angezeigt.

Problem 3: Webhooks werden nicht ausgelöst

  • Ursache: Webhook-Endpunkte müssen für Live- und Testumgebungen separat konfiguriert werden.
  • Lösung: Gehen Sie im Testmodus zu Settings > API & Webhooks. Stellen Sie sicher, dass Ihre Staging-Server-URL als Webhook-Endpunkt hinzugefügt ist und dass die Ereignisse „subscription_created“ oder „payment_succeeded“ aktiviert sind.

Fazit

Die Nutzung der 4Geeks Payments Sandbox ist ein entscheidender Schritt im Entwicklungslebenszyklus. Sie stellt sicher, dass Ihre Abrechnungslogik, von der Patientenrechnung in 4Geeks Health bis zur Abonnementverwaltung in 4Geeks Assets, einwandfrei funktioniert, bevor Sie mit echten Kunden interagieren. Indem Sie Tests in dieser Umgebung isolieren, schützen Sie Ihre Einnahmequellen und pflegen saubere Daten für genaue Berichte.

Für fortgeschrittenere Testszenarien wie 3D Secure-Simulation oder Streitbeilegung lesen Sie bitte die Zusätzlichen Ressourcen unten.

Zusätzliche Ressourcen