VibeFox MakeCommerce for WooCommerce — Hilfe
Anforderungen
WordPress: 6.0 oder neuer.
WooCommerce: 7.0 oder neuer, installiert und aktiv. Ohne WooCommerce verweigert das Plugin die Aktivierung.
PHP: 8.0 oder neuer.
Internetzugriff auf Ihre Website: MakeCommerce sendet Zahlungsbenachrichtigungen an Ihren Shop, daher muss die Website über das Internet erreichbar sein (HTTPS empfohlen). Eine Firewall, ein Wartungsmodus oder eine Basisauthentifizierung können diese blockieren.
MakeCommerce-Konto: Sie benötigen die Shop ID und den Secret key aus dem MakeCommerce Merchant Portal (Settings > API). Die Test- und die Live-Umgebung haben separate Konten und Schlüssel. Welche Zahlungsmethoden und Währungen verfügbar sind, wird durch Ihren MakeCommerce-Vertrag bestimmt (Banklinks sind in EUR). Währungen mit drei Dezimalstellen wie KWD oder BHD werden nicht angeboten.
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_makecommerce_payment auch per FTP nach /wp-content/plugins/ hochladen.
2. Klicken Sie auf Activate.
3. Öffnen Sie die Einstellungen: WooCommerce > Settings > Payments > MakeCommerce > Manage oder klicken Sie auf der Seite „Plugins“ unter dem Pluginnamen auf Settings.
4. Geben Sie Ihren VibeFox-Lizenzschlüssel im Lizenzblock oben auf der Seite ein und klicken Sie auf Activate.
5. Geben Sie die Shop ID und den Secret key der Testumgebung sowie für echte Zahlungen die Live-Schlüssel ein (siehe Konfiguration). Im Merchant Portal muss nichts konfiguriert werden.
6. Aktivieren Sie Enable/Disable. Testen Sie eine Zahlung mit aktiviertem Test mode und deaktivieren Sie ihn anschließend, um echte Zahlungen zu akzeptieren.
Konfiguration
Alle Einstellungen befinden sich auf einer Seite: WooCommerce > Settings > Payments > MakeCommerce. Über den Feldern zeigt die Seite Test mode is on: payments are created in the MakeCommerce test environment and no real money is charged. an, während der Testmodus aktiv ist. Sie warnt Sie, wenn die Methode aktiviert ist, aber die Shop ID oder der Secret key der aktuellen Umgebung leer ist, und wenn die Shop-Währung nicht von MakeCommerce abgerechnet werden kann. In beiden Fällen wird die Methode an der Kasse ausgeblendet. In der Liste der Zahlungsmethoden wird MakeCommerce als einrichtungsbedürftig markiert, bis die aktuelle Umgebung ihre Schlüssel hat. Leerzeichen werden beim Speichern aus den Schlüsseln entfernt.
General
Enable/Disable: Enable MakeCommerce payments schaltet die Zahlungsmethode ein oder aus. Standard: aus.
Title: der Name der Zahlungsmethode, den Kunden an der Kasse sehen. Standard: Bank link or card (MakeCommerce).
Description: der Text, der unter der Zahlungsmethode an der Kasse angezeigt wird. Standard: Pay with your Estonian, Latvian, Lithuanian or Finnish bank, or by card. You will be redirected to the secure MakeCommerce payment page.
MakeCommerce account
Die Shop ID und der Secret key befinden sich im MakeCommerce Merchant Portal unter Settings > API. Das Testportal und das Liveportal haben separate Konten und Schlüssel. Der Abschnitt enthält Links zu beiden Portalen sowie zur Registrierungsseite von MakeCommerce.
Test mode: Use the MakeCommerce test environment (no real money is charged). Neue Zahlungen werden in der ausgewählten Umgebung mit deren Schlüsseln erstellt. Jede Bestellung merkt sich die Umgebung, in der sie bezahlt wurde: Statusprüfungen und Erstattungen gehen immer dorthin. An der Kasse wird der Hinweis TEST MODE — MakeCommerce test environment, no real money is charged. angezeigt. Standard: ein.
Test Shop ID: die Shop ID Ihres Testkontos im Format xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.
Test Secret key: der Secret key Ihres Testkontos.
Live Shop ID: die Shop ID Ihres Livekontos.
Live Secret key: der Secret key Ihres Livekontos.
Payment notifications
Im Merchant Portal muss nichts konfiguriert werden. Jede Transaktion überträgt ihre eigenen Rückkehr-, Abbruch- und Benachrichtigungs-URLs, basierend auf der in diesem Abschnitt angezeigten Adresse (sie sieht aus wie https://your-site/wc-api/wc_mkc_payment/) ergänzt um Bestellnummer und Bestellschlüssel. MakeCommerce sendet eine signierte Nachricht an die Benachrichtigungs-URL (Server zu Server) und mit dem Browser des Kunden an die Rückkehr- oder Abbruch-URL. Die Signatur wird mit dem Secret key der Umgebung geprüft, in der die Transaktion erstellt wurde. Nachrichten ohne gültige Signatur werden abgelehnt.
Das Plugin verarbeitet folgende MakeCommerce-Transaktionsstatus:
Die Zahlung wird auch bestätigt, wenn der Kunde zum Shop zurückkehrt. Kehrt der Kunde ohne signierte Nachricht zurück, fragt das Plugin den Status bei der MakeCommerce-API ab.
Advanced
Debug log: Log API calls and payment notifications schreibt Details in WooCommerce > Status > Logs, Quelle wcp_makecommerce_payment. Fehler werden immer protokolliert. Schlüssel und Kundendaten werden niemals protokolliert. Standard: aus.
Delete data: Delete the gateway settings and logs when the plugin is deleted. Bestellungen und deren Zahlungsnotizen bleiben immer erhalten. Das Deaktivieren des Plugins löscht niemals Daten. Standard: aus.
Kasse
Der Kunde wählt die Zahlungsmethode (standardmäßig Bank link or card (MakeCommerce)) und gibt die Bestellung auf. Das Plugin erstellt eine MakeCommerce-Transaktion über den Gesamtbetrag der Bestellung in der Bestellwährung und leitet den Kunden zur MakeCommerce-Zahlungsseite weiter. Dort wählt der Kunde einen Banklink oder eine Karte. Die Rechnungs-E-Mail und das Rechnungsland werden an MakeCommerce übergeben, und die Seite öffnet sich in der Sprache des Shops, sofern MakeCommerce diese unterstützt (Estnisch, Englisch, Lettisch, Litauisch, Finnisch, Russisch, Deutsch, Polnisch), andernfalls auf Englisch.
Nach der Zahlung kehrt der Kunde zur Bestelleingangsseite Ihres Shops zurück. Die Bestellung wird erst als bezahlt markiert, nachdem MakeCommerce dies bestätigt hat: durch die signierte Benachrichtigung oder durch die signierte Rückkehr des Kunden, mit einer Überprüfung der Transaktion über die MakeCommerce-API.
Bricht der Kunde auf der MakeCommerce-Seite ab oder läuft die Zahlung ab, kehrt der Kunde mit einer Nachricht zur Kasse (oder zur Seite Pay for order) zurück, beispielsweise The payment was cancelled. You can try again or choose another payment method. oder The payment session expired. Please try again. Kann die Zahlung noch nicht bestätigt werden, lautet die Meldung We could not confirm your payment yet. If you completed it, your order will be updated automatically; otherwise please try again. Der Kunde kann erneut zahlen. Ein älterer Zahlungslink derselben Bestellung funktioniert weiterhin, und die Bestellung kann nicht doppelt bezahlt werden.
Falls MakeCommerce die Zahlung nicht starten kann, sieht der Kunde MakeCommerce is temporarily unavailable. Please try again in a moment or choose another payment method. oder MakeCommerce could not start the payment for this order. Please choose another payment method or contact us. Der technische Grund wird den Bestellnotizen und dem Protokoll hinzugefügt.
Die Zahlungsmethode funktioniert in der klassischen Kasse, im Kassen-Block und auf der Seite Pay for order. Sie ist kompatibel mit dem High-Performance Order Storage (HPOS) von WooCommerce.
Die Bank oder Karte wird auf der MakeCommerce-Seite ausgewählt, nicht in Ihrer Kasse. Das Plugin unterstützt keine gespeicherten Karten, wiederkehrenden Zahlungen oder WooCommerce Subscriptions und keinen MakeCommerce-Versand (Paketautomaten, Versandetiketten).
Bestellungen und Erstattungen
Bestellstatus
Pending payment: Der Kunde wurde zu MakeCommerce weitergeleitet und hat noch nicht bezahlt, oder MakeCommerce hat die Zahlung noch nicht bestätigt. Die Bestellnotiz zeigt die MakeCommerce-Transaktion, den Betrag und die Umgebung an.
Processing: Die Zahlung wurde bestätigt. Bestellungen, die nur virtuelle herunterladbare Produkte enthalten, wechseln zu Fertiggestellt, dem WooCommerce-Standard. Die Bestellnotiz zeigt den Betrag, die Transaktion, die Umgebung und die Art der Überprüfung (MakeCommerce-API oder signierte Benachrichtigung). Die Transaktions-ID ist die MakeCommerce-Transaktions-ID.
On hold: Der gezahlte Betrag oder die Währung wich von der Bestellung ab, der Betrag fehlte, der Transaktionsstatus bei MakeCommerce war noch nicht endgültig oder die Zahlung ging für eine stornierte Bestellung ein. Die Bestellnotiz erläutert dies. Eine solche Transaktion bezahlt die Bestellung später niemals. Prüfen Sie die Transaktion im Merchant Portal und schließen Sie die Bestellung manuell ab oder erstatten Sie sie.
Failed: Die letzte Zahlung der Bestellung wurde abgebrochen, ist abgelaufen oder fehlgeschlagen. Der Kunde kann erneut zahlen.
Geht eine zweite Zahlung für eine bereits bezahlte Bestellung ein, wird die Bestellung nicht erneut geändert. Eine Notiz fordert Sie auf, das Duplikat im MakeCommerce Merchant Portal zu erstatten.
Check MakeCommerce payment status
Wählen Sie auf der Bestellseite in den Bestellaktionen Check MakeCommerce payment status. Das Plugin fragt den Status der Transaktionen der Bestellung (die neueste zuerst) bei der MakeCommerce-API ab, wendet ihn an und fügt eine Notiz mit dem Ergebnis hinzu. Verwenden Sie dies, wenn eine Bestellung auf „Zahlung ausstehend“ stehen bleibt, obwohl der Kunde bezahlt hat.
Erstattungen
Öffnen Sie die Bestellung, klicken Sie auf Refund, geben Sie den Betrag ein und klicken Sie auf Refund via Bank link or card (MakeCommerce) (die Schaltfläche zeigt Ihren Title). Vollständige und teilweise Erstattungen werden unterstützt. Die Erstattung wird an die Umgebung gesendet, in der die Bestellung bezahlt wurde (Test oder Live); daher müssen die Schlüssel dieser Umgebung hinterlegt sein. Wird die Erstattung von MakeCommerce nicht akzeptiert, zeigt WooCommerce den Fehler an, eine Notiz wird hinzugefügt und es wird keine Erstattung erfasst. Wenn MakeCommerce die Zahlung noch verarbeitet, lautet die Meldung MakeCommerce is still processing this payment — try the refund again later. Eine erfolgreiche Erstattung wird mit der MakeCommerce-Erstattungs-ID den Bestellnotizen hinzugefügt.
Erstattungen, die im Merchant Portal vorgenommen wurden, treffen mit dem Transaktionsstatus ein und werden den Bestellnotizen hinzugefügt. Sie werden nicht automatisch als WooCommerce-Erstattungen erfasst.
Lizenzschlüssel
Das Plugin funktioniert mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock befindet sich oben unter WooCommerce > Settings > Payments > MakeCommerce. Fügen Sie den Schlüssel in License key ein und klicken Sie auf Activate. Der Block zeigt den Status an, beispielsweise 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 Konto auf vibefox.net.
Ein Schlüssel funktioniert auf einer Domain. Das Entfernen des Schlüssels von einer Website gibt den Domainplatz nicht frei. Geben Sie den Platz in Ihrem Konto auf vibefox.net frei.
Ohne aktiven Schlüssel wird MakeCommerce den Kunden an der Kasse nicht angezeigt. Wird dennoch eine Zahlung gestartet, 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. Eine Erinnerung erscheint auf der Seite „Plugins“ und auf WooCommerce-Seiten. Bestehende Bestellungen sind nicht betroffen: Bereits gestartete Zahlungen werden weiterhin bestätigt und Erstattungen funktionieren.
Wenn eine Lizenz abläuft, funktioniert das Plugin weiter, für Updates und Support ist jedoch eine Verlängerung erforderlich. Der Status wird im Hintergrund automatisch erneut geprüft.
Fehlerbehebung
MakeCommerce erscheint nicht an der Kasse: Prüfen Sie, ob die Lizenz aktiv ist, Enable/Disable eingeschaltet ist und die Schlüssel der aktuellen Umgebung hinterlegt sind: Test Shop ID und Test Secret key im Testmodus, Live Shop ID und Live Secret key im Livemodus. Prüfen Sie, ob die Shop-Währung (oder die Bestellwährung auf der Seite „Pay for order“) maximal zwei Dezimalstellen hat. Die Einstellungsseite zeigt für jedes dieser Probleme eine Warnung an.
Die Zahlung war erfolgreich, aber die Bestellung bleibt auf „Zahlung ausstehend“ stehen: Die Benachrichtigungen konnten die Website nicht erreichen, beispielsweise wegen einer Firewall, des Wartungsmodus oder einer Basisauthentifizierung. Öffnen Sie die Bestellung und führen Sie die Bestellaktion Check MakeCommerce payment status aus. Prüfen Sie, ob die Schlüssel der Umgebung, in der die Zahlung getätigt wurde, hinterlegt sind: Die Benachrichtigung wird mit dem Secret key dieser Umgebung geprüft; ohne diesen erhält MakeCommerce einen Fehler und unternimmt weitere Versuche.
Die Bestellung steht auf „In Wartestellung“ mit einer MakeCommerce-Notiz: Die Zahlung stimmte nicht mit der Bestellung überein (Betrag, Währung, Status) oder ging für eine stornierte Bestellung ein. Prüfen Sie die Transaktion im Merchant Portal und schließen Sie die Bestellung manuell ab oder erstatten Sie sie.
Benachrichtigungen werden abgelehnt: Eine Nachricht mit ungültiger Signatur, für eine andere Bestellung, einen anderen Shop oder eine nicht für die Bestellung erstellte Transaktion wird abgelehnt, und die Bestellung wird nicht geändert. Prüfen Sie, ob Shop ID und Secret key zum selben MakeCommerce-Konto und zur selben Umgebung gehören.
Der Kunde sieht beim Aufgeben der Bestellung einen Fehler: Öffnen Sie die Bestellnotizen oder aktivieren Sie das Debug log und prüfen Sie WooCommerce > Status > Logs, Quelle wcp_makecommerce_payment. Eine Währung, die MakeCommerce nicht verarbeiten kann, erzeugt MakeCommerce cannot process payments in gefolgt vom Währungscode.
Die Erstattung schlägt mit einer Meldung über die Umgebung fehl: Die Bestellung wurde in der Test- oder Live-Umgebung bezahlt, und die Schlüssel dieser Umgebung sind nicht konfiguriert. Tragen Sie diese ein und versuchen Sie es erneut.
Die Erstattung schlägt mit No MakeCommerce transaction ID found for this order fehl: Die Bestellung weist keine MakeCommerce-Transaktion auf. Erstatten Sie sie im Merchant Portal.
Der Lizenzblock zeigt einen Fehler an: Folgen Sie der Meldung im Block. Wenn der Schlüssel beispielsweise bereits auf einer anderen Domain verwendet wird, geben Sie einen Platz in Ihrem Konto auf vibefox.net 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
Das Deaktivieren des Plugins behält alle Daten bei. Um es zu 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 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.
MakeCommerce ist eine Marke des jeweiligen Eigentümers. Dieses Plugin ist nicht mit MakeCommerce verbunden und wird von MakeCommerce nicht unterstützt.