PayPal in Gambio einrichten (GX4 & GX5)

Diese Anleitung zeigt Schritt für Schritt, wie Sie PayPal in einem selbstgehosteten Gambio-Shop einrichten – über die offizielle PayPal Orders API v2 und unabhängig vom GambioHub. Geeignet für Gambio GX 4.8 und neuer sowie GX5.

Voraussetzungen

Gambio GX 4.8 oder neuer (selbstgehostete Installation) bzw. GX5
PHP 8.1 oder höher mit aktiviertem ionCube Loader
Gültiges SSL-Zertifikat (HTTPS)
Verifiziertes PayPal Business-Konto

Schritt für Schritt

PayPal Business-Konto vorbereiten

Stellen Sie sicher, dass Sie über ein verifiziertes PayPal Business-Konto verfügen. Privatkonten können für Händlerzahlungen nicht genutzt werden.

App im PayPal Developer Portal anlegen

Melden Sie sich im PayPal Developer Portal an, legen Sie unter „Apps & Credentials“ eine REST-App an und notieren Sie Client-ID und Secret – getrennt für Sandbox und Live. Diese Zugangsdaten erhalten Sie kostenlos; es entstehen keine zusätzlichen Gebühren für den API-Zugang.

Modul per FTP hochladen und aktivieren

Laden Sie die Moduldateien per FTP in das Gambio-Hauptverzeichnis, leeren Sie anschließend den Cache und aktivieren Sie das Modul unter Module → Zahlungsweisen. Eine ausführliche Anleitung liegt dem Modul bei.

Zugangsdaten eintragen

Tragen Sie Client-ID und Secret in der Modulkonfiguration ein und wählen Sie zunächst den Sandbox-Modus aus. Legen Sie außerdem fest, welcher Bestellstatus bei erfolgreichem Zahlungseingang gesetzt werden soll.

Im Sandbox-Modus testen

Führen Sie eine Testbestellung mit einem Sandbox-Käuferkonto durch und prüfen Sie, ob die Bestellung automatisch den korrekten Zahlungsstatus erhält. Die Webhook-Verarbeitung sorgt dafür, dass Statusänderungen ohne manuelles Zutun ankommen.

Live schalten

Wechseln Sie auf die Live-Zugangsdaten und stellen Sie das Modul auf den Live-Modus um. PayPal steht damit produktiv im Checkout zur Verfügung – inklusive Später bezahlen (Pay Later), Rechnungskauf und Kreditkarte über PayPal.

Häufige Stolpersteine

Sandbox-Daten im Live-Betrieb: Eine der häufigsten Ursachen für fehlschlagende Zahlungen ist, dass nach dem Test die Live-Zugangsdaten nicht eingetragen wurden.
ionCube Loader fehlt: Ohne aktiven ionCube Loader lässt sich das Modul nicht ausführen – die Erweiterung muss serverseitig in der genutzten PHP-Version aktiviert sein.
Cache nicht geleert: Nach Upload und Aktivierung sollte der Gambio-Cache geleert werden, damit das Modul im Backend erscheint.

Einrichtung sparen? Das PayPal-Modul für Gambio GX4 & GX5 bringt die komplette Orders-API-v2-Anbindung mit – Sie tragen nur Client-ID und Secret ein, der Rest ist vorkonfiguriert.