VibeFox SimplePay for WooCommerce — Hilfe

Anforderungen

WordPress: 6.0 oder neuer.

WooCommerce: 7.0 oder neuer, installiert und aktiv. Das Plugin lässt sich ohne WooCommerce nicht aktivieren.

PHP: 8.0 oder neuer.

Shopwährung: HUF, EUR oder USD. SimplePay akzeptiert keine anderen Währungen, und die Zahlungsart wird für sie nicht angeboten.

SimplePay-Händlerkonten: SimplePay vergibt für jede Währung ein eigenes Händlerkonto und getrennte Konten für Live- und Sandbox-Betrieb. Für jedes Konto benötigen Sie den MERCHANT und den SECRET KEY aus dem SimplePay-Händlerbereich (admin.simplepay.hu für Live, sandbox.simplepay.hu für die Sandbox), Konto > Technische Daten. Wenn Sie nur in HUF verkaufen, reicht das HUF-Konto aus. Weitere Schlüssel werden nicht benötigt.

VibeFox-Lizenzschlüssel: Erhältlich auf vibefox.net. Ein Schlüssel gilt für eine Domain.

Installation

1. Gehen Sie in WordPress zu Plugins > Add New > Upload Plugin, wählen Sie die ZIP-Datei des Plugins aus und klicken Sie auf Install Now. Alternativ können Sie den Ordner wcp_simplepay_gateway per FTP nach /wp-content/plugins/ hochladen.

2. Klicken Sie auf Activate.

3. Öffnen Sie die Einstellungen: WooCommerce > Settings > Payments > SimplePay (OTP) > Manage oder klicken Sie auf der Seite Plugins unter dem Namen des Plugins auf Settings.

4. Geben Sie Ihren VibeFox-Lizenzschlüssel im Lizenzblock oben auf der Seite ein und klicken Sie auf Activate.

5. Geben Sie MERCHANT und SECRET KEY Ihrer SimplePay-Konten für jede Währung ein, in der Sie verkaufen: Sandbox-Konten zum Testen und Live-Konten für echte Zahlungen (siehe Konfiguration).

6. Kopieren Sie die auf der Einstellungsseite angezeigte IPN URL in jedes Händlerkonto (Live und Sandbox) im SimplePay-Händlerbereich.

7. Aktivieren Sie Enable/Disable, testen Sie eine Zahlung mit aktiviertem Sandbox mode und deaktivieren Sie danach Sandbox mode, um echte Zahlungen anzunehmen.

Bei einem Update von Version 1.0 werden die einzelne Merchant ID und der Secret key aus Version 1.0 in das Konto der Shopwährung im zuvor aktiven Modus (Sandbox oder Live) übernommen. Prüfen Sie die Konten nach dem Update.

Konfiguration

Alle Einstellungen befinden sich auf einer Seite: WooCommerce > Settings > Payments > SimplePay (OTP). Oberhalb der Felder warnt die Seite, wenn die Shopwährung von SimplePay nicht unterstützt wird oder für die Shopwährung im aktuellen Modus kein Händlerkonto vorhanden ist. In beiden Fällen wird die Zahlungsart für Bestellungen in dieser Währung nicht angeboten. Solange der Sandbox-Modus aktiv ist, zeigt die Seite Sandbox mode is on: payments go to the SimplePay sandbox, no real money is charged. an. In der Liste der Zahlungsarten ist SimplePay als einrichtungsbedürftig markiert, bis der aktuelle Modus mindestens ein Händlerkonto hat.

Allgemein

Enable/Disable: Enable SimplePay Gateway schaltet die Zahlungsart ein oder aus. Standard: aus.

Title: der Name der Zahlungsart, den Kunden an der Kasse sehen. Standard: SimplePay (Card Payment).

Description: der Text, der an der Kasse unter der Zahlungsart angezeigt wird. Standard: Pay securely with your credit or debit card via SimplePay. Ungarische Händler müssen an der Kasse die Datenübermittlungserklärung von SimplePay (Adattovábbítási nyilatkozat) anzeigen. Sie können sie hier mit ihrem Link einfügen.

