VibeFox SimplePay for PrestaShop — Hilfe

Anforderungen

PrestaShop: 8.0 bis 9.x.

PHP: 8.0 oder neuer. Das Modul lässt sich auf älteren PHP-Versionen nicht installieren.

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

SimplePay-Händlerkonten: SimplePay stellt für jede Währung ein eigenes Händlerkonto bereit, und für Live und Sandbox jeweils separate Konten. Für jedes Konto benötigen Sie MERCHANT und SECRET KEY aus dem SimplePay-Händlerbereich (admin.simplepay.hu für Live, sandbox.simplepay.hu für Sandbox), account > Technical data. Wenn Sie nur in HUF verkaufen, genügt das HUF-Konto. Weitere Schlüssel werden nicht benötigt.

VibeFox-Lizenzschlüssel: wird auf vibefox.net erworben. Ein Schlüssel funktioniert auf einer Domain.

Installation

1. Gehen Sie im Back-Office zu Modules > Module Manager und klicken Sie auf Upload a module. Wählen Sie die ZIP-Datei des Moduls.

2. Wenn der Upload abgeschlossen ist, klicken Sie auf Configure, oder suchen Sie später VibeFox SimplePay Gateway in der Modulliste und klicken Sie dort auf Configure.

3. Geben Sie Ihren VibeFox-Lizenzschlüssel in License key im Lizenzblock oben auf der Seite Configure ein und klicken Sie auf Activate (siehe Lizenzschlüssel).

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

5. Kopieren Sie die IPN URL, die auf der Seite Configure angezeigt wird, in jedes Händlerkonto (Live und Sandbox) im SimplePay-Händlerbereich.

6. Aktivieren Sie Enable/Disable und klicken Sie auf Save. Testen Sie eine Zahlung mit aktivierter Sandbox mode, und deaktivieren Sie danach Sandbox mode, um echte Zahlungen anzunehmen.

Bei der Installation legt das Modul den Bestellstatus SimplePay payment on hold an. PrestaShop bietet ein neues Zahlungsmodul für alle Währungen, Länder und Kundengruppen an. Sie können dies unter Payment > Preferences einschränken.

Konfiguration

Alle Einstellungen befinden sich auf der Modulseite: Modules > Module Manager > VibeFox SimplePay Gateway > Configure. Jeder Abschnitt hat eine eigene Schaltfläche Save, die die gesamte Seite speichert. Oberhalb der Felder warnt die Seite, wenn die Standardwährung des Shops von SimplePay nicht unterstützt wird oder im aktuellen Modus kein Händlerkonto dafür besteht. In beiden Fällen wird die Zahlungsart für Warenkörbe in dieser Währung nicht angeboten. Solange der Sandbox-Modus aktiviert ist, zeigt die Seite Sandbox mode is on: payments go to the SimplePay sandbox, no real money is charged. an.

SimplePay (OTP)

Enable/Disable: Enable SimplePay Gateway aktiviert oder deaktiviert die Zahlungsart. Standard: aus.

Title: der Name der Zahlungsart, den Kunden an der Kasse sehen. Er wird auch als Name der Zahlungsart in der Bestellung gespeichert. Standard: SimplePay (Card Payment). Pflichtfeld.

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 können hier die Datenübertragungserklärung von SimplePay (mit Link) eintragen.

Sandbox mode: verwendet die SimplePay-Sandbox für Testzahlungen mit den Sandbox-Konten. Dabei werden sowohl die API-Adresse als auch die Händlerkonten umgeschaltet. Es wird kein echtes Geld abgebucht. Standard: an. Deaktivieren Sie die Option, um echte Zahlungen mit den Live-Konten anzunehmen. Solange sie aktiviert ist, sehen Kunden Sandbox mode: no real payment is taken. unter der Zahlungsart. Mit der Sandbox gestartete Bestellungen werden immer in der Sandbox erstattet.

Live-Händlerkonten

Die Konten, die verwendet werden, wenn Sandbox mode deaktiviert ist. Tragen Sie die Konten der Währungen ein, in denen Ihr Shop verkauft. MERCHANT und SECRET KEY finden Sie im SimplePay-Händlerbereich (admin.simplepay.hu), unter account > Technical data. 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.

Sandbox-Händlerkonten

