Zum Inhalt springen

Plugins

Auf dieser Seite

Magento 2 Plugin

Das Paymos Modul für Magento 2 oder Adobe Commerce installieren, Test- und Live-Zugangsdaten verbinden und den Weg von der Bestellung zur Rechnung prüfen.

1. Voraussetzungen

  • Magento Open Source oder Adobe Commerce 2.4.x und Zugriff auf die Kommandozeile
  • Ein Paymos-Konto mit einem im Dashboard ausgewählten Projekt
  • Das Modul selbst: über Composer aus dem Adobe Commerce Marketplace oder das offizielle ZIP aus den GitHub Releases

Die offiziellen Pakete sind für jeden Händler identisch und enthalten weder API-Schlüssel noch API Secrets, Projektkennungen, Webhook-Geheimnisse, OAuth-Token oder Gerätecodes.

2. Installieren

Magento hat keinen Uploader für Erweiterungen im Adminbereich, deshalb enden beide Wege bei denselben Konsolenbefehlen. Wählen Sie zuerst, wie die Dateien kommen.

Adobe Commerce Marketplace. Sobald das Modul dort gelistet ist, bringt Composer das Modul und das Paymos PHP SDK gemeinsam mit:

composer require paymos/magento2-payment

ZIP aus dem Dashboard. Laden Sie paymos-magento2-<version>.zip aus den GitHub Releases oder aus dem Bereich CMS-Integration im Paymos Dashboard und entpacken Sie es im Magento-Hauptverzeichnis. Das Archiv ist bereits als app/code/Paymos/Payment/… abgelegt, das SDK ist mitgeliefert — nichts muss verschoben werden, und ein Composer-Schritt entfällt.

Beide Wege enden mit denselben Befehlen:

bin/magento module:enable Paymos_Payment
bin/magento setup:upgrade
bin/magento setup:di:compile   # nur im Production-Modus
bin/magento cache:clean

setup:upgrade legt zwei Tabellen an: paymos_payment_invoice, eine Momentaufnahme pro Bestellung, und paymos_payment_event, das Journal zur Webhook-Deduplizierung. Öffnen Sie danach Stores → Konfiguration → Verkäufe → Zahlungsmethoden → Paymos und klicken Sie auf Connect Paymos.

3. Verbinden

  1. Öffnen Sie im Paymos Dashboard das Projekt, das Sie verbinden möchten. Das Plugin nutzt dieses aktuelle Projekt automatisch und fragt Sie nie erneut danach.
  2. Klicken Sie in Magento auf Connect Paymos.
  3. Bestätigen Sie in Paymos die angezeigte Shop-URL und das aktuelle Projekt. Einen zweiten Projektwähler gibt es nicht.
  4. Kehren Sie ins CMS zurück, sobald der Status „verbunden“ erscheint.

Für Sandbox und Live nutzt Paymos den einen aktiven Payment-Schlüssel des Händlers weiter oder legt einen an, wenn keiner existiert. Ein Webhook wird nur dann wiederverwendet, wenn Callback-URL, Kategorie Invoice und aktuelles Projekt exakt übereinstimmen; andernfalls entsteht ein eigener Invoice-Webhook. Ein abweichender Webhook unter derselben URL wird nie stillschweigend überschrieben:

https://your-store.example/paymos/payment/callback

Die OAuth-Geräteautorisierung ist nur der einmalige Übertragungsweg. Das kurzlebige Token wird verworfen; die laufenden Aufrufe der Händler-API bleiben HMAC-signiert.

4. Ablage der Geheimnisse

Zugangsdaten und vorübergehender Gerätezustand werden in core_config_data abgelegt, verschlüsselt über das Magento EncryptorInterface und den Verschlüsselungsschlüssel der Installation. Gespeicherte Geheimnisse werden nicht in den Adminbereich zurückgeschrieben.

5. Testen und live gehen

Wählen Sie Sandbox, geben Sie eine Testbestellung auf und prüfen Sie die Rechnung sowie die vom Webhook ausgelöste Statusänderung. Stellen Sie dieselbe Installation auf Live um, wenn Sie bereit sind; neu verbinden müssen Sie nur, wenn sich die Shop-URL ändert, ein Payment-Schlüssel widerrufen oder ein Webhook-Geheimnis gewechselt wird.

CS-Cart Plugin Shopware 6 Plugin