VibeFox Autopay 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.

Autopay-Dienst: Sie brauchen Service ID und Shared key (Hash-Schlüssel) Ihres Autopay-Dienstes. Sie werden im Autopay-Händlerportal angezeigt: portal.autopay.eu für Produktion, testportal.autopay.eu für Tests. Testdienste haben eigene Service ID und Shared key; bitten Sie Autopay, einen zu eröffnen. Die Hash-Funktion des Dienstes muss SHA-256 sein.

Währung: die Warenkorbwährung muss PLN, EUR, GBP, USD oder CZK sein und von Ihrem Autopay-Dienst akzeptiert werden.

Erreichbarer Shop: Autopay muss Benachrichtigungen an Ihren Shop senden können. Der Shop muss daher aus dem Internet erreichbar sein, ohne Basisauthentifizierung oder eine Firewall, die POST-Anfragen blockiert. Wartungsmodus und Ländereinschränkung Ihres Shops blockieren die Benachrichtigungen nicht.

VibeFox-Lizenzschlüssel: wird auf vibefox.net gekauft. 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 Autopay Payment in der Modulliste und klicken Sie 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 Service ID und Shared key (Test und Produktion) ein und wählen Sie die Währungen Ihres Dienstes.

5. Stellen Sie im Autopay-Portal für Ihren Dienst die ITN-URL, die Rückkehr-URL und die Hash-Funktion SHA-256 ein (siehe Konfiguration).

6. Aktivieren Sie Enable/Disable und klicken Sie auf Save. Legen Sie im Testmodus eine Testbestellung an und deaktivieren Sie danach Test mode für echte Zahlungen.

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

Konfiguration

Alle Einstellungen befinden sich auf der Modulseite: Modules > Module Manager > VibeFox Autopay Payment > Configure. Jeder Abschnitt hat seine eigene Schaltfläche Save, die die ganze Seite speichert. Oberhalb der Felder warnt die Seite, wenn Service ID oder Shared key der gewählten Umgebung leer sind, und wenn die Standardwährung des Shops unter Currencies nicht ausgewählt ist. In beiden Fällen wird die Zahlungsmethode an der Kasse ausgeblendet (für die nicht ausgewählte Währung).

Autopay

Enable/Disable: Enable Autopay payment gateway schaltet die Zahlungsmethode ein oder aus. Standard: aus.

Title: der Name der Zahlungsmethode, den Kunden an der Kasse sehen. Er wird auch als Name der Zahlungsmethode in der Bestellung gespeichert. Standard: Autopay. Pflichtfeld.

Description: der Text, der an der Kasse unter der Zahlungsmethode angezeigt wird. Standard: Pay online by bank transfer, BLIK or card. You will be redirected to the secure Autopay payment page.

Autopay-Dienst

Service ID und Shared key werden im Autopay-Händlerportal angezeigt (portal.autopay.eu oder testportal.autopay.eu, in diesem Abschnitt verlinkt).

Test mode: nutzt die Autopay-Testumgebung (testpay.autopay.eu) und die unten stehenden Testzugangsdaten. Standard: an. Schalten Sie ihn aus, um echte Zahlungen auf pay.autopay.eu mit den Produktionszugangsdaten anzunehmen.

Service ID (production): die numerische Dienst-ID von portal.autopay.eu.

Shared key (production): der Hash-Schlüssel des Produktionsdienstes. Geheim halten.

Service ID (test): die numerische Dienst-ID von testportal.autopay.eu.

Shared key (test): der Hash-Schlüssel des Testdienstes.

Beim Speichern wird eine Service ID mit anderen Zeichen als Buchstaben, Ziffern, Bindestrichen oder Unterstrichen mit einem Fehler abgelehnt, und nichts wird gespeichert. Gespeicherte Shared keys werden nie wieder angezeigt. Das Feld bleibt leer und zeigt Saved — leave empty to keep it. Geben Sie nur dann einen neuen Wert ein, wenn Sie ihn ändern möchten.

Clear saved keys: markieren Sie einen Schlüssel und klicken Sie auf Save, um ihn zu entfernen. Ein leeres Feld behält den gespeicherten Wert.

