Cost+Docs

Shopware

Cost+ über das offizielle Zahlungs-Plugin in Ihren Shopware 6 Shop integrieren

Shopware

Integrieren Sie Cost+ als Zahlungsmethode in Ihren Shopware 6 Shop. Das offizielle NoPayn Payment Plugin unterstützt mehrere Zahlungsmethoden pro Verkaufskanal und verwendet den Hosted Payment Page Ablauf — vollständig PCI-DSS-konform.

Voraussetzungen

  • Aktives Cost+ Händlerkonto
  • Shopware 6.7 oder neuer
  • PHP 8.2 oder neuer
  • SSH- oder Terminal-Zugang zu Ihrem Shopware-Server

Unterstützte Zahlungsmethoden

Checkout-NameTechnischer NameNoPayn-Bezeichner
Credit / Debit Cardnopayn_credit_cardcredit-card
Apple Paynopayn_apple_payapple-pay
Google Paynopayn_google_paygoogle-pay
Vipps MobilePaynopayn_vipps_mobilepayvipps-mobilepay

Jede Methode kann pro Verkaufskanal in der Plugin-Konfiguration aktiviert oder deaktiviert werden.

1. Plugin installieren

Klonen oder kopieren Sie das Plugin in Ihr Shopware-Verzeichnis custom/plugins/:

cd /path/to/shopware/custom/plugins
git clone git@github.com:NoPayn/shopware.git NoPaynPayment

Dann installieren und aktivieren Sie es über die Shopware CLI:

bin/console plugin:refresh
bin/console plugin:install NoPaynPayment --activate
bin/console cache:clear

2. Plugin konfigurieren

  1. Gehen Sie in Ihrem Shopware-Admin zu Einstellungen → Erweiterungen → NoPayn Payment
  2. Geben Sie Ihren API-Schlüssel aus dem Händlerportal ein — navigieren Sie zu Websites, klicken Sie auf die Website, die Sie verbinden möchten, und dann auf Integration, um Ihren API-Schlüssel zu finden
  3. Schalten Sie einzelne Zahlungsmethoden ein oder aus
  4. Speichern

Cost+ Händlerportal mit API-Schlüssel

Sie können einen anderen API-Schlüssel pro Verkaufskanal konfigurieren, wenn Sie mehrere Storefronts betreiben.

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

3. Zahlungsablauf

  1. Der Kunde wählt eine Zahlungsmethode an der Kasse und gibt die Bestellung auf
  2. Die Bestellung wird mit dem Transaktionsstatus in_progress erstellt
  3. Der Kunde wird auf die NoPayn Hosted Payment Page weitergeleitet
  4. Nach der Zahlung:
    • Erfolg — Kunde kehrt zurück, Status wird über API verifiziert, Transaktion auf paid gesetzt, Bestellung auf processing
    • Storniert — Kunde kehrt zurück, Transaktion und Bestellung auf cancelled gesetzt
    • Abgelaufen (5-Minuten-Timeout) — Webhook wird ausgelöst, Transaktion und Bestellung auf cancelled gesetzt

4. Bestellstatus-Zuordnung

NoPayn-StatusTransaktionsstatusBestellstatus
newin_progressopen
processingin_progressopen
completedpaidin_progress
cancelledcancelledcancelled
expiredcancelledcancelled
errorcancelledcancelled

5. Webhooks

Das Plugin registriert automatisch einen Webhook-Endpunkt unter /api/nopayn/webhook. Diese URL wird beim Erstellen von Bestellungen an NoPayn übermittelt und bietet asynchrone Statusbestätigung für alle Transaktionen.

Keine manuelle Webhook-Konfiguration erforderlich — das Plugin übernimmt die Registrierung automatisch.

6. 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