DocsPrestaShop
Cost+ in Ihren PrestaShop-Shop integrieren (9.x, 8.x und 1.7)
Integrieren Sie Cost+ als Zahlungsmethode in Ihren PrestaShop-Shop. Das Cost+ Modul ist verfügbar für PrestaShop 9.x, PrestaShop 8.x und PrestaShop 1.7.
Voraussetzungen
- Aktives Cost+ Händlerkonto
- PrestaShop 9.1 oder neuer
- PHP 8.1 oder neuer
- SSL/HTTPS aktiviert
- Administratorzugang zu Ihrem PrestaShop Back Office
- Aktives Cost+ Händlerkonto
- PrestaShop 8.x Installation
- PHP 8.0 oder neuer
- Administratorzugang zu Ihrem PrestaShop Back Office
- MySQL 5.4 oder höher
- Aktives Cost+ Händlerkonto
- PrestaShop 1.7.x Installation
- PHP 5.4 oder neuer
- Administratorzugang zu Ihrem PrestaShop Back Office
- MySQL 5.4 oder höher
1. Modul installieren
Laden Sie das Modul von GitHub herunter.
Methode A: Upload über das Admin-Panel (empfohlen)
- Gehen Sie zu Module → Module Manager in Ihrem Admin-Panel
- Klicken Sie auf Upload a module
- Ziehen Sie die ZIP-Datei per Drag & Drop oder wählen Sie sie manuell aus
- Warten Sie, bis die Installation abgeschlossen ist
- Suchen Sie nach "NoPayn" und klicken Sie auf Configure
Methode B: Manueller Upload
- Kopieren Sie den Ordner
nopaynpayment/in Ihr PrestaShop-Verzeichnismodules/ - Gehen Sie zu Module → Module Manager
- Suchen Sie nach "NoPayn" und klicken Sie auf Install
- Klicken Sie auf Configure, um die Einstellungen zu öffnen
Laden Sie das Modul von GitHub herunter.
Methode A: Upload über das Admin-Panel (empfohlen)
- Gehen Sie zu Improve > Module Manager in Ihrem Admin-Panel
- Klicken Sie auf Upload a module
- Ziehen Sie die ZIP-Datei per Drag & Drop oder wählen Sie sie manuell aus
- Warten Sie, bis die Installation abgeschlossen ist
- Scrollen Sie zum Abschnitt "Other" und klicken Sie auf Configure unter Cost+
Methode B: Manueller Upload per (S)FTP
- Entpacken Sie die heruntergeladene ZIP-Datei
- Laden Sie mit einem SFTP-Client (z. B. FileZilla, WinSCP) alle Ordner in das
/modules/-Verzeichnis Ihrer PrestaShop-Installation hoch - Gehen Sie zu Improve > Modules > Module Catalog
- Suchen Sie nach "Cost+" — prüfen Sie den Tab Uninstalled Modules falls nötig
- Klicken Sie auf Install
Laden Sie das Modul von GitHub herunter.
Methode A: Upload über das Admin-Panel (empfohlen)
- Gehen Sie zu Improve > Module Manager in Ihrem Admin-Panel
- Klicken Sie auf Upload a module
- Ziehen Sie die ZIP-Datei per Drag & Drop oder wählen Sie sie manuell aus
- Warten Sie, bis die Installation abgeschlossen ist
- Scrollen Sie zum Abschnitt "Other" und klicken Sie auf Configure unter Cost+
Methode B: Manueller Upload per (S)FTP
- Entpacken Sie die heruntergeladene ZIP-Datei
- Laden Sie mit einem SFTP-Client (z. B. FileZilla, WinSCP) alle Ordner in das
/modules/-Verzeichnis Ihrer PrestaShop-Installation hoch - Gehen Sie zu Modules > Module Manager
- Suchen Sie nach "Cost+" — prüfen Sie den Tab Uninstalled Modules falls nötig
- Klicken Sie auf Install
2. API-Zugangsdaten eingeben
Melden Sie sich im Händlerportal an und navigieren Sie zu Websites, klicken Sie dann auf die Website, die Sie verbinden möchten. Klicken Sie auf Integration, wo Sie Ihren API-Schlüssel finden.
Geben Sie in der NoPayn-Modulkonfiguration Ihren API Key ein und konfigurieren Sie die folgenden Einstellungen:
| Einstellung | Beschreibung |
|---|---|
| API Key | Ihr NoPayn API-Schlüssel |
| Credit / Debit Card | Kreditkartenzahlungen aktivieren/deaktivieren |
| Apple Pay | Apple Pay aktivieren/deaktivieren |
| Google Pay | Google Pay aktivieren/deaktivieren |
| Vipps MobilePay | Vipps MobilePay aktivieren/deaktivieren |
| Manual Capture | Kreditkartenzahlungen nur autorisieren — Erfassung beim Versand |
| Debug Logging | Detaillierte Protokollierung in var/logs/nopayn_debug.log aktivieren |
Fügen Sie den Schlüssel in das Feld API Key auf der Cost+ Library Konfigurationsseite ein und klicken Sie auf Save.
Fügen Sie den Schlüssel in das Feld API Key auf der Cost+ Library Konfigurationsseite ein und klicken Sie auf Save.
Aktivieren Sie bei PrestaShop 8.x und 1.7 Hosting-Umgebungen die Option cURL CA bundle während der Konfiguration, um SSL-Zertifikatprobleme zu vermeiden.
3. Zahlungsmethoden aktivieren
Zahlungsmethoden werden direkt in den Moduleinstellungen konfiguriert (siehe Schritt 2 oben). Schalten Sie jede Methode nach Bedarf ein oder aus.
Aktivieren Sie nur die Zahlungsmethoden, für die Sie freigeschaltet wurden und eine Bestätigung erhalten haben.
Nachdem Sie Ihren API-Schlüssel gespeichert haben, laden Sie jedes Zahlungsmethoden-Modul separat über Upload a module hoch.
Kehren Sie zu Improve > Module Manager zurück, klicken Sie erneut auf Upload a module und laden Sie jede ZIP-Datei für die gewünschten Zahlungsmethoden hoch (z. B. Kreditkarte, MobilePay, Swish).
Aktivieren Sie nur die Zahlungsmethoden, für die Sie freigeschaltet wurden und eine Bestätigung erhalten haben.
Zahlungsmodule haben entweder eine Configure-Option (wenn zusätzliche Einrichtung erforderlich ist) oder nur einen Aktivieren/Deaktivieren-Schalter.
Nachdem Sie Ihren API-Schlüssel gespeichert haben, laden Sie jedes Zahlungsmethoden-Modul separat über Upload a module hoch.
Kehren Sie zu Improve > Module Manager zurück, klicken Sie erneut auf Upload a module und laden Sie jede ZIP-Datei für die gewünschten Zahlungsmethoden hoch (z. B. Kreditkarte, MobilePay, Swish).
Aktivieren Sie nur die Zahlungsmethoden, für die Sie freigeschaltet wurden und eine Bestätigung erhalten haben.
Zahlungsmodule haben entweder eine Configure-Option (wenn zusätzliche Einrichtung erforderlich ist) oder nur einen Aktivieren/Deaktivieren-Schalter.
Zahlungsablauf
- Der Kunde wählt eine Cost+ Zahlungsmethode an der Kasse
- Der Kunde wird auf die Cost+ Hosted Payment Page (HPP) weitergeleitet
- Nach Abschluss der Zahlung wird der Kunde zurück zum Shop weitergeleitet
- Ein Webhook bestätigt den Zahlungsstatus Server-zu-Server
Webhook
Die Webhook-URL wird automatisch pro Bestellung konfiguriert:
https://your-shop.com/module/nopaynpayment/webhookKeine manuelle Webhook-Konfiguration erforderlich — das Modul übernimmt die Registrierung automatisch.
Manuelle Erfassung
Wenn für Kreditkartenzahlungen aktiviert:
- Die Zahlung wird an der Kasse autorisiert, aber nicht erfasst
- Die Erfassung erfolgt, wenn die Bestellung versandt / als abgeschlossen markiert wird
- Wird die Bestellung storniert, wird die Autorisierung automatisch storniert
Automatische Erstattung
Wenn eine erfasste Zahlungsbestellung storniert wird, stellt das Modul automatisch eine vollständige Erstattung aus. Teilerstattungen können über PrestaShop-Gutschriften verarbeitet werden.
Checkout-Button-Beschriftungen
Für die beste Benutzererfahrung bei Offsite-Weiterleitungsabläufen empfiehlt es sich, die Checkout-Button-Beschriftung auf "Bestellung überprüfen" statt "Bestätigen und bezahlen" zu ändern, da die eigentliche Zahlung auf der gehosteten Cost+-Seite stattfindet. Dies ist eine globale PrestaShop-Einstellung, nicht modulspezifisch.
Webhook
Der Webhook wird vom Modul automatisch konfiguriert. Keine manuelle Einrichtung erforderlich.
Webhook
Der Webhook wird vom Modul automatisch konfiguriert. Keine manuelle Einrichtung erforderlich.
4. Letzte Schritte und Tests
- Überprüfen Sie alle aktivierten Zahlungsmethoden
- Geben Sie einige Testtransaktionen auf — sowohl erfolgreiche als auch fehlgeschlagene — um sicherzustellen, dass alles reibungslos funktioniert
- Konfigurieren Sie das erweiterte Verhalten wie manuelle vs. automatische Erfassung je nach Ihrem Erfüllungsprozess
Support
Brauchen Sie Hilfe? Kontaktieren Sie unser Support-Team unter support@costplus.io.