Currencies: die Währungen, die Ihr Autopay-Dienst akzeptiert: PLN, EUR, GBP, USD, CZK. Autopay eröffnet in der Regel einen eigenen Dienst pro Währung. Die Zahlungsmethode wird nur angeboten, wenn die Warenkorbwährung hier ausgewählt ist. Standard: PLN.

Zahlungsbenachrichtigungen (ITN) und Rückkehradresse

Tragen Sie diese Adressen im Autopay-Portal für Ihren Dienst ein, für Produktion und Test. Die genauen Adressen werden im Feld Addresses dieses Abschnitts angezeigt. Mit „schönen“ URLs sehen sie so aus, eventuell mit einem Sprachcode wie /en/:

Kopieren Sie die Adressen genau so, wie die Einstellungen sie anzeigen. Ohne die ITN-URL werden nie Bestellungen angelegt, da PrestaShop die Bestellung erst erstellt, wenn Autopay die Zahlung bestätigt. Jede ITN wird mit dem SHA-256-Hash geprüft, der mit dem Shared key des in der Benachrichtigung genannten Dienstes erstellt wurde. Benachrichtigungen ohne gültigen Hash oder mit unbekannter Service ID werden abgelehnt. Eine Benachrichtigung wird nur auf einen Warenkorb angewendet, wenn seine Zahlung mit demselben Autopay-Dienst gestartet wurde; eine Testbenachrichtigung bestätigt deshalb nie eine Produktionszahlung. Benachrichtigungen zu Zahlungen, die vor dem Umschalten von Test mode gestartet wurden, werden weiterhin mit dem richtigen Schlüssel geprüft, solange beide Zugangsdaten gespeichert bleiben.

Das Modul verarbeitet in der ITN diese Zahlungsstatus:

Erweitert

Logging: schreibt Zahlungsereignisse in logs/wc_ap_debug.log.php im Modulordner. Die Datei kann nicht über das Web geöffnet werden. Schlüssel und Kundendaten werden nie protokolliert. Standard: aus. Solange sie aus ist, wird nichts geschrieben, auch keine Fehler.

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

Kasse

Im Zahlungsschritt wählt der Kunde die Zahlungsmethode (standardmäßig Autopay) mit ihrer Beschreibung und bestätigt. Die nächste Seite zeigt Thank you. You are being redirected to Autopay to complete the payment. Your order is created as soon as Autopay confirms it. und leitet den Kunden zur Zahlungsseite von Autopay weiter. Kehrt der Kunde mit der Zurück-Taste des Browsers zurück, zeigt die Seite die Schaltfläche Pay with Autopay statt erneut weiterzuleiten. Zu diesem Zeitpunkt existiert noch keine Bestellung.

Das Modul übergibt den Warenkorbbetrag in der Warenkorbwährung, die Warenkorbnummer als Bestellreferenz, die Beschreibung (Cart und die Nummer) und die E-Mail-Adresse des Kunden. Auf der Autopay-Seite wählt der Kunde die Zahlungsmethode und bezahlt.

Die Bestellung wird erst als bezahlt markiert, nachdem Autopay sie mit einer signierten ITN bestätigt hat und Betrag und Währung mit dem Warenkorb übereinstimmen. Dann wird die Bestellung angelegt, und der Kunde erhält die üblichen PrestaShop-Bestell-E-Mails. Nach der Zahlung kehrt der Kunde in Ihren Shop zurück. Die Rückkehradresse ist signiert, erstellt oder ändert aber nie eine Bestellung. Existiert die Bestellung bereits, sieht der Kunde die übliche Bestellbestätigungsseite. Ist die ITN noch nicht eingetroffen, zeigt eine Seite Payment confirmation den Text Thank you. Your payment is being confirmed by Autopay — your order will be created as soon as Autopay confirms it, and you will receive an e-mail. mit den Schaltflächen Check again und Back to checkout.

Hat Autopay eine fehlgeschlagene Zahlung gemeldet, kehrt der Kunde zur Kasse zurück, mit The payment was not completed. You can try again or choose another payment method. Der Warenkorb bleibt erhalten. Kann die Zahlung nicht gestartet werden, bleibt der Kunde an der Kasse mit einer kurzen Meldung, zum Beispiel Autopay payments are not configured. Please choose another payment method or contact the store. oder dass Autopay Zahlungen in dieser Währung nicht annehmen kann.

