DocsOpenCart
Cost+ in Ihren OpenCart-Shop integrieren (4.x und 3.x / ocStore 3)
Integrieren Sie Cost+ als Zahlungsmethode in Ihren OpenCart-Shop. Die offizielle NoPayn Payment Gateway Erweiterung ist verfügbar für OpenCart 4 und OpenCart 3 / ocStore 3.
Voraussetzungen
- Aktives Cost+ Händlerkonto
- OpenCart 4.0.0.0 oder neuer
- PHP 8.0 oder neuer
- Administratorzugang zu Ihrem OpenCart-Dashboard
- Aktives Cost+ Händlerkonto
- ocStore 3.0.x oder OpenCart 3.0.3.x
- PHP 7.4 oder neuer
- Administratorzugang zu Ihrem OpenCart-Dashboard
Unterstützte Zahlungsmethoden
- Credit / Debit Card — Visa, Mastercard, Amex, Maestro, V Pay, Bancontact, Diners, Discover
- Apple Pay
- Google Pay
- Vipps / MobilePay
- Credit / Debit Card — Visa, Mastercard, Amex, Maestro, V Pay, Bancontact, Diners, Discover
- Apple Pay
- Google Pay
- Vipps / MobilePay
- Swish
1. Erweiterung installieren
Methode A: Upload über das Admin-Panel (empfohlen)
- Laden Sie die neueste
.ocmod.zip-Version von GitHub herunter - Gehen Sie in Ihrem OpenCart-Admin zu Extensions → Installer
- Laden Sie die
.ocmod.zip-Datei hoch - Gehen Sie zu Extensions → Extensions → Payment
- Finden Sie NoPayn Payment Gateway und klicken Sie auf Install, dann auf Edit
Methode B: Manueller Upload
- Laden Sie das Repository herunter oder klonen Sie es
- Kopieren Sie den Inhalt des
upload/-Ordners in Ihr OpenCart-Stammverzeichnis - Gehen Sie zu Extensions → Extensions → Payment
- Finden Sie NoPayn Payment Gateway und klicken Sie auf Install, dann auf Edit
Architektur
OpenCart 3 verwendet ein Multi-Extension-Setup:
- NoPayn - Global Settings — gemeinsame Konfiguration (API-Schlüssel, Bestellstatus, Methodenverfügbarkeit, manuelle Erfassung, Debug-Logging)
- NoPayn - Card Payments — Kredit-/Debitkarten-Checkout
- NoPayn - Apple Pay / Google Pay — Wallet-Checkout (wenn nur ein Wallet aktiviert ist, passt sich die Beschriftung automatisch an)
- NoPayn - Vipps MobilePay — Vipps/MobilePay-Checkout
- NoPayn - Swish — Swish-Checkout
Methode A: Upload über das Admin-Panel (empfohlen)
- Laden Sie das
.ocmod.zip-Asset von der neuesten GitHub-Version herunter
Verwenden Sie das .ocmod.zip-Asset aus der Version — nicht GitHubs automatisch generierte "Source code"-Downloads, die das Repository-Layout enthalten, nicht das Installer-Layout.
- Gehen Sie im Admin zu Extensions → Installer
- Laden Sie die
.ocmod.zip-Datei hoch - Gehen Sie zu Extensions → Extensions → Payments
- Installieren Sie zuerst NoPayn - Global Settings
- Öffnen Sie NoPayn - Global Settings und konfigurieren Sie:
- API-Schlüssel
- Bestellstatus für abgeschlossene, ausstehende und stornierte Bestellungen
- Verfügbare Zahlungsmethoden, für die Ihr Händlerkonto freigeschaltet ist
- Optional: manuelle Kartenerfassung
- Optional: Debug-Logging
- Installieren Sie die Checkout-Module, die Sie anzeigen möchten:
- NoPayn - Card Payments
- NoPayn - Apple Pay / Google Pay
- NoPayn - Vipps MobilePay
- NoPayn - Swish
- Für jedes Checkout-Modul setzen Sie: Status, Geo Zone und Sort Order
Methode B: Manueller Upload
- Laden Sie das Repository herunter oder klonen Sie es
- Kopieren Sie den Inhalt des
upload/-Ordners in Ihr Shop-Stammverzeichnis - Gehen Sie zu Extensions → Extensions → Payments
- Folgen Sie der gleichen Installationsreihenfolge wie bei Methode A (Global Settings zuerst, dann Checkout-Module)
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 den NoPayn Payment Gateway Einstellungen Ihren API Key im entsprechenden Feld ein.
Geben Sie in NoPayn - Global Settings Ihren API Key im entsprechenden Feld ein. Der API-Schlüssel wird von allen Checkout-Modulen gemeinsam genutzt — Sie müssen ihn nur einmal eingeben.
3. Zahlungseinstellungen konfigurieren
- Aktivieren Sie die Zahlungsmethoden, für die Sie freigeschaltet wurden
- Setzen Sie Ihre bevorzugten Bestellstatus für abgeschlossene, ausstehende und stornierte Zahlungen
- Schränken Sie Zahlungen optional nach Geo Zone ein
- Setzen Sie Status auf Enabled
- Klicken Sie auf Save
Globale Einstellungen
NoPayn - Global Settings speichert alle gemeinsamen Konfigurationen:
| Einstellung | Beschreibung |
|---|---|
| API Key | Ihr NoPayn API-Schlüssel |
| Order Statuses | Zuordnung für abgeschlossene, ausstehende und stornierte Status |
| Method Availability | Für welche Zahlungsmethoden Ihr Händlerkonto freigeschaltet ist |
| Manual Capture | Kreditkartenzahlungen nur autorisieren — später erfassen |
| Debug Logging | Detaillierte Protokollierung zur Fehlerbehebung aktivieren |
Checkout-Modul-Einstellungen
Jedes Checkout-Modul hat eigene Storefront-Einstellungen:
| Einstellung | Beschreibung |
|---|---|
| Status | Diese Zahlungsmethode an der Kasse aktivieren oder deaktivieren |
| Geo Zone | Auf bestimmte geografische Zonen einschränken |
| Sort Order | Anzeigereihenfolge auf der Kassenseite |
Aktivieren Sie nur die Zahlungsmethoden, für die Sie freigeschaltet wurden und eine Bestätigung erhalten haben.
Zahlungsablauf
- Der Kunde wählt eine Cost+ Zahlungsmethode an der Kasse
- Der Kunde wird auf die NoPayn Hosted Payment Page weitergeleitet
- Nach der Zahlung kehrt der Kunde zurück und der Bestellstatus wird automatisch aktualisiert
- NoPayn sendet einen Webhook zur asynchronen Statusbestätigung
Die Erweiterung verwendet die Cost+ Hosted Payment Page, d. h. Kunden werden zu einem sicheren Zahlungsformular weitergeleitet. Keine sensiblen Kartendaten werden von Ihrem Server verarbeitet.
Jedes Checkout-Modul ist eine separate OpenCart-Zahlungserweiterung, die Kunden an der Kasse eigene Radio-Optionen bietet (z. B. "Card Payments", "Apple Pay & Google Pay").
- Der Kunde wählt eine Zahlungsmethode an der Kasse (z. B. Card Payments)
- Die Erweiterung erstellt eine NoPayn Hosted-Payment-Bestellung
- Der Kunde wird auf die sichere NoPayn-Zahlungsseite weitergeleitet
- Nach der Zahlung kehrt der Kunde zurück und der Bestellstatus wird automatisch aktualisiert
- NoPayn sendet einen Webhook zur asynchronen Statusbestätigung
Das Apple Pay / Google Pay Modul sendet beide Methoden in einer Transaktion, sodass die NoPayn-gehostete Seite beide Wallet-Optionen in einem einzigen Ablauf anbieten kann.
Upgrade von v1.0.0 auf v2.0.0
Version 1.0.0 verwendete eine einzelne Checkout-Methode namens "NoPayn Checkout". Version 2.0.0 wechselt zu separaten Checkout-Modulen pro Zahlungsmethode. Beim Upgrade:
- Laden Sie das neue Paket hoch
- Ihr bestehender "NoPayn Checkout"-Eintrag wird zu NoPayn - Global Settings
- Überprüfen und speichern Sie die globalen Einstellungen
- Installieren und aktivieren Sie die neuen Checkout-Module, die Sie Kunden anzeigen möchten
4. Testen und starten
Führen Sie einige Testtransaktionen durch, um sicherzustellen, dass alles reibungslos funktioniert. Wir empfehlen, sowohl erfolgreiche als auch fehlgeschlagene Zahlungen zu testen, um alle Szenarien korrekt zu bestätigen.
Support
Brauchen Sie Hilfe? Kontaktieren Sie unser Support-Team unter support@costplus.io.