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

1. 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.

2. 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.

3. 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.

4. 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.

5. 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.

6. 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.