VibeFox Autopay for WooCommerce — Hilfe

Anforderungen

WordPress: 6.0 oder neuer.

WooCommerce: 8.0 oder neuer, installiert und aktiv.

PHP: 8.0 oder neuer.

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

Währung: die Shopwä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 Wartungsmodus, Basisauthentifizierung oder eine Firewall, die POST-Anfragen blockiert.

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 und klicken Sie auf Install Now. Alternativ können Sie den Ordner wcp_autopay_payment per FTP nach /wp-content/plugins/ hochladen.

2. Klicken Sie auf Activate.

3. Öffnen Sie die Einstellungen: WooCommerce > Settings > Payments > Autopay > Manage, oder klicken Sie auf der Plugins-Seite unter dem Plugin-Namen auf Settings.

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

5. Geben Sie Service ID und Shared key (Test und Live) ein und wählen Sie die Währungen Ihres Dienstes.

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

7. Schalten Sie Enable/Disable ein. Führen Sie eine Testbestellung im Testmodus durch und entfernen Sie danach das Häkchen bei Test mode, um echte Zahlungen anzunehmen.

Konfiguration

Alle Einstellungen befinden sich auf einer Seite: WooCommerce > Settings > Payments > Autopay. Oberhalb der Felder warnt die Seite, wenn Service ID oder Shared key der gewählten Umgebung leer sind, und wenn die Shopwährung unter Currencies nicht ausgewählt ist. In beiden Fällen wird die Zahlungsmethode an der Kasse ausgeblendet. In der Liste der Zahlungsmethoden ist Autopay als einrichtungsbedürftig markiert, bis die gewählte Umgebung Zugangsdaten hat.

Allgemein

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. Standard: Autopay.

Description: der Text unter der Zahlungsmethode an der Kasse. 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).

Test mode: Use the Autopay test environment (testpay.autopay.eu) and the test credentials below. Standard: ein. Entfernen Sie das Häkchen, um mit den Live-Zugangsdaten echte Zahlungen über pay.autopay.eu anzunehmen.

Service ID (production): die numerische Service ID aus portal.autopay.eu.

Shared key (production): der Hash-Schlüssel des Live-Dienstes. Bewahren Sie ihn geheim auf.

Service ID (test): die numerische Service ID aus testportal.autopay.eu.

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

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

Zahlungsbenachrichtigungen (ITN) und Rückkehradresse

Tragen Sie diese Adressen für Ihren Dienst im Autopay-Portal ein, für den Live-Betrieb und für Tests. Die genauen Adressen werden in diesem Abschnitt der Einstellungen angezeigt.

ITN (transaction notification) URL: https://your-site/?wc-api=wc_ap_payment

Return URL (after payment): https://your-site/?wc-api=wc_ap_return

Ohne die ITN-URL werden Bestellungen nie als bezahlt markiert. Jede ITN wird mit dem SHA-256-Hash geprüft, der mit dem Shared key des passenden Dienstes erstellt wurde. Benachrichtigungen ohne gültigen Hash oder mit unbekannter Service ID werden abgelehnt. Eine Benachrichtigung wird nur auf eine Bestellung angewendet, wenn die Zahlung für diese Bestellung mit demselben Autopay-Dienst gestartet wurde. Benachrichtigungen für Zahlungen, die vor dem Umschalten von Test mode gestartet wurden, werden weiterhin mit dem richtigen Schlüssel geprüft.

Das Plugin verarbeitet diese Zahlungsstatus in der ITN:

SUCCESS: die Zahlung wurde geleistet; die Bestellung wird nach der Prüfung von Betrag und Währung als bezahlt markiert.

PENDING: die Zahlung wurde gestartet; es wird eine Notiz hinzugefügt.

FAILURE: die Zahlung ist fehlgeschlagen; eine wartende Bestellung wird auf „Fehlgeschlagen“ gesetzt.

Erweitert

Logging: Log payment events schreibt in WooCommerce > Status > Logs, Quelle wcp_autopay_payment. Schlüssel und Kundendaten werden nie protokolliert. Standard: aus.

Kasse

Der Kunde wählt die Zahlungsmethode (standardmäßig Autopay) und gibt die Bestellung auf. Die nächste Seite zeigt Thank you for your order. You are being redirected to Autopay to complete the payment. und leitet den Kunden zur Zahlungsseite von Autopay weiter. Kommt der Kunde mit der Zurück-Schaltfläche des Browsers zurück, zeigt die Seite die Schaltfläche Pay with Autopay, statt erneut weiterzuleiten.

Das Plugin übergibt den Bestellbetrag in der Bestellwährung, die Bestellnummer als Beschreibung (Order und die Nummer) und die Rechnungs-E-Mail-Adresse des Kunden. Auf der Autopay-Seite wählt der Kunde die Zahlungsmethode und bezahlt.

Nach der Zahlung kehrt der Kunde zur Seite „Bestellung eingegangen“ zurück. Die Rückkehradresse ist signiert, ändert aber nie den Bestellstatus. Die Bestellung wird erst als bezahlt markiert, wenn Autopay sie mit einer signierten ITN bestätigt und Betrag und Währung zur Bestellung passen.

Schlägt die Zahlung fehl, wird die Bestellung auf „Fehlgeschlagen“ gesetzt, und der Kunde kann über den Link Pay in der Bestellung erneut bezahlen. Kann die Zahlung nicht gestartet werden, sieht der Kunde eine kurze 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.

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