Sandbox mode: Use the SimplePay sandbox leitet Zahlungen an die SimplePay-Sandbox und verwendet die Sandbox-Konten. Dabei werden sowohl die API-Adresse als auch die Händlerkonten umgeschaltet. Es wird kein echtes Geld belastet. Standard: ein. Deaktivieren Sie das Kontrollkästchen, um echte Zahlungen mit den Live-Konten anzunehmen.

Händlerkonten für den Live-Betrieb

Die Konten, die verwendet werden, wenn Sandbox mode deaktiviert ist. Tragen Sie die Konten der Währungen ein, in denen Ihr Shop verkauft. Die Werte für MERCHANT und SECRET KEY finden Sie im SimplePay-Händlerbereich (admin.simplepay.hu), Konto > Technische Daten. Ein Konto wird nur verwendet, wenn beide Felder ausgefüllt sind.

HUF account — Merchant ID: der MERCHANT Ihres Live-Kontos in HUF.

HUF account — Secret key: der SECRET KEY Ihres Live-Kontos in HUF.

EUR account — Merchant ID und EUR account — Secret key: dasselbe für Ihr Live-Konto in EUR.

USD account — Merchant ID und USD account — Secret key: dasselbe für Ihr Live-Konto in USD.

Händlerkonten für die Sandbox

Die Konten, die verwendet werden, wenn Sandbox mode aktiviert ist. Die Felder sind dieselben wie bei den Live-Konten: HUF account — Merchant ID, HUF account — Secret key und dieselben Paare für EUR und USD. Die Werte stammen aus dem Sandbox-Händlerbereich von SimplePay (sandbox.simplepay.hu), Konto > Technische Daten.

IPN URL

Die IPN ist die Nachricht, die SimplePay an Ihren Shop sendet, wenn sich der Zahlungsstatus ändert. Sie ist der übliche Weg, auf dem eine Bestellung als bezahlt markiert wird. Die Einstellungsseite zeigt die IPN URL Ihres Shops an. Sie sieht etwa so aus: https://your-site/wc-api/simplepay_payment_callback/. Hinterlegen Sie diese URL für jedes Händlerkonto, Live und Sandbox, im SimplePay-Händlerbereich. Wenn Ihre Website in URLs ein Sprachpräfix verwendet oder andere Adressen weiterleitet, kopieren Sie die URL genau so, wie die Einstellungen sie anzeigen, denn eine weitergeleitete IPN geht verloren.

Die IPN muss mit dem SECRET KEY des Händlerkontos signiert sein, das sie nennt. IPNs ohne gültige Signatur werden abgelehnt. Das Plugin bestätigt jede gültige IPN gegenüber SimplePay in der von SimplePay vorgeschriebenen signierten Form. Diese IPN-Status ändern die Bestellung:

FINISHED: die Zahlung war erfolgreich. Die Bestellung wird nach der Prüfung von Betrag und Währung als bezahlt markiert.

NOTAUTHORIZED, FRAUD: die Zahlung wurde abgelehnt. Die Bestellung wird auf Fehlgeschlagen gesetzt.

TIMEOUT, CANCELLED: die Zahlungszeit ist abgelaufen oder der Kunde hat abgebrochen. Die Bestellung wird auf Storniert gesetzt.

Fehlgeschlagen und Storniert werden nur für den letzten Zahlungsversuch einer Bestellung gesetzt, die noch auf Zahlung ausstehend steht. Andere Status werden protokolliert und ändern die Bestellung nicht. Ohne IPN wird eine Bestellung nur bestätigt, wenn der Kunde nach einer erfolgreichen Zahlung in den Shop zurückkehrt.

Bestellungen

Order Status After Payment: der Bestellstatus, der nach einer erfolgreichen Zahlung gesetzt wird. Der Status wird sofort gesetzt, ohne eine zweite Statusänderung.

WooCommerce default (Processing; Completed for virtual/downloadable orders): der Standard.

Completed: jede bezahlte Bestellung wird auf Abgeschlossen gesetzt.

Erweitert

Logging: Enable logging schreibt API-Aufrufe, IPNs und Rückkehrvorgänge in WooCommerce > Status > Logs, Quelle wcp_simplepay_gateway. Schlüssel und Kundendaten werden nicht protokolliert. Fehler werden immer protokolliert, auch wenn diese Option deaktiviert ist. Standard: aus.

