VibeFox PayPlug for WooCommerce — Hilfe
Anforderungen
WordPress: 6.0 oder neuer.
WooCommerce: 7.0 oder neuer, installiert und aktiv. Ohne WooCommerce lässt sich das Plugin nicht aktivieren.
PHP: 8.0 oder neuer.
Währung und Beträge: Euro (EUR), von 0,99 bis 20.000,00 pro Zahlung, die PayPlug-Standardwerte. Bei einer anderen Währung oder außerhalb dieser Grenzen wird die Zahlungsart ausgeblendet.
PayPlug-Konto: Sie benötigen die geheimen Schlüssel Ihres PayPlug-Kontos: den Testschlüssel (sk_test_...) und/oder den Live-Schlüssel (sk_live_...). Weitere Schlüssel sind nicht nötig, und in PayPlug muss keine Benachrichtigung eingerichtet werden. Ihre Website muss aus dem Internet erreichbar sein, um Benachrichtigungen zu empfangen; andernfalls werden Bestellungen aktualisiert, wenn der Kunde von PayPlug zurückkehrt.
VibeFox-Lizenzschlüssel: erhältlich 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. Alternativ können Sie den Ordner wcp_payplug_gateway per FTP nach /wp-content/plugins/ hochladen.
2. Klicken Sie auf Activate.
3. Öffnen Sie die Einstellungen: WooCommerce > Settings > Payments > PayPlug > Manage oder klicken Sie auf der Seite Plugins unter dem Plugin-Namen auf Settings.
4. Geben Sie Ihren VibeFox-Lizenzschlüssel im Lizenzbereich oben auf der Seite ein und klicken Sie auf Activate.
5. Fügen Sie Ihre geheimen Schlüssel aus dem PayPlug-Portal ein (siehe Konfiguration).
6. Aktivieren Sie Enable/Disable und speichern Sie. Testen Sie eine Zahlung mit eingeschaltetem Test Mode und deaktivieren Sie ihn danach, um echte Zahlungen anzunehmen.
Konfiguration
Alle Einstellungen befinden sich auf einer Seite: WooCommerce > Settings > Payments > PayPlug. Oberhalb der Felder warnt die Seite, wenn die Zahlungsart aktiviert ist, der geheime Schlüssel des aktuellen Modus aber leer ist, und wenn die Shop-Währung nicht EUR ist. In beiden Fällen wird die Zahlungsart auf der Kasse ausgeblendet. In der Liste der Zahlungsarten zeigt PayPlug im Testmodus ein Testmodus-Abzeichen und ist als einzurichten markiert, bis der aktuelle Modus einen geheimen Schlüssel hat.
Kasse
Enable/Disable: Enable PayPlug Gateway schaltet die Zahlungsart ein oder aus. Standard: off.
Title: der Name der Zahlungsart, den Kunden auf der Kasse sehen. Standard: PayPlug.
Description: der Text unter der Zahlungsart auf der Kasse. Standard: Pay securely by card via PayPlug.
API-Schlüssel
Ihre geheimen Schlüssel finden Sie im PayPlug-Portal unter Developers > API keys. Der Bereich zeigt außerdem die Benachrichtigungs-URL, die das Plugin mit jeder Zahlung übermittelt. Sie sieht etwa so aus: https://your-site/wc-api/ppg_payplug_webhook/. In PayPlug ist keine Einrichtung von Benachrichtigungen nötig.
Test Mode: Enable test mode verwendet für neue Zahlungen den geheimen Testschlüssel. Es werden keine echten Zahlungen verarbeitet. Zahlungen im anderen Modus verwenden für Statusprüfungen und Erstattungen weiterhin den Schlüssel ihres eigenen Modus. Standard: on.
Test Secret Key: Ihr geheimer PayPlug-Testschlüssel. Er beginnt mit sk_test_.
Live Secret Key: Ihr geheimer PayPlug-Live-Schlüssel. Er beginnt mit sk_live_.
Ein Schlüssel mit falschem Präfix wird nicht gespeichert. Die Seite zeigt dann zum Beispiel Test Secret Key must start with "sk_test_". The previous value was kept. an.
Bestellungen
Order Status After Payment: der Bestellstatus, der nach einer erfolgreichen Zahlung gesetzt wird. Der Status wird sofort gesetzt, ohne einen zweiten Statuswechsel.
Erweitert
Logging: Enable debug logging protokolliert API-Aufrufe und Benachrichtigungen unter WooCommerce > Status > Logs, Quelle wcp_payplug_gateway. Fehler werden immer protokolliert. Geheime Schlüssel, Kartendaten und Kundendaten werden nie protokolliert. Standard: off.
Delete Data on Uninstall: Remove all plugin data when uninstalling. Ist die Option aktiv, werden beim Löschen des Plugins die Plugin-Einstellungen und seine Protokolle entfernt. In Bestellungen gespeicherte PayPlug-Zahlungs-IDs bleiben erhalten. Standard: off.
Kasse
Der Kunde wählt die Zahlungsart (standardmäßig PayPlug) und gibt die Bestellung auf. Im Testmodus zeigt die Kasse Testmodus: Es wird keine echte Zahlung ausgeführt. Das Plugin erstellt eine PayPlug-Zahlung über die Bestellsumme in Cent und leitet den Kunden auf die PayPlug-Zahlungsseite weiter. Rechnungs- und Lieferdaten der Bestellung sowie die Sprache Ihrer Website werden an PayPlug übergeben. Dort zahlt der Kunde mit Karte.
Nach der Zahlung kehrt der Kunde zu Ihrem Shop zurück. Die Bestellung wird erst als bezahlt markiert, wenn PayPlug die Zahlung bestätigt: Das Plugin liest die Zahlung über die PayPlug-API, wenn die Benachrichtigung eintrifft und wenn der Kunde zurückkehrt. Eine bezahlte Zahlung führt den Kunden zur Bestellbestätigung.
Bricht der Kunde auf der PayPlug-Seite ab, wird die Zahlungsseite bei PayPlug geschlossen, sodass sie nicht versehentlich später bezahlt werden kann. Der Kunde kehrt mit einer Meldung zur Seite Pay for order zurück, zum Beispiel Sie haben die PayPlug-Zahlung abgebrochen. Sie können es erneut versuchen oder eine andere Zahlungsart wählen., Die PayPlug-Zahlungssitzung ist abgelaufen. Bitte versuchen Sie es erneut oder wählen Sie eine andere Zahlungsart. oder Die PayPlug-Zahlung ist fehlgeschlagen. Bitte versuchen Sie es erneut oder wählen Sie eine andere Zahlungsart.
Bezahlt der Kunde dieselbe Bestellung erneut, prüft das Plugin zuerst den vorherigen Versuch. Wurde er inzwischen bezahlt, wird die Bestellung ohne neue Zahlung abgeschlossen. Ist er noch offen für denselben Betrag, wird dieselbe Zahlungsseite erneut verwendet. Andernfalls wird die alte Seite bei PayPlug geschlossen und eine neue Zahlung erstellt.
Kann PayPlug die Zahlung nicht starten, sieht der Kunde eine kurze Meldung, zum Beispiel PayPlug konnte Ihre Rechnungsdaten (Postleitzahl) nicht akzeptieren. Bitte prüfen Sie diese und versuchen Sie es erneut. oder Der Zahlungsanbieter ist nicht erreichbar. Bitte versuchen Sie es in einem Moment erneut. Der technische Grund wird den Bestellnotizen hinzugefügt.
Die Zahlungsart funktioniert auf der klassischen Kasse, im Checkout-Block und auf der Seite Pay for order. Sie ist mit WooCommerce High-Performance Order Storage (HPOS) kompatibel.
Zahlungen werden sofort erfasst. Das Plugin bietet keine Oney-Ratenzahlungen, Bancontact, Apple Pay oder American Express, keine Ein-Klick-Kartenspeicherung, kein eingebettetes Zahlungsformular, keine Abonnements und keine verzögerte Erfassung.
Bestellungen und Erstattungen
Order statuses
Pending payment: Der Kunde wurde zu PayPlug weitergeleitet und hat noch nicht bezahlt, oder PayPlug hat die Zahlung noch nicht bestätigt.
Processing or Completed: Die Zahlung wurde bestätigt. Der Status richtet sich nach Order Status After Payment. Die Bestellnotiz zeigt die PayPlug-Zahlung und deren Modus. Die Transaktions-ID ist die PayPlug-Zahlungs-ID (pay_...).
On hold: Der gezahlte Betrag oder die Währung weicht von der Bestellung ab (Hinweis amount/currency mismatch); oder eine Testzahlung wurde getätigt, während der Shop im Live-Modus ist, sodass kein Geld eingegangen ist; oder die Zahlung kam für eine Bestellung an, die storniert worden war; oder eine Zahlung ist autorisiert, aber nicht erfasst (erfassen Sie sie im PayPlug-Portal; die Bestellung wird als bezahlt markiert, sobald PayPlug sie als bezahlt meldet). Die Bestellnotiz erklärt, was zu prüfen ist.
Failed: Der letzte Zahlungsversuch einer ausstehenden Bestellung ist fehlgeschlagen oder wurde abgebrochen. Ein Fehler bei einem älteren Versuch ändert die Bestellung nicht. Der Kunde kann erneut bezahlen.
Wird auch ein zweiter Versuch einer bereits bezahlten Bestellung bezahlt, bleibt die Bestellung unverändert. Eine Notiz bittet Sie, die doppelte Zahlung im PayPlug-Portal zu erstatten.
Erstattungen
Öffnen Sie die Bestellung, klicken Sie auf Refund, geben Sie den Betrag ein und klicken Sie auf Refund via PayPlug. Vollständige und teilweise Erstattungen werden unterstützt. Die Erstattung geht an die Zahlung, mit der die Bestellung tatsächlich bezahlt wurde, und verwendet den geheimen Schlüssel des Modus (Test oder Live), in dem sie erfolgte; dieser Schlüssel muss hinterlegt sein. Akzeptiert PayPlug die Erstattung nicht, zeigt WooCommerce den Fehler an und es wird keine Erstattung erfasst. Eine erfolgreiche Erstattung wird mit der PayPlug-Erstattungs-ID in den Bestellnotizen vermerkt.
Im PayPlug-Portal vorgenommene Erstattungen kommen per Benachrichtigung an und werden den Bestellnotizen hinzugefügt. Sie werden nicht automatisch in WooCommerce angelegt. Erfassen Sie sie bei Bedarf manuell.
Lizenzschlüssel
Das Plugin funktioniert mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzbereich befindet sich oben unter WooCommerce > Settings > Payments > PayPlug. Fügen Sie den Schlüssel in License key ein und klicken Sie auf Activate. Der Bereich zeigt den Status, zum Beispiel das Datum, bis zu dem die Lizenz gültig 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 funktioniert auf einer Domain. Wenn Sie den Schlüssel von einer Website entfernen, wird der Domain-Platz nicht frei. Geben Sie ihn in Ihrem vibefox.net-Konto frei.
Ohne aktiven Schlüssel wird PayPlug Kunden auf der Kasse nicht angezeigt. Wird trotzdem eine Zahlung gestartet, sieht der Kunde This payment method is not available. Please choose another one. Angemeldete Shopbetreiber sehen die Zahlungsart weiterhin, markiert mit (unlicensed — visible to admins only), damit Sie das Plugin einrichten und testen können, bevor Sie einen Schlüssel kaufen. Ein Hinweis erscheint auf der Seite Plugins und auf WooCommerce-Seiten. Bestehende Bestellungen sind nicht betroffen: Bereits gestartete Zahlungen werden weiterhin bestätigt, und Erstattungen funktionieren.
Läuft eine Lizenz ab, arbeitet das Plugin weiter, Updates und Support erfordern jedoch eine Verlängerung. Der Status wird automatisch im Hintergrund erneut geprüft.
Fehlerbehebung
PayPlug erscheint nicht auf der Kasse: Prüfen Sie, ob die Lizenz aktiv ist, Enable/Disable eingeschaltet ist, der aktuelle Modus einen geheimen Schlüssel hat (Test Secret Key im Testmodus, Live Secret Key im Live-Modus), die Shop-Währung EUR ist und die Bestellsumme zwischen 0,99 und 20.000,00 EUR liegt. Konten mit anderen Grenzen können diese mit dem Filter ppg_amount_limits (Werte in Cent) ändern.
Die Zahlung ist eingegangen, die Bestellung bleibt aber auf Zahlung ausstehend: Die Benachrichtigung hat Ihren Shop nicht erreicht, und der Kunde ist nicht zurückgekehrt. Prüfen Sie, ob Ihre Website unter der in den Einstellungen angezeigten Benachrichtigungs-URL aus dem Internet erreichbar ist, zum Beispiel ob ein Wartungsmodus, eine Firewall oder ein Passwortschutz sie blockiert. Sehen Sie unter WooCommerce > Status > Logs, Quelle wcp_payplug_gateway, nach abgelehnten Benachrichtigungen.
Die Benachrichtigung antwortet Verification failed: Die Zahlung konnte nicht über die PayPlug-API gelesen werden, etwa weil PayPlug nicht antwortete. Die Bestellung bleibt unverändert, und PayPlug sendet die Benachrichtigung erneut.
Die Benachrichtigung antwortet Busy, retry: Die Bestellung wurde im selben Moment von einer anderen Anfrage aktualisiert, zum Beispiel der Rückkehr des Kunden. PayPlug sendet die Benachrichtigung erneut.
Die Benachrichtigung antwortet Unknown payment oder Payment does not belong to the order: Die Zahlung wurde nicht von diesem Shop oder nicht für diese Bestellung erstellt, zum Beispiel eine Zahlung eines anderen Shops auf demselben PayPlug-Konto. Sie wird ignoriert.
Der Kunde sieht Payment could not be initiated: Der vorherige Zahlungsversuch der Bestellung wird gerade bestätigt, oder PayPlug hat die Anfrage abgelehnt. Warten Sie kurz und versuchen Sie es erneut; die Bestellnotizen zeigen den PayPlug-Fehler.
Die Bestellung ist nach der Zahlung auf Wartend: Lesen Sie die Bestellnotiz. Der gezahlte Betrag oder die Währung wich von der Bestellung ab, eine Testzahlung wurde während des Live-Betriebs getätigt, oder die Zahlung kam an, nachdem die Bestellung storniert war. Bearbeiten Sie die Bestellung oder erstatten Sie die Zahlung.
Erstattung schlägt mit einer Meldung zum Modus fehl: Die Zahlung erfolgte im Test- oder Live-Modus, und der geheime Schlüssel dieses Modus ist nicht hinterlegt. Geben Sie ihn ein und versuchen Sie es erneut.
Der Lizenzbereich zeigt einen Fehler: Folgen Sie der Meldung im Bereich. 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 letzten bekannten Status weiter.
Deinstallation
Das Deaktivieren des Plugins behält alle Daten. Zum Entfernen deaktivieren und löschen Sie es auf der Seite Plugins. Lizenzschlüssel und Lizenzstatus dieses Plugins werden immer entfernt. Die Einstellungen des Gateways und die Protokolle 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 PayPlug-Zahlungs-IDs.
PayPlug ist eine Marke ihres jeweiligen Inhabers. Dieses Plugin ist nicht mit PayPlug verbunden und wird nicht von PayPlug unterstützt.