Das Modul bietet keine Erstattungen aus PrestaShop, keine Abonnements oder wiederkehrenden Zahlungen, keine gespeicherten Karten, keinen BLIK-Code und kein Kartenformular an der Kasse, keine Auswahl von Bank oder Zahlungskanal an der Kasse, und es verwendet pro Umgebung eine Service ID.

Bestellungen

Bestellstatus

No order yet: der Kunde wurde zu Autopay geleitet und hat nicht bezahlt, die Zahlung ist fehlgeschlagen oder Autopay hat die Zahlung noch nicht bestätigt. Es existiert nur der Warenkorb.

Payment accepted: Autopay hat die Zahlung bestätigt, und Betrag und Währung stimmen überein. Die Zahlung wird mit der Autopay-Transaktions-ID (remoteID) als Transaktions-ID erfasst, und eine Notiz zeigt Betrag, Autopay-Transaktion und Zahlungsdatum.

Autopay payment on hold: Autopay hat einen anderen Betrag oder eine andere Währung als den Warenkorbbetrag gemeldet (zum Beispiel wurde der Warenkorb geändert, nachdem die Zahlung gestartet wurde). Die Bestellung wird nicht als bezahlt markiert. Prüfen Sie die Transaktion im Autopay-Portal und schließen Sie sie manuell ab oder erstatten Sie sie. Eine spätere korrekte Benachrichtigung für diese Bestellung markiert sie als bezahlt. Derselbe Status wird verwendet, wenn eine Zahlung für eine stornierte Bestellung eingeht: Die Zahlung wird erfasst, und eine Notiz bittet Sie, den Lagerbestand zu prüfen und die Bestellung abzuwickeln oder die Zahlung zu erstatten.

Eine bezahlte Bestellung wird durch eine spätere Fehlermeldung nie geändert. Meldet Autopay eine weitere erfolgreiche Zahlung für eine bezahlte Bestellung, warnt eine Notiz, dass der Kunde möglicherweise zweimal bezahlt hat. Eine Benachrichtigung zu einer Zahlung, die mit einem anderen Autopay-Dienst gestartet wurde, wird nicht angewendet, und eine Notiz erklärt dies. Notizen sind nur für Mitarbeiter sichtbar, im Block Autopay payment auf der Bestellseite.

Autopay-Zahlungsblock

Die Bestellseite zeigt einen Block Autopay payment mit der Autopay-OrderID, der Service ID und Umgebung, Betrag und Währung, dem Zahlungsstatus, der Autopay-Transaktions-ID, einem Abzeichen Test mode für Testzahlungen und den Autopay notes der Bestellung. Der Block ist nur lesbar.

Erstattungen

Erstattungen über Autopay werden nicht unterstützt. Erstatten Sie die Zahlung im Autopay-Portal und erfassen Sie sie anschließend in PrestaShop mit den Standard-Bestellwerkzeugen.

Lizenzschlüssel

Das Modul arbeitet mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock License — VibeFox Autopay Payment ist der erste Block auf Modules > Module Manager > VibeFox Autopay Payment > Configure, oberhalb der Einstellungen. Geben 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 zum erneuten Prüfen des Status, Change key zum Eingeben eines anderen Schlüssels und Remove key zum Entfernen des Schlüssels aus diesem Shop. Darunter stehen die Zeile Product: presta-payment-autopay und der Link Manage licenses and domains in your account, der Ihr vibefox.net-Konto öffnet. Den Schlüssel können nur Mitarbeiter mit der Berechtigung Configure für das Modul ä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 in Ihrem Konto einen Domain-Platz freigegeben haben, klicken Sie auf Check now. Ist der Lizenzserver nicht erreichbar, arbeitet das Modul mit dem zuletzt bekannten Status weiter.

Ein Schlüssel gilt für eine Domain: die Domain des Hauptshops, auch bei einer Multistore-Konfiguration. 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 Autopay Kunden an der Kasse nicht angezeigt. Wird trotzdem eine Zahlung gestartet, sieht der Kunde This payment method is not available. Please choose another one. Der PrestaShop-Shop weiß nicht, dass Sie im Back Office angemeldet sind; daher wird die Zahlungsart auch für Sie ausgeblendet: Sie können das Modul vor dem Kauf eines Schlüssels einrichten, aber nicht in der Kasse testen. Ein Hinweis erscheint unter Modules > Module Manager auf dem Tab Alerts. Bestehende Bestellungen sind nicht betroffen: bereits gestartete Zahlungen werden weiterhin bestätigt.

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