Delete Data on Uninstall: Remove all plugin data when uninstalling. Ist die Option aktiv, entfernt das Löschen des Plugins die Einstellungen des Gateways und die Protokolle des Plugins. Bestelldaten bleiben immer erhalten. Standard: aus.

Kasse

Der Kunde wählt die Zahlungsart (standardmäßig SimplePay (Card Payment)) und gibt die Bestellung auf. Das Plugin startet eine SimplePay-Kartenzahlung über den Bestellbetrag in der Bestellwährung mit dem Händlerkonto dieser Währung im aktuellen Modus und leitet den Kunden zur Zahlungsseite von SimplePay weiter. Die Seite zeigt an, was Ihr Händlerkonto für Kartenzahlungen zulässt. Die E-Mail-Adresse des Kunden und, wenn sie vollständig ist, die Rechnungsadresse werden an SimplePay übergeben. Die Zahlungsseite verwendet die Sprache Ihrer Website, wenn SimplePay sie unterstützt, andernfalls Englisch. Eine gestartete Zahlung kann innerhalb von 30 Minuten bezahlt werden.

Nach einer erfolgreichen Zahlung kehrt der Kunde zur Bestellbestätigungsseite Ihres Shops zurück. Die Rückkehr allein bezahlt nie eine Bestellung: Das Plugin fragt den Status der Transaktion mit einer signierten Anfrage bei SimplePay ab, sodass die Bestellung auch dann bestätigt wird, wenn die IPN verspätet ankommt. Die Bestellbestätigungsseite zeigt Successful transaction. SimplePay transaction ID: und die ID an. Ist die Zahlung noch nicht bestätigt, zeigt sie Your payment is being confirmed by SimplePay. SimplePay transaction ID: und die ID an.

Schlägt die Zahlung fehl, wird abgebrochen oder läuft die Zeit ab, wird der Kunde zurück zur Kasse geschickt oder, wenn der Warenkorb leer ist, zur Seite Pay for order. Dort sieht der Kunde die Meldung von SimplePay mit der Transaktions-ID, zum Beispiel Cancelled payment. You cancelled the payment oder Timeout. The time allowed to complete the payment has expired. Bei einer fehlgeschlagenen Zahlung wird der Kunde gebeten, die eingegebenen Daten zu prüfen und sich mit seiner kartenausgebenden Bank in Verbindung zu setzen. Der Kunde kann es erneut versuchen. Jeder neue Versuch erhält eine eigene SimplePay-Referenz, zum Beispiel 123, 123-2, 123-3.

Kann SimplePay die Zahlung nicht starten, sieht der Kunde The SimplePay payment could not be started. Please try again or choose another payment method. Hat die Bestellwährung kein Händlerkonto, lautet die Meldung SimplePay is not available for the currency of this order. Please choose another payment method. Der technische Grund wird den Bestellnotizen und dem Protokoll hinzugefügt. Angemeldete Shop-Manager sehen ihn zusätzlich in der Meldung.

Die Zahlungsart funktioniert in der klassischen Kasse, im Kassen-Block und auf der Seite Pay for order. Sie ist mit WooCommerce High-Performance Order Storage (HPOS) kompatibel.

Das Plugin nimmt nur einmalige Kartenzahlungen an, die auf der Seite von SimplePay erfasst werden. Es unterstützt keine gespeicherten Karten oder Ein-Klick-Zahlungen, keine Abonnements oder wiederkehrenden Zahlungen und kein getrenntes Autorisieren und Erfassen.

Bestellungen und Erstattungen

Bestellstatus

Pending payment: Der Kunde wurde zu SimplePay weitergeleitet und hat noch nicht bezahlt, oder SimplePay hat die Zahlung noch nicht bestätigt. Die Bestellnotiz zeigt die gestartete Transaktion, den Betrag und den Modus (Sandbox oder Live).

Processing or Completed: Die Zahlung wurde bestätigt. Der Status richtet sich nach Order Status After Payment. Die Bestellnotiz zeigt die Transaktions-ID und ob die IPN oder die Statusanfrage die Zahlung bestätigt hat. Die SimplePay-Transaktions-ID wird als Transaktions-ID der Bestellung gespeichert. Eine verspätet eingegangene erfolgreiche Zahlung schließt auch eine Bestellung ab, die auf Fehlgeschlagen oder Storniert stand.

