cms-drupal-commerce

Voraussetzungen prüfen

Installieren Sie die stabile Version 1.0.0 mit composer require drupal/commerce_paymos:^1.0. Verbinden Sie anschließend Ihren Shop mit Paymos und fügen Sie das Zahlungsgateway hinzu.

Sie benötigen Drupal ^10.3 || ^11 und Commerce ^3. Das Modul verlangt PHP ^8.1. Verlangt Ihre Drupal-Version eine neuere PHP-Version, gilt diese strengere Vorgabe. Der Shop muss über eine öffentliche HTTPS-Adresse erreichbar sein.

Das Modul ergänzt ein natives Offsite-Gateway. Kunden wechseln zum Bezahlen auf die Zahlungsseite; Bestellungen und Zahlungen bleiben in Drupal Commerce.

Modul installieren

Verwenden Sie vorzugsweise Composer. Sobald ein Release auf Drupal.org verfügbar ist, führen Sie im Drupal-Projekt folgenden Befehl aus:

composer require 'drupal/commerce_paymos:^1.0'

Alternativ installieren Sie das ZIP aus dem GitHub-Release. Das PHP-SDK ist enthalten. Legen Sie commerce_paymos im Verzeichnis für beigesteuerte Module ab und aktivieren Sie das Modul in Drupal. Für das Modul gilt GPL-2.0-or-later, für das SDK MIT.

Shop verbinden

Öffnen Sie zuerst das Paymos-Dashboard und wählen Sie das Projekt Ihres Shops. Gehen Sie dann in Drupal zu /admin/commerce/config/payment/paymos und wählen Sie Connect Paymos. Folgen Sie dem Bestätigungslink und genehmigen Sie die Verbindung für das aktuelle Projekt. Zurück in Drupal wählen Sie Check approval.

Legen Sie anschließend unter /admin/commerce/config/payment-gateways/add ein Gateway an. Wählen Sie Paymos und die Umgebung Sandbox oder Live. Dieser Schritt folgt auf die Verbindung des Shops und muss separat erfolgen.

Zugangsdaten liegen verschlüsselt im Drupal State. Der private Drupal-Schlüssel und hash_salt schützen sie; Konfigurationsexporte enthalten keine Geheimnisse. Verbinden Sie den Shop erneut, wenn sich seine kanonische URL ändert. /paymos/webhook wird automatisch eingerichtet. Sie müssen weder Geheimnisse eingeben noch den Webhook manuell anlegen.

Übernehmen Sie die Adressen aus der Drupal-Verwaltung einmalig in Ihr bestehendes Paymos-Projekt: /paymos/return unter Success URL und /paymos/return?cancel=1 unter Fail URL. Im gehosteten Checkout führt der Link Back to store zurück zum Shop. Die Rücksprungziele gelten eine Stunde lang für den letzten Paymos-Checkout in derselben Browsersitzung. Fehlen diese Sitzungsdaten, sind sie abgelaufen oder passen Bestellung und Zahlungs-Gateway nicht mehr, öffnet sich die Shop-Startseite. Die Rückkehr bestätigt keine Zahlung. Dafür zählen die geprüften Webhook/API-Daten und die native Zahlung in Drupal Commerce.

Bauen Sie nach dem Modulupdate den Drupal-Cache neu auf: drush --uri=https://your-store.example cache:rebuild.

Zahlungen prüfen

Auf signierte Benachrichtigungen folgt eine Abfrage über die API. Rechnung, Bestellung, Projekt, Umgebung, Betrag und Währung müssen zusammenpassen. Eine SQL-Transaktion speichert eine abgeschlossene Commerce-Zahlung. Wiederholte Benachrichtigungen erzeugen keine weitere Zahlung.

Teilzahlungen, verspätete Zahlungen und abweichende Daten lösen keine automatische Warenfreigabe aus. Prüfen Sie Abweichungen selbst. Wie die Bestellung erfüllt wird, regelt Ihr Commerce-Workflow; das Modul erstattet Zahlungen nicht automatisch.

Cron ausführen

Lassen Sie Drupal Cron regelmäßig laufen. Er prüft ungeklärte Rechnungen in begrenzten Gruppen. Geben Sie Drush die kanonische HTTPS-Adresse des Shops mit:

drush --uri=https://your-store.example cron

Modul entfernen

Klären Sie offene Rechnungen vor der Deinstallation. Solange ungeklärte Rechnungen vorliegen, bleibt sie gesperrt. Beim Entfernen werden lokale verschlüsselte Verbindungsdaten gelöscht; native Commerce-Zahlungen bleiben erhalten.

Weitere Plattformen finden Sie unter Plugins, darunter die Anleitung für WooCommerce.