VibeFox MultiSafepay 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: Die Shop- oder Bestellwährung muss eine von MultiSafepay akzeptierte Währung sein, zum Beispiel EUR, USD, GBP, PLN, CHF, SEK, DKK oder NOK. Bei anderen Währungen wird die Zahlungsart an der Kasse ausgeblendet.
MultiSafepay-Konto: Sie benötigen den API-Schlüssel Ihrer Website in MultiSafepay Control. Test- und Live-Konten haben unterschiedliche Schlüssel. In MultiSafepay muss sonst nichts eingerichtet werden: Die Benachrichtigungsadresse wird mit jeder Zahlung übermittelt.
Öffentliche Website: MultiSafepay muss Ihre Website erreichen können, um Benachrichtigungen zu senden. Andernfalls werden Bestellungen trotzdem aktualisiert, wenn der Kunde von MultiSafepay zurückkehrt.
VibeFox-Lizenzschlüssel: wird auf vibefox.net gekauft. 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 auch den Ordner wcp_multisafepay_gateway per FTP nach /wp-content/plugins/ hochladen.
2. Klicken Sie auf Activate.
3. Öffnen Sie die Einstellungen: WooCommerce > Settings > Payments > MultiSafepay > Manage, oder klicken Sie auf der Plugins-Seite 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 den Test- und/oder Live-API-Schlüssel aus MultiSafepay Control ein (siehe Konfiguration).
6. Aktivieren Sie Enable/Disable und speichern Sie. Testen Sie eine Zahlung mit aktiviertem Test mode und entfernen Sie danach den Haken, um echte Zahlungen anzunehmen.
Konfiguration
Alle Einstellungen befinden sich auf einer Seite: WooCommerce > Settings > Payments > MultiSafepay. Der Seitentitel zeigt eine Kennzeichnung Test mode, solange der Testmodus aktiv ist. Oberhalb der Felder warnt die Seite, wenn für den aktuellen Modus kein API-Schlüssel hinterlegt ist (die Zahlungsart wird dann an der Kasse nicht angezeigt) oder MultiSafepay die Shop-Währung nicht akzeptiert. In der Liste der Zahlungsarten ist MultiSafepay als einrichtungsbedürftig markiert, bis für den aktuellen Modus ein API-Schlüssel vorhanden ist.
Kasse
Enable/Disable: Enable MultiSafepay aktiviert oder deaktiviert die Zahlungsart. Standard: aus.
Title: der Name der Zahlungsart, den Kunden an der Kasse sehen. Standard: MultiSafepay.
Description: der Text unter der Zahlungsart an der Kasse. Standard: Pay securely with iDEAL, cards, Bancontact, PayPal and more via MultiSafepay.
API-Schlüssel
Den API-Schlüssel finden Sie unter MultiSafepay Control > Manage settings > Website settings. Das Testkonto (testmerchant.multisafepay.com) und das Live-Konto (merchant.multisafepay.com) haben unterschiedliche Schlüssel. Der Testmodus verwendet nur den Testschlüssel, der Live-Modus nur den Live-Schlüssel.
Test mode: Use the MultiSafepay test environment (no real payments). Dies wechselt sowohl die API-Adresse als auch den API-Schlüssel. Bereits getätigte Zahlungen verwenden für Statusprüfungen und Erstattungen weiterhin die Umgebung, in der sie getätigt wurden. Standard: ein.
Test API key: der API-Schlüssel Ihres MultiSafepay-Testkontos.
Live API key: der API-Schlüssel Ihres MultiSafepay-Live-Kontos.
Benachrichtigungen
Hier ist nichts zu konfigurieren. Dieser Abschnitt zeigt die Benachrichtigungs-URL, die mit jeder Zahlung an MultiSafepay gesendet wird. Sie sieht etwa so aus: https://your-site/?wc-api=mspg_webhook. MultiSafepay muss Ihre Website erreichen können. Eine Benachrichtigung teilt dem Plugin nur mit, welche Zahlung sich geändert hat: Status, Betrag und Währung werden immer über die MultiSafepay-API mit Ihrem API-Schlüssel abgerufen, bevor eine Bestellung geändert wird. Benachrichtigungen zu Zahlungen, die keiner Bestellung Ihres Shops gehören, werden ignoriert.
Bestellungen
Order status after payment: der Status einer bezahlten Bestellung. Der Status wird sofort gesetzt, mit einem Statuswechsel und einer E-Mail an den Kunden.
Erweitert
Debug log: Log API calls and notifications schreibt Details nach WooCommerce > Status > Logs, Quelle wcp_multisafepay_gateway. Fehler werden immer protokolliert. API-Schlüssel und Kundendaten werden nicht protokolliert. Standard: aus.
Delete data on uninstall: Remove settings, logs and MultiSafepay order data when the plugin is deleted. Das Deaktivieren des Plugins löscht nie etwas. Standard: aus.
Kasse
Der Kunde wählt die Zahlungsart (standardmäßig MultiSafepay) und gibt die Bestellung auf. Das Plugin erstellt eine MultiSafepay-Zahlung über den Bestellbetrag in der Bestellwährung und leitet den Kunden zur MultiSafepay-Zahlungsseite weiter. Dort wählt der Kunde eine beliebige in Ihrem MultiSafepay-Konto aktivierte Zahlungsart und bezahlt. Die Rechnungsdaten des Kunden und die Shop-Sprache werden an MultiSafepay übergeben; die Zahlung erscheint als Order #, mit der Bestellnummer und dem Namen Ihrer Website. Im Testmodus zeigt die Kasse Test mode: no real payment will be made. an.
Der Bestand wird reserviert, während der Kunde bezahlt, und der Warenkorb bleibt bis zur Seite „Bestellung eingegangen“ erhalten. Nach der Zahlung kehrt der Kunde zur Seite „Bestellung eingegangen“ Ihres Shops zurück. Die Bestellung wird erst als bezahlt markiert, wenn MultiSafepay sie bestätigt: durch die Benachrichtigung oder durch eine Prüfung über die MultiSafepay-API, wenn der Kunde diese Seite erreicht.
Bricht der Kunde auf der MultiSafepay-Seite während der Kasse ab, wird die Bestellung auf die übliche WooCommerce-Weise storniert, der Bestand freigegeben und die Produkte bleiben im Warenkorb. Hat der Kunde über die Seite Pay for order bezahlt, kehrt er auf diese Seite zurück, die erklärt, was geschehen ist: The MultiSafepay payment was cancelled. You can try again or choose another payment method., The payment was declined. Please try again or choose another payment method. oder The payment session has expired. Please try again.
Ein Kunde kann eine unbezahlte Bestellung erneut bezahlen. Vor dem Erstellen einer neuen Zahlung prüft das Plugin die vorherige bei MultiSafepay. Ist sie bereits bezahlt, wird die Bestellung bestätigt. Ist sie noch offen mit demselben Betrag, wird dieselbe Zahlungsseite wiederverwendet. Hat sich der Betrag geändert, wird die alte Zahlung bei MultiSafepay storniert, sodass sie nicht mehr bezahlt werden kann.
Kann MultiSafepay die Zahlung nicht starten, sieht der Kunde eine kurze Meldung, zum Beispiel Could not connect to MultiSafepay. Please try again in a moment. oder MultiSafepay cannot accept this order amount or currency. Please choose another payment method., und kann eine andere Zahlungsart wählen. Der MultiSafepay-Fehler wird den Bestellnotizen hinzugefügt.
Die Zahlungsart funktioniert an der klassischen Kasse, im Checkout-Block und auf der Seite Pay for order. Sie ist mit WooCommerce High-Performance Order Storage (HPOS) kompatibel.
Das Plugin bietet eine Zahlungsart, die zur MultiSafepay-Seite führt. Es gibt keine eigenen WooCommerce-Zahlungsarten je MultiSafepay-Zahlungsmethode, keine eingebetteten Kartenfelder, keine Apple Pay- oder Google Pay-Express-Schaltflächen, keine Abonnements, wiederkehrenden Zahlungen oder gespeicherten Karten und keine Erfassung oder Stornierung aus WooCommerce heraus. Es werden keine Warenkorbdaten übermittelt, daher bietet MultiSafepay für diese Bestellungen keine Zahlungsarten mit späterer Zahlung an, die diese benötigen (zum Beispiel Klarna, in3 oder Riverty).
Bestellungen und Erstattungen
Bestellstatus
Pending payment: der Kunde wurde zu MultiSafepay weitergeleitet und hat noch nicht bezahlt.
Processing oder Completed: MultiSafepay hat die Zahlung bestätigt (abgeschlossen oder versendet). Der Status richtet sich nach Order status after payment. Die Bestellnotiz zeigt die MultiSafepay-Zahlungs-ID, die Zahlungsart und die Umgebung. Die Transaktions-ID ist die MultiSafepay-Bestell-ID der Zahlung.
On hold before payment: die Zahlung ist nicht abgeschlossen (wird von MultiSafepay geprüft) oder reserviert (autorisiert). Erfassen Sie eine reservierte Zahlung in MultiSafepay Control, um das Geld zu erhalten. Die Bestellung wird automatisch abgeschlossen, wenn MultiSafepay sie als bezahlt meldet.
On hold after payment: MultiSafepay hat einen anderen Betrag oder eine andere Währung als den Bestellbetrag bestätigt, eine Testzahlung wurde abgeschlossen, während der Shop im Live-Modus ist (es ging kein echtes Geld ein), oder die Zahlung wurde abgeschlossen, nachdem die Bestellung storniert worden war. Die Bestellnotiz erklärt dies. Prüfen Sie die Transaktion in MultiSafepay Control und bearbeiten oder erstatten Sie die Bestellung manuell.
On hold after a chargeback: MultiSafepay hat eine Rückbuchung zu einer bezahlten Bestellung gemeldet: Das Geld wurde von Ihrem Konto zurückgebucht.
Failed: die letzte Zahlung einer unbezahlten Bestellung wurde abgelehnt, storniert, ist abgelaufen oder wurde annulliert. Der reservierte Bestand wird freigegeben. Der Kunde kann es erneut versuchen.
Eine bezahlte, erstattete oder stornierte Bestellung wird durch eine verspätete Benachrichtigung nie wieder geöffnet. Wird eine zweite Zahlung für eine bereits bezahlte Bestellung abgeschlossen, wird die Bestellung nicht erneut geändert. Eine Notiz bittet Sie, das Duplikat in MultiSafepay Control zu erstatten.
Erstattungen
Öffnen Sie die Bestellung, klicken Sie auf Refund, geben Sie den Betrag ein und klicken Sie auf Refund via MultiSafepay. Vollständige und teilweise Erstattungen sind für über MultiSafepay bezahlte Bestellungen möglich. Die Erstattung wird an die Umgebung gesendet, in der die Zahlung erfolgte (Test oder Live), daher muss der API-Schlüssel dieser Umgebung hinterlegt sein. Akzeptiert MultiSafepay die Erstattung nicht, zeigt WooCommerce den MultiSafepay-Fehler an, und es wird keine Erstattung erfasst. Eine erfolgreiche Anfrage wird mit der MultiSafepay-Erstattungs-ID in den Bestellnotizen vermerkt.
In MultiSafepay Control vorgenommene Erstattungen werden den Bestellnotizen hinzugefügt, sobald MultiSafepay sie meldet. Sie werden nicht automatisch als WooCommerce-Erstattungen erfasst. Erstellen Sie bei Bedarf eine manuelle Erstattung in WooCommerce ohne Refund via MultiSafepay.
Lizenzschlüssel
Das Plugin arbeitet mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzbereich befindet sich oben unter WooCommerce > Settings > Payments > MultiSafepay. 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 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 funktioniert auf einer Domain. Das Entfernen des Schlüssels von einer Website gibt den Domain-Platz nicht frei. Geben Sie den Platz in Ihrem vibefox.net-Konto frei.
Ohne aktiven Schlüssel wird MultiSafepay 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 Zahlungsart 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 sind nicht betroffen: Bereits gestartete Zahlungen werden weiterhin bestätigt, und Erstattungen funktionieren.
Läuft eine Lizenz ab, arbeitet das Plugin weiter, doch für Updates und Support ist eine Verlängerung nötig. Der Status wird im Hintergrund automatisch erneut geprüft.
Fehlerbehebung
MultiSafepay erscheint nicht an der Kasse: Prüfen Sie, ob die Lizenz aktiv ist, Enable/Disable eingeschaltet ist, der aktuelle Modus einen API-Schlüssel hat (Test API key im Testmodus, Live API key im Live-Modus) und die Shop- oder Bestellwährung von MultiSafepay akzeptiert wird. Die Einstellungsseite zeigt eine Warnung, wenn der Schlüssel fehlt oder die Währung nicht akzeptiert wird.
Die Zahlung ist erfolgt, aber die Bestellung bleibt bei Pending payment: Die Benachrichtigung hat Ihren Shop nicht erreicht. Prüfen Sie, ob die Website aus dem Internet erreichbar ist und ob der API-Schlüssel der Umgebung der Zahlung hinterlegt ist, da das Plugin den Status über die MultiSafepay-API abruft. Kann die API nicht erreicht werden, antwortet die Benachrichtigung mit ERROR, und MultiSafepay wiederholt sie. Die Bestellung wird auch aktualisiert, wenn der Kunde zur Seite „Bestellung eingegangen“ zurückkehrt und wenn er versucht, dieselbe Bestellung erneut zu bezahlen.
Der Kunde sieht beim Absenden der Bestellung einen Fehler: Öffnen Sie die Bestellnotizen oder aktivieren Sie Debug log und prüfen Sie WooCommerce > Status > Logs, Quelle wcp_multisafepay_gateway. This payment method is temporarily unavailable. Please choose another payment method. bedeutet meist einen falschen oder fehlenden API-Schlüssel. MultiSafepay cannot accept this order amount or currency. Please choose another payment method. bedeutet, dass MultiSafepay Betrag oder Währung abgelehnt hat.
Die Bestellung ist On hold after payment: Lesen Sie die Bestellnotiz. Die Zahlung kann nicht abgeschlossen oder reserviert sein, der bezahlte Betrag oder die Währung kann vom Bestellbetrag abweichen, eine Testzahlung kann im Live-Modus eingegangen sein, die Zahlung kann nach der Stornierung der Bestellung erfolgt sein oder es kann eine Rückbuchung vorliegen. Prüfen Sie die Transaktion in MultiSafepay Control.
Testzahlungen bestätigen keine Live-Bestellung: Eine Testzahlung bezahlt nie eine Bestellung, solange der Shop im Live-Modus ist; stattdessen wird die Bestellung auf Halten gesetzt. Frühere Testzahlungen werden nach dem Wechsel in den Live-Modus weiterhin mit dem Testschlüssel geprüft und erstattet.
Erstattung schlägt mit einer Meldung zur Umgebung fehl: Die Zahlung wurde in der Test- oder Live-Umgebung getätigt, und der API-Schlüssel dieser Umgebung 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 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
Das Deaktivieren des Plugins behält alle Daten. Zum Entfernen deaktivieren und löschen Sie es auf der Seite Plugins. Der Lizenzschlüssel und der Lizenzstatus dieses Plugins werden immer entfernt. Die Gateway-Einstellungen, die bei Bestellungen gespeicherten MultiSafepay-Daten 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 und Transaktions-IDs.
MultiSafepay ist eine Marke ihres jeweiligen Inhabers. Dieses Plugin ist weder mit MultiSafepay verbunden noch wird es von MultiSafepay empfohlen.