On hold: Die Bestellsumme oder die Währung wurde geändert, nachdem die Zahlung gestartet wurde, sodass der bezahlte Betrag von der Bestellung abweicht. Die Bestellnotiz zeigt beide Beträge. Prüfen Sie die Bestellung und bearbeiten Sie sie oder erstatten Sie die Zahlung.

Failed: SimplePay hat den letzten Zahlungsversuch als nicht autorisiert oder als Betrug gemeldet.

Cancelled: SimplePay hat gemeldet, dass der letzte Zahlungsversuch abgelaufen oder abgebrochen wurde.

Eine erstattete oder abgeschlossene Bestellung wird durch eine verspätete IPN nie wieder geöffnet. Gelingt eine zweite Zahlung für eine bereits bezahlte Bestellung, wird die Bestellung nicht erneut geändert. Eine Notiz bittet Sie, dies im SimplePay-Adminbereich zu prüfen und die Zahlung zu erstatten, falls es sich um ein Duplikat handelt.

Erstattungen

Öffnen Sie die Bestellung, klicken Sie auf Refund, geben Sie den Betrag ein und klicken Sie auf Refund via SimplePay (OTP). Vollständige und teilweise Erstattungen werden unterstützt. HUF-Erstattungen müssen ganze Forint sein. Die Erstattung wird mit dem Händlerkonto und im Modus (Sandbox oder Live) gesendet, mit dem die Zahlung erfolgte. Das Konto muss daher noch in den Einstellungen vorhanden sein. Akzeptiert SimplePay die Erstattung nicht, zeigt WooCommerce den Fehler an und es wird keine Erstattung erfasst. Eine erfolgreiche Erstattung wird den Bestellnotizen mit der SimplePay-Transaktions-ID der Erstattung und dem Grund hinzugefügt, sofern Sie einen eingegeben haben.

Erstattungen, die im SimplePay-Händlerbereich vorgenommen wurden, werden nicht mit WooCommerce synchronisiert. Erfassen Sie sie manuell in WooCommerce, ohne Refund via SimplePay (OTP) zu verwenden.

Lizenzschlüssel

Das Plugin arbeitet mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock befindet sich oben unter WooCommerce > Settings > Payments > SimplePay (OTP). Fügen Sie den Schlüssel in License key ein und klicken Sie auf Activate. Der Block zeigt den Status an, zum Beispiel das Datum, bis zu dem die Lizenz aktiv ist, und Ihre Domain. Mit Check now prüfen Sie den Status erneut, mit Change key geben Sie einen anderen Schlüssel ein und mit Remove key entfernen Sie ihn von dieser Website. Der Link Manage licenses and domains in your account öffnet Ihr vibefox.net-Konto.

Ein Schlüssel gilt für eine Domain. Das Entfernen des Schlüssels von einer Website gibt deren Domain-Platz nicht frei. Geben Sie den Platz in Ihrem vibefox.net-Konto frei.

Ohne aktiven Schlüssel wird SimplePay Kunden an der Kasse nicht angezeigt. Wird dennoch eine Zahlung gestartet, sieht der Kunde This payment method is not available. Please choose another one. Angemeldete Shop-Manager sehen die Zahlungsart weiterhin, markiert mit (unlicensed — visible to admins only), damit Sie das Plugin vor dem Kauf eines Schlüssels einrichten und testen können. Ein Hinweis erscheint auf der Plugins-Seite und auf WooCommerce-Seiten. Bestehende Bestellungen bleiben unberührt: bereits gestartete Zahlungen werden weiterhin bestätigt, und Erstattungen funktionieren.

Läuft eine Lizenz ab, arbeitet das Plugin weiter, für Updates und Support ist jedoch eine Verlängerung nötig. Der Status wird automatisch im Hintergrund erneut geprüft.

Fehlerbehebung

SimplePay erscheint nicht an der Kasse: prüfen Sie, ob die Lizenz aktiv ist, Enable/Disable eingeschaltet ist, die Bestellwährung HUF, EUR oder USD ist und für diese Währung im aktuellen Modus sowohl Merchant ID als auch Secret key hinterlegt sind: die Sandbox-Konten, solange Sandbox mode aktiv ist, die Live-Konten, solange es deaktiviert ist. Die Einstellungsseite zeigt eine Warnung, wenn für die Shopwährung kein Konto vorhanden ist.