Die Konten, die verwendet werden, wenn Sandbox mode aktiviert ist. Die Felder entsprechen denen der 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), unter account > Technical data.

Gespeicherte Secret Keys werden nie wieder angezeigt. Das Feld bleibt leer und zeigt Saved — leave empty to keep it. an. Geben Sie nur dann einen neuen Wert ein, wenn Sie ihn ändern möchten.

IPN URL

Der IPN ist die Nachricht, die SimplePay an Ihren Shop sendet, wenn sich der Zahlungsstatus ändert. Auf diesem Weg wird eine Bestellung in der Regel angelegt. Der Abschnitt zeigt die IPN-URL Ihres Shops. Mit lesbaren URLs (Friendly URLs) sieht sie so aus: https://your-shop/module/wcp_simplepay_gateway/ipn, gegebenenfalls mit einem Sprachcode wie /en/. Hinterlegen Sie diese URL für jedes Händlerkonto, Live und Sandbox, im SimplePay-Händlerbereich. Kopieren Sie die URL genau so, wie die Einstellungen sie anzeigen, denn ein umgeleiteter IPN geht verloren.

Der IPN muss mit dem SECRET KEY des Händlerkontos signiert sein, das er nennt, und zwar im Modus (Sandbox oder Live), in dem die Zahlung gestartet wurde. IPNs ohne gültige Signatur werden abgelehnt. Das Modul bestätigt jeden gültigen IPN gegenüber SimplePay in der von SimplePay geforderten signierten Form. Folgende IPN-Status werden verwendet:

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

NOTAUTHORIZED, FRAUD: die Zahlung wurde abgelehnt. Der Zahlungsversuch wird als fehlgeschlagen markiert; es wird keine Bestellung angelegt.

TIMEOUT, CANCELLED: die Zahlungszeit ist abgelaufen oder der Kunde hat abgebrochen. Der Zahlungsversuch wird als abgelaufen bzw. abgebrochen markiert; es wird keine Bestellung angelegt.

Abgelehnte, abgebrochene und abgelaufene Status werden nur für den letzten Zahlungsversuch eines Warenkorbs ohne Bestellung erfasst. Andere Status werden protokolliert und ändern nichts. Ohne IPN wird eine Bestellung nur angelegt, wenn der Kunde nach einer erfolgreichen Zahlung in den Shop zurückkehrt.

Clear saved secret keys: Setzen Sie einen Haken bei einem Secret Key und klicken Sie auf Save, um ihn zu entfernen. Ein leeres Feld behält den gespeicherten Wert.

Bestellungen

Order Status After Payment: der Bestellstatus, der nach einer erfolgreichen Zahlung gesetzt wird.

Processing (Payment accepted): der Standard, der übliche PrestaShop-Status für bezahlte Bestellungen.

Completed (Delivered): jede bezahlte Bestellung wird auf Zugestellt gesetzt.

Eine Zahlung über einen anderen Betrag oder eine andere Währung als die Bestellung wird immer in SimplePay payment on hold überführt.

Erweitert

Logging: schreibt API-Aufrufe, IPNs und Rückkehrvorgänge in logs/simplepay_op_debug.log.php im Modulordner. Die Datei kann nicht über das Web geöffnet werden. Schlüssel und Kundendaten werden nicht protokolliert. Fehler werden immer protokolliert, auch wenn die Option deaktiviert ist. Standard: aus.

Log: zeigt die Größe und die neuesten Einträge des Protokolls. Klicken Sie auf Clear log, um es zu leeren.

Delete Data on Uninstall: ist die Option aktiviert, entfernt die Deinstallation des Moduls die Gateway-Einstellungen und das Protokoll. Bestelldaten (SimplePay-Transaktionen und Erstattungen) bleiben immer erhalten. Standard: aus.

Kasse

Im Zahlungsschritt wählt der Kunde die Zahlungsart (standardmäßig SimplePay (Card Payment)) und sieht den Hinweis You will be redirected to the SimplePay payment page to pay by card. Nach der Bestätigung startet das Modul eine SimplePay-Kartenzahlung über die Warenkorbsumme in der Warenkorbwährung, mit dem Händlerkonto dieser Währung im aktuellen Modus, und leitet den Kunden zur Zahlungsseite von SimplePay weiter. Die E-Mail-Adresse des Kunden und, wenn sie vollständig ist, die Rechnungsadresse werden an SimplePay übergeben. Die Zahlungsseite verwendet die Sprache des Shops, sofern SimplePay sie unterstützt, andernfalls Englisch. Eine gestartete Zahlung kann innerhalb von 30 Minuten abgeschlossen werden. Zu diesem Zeitpunkt existiert noch keine Bestellung.

