Zum Inhalt springen
Plugins
.md öffnen
Auf dieser Seite

Krypto-Zahlungen in HikaShop einrichten

So installieren Sie das Paymos-Plugin in Joomla, testen die Zahlungsart in HikaShop und prüfen Zahlungen und Erstattungen.

Mit dem Paymos-Plugin können Ihre Kunden in HikaShop mit Krypto bezahlen. Ob die Zahlung eingegangen ist, prüfen Sie in der Bestellung.

Was Ihr Joomla-Shop braucht

Das Plugin läuft mit Joomla 5.4 oder 6.2, HikaShop 6.8.1 oder einem neueren Patch der Reihe 6.8 und PHP ab 8.3 mit cURL und OpenSSL. Ihr Shop muss öffentlich per HTTPS erreichbar sein.

Setzen Sie in HikaShop die Einstellung Order created status auf created. Die Status confirmed und refunded müssen verfügbar bleiben. Die nativen HikaShop-Tabellen für Bestellungen, Bestellverlauf, Produkte, Bestellpositionen, Rabatte und Benutzer müssen InnoDB verwenden.

Vom Download zur Testbestellung

Laden Sie die kostenlose ZIP-Datei für Joomla von GitHub. Öffnen Sie in Joomla System → Installieren → Erweiterungen und laden Sie dort die ZIP-Datei hoch. Unter System → Verwalten → Plugins aktivieren Sie anschließend Payment - Paymos for HikaShop.

In HikaShop geht es unter System → Zahlungsarten weiter. Legen Sie eine Zahlungsart für Paymos an und speichern Sie sie. Klicken Sie auf Connect Paymos und wählen Sie in Paymos das Projekt für Ihren Shop.

Speichern Sie die Zahlungsart zunächst im Modus Sandbox. Geben Sie sie für Ihre Testgruppe frei und bezahlen Sie eine Testbestellung. Prüfen Sie den Bestellstatus, bevor Sie zu Live wechseln und die Zahlungsart für Ihre Kunden freigeben.

Das Plugin verschlüsselt die Schlüssel mit dem Installationsgeheimnis von Joomla. Wenn sich die kanonische Shopadresse ändert, verbinden Sie die Zahlungsart erneut mit Paymos.

Was nach der Zahlung in HikaShop steht

Ihre Kunden bezahlen auf der gehosteten Zahlungsseite. Betrag und Währung stammen aus der gespeicherten Bestellung. Das Plugin prüft die Webhook-Signatur und gleicht die Zahlungsdaten per API mit der Bestellung ab. Deckt die geprüfte Zahlung den vollen Bestellbetrag, bestätigt das Plugin die Bestellung einmal. Das gilt auch bei einer Überzahlung.

Bei einem zu niedrigen Betrag bleibt die Bestellung unbestätigt. Prüfen Sie verspätete Zahlungen und Abweichungen, bevor Sie liefern. Fehlt eine Benachrichtigung, nutzen Sie Check payment in der Bestellung. Es gibt keine automatische Prüfung per Cron.

Die Rückkehr in den Shop ändert den Bestellstatus nicht. Für die Rückkehr zu HikaShop können Sie die Success URL des Paymos-Projekts auf Ihre Joomla-Basisadresse mit dem Pfad /index.php?option=com_hikashop&ctrl=checkout&task=after_end setzen. Diese Einstellung gilt für das gesamte Projekt.

Erstattungen in der Bestellung verfolgen

Wenn Sie Erstattungen aktiviert haben und die Zahlung dafür infrage kommt, können Sie die Zahlung vollständig erstatten oder eine Überzahlung zurückgeben. Die API berechnet den Betrag. Das Geld geht an die gespeicherte Absenderadresse; dabei können Netzwerkgebühren anfallen.

Solange die Erstattung läuft, bleibt der Bestellstatus unverändert. Prüfen Sie den Stand mit Check refund. Nach einer vollständigen Erstattung wechselt die Bestellung auf refunded. Bei einer erstatteten Überzahlung bleibt der aktuelle Bestellstatus erhalten. Im Bestellverlauf kommt ein Eintrag hinzu. Mehr dazu unter Erstattungen.

Klären Sie offene Zahlungen und Erstattungen, bevor Sie die Verbindung trennen oder das Plugin deinstallieren. Dabei werden die Zugangsdaten gelöscht. Bestellungen und Verlauf bleiben erhalten.

Lizenz

Das Plugin steht unter GPL-2.0-or-later, das mitgelieferte SDK unter der MIT-Lizenz.