Die Zahlung ist eingegangen, aber die Bestellung bleibt auf Zahlung ausstehend: die IPN hat den Shop nicht erreicht. Prüfen Sie im SimplePay-Händlerbereich die IPN URL des verwendeten Händlerkontos (Live oder Sandbox, Währung der Bestellung). Sie muss exakt der Adresse entsprechen, die in den Einstellungen angezeigt wird, und Ihr Server muss aus dem Internet erreichbar sein. Die Bestellung wird auch bestätigt, wenn der Kunde nach der Zahlung in den Shop zurückkehrt.

IPN meldet Invalid signature: die IPN nennt ein Händlerkonto, das nicht in den Einstellungen hinterlegt ist, oder der Secret key ist falsch. Geben Sie MERCHANT und SECRET KEY genau so ein, wie der SimplePay-Händlerbereich sie anzeigt. SimplePay wiederholt nicht bestätigte IPNs.

IPN meldet Order not found oder Unknown transaction: die IPN betrifft eine Bestellung oder Transaktion, die dieser Shop nicht gestartet hat. Die Bestellung wird nicht geändert.

IPN meldet Busy, retry: die Bestellung wurde im selben Moment von einer anderen Anfrage bestätigt. SimplePay wiederholt die IPN.

Der Kunde sieht beim Abschicken der Bestellung einen Fehler: öffnen Sie die Bestellnotizen oder sehen Sie unter WooCommerce > Status > Logs, Quelle wcp_simplepay_gateway, nach. Ein falscher Secret Key führt zu Invalid response signature from SimplePay. Check the secret key of the merchant account. SimplePay-Fehler werden als SimplePay error code(s): mit den Codes angezeigt.

Nach dem Wechsel zwischen Sandbox und Live: neue Zahlungen verwenden die Konten des neuen Modus. Bestellungen, die vorher gestartet wurden, behalten das Händlerkonto und den Modus, mit denen sie gestartet wurden: Ihre IPNs, Statusanfragen und Erstattungen verwenden dieses Konto. Behalten Sie die Konten des alten Modus in den Einstellungen, solange solche Bestellungen offen sind oder erstattet werden können.

Bestellung nach der Zahlung auf Wartend: lesen Sie die Bestellnotiz. Die Bestellsumme oder die Währung wurde nach dem Start der Zahlung geändert. Bearbeiten Sie die Bestellung oder erstatten Sie die Zahlung.

Erstattung schlägt fehl: lesen Sie die Meldung. SimplePay refunds in HUF must be whole amounts. bedeutet, dass der HUF-Betrag Dezimalstellen hatte. Meldet die Nachricht, dass das Händlerkonto dieser Zahlung nicht konfiguriert ist, geben Sie das Konto (Währung und Modus), mit dem die Zahlung erfolgte, erneut ein. Hat SimplePay einen anderen Betrag erstattet, fordert die Meldung Sie auf, die Erstattung im SimplePay-Adminbereich zu prüfen.

Der Lizenzblock zeigt einen Fehler: folgen Sie der Meldung im Block. Ist der Schlüssel etwa bereits auf einer anderen Domain verwendet, geben Sie in Ihrem vibefox.net-Konto einen Platz frei und klicken Sie auf Check now. Hat sich die Adresse der Website geändert, klicken Sie auf Check now, um den Schlüssel für die neue Domain zu aktivieren. Ist der Lizenzserver nicht erreichbar, arbeitet das Plugin mit dem zuletzt bekannten Status weiter.

Deinstallation

Die Deaktivierung des Plugins behält alle Daten. Zum Entfernen deaktivieren und löschen Sie es auf der Seite Plugins. Der Lizenzschlüssel und der Lizenzstatus dieses Plugins werden immer entfernt. Die Einstellungen des Gateways und die Protokolle des Plugins werden nur entfernt, wenn Delete Data on Uninstall aktiviert war. Andernfalls bleiben sie für eine spätere Neuinstallation erhalten. Bestehende Bestellungen behalten ihre Zahlungsnotizen, Transaktions-IDs und SimplePay-Daten.

SimplePay ist eine Marke ihres jeweiligen Inhabers. Dieses Plugin ist weder mit SimplePay verbunden noch wird es von SimplePay unterstützt.