Drupal Commerce

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

Voraussetzungen

• Aktives Cost+ Händlerkonto
• Drupal 10 oder 11
• Drupal Commerce 3.x
• PHP 8.1 oder neuer
• Administratorzugang zu Ihrer Drupal-Website

Unterstützte Zahlungsmethoden

• Credit / Debit Card — Visa, Mastercard und mehr
• Apple Pay
• Google Pay
• Vipps / MobilePay

1. Modul installieren

Kopieren Sie das Modul commerce_nopayn in Ihre Drupal-Installation und aktivieren Sie es:

cp -r commerce_nopayn /path/to/drupal/web/modules/custom/
drush en commerce_nopayn -y
drush cr

2. Zahlungsgateway hinzufügen

1. Navigieren Sie zu Commerce → Konfiguration → Zahlungsgateways (/admin/commerce/config/payment-gateways)
2. Klicken Sie auf Zahlungsgateway hinzufügen
3. Wählen Sie NoPayn Payment Gateway als Plugin

3. Gateway konfigurieren

Geben Sie die folgenden Einstellungen ein:

• NoPayn API Key — Ihr Händler-API-Schlüssel aus dem Händlerportal
• Payment Methods — Credit Card, Apple Pay, Google Pay, Vipps MobilePay aktivieren oder deaktivieren
• Mode — Setzen Sie auf Test, wenn Sie einen API-Schlüssel einer Sandbox-Website verwenden, oder Live, wenn Sie einen Produktions-Website-Schlüssel verwenden

Optionale Einstellungen

• Manual Capture — Kreditkartenzahlungen ohne sofortige Erfassung autorisieren (Geld wird reserviert, dann beim Erfüllen der Bestellung erfasst)
• Debug Logging — Aktivieren, um alle API-Anfragen und -Antworten im Drupal-Log zur Fehlerbehebung zu protokollieren

Klicken Sie auf Speichern, wenn Sie fertig sind.

4. Zahlungsablauf

Sobald konfiguriert, funktioniert der Zahlungsablauf wie folgt:

1. Der Kunde legt Produkte in den Warenkorb und geht zur Kasse
2. Beim Zahlungsschritt werden die aktivierten Cost+ Methoden als Radio-Buttons angezeigt
3. Der Kunde wählt eine Methode und bestätigt die Bestellung
4. Das Modul erstellt eine Bestellung über die Cost+ API und leitet auf die gehostete Zahlungsseite weiter
5. Der Kunde schließt die Zahlung auf der Cost+-Seite ab
6. Der Kunde kehrt zum Shop zurück — die Zahlung wird über die API verifiziert
7. Ein Webhook von Cost+ bestätigt asynchron das Zahlungsergebnis

5. Webhook-Konfiguration

Die Webhook-URL wird automatisch von Drupal Commerce generiert:

https://your-store.com/payment/notify/{gateway_machine_name}

Beispiel: https://your-store.com/payment/notify/nopayn

Diese URL muss aus dem Internet ohne Authentifizierung erreichbar sein. Das Modul verifiziert den Zahlungsstatus immer über die API — es vertraut niemals dem Webhook-Payload allein.

Manuelle Erfassung

Wenn die manuelle Erfassung für Kreditkarten aktiviert ist:

1. Die Karte des Kunden wird beim Checkout autorisiert (Geld reserviert)
2. Die Erfassung erfolgt automatisch, wenn die Bestellung in den Status Fulfilled wechselt
3. Bei Stornierung der Bestellung wird die Autorisierung per Webhook storniert

Erstattungen

Erstattungen können direkt über das Commerce-Admin-Panel verarbeitet werden. Sowohl vollständige als auch teilweise Erstattungen werden unterstützt.

Datenbanktabellen

Das Modul erstellt zwei Tabellen zur Nachverfolgung:

Deinstallation

drush pmu commerce_nopayn -y
drush cr

Testen und starten

Führen Sie einige Testtransaktionen durch, um sicherzustellen, dass alles reibungslos funktioniert. Setzen Sie den Gateway-Mode auf Test und verifizieren Sie sowohl erfolgreiche als auch fehlgeschlagene Zahlungen, bevor Sie auf Live umschalten.

Support

Brauchen Sie Hilfe? Kontaktieren Sie unser Support-Team unter support@costplus.io.