Nach einer erfolgreichen Zahlung kehrt der Kunde in Ihren Shop zurück. Die Rückkehr allein bezahlt nie eine Bestellung: Das Modul fragt bei SimplePay den Status der Transaktion mit einer signierten Anfrage ab, sodass die Bestellung auch dann angelegt wird, wenn der IPN verspätet eintrifft. Die Bestellung wird erst als bezahlt markiert, nachdem SimplePay die Zahlung bestätigt hat. Der Kunde sieht dann die übliche Bestellbestätigungsseite mit Successful transaction. SimplePay transaction ID: und der ID. Hat SimplePay die Zahlung noch nicht bestätigt, zeigt eine Seite Payment confirmation den Hinweis Your payment is being confirmed by SimplePay. SimplePay transaction ID: mit der ID sowie eine Schaltfläche Check again; der IPN legt die Bestellung an, sobald er eintrifft.

Schlägt die Zahlung fehl, wird abgebrochen oder läuft die Zeit ab, kehrt der Kunde mit der Meldung von SimplePay und der Transaktions-ID zur Kasse zurück, 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 die kartenausgebende Bank zu kontaktieren. Der Warenkorb bleibt erhalten, und der Kunde kann es erneut versuchen. Jeder neue Versuch erhält eine eigene SimplePay-Referenz: PS, die Warenkorbnummer und die Versuchsnummer, zum Beispiel PS123-1, PS123-2.

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 Warenkorbwä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 im Protokoll festgehalten.

Der IPN funktioniert auch, wenn der Shop im Wartungsmodus ist, und wird nicht durch die Länderbeschränkung Ihres Shops blockiert.

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

Bestellungen und Erstattungen

Bestellstatus

Noch keine Bestellung: Der Kunde wurde zu SimplePay weitergeleitet und hat nicht bezahlt, die Zahlung ist fehlgeschlagen, wurde abgebrochen oder abgelaufen, oder SimplePay hat die Zahlung noch nicht bestätigt. Es existiert nur der Warenkorb.

Payment accepted or Delivered: Die Zahlung wurde bestätigt. Der Status richtet sich nach Order Status After Payment. Die Zahlung wird mit der SimplePay-Transaktions-ID erfasst, und eine Notiz zeigt die Transaktions-ID sowie an, ob der IPN oder die Statusabfrage bestätigt hat.

SimplePay payment on hold: Die Warenkorbsumme oder die Währung wurde geändert, nachdem die Zahlung gestartet wurde, daher weicht der bezahlte Betrag von der Bestellung ab. Es wird keine Zahlung erfasst. Die Notiz zeigt beide Beträge. Prüfen Sie die Bestellung und wickeln Sie sie ab oder erstatten Sie die Zahlung im SimplePay-Händlerbereich. Wird danach ein anderer Versuch desselben Warenkorbs mit dem richtigen Betrag bezahlt, wechselt die Bestellung in den bezahlten Status.

Refunded: Die Zahlung wurde über das Modul vollständig erstattet.

Eine bezahlte, erstattete oder zugestellte Bestellung wird durch einen verspäteten IPN nie wieder geöffnet. Wenn für eine bereits bezahlte Bestellung eine zweite Zahlung erfolgreich ist, wird die Bestellung nicht verändert. Eine Notiz bittet Sie, dies im SimplePay-Händlerbereich zu prüfen und bei einem Duplikat zu erstatten.

SimplePay-Zahlungsblock

Die Bestellseite zeigt einen Block SimplePay payment mit der Transaktions-ID, der Bestellreferenz (orderRef), dem Händlerkonto und Modus, dem SimplePay-Status, den bezahlten und erstatteten Beträgen, einem Kennzeichen Sandbox für Sandbox-Zahlungen, den Zahlungsversuchen des Warenkorbs (wenn es mehr als einen gab), dem Erstattungsverlauf und den SimplePay notes der Bestellung.

