Magento
Cost+ in Ihren Magento-Shop integrieren (2.x und 1.9 / OpenMage LTS)

Integrieren Sie Cost+ als Zahlungsmethode in Ihren Magento-Shop. Die Cost+ Erweiterung ist verfügbar für Magento 2 (2.4.6 – 2.4.8) und Magento 1.9 (einschließlich OpenMage LTS 20+).
Voraussetzungen
- Aktives Cost+ Händlerkonto
- Magento 2.4.6 – 2.4.8 Installation
- PHP 8.2 – 8.4
- Administratorzugang zu Ihrem Magento Admin-Panel
- SSH-Zugang zu Ihrem Server (für Composer-Installation)
- Aktives Cost+ Händlerkonto
- Magento 1.9.x oder OpenMage LTS 20+
- PHP 7.4 oder neuer
- Administratorzugang zu Ihrem Magento Admin-Panel
- SSH- oder FTP-Zugang zu Ihrem Server
1. Erweiterung installieren
Methode A: Installation über Composer (empfohlen)
Verbinden Sie sich per SSH mit Ihrem Magento-Server und navigieren Sie zu Ihrem Magento-Stammverzeichnis.
Installieren Sie das Plugin:
composer require nopayn/nopayn-magento-2Führen Sie die Magento-Setup-Befehle aus:
php bin/magento setup:upgrade
php bin/magento module:enable GingerPay_Payment
php bin/magento cache:cleanWenn Sie sich im Produktionsmodus befinden, führen Sie zusätzlich aus:
php bin/magento setup:static-content:deployMethode B: Manuelle Installation
- Navigieren Sie zu Ihrem
app/code-Verzeichnis - Laden Sie die Cost+ Version von GitHub herunter und entpacken Sie sie
- Führen Sie die Setup-Befehle aus:
php bin/magento setup:upgrade
php bin/magento cache:cleanIm Produktionsmodus:
php bin/magento setup:static-content:deployLaden Sie das Modul von GitHub herunter oder klonen Sie es.
Kopieren Sie den Inhalt von app/ in Ihr Magento-Stammverzeichnis app/:
cp -r app/* /path/to/magento/app/Leeren Sie den Magento-Cache:
rm -rf var/cache/*Melden Sie sich im Magento Admin-Panel an und navigieren Sie zu System → Konfiguration → Verkäufe → Zahlungsmethoden, um zu überprüfen, ob der Abschnitt NoPayn Payment Gateway angezeigt wird.
Das Modul erstellt eine nopayn_transactions-Tabelle in Ihrer Datenbank zur Nachverfolgung von Zahlungstransaktionen. Diese wird bei der ersten Verwendung automatisch erstellt.
2. Plugin konfigurieren
- Gehen Sie zu Stores → Konfiguration → Verkäufe → Zahlungsmethoden → Cost+ Payments
- Geben Sie Ihren API-Schlüssel ein (siehe Schritt 3 unten)
- Aktivieren Sie die Zahlungsmethoden, für die Sie freigeschaltet wurden
- Änderungen speichern
- Gehen Sie zu System → Konfiguration → Verkäufe → Zahlungsmethoden
- Finden Sie den Abschnitt NoPayn Payment Gateway
- Geben Sie Ihren API-Schlüssel ein (siehe Schritt 3 unten)
- Aktivieren Sie einzelne Zahlungsmethoden (Credit / Debit Card, Apple Pay, Google Pay, Vipps MobilePay)
- Optional nach Land einschränken
- Konfiguration speichern
3. 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.

Fügen Sie den API-Schlüssel in das Konfigurationsfeld ein und speichern Sie.
Aktivieren Sie nur die Zahlungsmethoden, für die Sie freigeschaltet wurden und eine Bestätigung erhalten haben.
Unterstützte Zahlungsmethoden
| Checkout-Name | NoPayn-Bezeichner |
|---|---|
| Credit / Debit Card | credit-card |
| Apple Pay | apple-pay |
| Google Pay | google-pay |
| Vipps MobilePay | vipps-mobilepay |
Zahlungsablauf
- Der Kunde wählt eine Zahlungsmethode an der Kasse und gibt die Bestellung auf
- 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
- Der Kunde wählt eine Zahlungsmethode an der Kasse und gibt die Bestellung auf
- Die Bestellung wird mit dem Status Pending Payment erstellt
- Der Kunde wird auf die sichere NoPayn-Zahlungsseite weitergeleitet
- Nach der Zahlung:
- Erfolg — Kunde kehrt zurück, Status über API verifiziert, Bestellung auf Processing gesetzt
- Storniert — Kunde kehrt zurück, Bestellung auf Canceled gesetzt
- Abgelaufen (5-Minuten-Timeout) — Webhook wird ausgelöst, Bestellung auf Canceled gesetzt
- NoPayn sendet einen Webhook zur asynchronen Statusbestätigung
Bestellstatus-Zuordnung
| NoPayn-Status | Magento Bestellstatus | Magento Bestellanzeige |
|---|---|---|
new | pending_payment | Pending Payment |
processing | pending_payment | Pending Payment |
completed | processing | Processing |
cancelled | canceled | Canceled |
expired | canceled | Canceled |
error | canceled | Canceled |
Webhooks
Das Modul registriert einen Webhook-Endpunkt unter /nopayn/payment/webhook. Diese URL wird beim Erstellen von Bestellungen automatisch an NoPayn übermittelt. Der Webhook verifiziert den Bestellstatus immer über die NoPayn API, bevor er die Magento-Bestellung aktualisiert.
Keine manuelle Webhook-Konfiguration erforderlich — das Modul übernimmt die Registrierung automatisch.
4. Einrichtung testen
- Geben Sie einige Testtransaktionen auf — sowohl erfolgreiche als auch fehlgeschlagene
- Überprüfen Sie, ob alle aktivierten Zahlungsmethoden an der Kasse angezeigt werden
- Konfigurieren Sie das Erfassungsverhalten (automatische Erfassung vs. manuell) basierend auf Ihrem Erfüllungsprozess
Support
Brauchen Sie Hilfe? Kontaktieren Sie unser Support-Team unter support@costplus.io.