{"id":841321,"date":"2026-09-09T12:21:13","date_gmt":"2026-09-09T12:21:13","guid":{"rendered":"https:\/\/www.knowband.com\/blog\/?p=841317\/"},"modified":"2026-09-10T12:11:29","modified_gmt":"2026-09-10T12:11:29","slug":"prestashop-payment-gateway-integration","status":"publish","type":"post","link":"https:\/\/www.knowband.com\/blog\/de\/prestashop-de\/prestashop-payment-gateway-integration\/","title":{"rendered":"Integration eines benutzerdefinierten Zahlungsgateways in PrestaShop: Technische Anforderungen, API-Ablauf und Herausforderungen im Bereich OPC in der Praxis"},"content":{"rendered":"

Die Integration eines Zahlungsgateways in PrestaShop mag auf dem Papier unkompliziert erscheinen.<\/span><\/p>\n

Das Gateway stellt API-Dokumentation, Sandbox-Zugangsdaten, Authentifizierungsschl\u00fcssel, Callback-URLs und einige Endpunkte bereit. Das PrestaShop-Modul sendet anschlie\u00dfend die Zahlungsanfrage, empf\u00e4ngt die Antwort, erstellt die Bestellung und leitet den Kunden zur Best\u00e4tigungsseite weiter.<\/span><\/p>\n

In einem realen PrestaShop-Shop arbeitet das Zahlungsgateway jedoch selten allein.<\/span><\/p>\n

Sobald ein Shop ein One Page Checkout (OPC)-Modul wie SuperCheckout verwendet, k\u00f6nnen mehrere Zahlungsmodule, benutzerdefinierte Zahlungsabl\u00e4ufe, iFrames, JavaScript-basierte Zahlungsmethoden und zus\u00e4tzliche Checkout-Anpassungen miteinander interagieren.<\/span><\/p>\n

Hier sto\u00dfen viele Zahlungsintegrationen auf Schwierigkeiten.<\/span><\/p>\n

Im Rahmen der Kompatibilit\u00e4tsarbeiten mit Zahlungsgateways sind wir auf F\u00e4lle gesto\u00dfen, in denen eine Zahlungsmethode im Standard-Checkout von PrestaShop einwandfrei funktionierte, sich aber innerhalb von OPC anders verhielt. Beispielsweise konnte ein Zahlungsanbieter im Standard-Checkout korrekt angezeigt werden, w\u00e4hrend Optionen wie BLIK, Bankauswahl oder BNPL in SuperCheckout nicht mehr verf\u00fcgbar waren.<\/span><\/p>\n

Die wichtigste Erkenntnis war, dass die Integration eines Zahlungs-Gateways nicht nur bedeutet, den API-Aufruf zum Laufen zu bringen. Es geht darum, den gesamten Zahlungszyklus innerhalb des PrestaShop-Checkouts korrekt abzuwickeln.<\/span><\/p>\n

1.0 Was ben\u00f6tigt ein kundenspezifisches Zahlungsgateway tats\u00e4chlich?<\/strong><\/h2>\n

\"Was<\/a><\/p>\n

Im Wesentlichen muss eine PrestaShop-Zahlungsintegration f\u00fcnf Dinge ber\u00fccksichtigen:<\/span><\/p>\n

    \n
  1. Die Zahlungsmethode wird im Bestellvorgang angezeigt.<\/span><\/li>\n
  2. Senden Sie die Kunden- oder Zahlungsdaten an das Zahlungsportal.<\/span><\/li>\n
  3. Empfangen und validieren Sie die Gateway-Antwort.<\/span><\/li>\n
  4. Erstellen oder aktualisieren Sie die PrestaShop-Bestellung korrekt.<\/span><\/li>\n
  5. Leiten Sie den Kunden zur entsprechenden Best\u00e4tigungs- oder Fehlerseite zur\u00fcck.<\/span><\/li>\n<\/ol>\n

    Ein typisches Zahlungsmodul erweitert die Basisklasse, anstatt sie zu erweitern.<\/p>\n

    Das Zahlungsmodul arbeitet normalerweise mit Hooks wie:<\/p>\n

    Der Hook sorgt daf\u00fcr, dass die Zahlungsmethode im Checkout verf\u00fcgbar ist.<\/p>\n

    Der Hook steuert, was der Kunde nach der R\u00fcckkehr vom Zahlungsvorgang sieht.<\/p>\n

    Beispielsweise:<\/span><\/p>\n

    public function hookPaymentOptions($params) { if (!$this->active || !$this->checkCurrency($params['cart'])) { return []; } $paymentOption = new PaymentOption(); $paymentOption ->setCallToActionText($this->l('Mit Karte bezahlen')) ->setAction( $this->context->link->getModuleLink( $this->name, 'redirect', [], true ) ); return [$paymentOption]; }<\/pre>\n
    Wichtig ist, dass dieser Hook nicht einfach davon ausgehen sollte, dass die Zahlungsmethode immer angezeigt werden kann.<\/span><\/p>\n
    W\u00e4hrung, Land, Zahlungsdienstleister, Kundenstatus, Warenkorbwert, Modulkonfiguration und Verf\u00fcgbarkeit des Zahlungsgateways k\u00f6nnen Einfluss darauf haben, ob die Zahlungsmethode angezeigt werden soll.<\/span><\/p>\n
    2.0 Der Teil, der alles ver\u00e4ndert: OPC<\/strong><\/h2>\n
    Der standardm\u00e4\u00dfige PrestaShop-Checkout und ein OPC-Modul verarbeiten Zahlungsmethoden nicht unbedingt auf genau die gleiche Weise.<\/span><\/p>\n
    Dies war eine der wichtigsten Erkenntnisse aus der Arbeit mit verschiedenen Zahlungsmodulen.<\/span>
    \n<\/span><\/p>\n
    Bei der Standard-Kasse steuert ein Zahlungsmodul im Allgemeinen die Darstellung seiner eigenen Zahlungsoptionen und den Zahlungsablauf.<\/span><\/p>\n
    Mit einem OPC wird das Checkout-Modul zu einer weiteren Schicht zwischen dem Zahlungsmodul und dem Kunden. Das bedeutet, dass folgende Komponenten interagieren k\u00f6nnen:<\/span><\/p>\n
    Durch den<\/b>\r\n\u2193<\/span>\r\nOPC \/ SuperCheckout<\/b>\r\n\u2193<\/span>\r\nZahlungsm\u00f6glichkeiten<\/b>\r\n\u2193<\/span>\r\nZahlungsmodul<\/b>\r\n\u2193<\/span>\r\nGateway-API<\/b>\r\n\u2193<\/span>\r\nGateway-Antwort<\/b>\r\n\u2193<\/span>\r\nZahlungsmodul<\/b>\r\n\u2193<\/span>\r\nOPC \/ PrestaShop<\/b>\r\n\u2193<\/span>\r\nAuftragsbest\u00e4tigung<\/b><\/pre>\n
    Ein Zahlungsmodul kann daher aus API-Sicht v\u00f6llig korrekt sein und dennoch innerhalb eines OPC nicht korrekt funktionieren.<\/span><\/p>\n
    Deshalb sollte die Pr\u00fcfung der Zahlungskompatibilit\u00e4t immer beides umfassen:<\/span><\/p>\n