Erstattungen

Geben Sie im Block SimplePay payment den Betrag ein (der noch nicht erstattete Betrag ist vorausgefüllt), optional einen Grund, und klicken Sie auf Refund via SimplePay (OTP). Bestätigen Sie die Frage Refund this amount via SimplePay? This cannot be undone. Vollständige und teilweise Erstattungen werden unterstützt. Sie benötigen das Recht, Bestellungen zu bearbeiten; der Zugriff auf die Modulseiten ist nicht erforderlich. HUF-Erstattungen müssen ganze Forint sein. Die Erstattung wird für die SimplePay-Transaktion gesendet, die die Bestellung bezahlt hat, mit ihrem Betrag und ihrer Währung, über das Händlerkonto und im Modus (Sandbox oder Live) dieser Zahlung. Dieses Konto muss daher weiterhin in den Einstellungen hinterlegt sein. Akzeptiert SimplePay die Erstattung nicht, zeigt der Block den Fehler, und es wird keine Erstattung erfasst. Eine erfolgreiche Erstattung wird dem Erstattungsverlauf und den Notizen hinzugefügt, mit der SimplePay-Transaktions-ID der Erstattung und dem Grund, falls Sie einen eingegeben haben. Eine vollständige Erstattung setzt die Bestellung auf Refunded. Eine teilweise Erstattung ändert den Status nicht. Eine Bestellung in SimplePay payment on hold nach einer Betragsabweichung kann nicht über den Block erstattet werden: Erstatten Sie sie im SimplePay-Händlerbereich.

Das Modul erstellt keine Gutschriften. Die standardmäßigen Erstattungsschaltflächen von PrestaShop auf der Bestellseite senden kein Geld über SimplePay zurück. Im SimplePay-Händlerbereich vorgenommene Erstattungen werden nicht mit PrestaShop synchronisiert. Erfassen Sie sie manuell.

Lizenzschlüssel

Das Modul arbeitet mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock License — VibeFox SimplePay Gateway ist der erste Block auf Modules > Module Manager > VibeFox SimplePay Gateway > Configure, über den Einstellungen. Fügen Sie den Schlüssel in License key ein und klicken Sie auf Activate. Danach zeigt der Block den Schlüssel maskiert, den Status (zum Beispiel das Datum, bis zu dem die Lizenz gültig ist, und Ihre Domain) sowie die Schaltflächen Check now, um den Status erneut zu prüfen, Change key, um einen anderen Schlüssel einzugeben, und Remove key, um den Schlüssel aus diesem Shop zu entfernen. Darunter stehen die Zeile Product: presta-payment-simplepay und der Link Manage licenses and domains in your account, der Ihr vibefox.net-Konto öffnet. Nur Mitarbeiter mit der Berechtigung Configure für das Modul können den Schlüssel ändern. Die Texte des Blocks folgen der Sprache des Back Office (Englisch und Russisch sind enthalten).

Wird der Schlüssel nicht akzeptiert, nennt der Block den Grund, zum Beispiel Key not found, This key belongs to another product, Domain limit reached oder License expired on mit einem Datum. Nach einer Änderung der Shop-Adresse oder nachdem Sie einen Domain-Platz in Ihrem Konto freigegeben haben, klicken Sie auf Check now. Ist der Lizenzserver nicht erreichbar, arbeitet das Modul weiter mit dem zuletzt bekannten Status.

Ein Schlüssel gilt für eine Domain: die Domain des Hauptshops, auch bei einer Multistore-Einrichtung. Das Entfernen des Schlüssels aus dem Shop gibt seinen 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 trotzdem eine Zahlung gestartet, sieht der Kunde This payment method is not available. Please choose another one. Das Frontend von PrestaShop weiß nicht, dass Sie im Back Office angemeldet sind, daher ist die Zahlungsart auch für Sie ausgeblendet: Sie können das Modul einrichten, bevor Sie einen Schlüssel kaufen, aber nicht an der Kasse testen. Eine Erinnerung erscheint unter Modules > Module Manager auf der Registerkarte Alerts. Bestehende Bestellungen sind nicht betroffen: Bereits gestartete Zahlungen werden weiterhin durch den IPN bestätigt, und Rückerstattungen funktionieren.

