Einrichten des WooCommerce-Plugins für 4Geeks Payments¶
Übersicht¶
Mit dem 4Geeks Payments WooCommerce Plugin können Sie Online-Zahlungen in Ihrem WordPress/WooCommerce-Shop in maximal 5 Minuten akzeptieren – keine Programmierung erforderlich. Als eingetragener Merchant of Record kümmert sich 4Geeks um die Einhaltung von Steuervorschriften, Betrugsprävention und Rückbuchungen, sodass Sie sich auf den Verkauf konzentrieren können.
In diesem Tutorial werden Sie:
- Installieren Sie das 4Geeks Payments-Plugin
- Zahlungsmethoden konfigurieren
- Testen Sie Transaktionen im Sandbox-Modus
- Gehen Sie live und akzeptieren Sie Zahlungen
Voraussetzungen¶
- Ein aktiviertes 4Geeks Payments-Konto (Dienst aktivieren)
- WordPress 5.0+ mit installiertem WooCommerce
- Administratorzugriff auf Ihr WordPress-Dashboard
Schritt 1: Installieren Sie das Plugin¶
Option A: Aus dem WordPress-Plugin-Verzeichnis¶
- Gehen Sie zu Ihrem WordPress-Admin-Dashboard
- Navigieren Sie zu Plugins → Neu hinzufügen
- Suchen Sie nach „4Geeks Payments“
- Klicken Sie auf „Jetzt installieren“ und dann auf „Aktivieren“
Option B: Manueller Upload¶
- Laden Sie das Plugin von docs.4geeks.io/en/zahlungen/plugins/woocommerce herunter.
- Gehen Sie zu Plugins → Neu hinzufügen → Plugin hochladen
- Laden Sie die ZIP-Datei hoch
- Klicken Sie auf „Aktivieren“
Schritt 2: API-Schlüssel konfigurieren¶
- Gehen Sie zu WooCommerce → Einstellungen → Zahlungen
- Suchen Sie nach 4Geeks Payments und klicken Sie auf „Verwalten“
- Geben Sie Ihre API-Anmeldeinformationen ein:
- Öffentlicher Schlüssel: Von Ihrer 4Geeks-Konsole
- Geheimer Schlüssel: Von Ihrer 4Geeks-Konsole
- Schalten Sie „Aktivieren/Deaktivieren“ auf Aktivieren um.
Tipp: Beginnen Sie mit Sandbox-Schlüsseln zum Testen, bevor Sie live gehen.
Schritt 3: Zahlungseinstellungen konfigurieren¶
Allgemeine Einstellungen¶
| Einstellung | Beschreibung | Empfohlen |
|---|---|---|
| Titel | Name der Zahlungsmethode wird an der Kasse angezeigt | „Kredit-/Debitkarte“ |
| Beschreibung | Den Kunden angezeigte Beschreibung | „Sicher mit Ihrer Karte bezahlen“ |
| Testmodus | Sandbox-Tests aktivieren | Ja (zunächst) |
| 3D Secure | 3DS-Authentifizierung aktivieren | Ja |
Transaktionseinstellungen¶
| Einstellung | Beschreibung | Empfohlen |
|---|---|---|
| Erfassung | Nur automatisch erfassen oder autorisieren | Automatische Erfassung |
| Anweisungsdeskriptor | Text auf dem Kontoauszug des Kunden | Ihr Firmenname |
| Akzeptierte Karten | Welche Kartenmarken werden akzeptiert | Alle aktiviert |
Schritt 4: Testen Sie im Sandbox-Modus¶
- Stellen Sie sicher, dass der Testmodus aktiviert ist
- Fügen Sie ein Produkt zu Ihrem Warenkorb hinzu und gehen Sie zur Kasse
- Verwenden Sie eine Testkartennummer:
| Karte | Nummer | Ergebnis |
|---|---|---|
| Visum (Erfolg) | 4242 4242 4242 4242 | Zahlung genehmigt |
| Visum (abgelehnt) | 4000 0000 0000 9995 | Zahlung abgelehnt |
| Erfordert 3DS | 4000 0000 0000 0002 | 3D Secure-Herausforderung |
- Verwenden Sie ein beliebiges zukünftiges Ablaufdatum und einen beliebigen dreistelligen CVC
- Schließen Sie den Bestellvorgang ab und überprüfen Sie den Bestellstatus
Schritt 5: Überprüfen Sie die Webhook-Konfiguration¶
Webhooks stellen sicher, dass Ihr Shop Zahlungsaktualisierungen in Echtzeit erhält:
- Gehen Sie in Ihrer 4Geeks-Konsole zu Zahlungen → Einstellungen → Webhooks
- Fügen Sie Ihre Webhook-URL hinzu: „https://yourstore.com/wc-api/4geeks_paids“.
- Wählen Sie die zu empfangenden Ereignisse aus:
- „Aufladen.erfolgreich“.
- „Aufladen.fehlgeschlagen“.
- „Rückerstattung.abgeschlossen“.
- „Abonnement.erstellt“.
- Speichern und testen Sie den Webhook
Schritt 6: Live gehen¶
Sobald der Test abgeschlossen ist:
- Wechseln Sie in den Plugin-Einstellungen vom Testmodus zum Live-Modus
- Ersetzen Sie Sandbox-API-Schlüssel durch Produktionsschlüssel
- Geben Sie eine echte Testbestellung mit einer echten Karte (kleiner Betrag) auf.
- Überprüfen Sie, ob die Zahlung in Ihrer 4Geeks-Konsole angezeigt wird
- Bestätigen Sie, dass die Auszahlung auf Ihr Bankkonto geplant ist
Unterstützte Funktionen¶
| Funktion | Unterstützt |
|---|---|
| Einmalige Zahlungen | Ja |
| Wiederkehrende Abonnements (WooCommerce-Abonnements) | Ja |
| Rückerstattungen vom WooCommerce-Administrator | Ja |
| Teilweise Rückerstattung | Ja |
| Mehrwährung | Ja |
| 3D Secure (3DS) | Ja |
| Gespeicherte Karten | Ja |
| Zahlungslinks | Ja |
Fehlerbehebung¶
Häufige Probleme¶
| Problem | Lösung |
|---|---|
| Fehler „Ungültiger API-Schlüssel“ | Überprüfen Sie, ob die Schlüssel korrekt sind und aus der richtigen Umgebung stammen (Sandbox vs. Produktion) |
| Die Zahlung schlägt stillschweigend fehl | Überprüfen Sie die Webhook-Konfiguration und die Serverprotokolle |
| 3D Secure wird nicht ausgelöst | Stellen Sie sicher, dass 3DS in den Plugin-Einstellungen |
| Rückerstattung wird nicht bearbeitet | Stellen Sie sicher, dass die ursprüngliche Gebühr erfasst und erstattet wird |
Hilfe bekommen¶
- Überprüfen Sie die Plugin-Protokolle: WooCommerce → Status → Protokolle
- Lesen Sie die Zahlungsdokumentation
- Kontaktieren Sie den Support über das Konsolen-Dashboard
Was kommt als nächstes?¶
- Erfahren Sie mehr über Wiederkehrende Abonnementabrechnung
- Entdecken Sie Multi-Currency Checkout
Brauchen Sie Hilfe?¶
- Dokumentation: docs.4geeks.io/en/zahlungen/plugins/woocommerce
- API-Referenz: docs.4geeks.io/en/api
- Support: Verfügbar über das Konsolen-Dashboard
Noch Fragen? Get support or explore tutorials