Fehlerbehebung

Autopay erscheint nicht an der Kasse: prüfen Sie, ob die Lizenz aktiv ist, Enable/Disable eingeschaltet ist, die gewählte Umgebung Service ID und Shared key hat und die Warenkorbwährung unter Currencies ausgewählt ist. Die Einstellungsseite zeigt eine Warnung, wenn eines davon fehlt. Prüfen Sie unter Payment > Preferences, ob das Modul für die Warenkorbwährung, das Land des Kunden und die Kundengruppe erlaubt ist.

Die Zahlung ist erfolgt, aber es wurde keine Bestellung angelegt: Autopay hat die ITN nicht zugestellt oder der Shop hat sie abgelehnt. Prüfen Sie, ob die auf der Einstellungsseite angezeigte ITN-URL für den Dienst im Autopay-Portal (Produktion oder Test) eingetragen ist, ob die Hash-Funktion SHA-256 ist und ob der Shared key im Modul zum Dienst passt. Prüfen Sie, ob der Shop aus dem Internet erreichbar ist. Schalten Sie Logging ein und sehen Sie sich das Feld Log auf der Modulseite an.

Das Protokoll zeigt ITN rejected: invalid hash: der Shared key passt nicht zum Dienst, oder die Hash-Funktion des Dienstes ist nicht SHA-256.

Das Protokoll zeigt, dass die Service ID nicht konfiguriert ist: die Benachrichtigung kam von einem Dienst, dessen Service ID nicht im Modul eingetragen ist, oder dessen Shared key leer ist.

Das Protokoll zeigt could not lock the cart, Autopay will retry: der Warenkorb wurde im selben Moment von einer anderen Benachrichtigung verarbeitet. Der Shop antwortet so, dass Autopay die Benachrichtigung erneut sendet. Dasselbe geschieht, wenn die Bestellung nicht angelegt werden konnte, zum Beispiel weil das Modul deaktiviert ist.

Die Bestellung ist Autopay payment on hold mit Abweichungsnotiz: Autopay hat einen anderen Betrag oder eine andere Währung als den Warenkorbbetrag gemeldet. Prüfen Sie die Transaktion im Autopay-Portal und schließen Sie die Bestellung manuell ab oder erstatten Sie sie.

Eine Notiz sagt, dass die Benachrichtigung NICHT angewendet wurde: die Zahlung für diese Bestellung wurde nicht mit diesem Autopay-Dienst gestartet, zum Beispiel eine Testbenachrichtigung für eine Live-Bestellung. Prüfen Sie die Transaktion im Autopay-Portal.

Nach der Zahlung landet der Kunde auf der Startseite: die Rückkehradresse konnte nicht verifiziert werden, zum Beispiel weil die Service ID nicht im Modul eingetragen ist. Die Bestellung ist nicht betroffen; sie richtet sich nach der ITN.

Der Kunde sieht This payment method is not available.: die Zahlungsmethode wird für diesen Warenkorb nicht angeboten (deaktiviert, fehlende Zugangsdaten, Währung nicht ausgewählt oder unter Payment > Preferences nicht erlaubt).

Deinstallation

Gehen Sie zu Modules > Module Manager, öffnen Sie das Menü neben VibeFox Autopay Payment und wählen Sie Uninstall. Lizenzschlüssel und Lizenzstatus dieses Moduls werden immer entfernt. Die Modul-Einstellungen einschließlich der Schlüssel und das Protokoll werden entfernt. Das Modul bietet keine Option, die Einstellungen zu behalten. Die Autopay-Zahlungsdaten und der Bestellstatus Autopay payment on hold bleiben immer erhalten. Bestehende Bestellungen behalten ihre Zahlungsnotizen und Transaktions-IDs.

Autopay ist eine Marke ihres jeweiligen Inhabers. Dieses Modul steht in keiner Verbindung zu Autopay und wird nicht von Autopay unterstützt.