osCommerce

Integrieren Sie Cost+ als Zahlungsmethode in Ihren osCommerce 4 Shop. Das offizielle NoPayn Payments Modul verwendet den Hosted Payment Page Ablauf, sodass keine Kartendaten Ihren Server berühren — vollständig PCI-DSS-konform.

Voraussetzungen

Aktives Cost+ Händlerkonto
osCommerce 4.x
PHP 8.1 oder neuer
cURL-Erweiterung aktiviert
SSL-Zertifikat (HTTPS erforderlich)
Administratorzugang zu Ihrem osCommerce Admin-Panel

Unterstützte Zahlungsmethoden

Checkout-Bezeichnung	NoPayn-Bezeichner
Credit / Debit Card	`credit-card`
Apple Pay	`apple-pay`
Google Pay	`google-pay`
Vipps MobilePay	`vipps-mobilepay`

Jede Methode kann einzeln im Admin-Panel aktiviert oder deaktiviert werden.

1. Modul installieren

Laden Sie das Modul von GitHub herunter oder klonen Sie es.

Kopieren Sie das lib/-Verzeichnis in Ihr osCommerce 4 Stammverzeichnis:

cp -r lib/ /path/to/oscommerce/

Dadurch werden die Moduldateien platziert unter:

lib/common/modules/orderPayment/nopayn.php
lib/common/modules/orderPayment/nopayn/NoPaynApiClient.php
lib/common/modules/orderPayment/nopayn/NoPaynLogger.php
lib/common/modules/orderPayment/nopayn/NoPaynWebhookHandler.php

In Ihrem osCommerce Admin-Panel:

Navigieren Sie zu Modules → Payment → Online
Aktivieren Sie bei Bedarf die Filter "Show inactive" und "Show not installed"
Finden Sie NoPayn Payments und klicken Sie auf Install

2. Modul konfigurieren

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.

Cost+ Händlerportal mit API-Schlüssel

Geben Sie Ihren API Key ein und konfigurieren Sie die folgenden Einstellungen:

Einstellung	Beschreibung	Standard
Enable NoPayn Payments	Hauptschalter zum Aktivieren/Deaktivieren	True
API Key	Ihr NoPayn API-Schlüssel	—
Enable Credit / Debit Card	Kredit-/Debitkarte an der Kasse anzeigen	True
Enable Apple Pay	Apple Pay an der Kasse anzeigen	True
Enable Google Pay	Google Pay an der Kasse anzeigen	True
Enable Vipps MobilePay	Vipps MobilePay an der Kasse anzeigen	True
Manual Capture (Credit Card)	Nur autorisieren — Erfassung bei Bestellabschluss	False
Debug Logging	API-Anfragen/-Antworten in Log schreiben	False
Completed Order Status	Status bei erfolgreicher Zahlung	Processing
Pending Order Status	Status während der Zahlungserwartung	Pending
Cancelled Order Status	Status bei Stornierung/Fehler/Ablauf	Cancelled
Payment Zone	Auf eine geografische Zone einschränken (optional)	Alle Zonen
Sort Order	Anzeigereihenfolge auf der Kassenseite	0

Aktivieren Sie nur die Zahlungsmethoden, für die Sie freigeschaltet wurden und eine Bestätigung erhalten haben.

3. Checkout-Beschriftungen aktualisieren (empfohlen)

Die Standard-Checkout-Button-Beschriftungen in osCommerce gehen von einem einstufigen Ablauf aus. Für eine bessere Erfahrung mit der Offsite-Zahlungsweiterleitung aktualisieren Sie diese Übersetzungen unter Admin → Localisation → Languages → English → Define:

Schlüssel	Standard	Empfohlen
`TEXT_PAY_WITH_CARD`	Pay with card	Go to payment
`TEXT_CONFIRM_AND_PAY`	Confirm and pay	Review order
`CONFIRM_ORDER`	Confirm order	Confirm and pay

Dies verbessert die Kundenerfahrung, indem der Checkout-Ablauf klarer wird — Kunden verstehen, dass sie zur Zahlung auf eine sichere Seite weitergeleitet werden.

4. Zahlungsablauf

Sobald konfiguriert, funktioniert der Zahlungsablauf wie folgt:

Der Kunde wählt eine Cost+ Zahlungsmethode an der Kasse
Der Kunde bestätigt die Bestellung
Das Modul erstellt eine ausstehende Bestellung und ruft die Cost+ API auf
Der Kunde wird auf die Cost+ Hosted Payment Page (HPP) weitergeleitet
Der Kunde schließt die Zahlung auf der sicheren HPP ab
Der Kunde wird zurück zum Shop weitergeleitet
Das Modul verifiziert den Zahlungsstatus über die Cost+ API
Der Bestellstatus wird entsprechend aktualisiert

Zahlungslinks laufen nach 5 Minuten ab. Wenn der Kunde die Zahlung nicht innerhalb dieses Zeitfensters abschließt, wird die Bestellung automatisch als storniert markiert.

5. Webhooks

Das Modul registriert eine Webhook-URL bei Cost+ für Server-zu-Server-Statusaktualisierungen. Wenn sich ein Zahlungsstatus ändert, sendet Cost+ eine Benachrichtigung, und das Modul:

Empfängt den Webhook-POST
Verifiziert den Zahlungsstatus über die API (vertraut niemals dem Webhook-Payload)
Aktualisiert den Bestellstatus in osCommerce

Keine 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 in den Status completed wechselt
Bei Stornierung der Bestellung wird die Autorisierung automatisch storniert

Verwenden Sie die manuelle Erfassung, wenn Sie Kunden erst beim Versand belasten möchten. Dies ist nützlich für Händler mit längeren Erfüllungszeiten.

Debug-Logging

Wenn Debug Logging aktiviert ist, schreibt das Modul in nopayn_debug.log im osCommerce-Log-Verzeichnis. Log-Einträge umfassen:

Alle API-Anfragen und -Antworten
Webhook-Ereignisse und Verarbeitungsergebnisse
Erfassungs- und Stornierungsoperationen
Fehler (werden immer protokolliert, unabhängig vom Debug-Schalter)

Alle Einträge sind mit NoPayn_ für einfaches Filtern versehen.

Deinstallation

Gehen Sie zu Modules → Payment → Online im Admin-Panel
Wählen Sie NoPayn Payments
Klicken Sie auf Remove

Die Deinstallation des Moduls entfernt die Konfiguration und löscht die Datenbanktabellen nopayn_transactions und nopayn_refunds. Stellen Sie sicher, dass Sie alle benötigten Daten exportieren, bevor Sie deinstallieren.

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.

On this page