VibeFox DPO for WooCommerce — Hilfe
Anforderungen
WordPress: 6.2 oder neuer.
WooCommerce: 8.0 oder neuer, installiert und aktiv. Das Plugin verweigert ohne WooCommerce die Aktivierung.
PHP: 8.0 oder neuer.
DPO-Pay-Konto: Sie benötigen den Company Token und die Service Type ID Ihres DPO-Händlerkontos. DPO stellt diese bei der Kontoeröffnung aus; Sie erhalten sie von Ihrem DPO-Kundenbetreuer oder von dpogroup.com. DPO kann auch ein Testkonto mit eigenem Token und Service Type bereitstellen. Es gibt keinen separaten Testserver: DPO verwendet dieselbe API-Adresse für Test- und Live-Konten, und das Konto wird über den Token ausgewählt.
Währung: die Shop-Währung muss von Ihrem DPO-Konto unterstützt werden, zum Beispiel USD, EUR, ZAR, KES, UGX, TZS, RWF, GHS, NGN, ZMW, XOF oder AED. DPO akzeptiert höchstens 2 Dezimalstellen, daher können Bestellsummen mit 3 Dezimalstellen (zum Beispiel KWD 12.345) nicht bezahlt werden.
VibeFox-Lizenzschlüssel: gekauft auf vibefox.net. Ein Schlüssel funktioniert auf einer 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. Sie können den Ordner wcp_dpo_pay auch per FTP in /wp-content/plugins/ hochladen.
2. Klicken Sie auf Activate.
3. Öffnen Sie die Einstellungen: WooCommerce > Settings > Payments > DPO Pay > Manage, oder klicken Sie auf Settings unter dem Plugin-Namen auf der Plugins-Seite.
4. Geben Sie Ihren VibeFox-Lizenzschlüssel in den Lizenzblock oben auf der Seite ein und klicken Sie auf Activate.
5. Geben Sie den Test- und/oder Live-Company-Token und Service Type ein (siehe Konfiguration).
6. Senden Sie die auf der Einstellungsseite angezeigte Push-Benachrichtigungs-URL an den DPO-Support und bitten Sie darum, diese für Ihr Konto einzurichten.
7. Aktivieren Sie Enable/Disable. Führen Sie eine Testbestellung im Testmodus durch und deaktivieren Sie dann Test mode, um echte Zahlungen anzunehmen.
Konfiguration
Alle Einstellungen befinden sich auf einer Seite: WooCommerce > Settings > Payments > DPO Pay. Wenn das Gateway aktiviert ist, aber der Company Token oder der Service Type des ausgewählten Modus leer ist, warnt die Seite, dass die Zahlungsmethode an der Kasse ausgeblendet ist, und beim Speichern erscheint derselbe Fehler. Während der Testmodus aktiv ist, zeigt die Seite Test mode is on: payments are created with the test account credentials.
Allgemein
Enable/Disable: Enable DPO Pay schaltet die Zahlungsmethode ein oder aus. Standard: aus.
Title: der Name der Zahlungsmethode, den Kunden an der Kasse sehen. Standard: DPO Pay.
Description: der Text, der unter der Zahlungsmethode an der Kasse angezeigt wird. Standard: Pay securely by card or mobile money on the DPO Pay payment page.
API-Zugangsdaten
DPO stellt für Ihr Händlerkonto einen Company Token und eine Service Type ID aus, und separate für ein Testkonto. Sie erhalten diese von Ihrem DPO-Kundenbetreuer oder von dpogroup.com.
Test mode: Use the test account credentials below. Wenn aktiviert, werden neue Zahlungen mit dem Test-Company-Token und Service Type erstellt. Standard: aktiviert. Deaktivieren Sie es, um echte Zahlungen mit den Live-Zugangsdaten anzunehmen. Statusprüfungen bestehender Bestellungen verwenden immer das Konto, mit dem die Zahlung erstellt wurde.
Test Company Token: der Company Token Ihres DPO-Testkontos.
Test Service Type: die numerische Service Type ID Ihres DPO-Testkontos.
Live Company Token: der Company Token Ihres Live-DPO-Händlerkontos.
Live Service Type: die numerische Service Type ID Ihres Live-DPO-Händlerkontos.
Ein Service Type muss eine Zahl sein. Jeder andere Wert wird nicht gespeichert: die Seite zeigt einen Fehler und behält den vorherigen Wert bei. Wenn Sie von Version 1.0 aktualisieren, werden die Zugangsdaten dieser Version auch in die Testfelder kopiert.
Zahlungsbenachrichtigungen
Die Push-Benachrichtigung teilt Ihrem Shop sofort mit, dass eine Zahlung erfolgt ist, auch wenn der Kunde den Browser nach der Zahlung schließt. Dieser Abschnitt zeigt die Push-Benachrichtigungs-URL. Sie sieht etwa so aus: https://your-site/wc-api/dpo_pay_notify/. Sie wird nicht in einem Dashboard eingestellt: bitten Sie den DPO-Support, diese URL für Ihr Konto einzurichten.
DPO-Push-Benachrichtigungen tragen keine Signatur, daher wird ihrem Inhalt nie vertraut. Das Plugin nutzt sie nur, um die Bestellung zu finden, und prüft die Zahlung dann direkt bei DPO. Ohne die Push-URL werden Bestellungen weiterhin bestätigt, wenn der Kunde zum Shop zurückkehrt, und durch die automatischen Nachprüfungen 15 Minuten nach der Weiterleitung und nach Ablauf der Zahlungsfrist.
Bestellungen
Successful payment status: der Bestellstatus nach einer verifizierten erfolgreichen Zahlung. Der Status wird sofort gesetzt, ohne einen zweiten Statuswechsel.
Erweitert
Logging: Enable logging schreibt API-Aufrufe und Benachrichtigungen in WooCommerce > Status > Logs, Quelle wcp_dpo_pay. Fehler werden immer protokolliert. Tokens werden maskiert, es werden keine Kundendaten protokolliert. Standard: aus.
Delete data: Delete all plugin data when the plugin is deleted. Entfernt beim Deinstallieren die Einstellungen, die bei Bestellungen gespeicherten DPO-Daten und Protokolle. Eine Deaktivierung löscht niemals Daten. Standard: aus.
Kasse
Der Kunde wählt die Zahlungsmethode (standardmäßig DPO Pay) und gibt die Bestellung auf. Das Plugin erstellt eine DPO-Transaktion über den Bestellbetrag in der Bestellwährung, mit der Bestellnummer und Ihrem Website-Namen als Beschreibung, und leitet den Kunden zur DPO-Zahlungsseite weiter. Name, E-Mail, Telefon und Adresse des Kunden werden übergeben, um die Seite vorauszufüllen. Dort bezahlt der Kunde mit einer in Ihrem DPO-Konto aktivierten Methode. Der Zahlungslink ist 5 Stunden gültig.
Nach der Zahlung kehrt der Kunde zu Ihrem Shop zurück. Die Bestellung wird erst als bezahlt markiert, nachdem DPO sie bestätigt hat: Das Plugin fragt DPO nach dem Transaktionsergebnis, wenn der Kunde zurückkehrt, wenn eine Push-Benachrichtigung eingeht und bei den automatischen Nachprüfungen. Sobald die Zahlung bestätigt ist, gelangt der Kunde zur Seite „Bestellung erhalten“.
Wird die Zahlung nicht bestätigt, kehrt der Kunde zur Kasse oder zur Seite Pay for order zurück, mit einer dieser Meldungen:
Klickt der Kunde auf der DPO-Seite auf die Schaltfläche zur Rückkehr zum Shop, wird die Bestellung auf die übliche WooCommerce-Weise storniert und ihr DPO-Zahlungslink bei DPO storniert.
Wenn ein Kunde für dieselbe Bestellung erneut bezahlt, wird zuerst der vorherige DPO-Zahlungslink geprüft. Wurde er bezahlt, wird die Bestellung ohne eine zweite Belastung abgeschlossen. Wird er noch verarbeitet, sieht der Kunde Your previous payment for this order is still being processed by DPO. Please wait a few minutes before trying again. Andernfalls wird der alte Link bei DPO storniert und ein neuer erstellt.
Kann DPO die Zahlung nicht starten, sieht der Kunde eine kurze Meldung, die anhand des DPO-Fehlercodes ausgewählt wird, zum Beispiel dass DPO Pay die Währung dieser Bestellung nicht unterstützt oder dass der Betrag das von DPO Pay erlaubte Limit überschreitet, und kann eine andere Zahlungsmethode wählen.
Die Zahlungsmethode 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 akzeptiert nur Einmalzahlungen auf der DPO-Seite. Es unterstützt keine Erstattungen aus WooCommerce, keine gespeicherten Karten, keine Abonnements oder wiederkehrenden Zahlungen, keine Kartenfelder auf Ihrer Website und keine Erfassung nur autorisierter Zahlungen.
Bestellungen
Bestellstatus
Pending payment: der Kunde wurde zu DPO geleitet und hat noch nicht bezahlt, oder DPO hat die Zahlung noch nicht bestätigt.
Processing, Completed oder On hold: die Zahlung wurde verifiziert. Der Status folgt Successful payment status. Die Bestellnotiz zeigt den Betrag, die Währung, den Genehmigungscode und den Anfang des DPO-Transaktionstokens. Die Transaktions-ID ist der DPO-Transaktionstoken.
On hold after payment: DPO hat eine Zahlung bestätigt, aber der Betrag oder die Währung weicht von der Bestellung ab, die Zahlung ist nur autorisiert und nicht erfasst, die Transaktion wurde über- oder unterbezahlt, oder die Bestellung war bereits storniert. Die Bestellnotiz erklärt den Grund. Prüfen Sie die Transaktion im DPO-Portal. Erfassen oder stornieren Sie eine nur autorisierte Zahlung im DPO-Portal und aktualisieren Sie dann die Bestellung.
Failed: die Zahlung wurde abgelehnt, storniert, oder die Zahlungsfrist ist abgelaufen. Der Kunde kann erneut bezahlen.
Cancelled: der Kunde ist von der DPO-Seite zum Shop zurückgekehrt, oder die Bestellung wurde von Ihnen oder durch den WooCommerce-Timeout für unbezahlte Bestellungen storniert. Der unbezahlte DPO-Zahlungslink wird bei DPO storniert.
Eine spätere Ablehnungsmeldung ändert niemals eine bereits bezahlte Bestellung, und Ergebnisse älterer Zahlungslinks lassen den aktuellen Versuch niemals fehlschlagen. Bestätigt DPO eine zweite erfolgreiche Zahlung für eine bereits bezahlte Bestellung, erhält die Bestellung eine Notiz über eine mögliche Doppelzahlung, damit Sie diese im DPO-Portal erstatten können.
Erstattungen
Erstattungen aus WooCommerce sind in dieser Version nicht verfügbar. Erstatten Sie die Zahlung im DPO-Händlerportal und markieren Sie die Bestellung dann in WooCommerce als erstattet.
Lizenzschlüssel
Das Plugin funktioniert mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock befindet sich oben auf WooCommerce > Settings > Payments > DPO Pay. 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. Verwenden Sie Check now, um den Status erneut zu prüfen, Change key, um einen anderen Schlüssel einzugeben, und Remove key, um ihn von dieser Website zu entfernen. Der Link Manage licenses and domains in your account öffnet Ihr vibefox.net-Konto.
Ein Schlüssel funktioniert auf einer 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 einen aktiven Schlüssel wird DPO Pay den Kunden an der Kasse nicht angezeigt. Wird trotzdem eine Zahlung gestartet, sieht der Kunde This payment method is not available. Please choose another one. Angemeldete Shop-Manager sehen die Zahlungsmethode weiterhin, gekennzeichnet 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 den WooCommerce-Seiten. Bestehende Bestellungen sind nicht betroffen: bereits gestartete Zahlungen werden weiterhin bestätigt.
Läuft eine Lizenz ab, funktioniert das Plugin weiter, aber Updates und Support erfordern eine Verlängerung. Der Status wird im Hintergrund automatisch erneut geprüft.
Fehlerbehebung
DPO Pay erscheint nicht an der Kasse: prüfen Sie, dass die Lizenz aktiv ist, Enable/Disable aktiviert ist und der Company Token und der Service Type des ausgewählten Modus eingetragen sind: die Testfelder im Testmodus, andernfalls die Live-Felder. Die Einstellungsseite zeigt eine Warnung an, wenn diese fehlen.
Die Zahlung wurde durchgeführt, aber die Bestellung bleibt bei Pending payment: wahrscheinlich ist die Push-Benachrichtigungs-URL für Ihr DPO-Konto nicht eingestellt, und der Kunde ist nicht zum Shop zurückgekehrt. Bitten Sie den DPO-Support, die in den Einstellungen angezeigte URL einzutragen. Die Bestellung wird außerdem durch die automatische Nachprüfung 15 Minuten nach der Weiterleitung bestätigt. Aktivieren Sie Logging und sehen Sie in WooCommerce > Status > Logs, Quelle wcp_dpo_pay, nach.
Die Push-Benachrichtigung antwortet Unknown transaction: der Transaktionstoken gehört nicht zu einer DPO-Pay-Bestellung dieses Shops, zum Beispiel stammt die Push-Benachrichtigung von einem anderen Shop im selben DPO-Konto.
Die Push-Benachrichtigung antwortet Verification failed: DPO konnte zur Zahlungsprüfung nicht erreicht werden. DPO wiederholt die Benachrichtigung, und die automatische Nachprüfung bestätigt die Bestellung ebenfalls.
Der Service Type wird nicht gespeichert: er muss die numerische Service Type ID von DPO sein.
Der Kunde sieht DPO Pay is temporarily unavailable: DPO hat sich geweigert, die Transaktion zu erstellen, zum Beispiel aufgrund eines falschen Company Token oder Service Type, oder eines Tokens des anderen Modus. Der DPO-Ergebniscode steht in WooCommerce > Status > Logs, Quelle wcp_dpo_pay.
Der Kunde sieht, dass DPO höchstens 2 Dezimalstellen akzeptiert: die Bestellsumme hat 3 Dezimalstellen. DPO kann solche Beträge nicht belasten.
Die Bestellung ist nach der Zahlung On hold: lesen Sie die Bestellnotiz. Der bezahlte Betrag oder die Währung wichen von der Bestellung ab, die Zahlung ist nur autorisiert, die Transaktion wurde über- oder unterbezahlt, oder die Bestellung war storniert worden. Prüfen Sie die Transaktion im DPO-Portal.
Der Lizenzblock zeigt einen Fehler: folgen Sie der Meldung im Block. Wenn der Schlüssel beispielsweise bereits auf einer anderen Domain verwendet wird, geben Sie einen Platz in Ihrem vibefox.net-Konto frei und klicken Sie auf Check now. Hat sich die Website-Adresse 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, nur die geplanten Statusprüfungen werden gestoppt. Um es zu entfernen, deaktivieren Sie es und löschen Sie es auf der Seite Plugins. Der Lizenzschlüssel und der Lizenzstatus dieses Plugins werden immer entfernt. Die Einstellungen, die bei Bestellungen gespeicherten DPO-Daten, die geplanten Prüfungen und die Protokolle werden nur entfernt, wenn Delete data aktiviert war. Andernfalls bleiben sie für eine spätere Neuinstallation erhalten. Bestehende Bestellungen behalten ihre Zahlungsnotizen und Transaktions-IDs.
DPO Pay ist eine Marke des jeweiligen Inhabers. Dieses Plugin ist nicht mit DPO Pay verbunden und wird nicht von DPO Pay empfohlen.