Läuft eine Lizenz ab, arbeitet das Modul weiter, aber Updates und Support erfordern eine Verlängerung. Der Status wird automatisch erneut geprüft, während Sie im Back Office arbeiten: einmal täglich in den ersten 14 Tagen nach Eingabe des Schlüssels, danach einmal pro Woche. Ein Cron-Job ist nicht erforderlich. Das Deinstallieren oder Zurücksetzen des Moduls entfernt immer den Lizenzschlüssel und den Lizenzstatus.

Fehlerbehebung

SimplePay erscheint nicht an der Kasse: Prüfen Sie, ob die Lizenz aktiv ist, Enable/Disable eingeschaltet ist, die Warenkorbwährung HUF, EUR oder USD ist und diese Währung im aktuellen Modus Merchant ID und Secret key hat: die Sandbox-Konten, solange Sandbox mode aktiviert ist, die Live-Konten, solange die Option deaktiviert ist. Prüfen Sie unter Payment > Preferences, ob das Modul für die Warenkorbwährung, das Land des Kunden und die Kundengruppe zugelassen ist.

Die Zahlung ist erfolgt, aber es wurde keine Bestellung angelegt: Der IPN hat den Shop nicht erreicht. Prüfen Sie im SimplePay-Händlerbereich die IPN-URL des Händlerkontos, das Sie verwenden (Live oder Sandbox, die Währung des Warenkorbs). Sie muss genau der URL entsprechen, die in den Einstellungen angezeigt wird, und Ihr Server muss aus dem Internet erreichbar sein. Die Bestellung wird auch angelegt, wenn der Kunde nach der Zahlung in den Shop zurückkehrt.

IPN meldet Invalid signature: Der IPN nennt ein Händlerkonto, das nicht in den Einstellungen hinterlegt ist, sein Secret key ist falsch, oder er ist mit dem Konto des anderen Modus signiert als die Zahlung. 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: Der IPN betrifft eine Zahlung, die dieser Shop nicht gestartet hat. Es wird nichts geändert.

IPN meldet Busy, retry: Der Warenkorb wurde im selben Moment von einer anderen Anfrage verarbeitet, oder die Bestellung konnte nicht angelegt werden (zum Beispiel, weil das Modul deaktiviert ist). SimplePay wiederholt den IPN. Der Grund wird im Protokoll festgehalten.

Der Kunde sieht The SimplePay payment could not be started: Sehen Sie im Feld Log auf der Modulseite nach. Ein falscher Secret Key ergibt Invalid response signature from SimplePay. Check the secret key of the merchant account. SimplePay-Fehler werden mit ihren Fehlercodes protokolliert.

Nach dem Wechsel zwischen Sandbox und Live: Neue Zahlungen verwenden die Konten des neuen Modus. Zuvor gestartete Zahlungen behalten das Händlerkonto und den Modus, mit denen sie gestartet wurden: Ihre IPNs, Statusabfragen und Erstattungen verwenden dieses Konto. Lassen Sie die Konten des alten Modus in den Einstellungen, solange solche Zahlungen offen sind oder erstattet werden könnten.

Bestellung nach der Zahlung in SimplePay payment on hold: Lesen Sie die Notizen im Block SimplePay payment. Die Warenkorbsumme oder die Währung wurde geändert, nachdem die Zahlung gestartet wurde. Wickeln Sie die Bestellung ab oder erstatten Sie die Zahlung im SimplePay-Händlerbereich.

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

Deinstallation

Gehen Sie zu Modules > Module Manager, öffnen Sie das Menü neben VibeFox SimplePay Gateway und wählen Sie Uninstall. Der Lizenzschlüssel und der Lizenzstatus dieses Moduls werden immer entfernt. Ist Delete Data on Uninstall aktiviert, werden die Gateway-Einstellungen und das Protokoll entfernt. Ist die Option deaktiviert, bleiben alle Einstellungen für eine spätere Neuinstallation erhalten. Die SimplePay-Transaktionen und -Erstattungen sowie der Bestellstatus SimplePay payment on hold bleiben immer erhalten, sodass zuvor bezahlte Bestellungen nach einer Neuinstallation weiter erstattet werden können. Bestehende Bestellungen behalten ihre Zahlungsnotizen und Transaktions-IDs.

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