Das Plugin bietet keine Erstattungen aus WooCommerce, keine Abonnements oder wiederkehrenden Zahlungen, keine gespeicherten Karten (1-Click), keinen BLIK-Code oder ein Kartenformular auf der Kassenseite, keine Auswahl von Bank oder Zahlungskanal auf der Kassenseite und verwendet pro Umgebung eine einzige Service ID.

Bestellungen

Bestellstatus

Pending payment: der Kunde wurde zu Autopay geleitet, und Autopay hat die Zahlung noch nicht bestätigt.

Processing or Completed: Autopay hat die Zahlung bestätigt. WooCommerce setzt „In Bearbeitung“, bei Bestellungen mit ausschließlich virtuellen, herunterladbaren Produkten „Abgeschlossen“. Die Bestellnotiz zeigt Betrag, Autopay-Transaktion und Zahlungsdatum. Die Transaktions-ID ist die Autopay-Transaktions-ID (RemoteID).

On hold: Autopay hat einen anderen Betrag oder eine andere Währung gemeldet als den Bestellbetrag. Die Bestellung wurde nicht als bezahlt markiert. Prüfen Sie die Transaktion im Autopay-Portal und schließen Sie die Bestellung manuell ab oder erstatten Sie den Betrag.

Failed: die Zahlung ist fehlgeschlagen. Der Kunde kann über die Bestellung erneut bezahlen.

Eine bezahlte Bestellung wird durch eine spätere Fehlermeldung nie verändert. Meldet Autopay für eine bezahlte Bestellung eine weitere erfolgreiche Zahlung, warnt eine Notiz, dass der Kunde möglicherweise doppelt bezahlt hat. Eine Benachrichtigung für eine Zahlung, die mit einem anderen Autopay-Dienst gestartet wurde, wird nicht angewendet; eine Notiz erklärt das.

Erstattungen

Erstattungen aus WooCommerce werden nicht unterstützt. Erstatten Sie die Zahlung im Autopay-Portal und verbuchen Sie sie danach in WooCommerce mit einer manuellen Erstattung.

Lizenzschlüssel

Das Plugin funktioniert mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock befindet sich oben unter WooCommerce > Settings > Payments > Autopay. Fügen Sie den Schlüssel in License key ein und klicken Sie auf Activate. Der Block zeigt den Status, 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 Autopay Kunden an der Kasse nicht angezeigt. Versucht trotzdem jemand, eine Zahlung zu starten, sieht der Kunde This payment method is not available. Please choose another one. Angemeldete Shop-Manager sehen die Zahlungsmethode weiterhin, markiert mit (unlicensed — visible to admins only), damit Sie das Plugin einrichten und testen können, bevor Sie einen Schlüssel kaufen. Auf der Plugins-Seite und auf WooCommerce-Seiten erscheint ein Hinweis. Bestehende Bestellungen bleiben unberührt: Bereits gestartete Zahlungen werden weiterhin bestätigt.

Läuft eine Lizenz ab, arbeitet das Plugin weiter, doch Updates und Support erfordern eine Verlängerung. Der Status wird im Hintergrund automatisch erneut geprüft.

Fehlerbehebung

Autopay erscheint nicht an der Kasse: prüfen Sie, ob die Lizenz aktiv ist, Enable/Disable eingeschaltet ist, die gewählte Umgebung eine Service ID und einen Shared key hat und die Shopwährung unter Currencies ausgewählt ist. Die Einstellungsseite zeigt eine Warnung, wenn einer dieser Punkte fehlt.

Die Zahlung ist durchgegangen, aber die Bestellung bleibt bei Pending payment: Autopay hat die ITN nicht zugestellt, oder der Shop hat sie abgelehnt. Prüfen Sie, ob die in den Einstellungen angezeigte ITN-URL für den Dienst im Autopay-Portal (Live oder Test) eingetragen ist, ob die Hash-Funktion SHA-256 ist und ob der Shared key im Plugin zum Dienst passt. Prüfen Sie, ob der Shop aus dem Internet erreichbar ist. Schalten Sie Logging ein und sehen Sie in WooCommerce > Status > Logs, Quelle wcp_autopay_payment, nach.

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 stammt von einem Dienst, dessen Service ID nicht im Plugin eingetragen ist.

Die Bestellung wurde mit einer Abweichungsnotiz auf „Wartend“ gesetzt: Autopay hat einen anderen Betrag oder eine andere Währung gemeldet als den Bestellbetrag. Prüfen Sie die Transaktion im Autopay-Portal und schließen Sie die Bestellung manuell ab oder erstatten Sie den Betrag.

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 geprüft werden, zum Beispiel weil die Service ID nicht im Plugin eingetragen ist. Der Bestellstatus ist davon nicht betroffen; er richtet sich nach der ITN.

Der Lizenzblock zeigt einen Fehler: folgen Sie der Meldung im Block. Ist der Schlüssel zum Beispiel 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

Beim Deaktivieren des Plugins bleiben alle Daten erhalten. Zum Entfernen deaktivieren und löschen Sie es auf der Seite Plugins. Der Lizenzschlüssel und der Lizenzstatus dieses Plugins sowie die Gateway-Einstellungen werden entfernt. Das Plugin bietet keine Option, die Einstellungen zu behalten. Bestehende Bestellungen behalten ihre Zahlungsnotizen und Transaktions-IDs.

Autopay ist eine Marke ihres jeweiligen Inhabers. Dieses Plugin ist weder mit Autopay verbunden noch von Autopay empfohlen.