VibeFox MakeCommerce for PrestaShop — Hilfe

Anforderungen

PrestaShop: 8.0 bis 9.x.

PHP: 8.0 oder neuer. Das Modul lässt sich auf älteren PHP-Versionen nicht installieren.

Internetzugang zu Ihrem Shop: MakeCommerce sendet Zahlungsbenachrichtigungen an Ihren Shop, daher muss die Website aus dem Internet erreichbar sein. Eine Firewall oder eine Basisauthentifizierung kann sie blockieren. Der Wartungsmodus und die Länderbeschränkung Ihres Shops blockieren sie nicht.

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 getrennte Konten und Schlüssel. Welche Zahlungsmethoden und Währungen verfügbar sind, legt Ihr MakeCommerce-Vertrag fest. Währungen mit drei Dezimalstellen, wie KWD oder BHD, werden nicht angeboten.

VibeFox-Lizenzschlüssel: Erhältlich auf vibefox.net. Ein Schlüssel funktioniert auf einer Domain.

Installation

1. Gehen Sie im Back Office zu Modules > Module Manager und klicken Sie auf Upload a module. Wählen Sie die ZIP-Datei des Moduls.

2. Wenn der Upload abgeschlossen ist, klicken Sie auf Configure, oder suchen Sie später VibeFox MakeCommerce Payment in der Modulliste und klicken Sie auf Configure.

3. Geben Sie Ihren VibeFox-Lizenzschlüssel in License key im Lizenzblock oben auf der Seite Configure ein und klicken Sie auf Activate (siehe Lizenzschlüssel).

4. Geben Sie die Shop ID und den Secret key der Testumgebung und für echte Zahlungen die Live-Schlüssel ein (siehe Konfiguration). Im Merchant Portal muss nichts eingerichtet werden.

5. Aktivieren Sie Enable/Disable und klicken Sie auf Save. Testen Sie eine Zahlung mit aktiviertem Test mode und schalten Sie ihn danach aus, um echte Zahlungen anzunehmen.

Bei der Installation legt das Modul den Bestellstatus MakeCommerce payment on hold an. PrestaShop bietet das neue Zahlungsmodul für alle Währungen, Länder und Kundengruppen an. Sie können dies unter Payment > Preferences einschränken.

Konfiguration

Alle Einstellungen befinden sich auf der Modulseite: Modules > Module Manager > VibeFox MakeCommerce Payment > Configure. Jeder Abschnitt hat eine eigene Schaltfläche Save, die die gesamte Seite speichert. Oberhalb der Felder zeigt die Seite Test mode is on: payments are created in the MakeCommerce test environment and no real money is charged., solange der Testmodus aktiv ist. Außerdem warnt die Seite, wenn die Methode aktiviert ist, die Shop ID oder der Secret key der aktuellen Umgebung jedoch leer ist, und wenn die Standardwährung des Shops von MakeCommerce nicht abgerechnet werden kann. In beiden Fällen wird die Methode in der Kasse ausgeblendet. Beim Speichern werden Leerzeichen aus den Schlüsseln entfernt.

MakeCommerce

Enable/Disable: Enable MakeCommerce payments schaltet die Zahlungsmethode ein oder aus. Standard: aus.

Title: der Name der Zahlungsmethode, den Kunden in der Kasse sehen. Er wird auch als Name der Zahlungsmethode in der Bestellung gespeichert. Standard: Bank link or card (MakeCommerce). Pflichtfeld.

Description: der Text, der in der Kasse unter der Zahlungsmethode 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-Konto

Die Shop ID und der Secret key finden Sie im MakeCommerce Merchant Portal unter Settings > API. Das Test-Portal und das Live-Portal haben getrennte Konten und Schlüssel. Der Abschnitt enthält Links zu beiden Portalen und zur Registrierungsseite von MakeCommerce.

Test mode: nutzt die Testumgebung von MakeCommerce (es wird kein echtes Geld abgebucht). Neue Zahlungen werden in der ausgewählten Umgebung mit deren Schlüsseln angelegt. Jede Bestellung merkt sich die Umgebung, in der sie bezahlt wurde: Statusprüfungen und Erstattungen gehen immer dorthin. Ist er aktiv, sehen Kunden unter der Zahlungsmethode TEST MODE — MakeCommerce test environment, no real money is charged. Standard: aktiv.

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 Live-Kontos.

Live Secret key: der Secret key Ihres Live-Kontos.

Gespeicherte geheime Schlüssel werden nie wieder angezeigt. Das Feld bleibt leer und zeigt Saved — leave empty to keep it. Geben Sie nur dann einen neuen Wert ein, wenn Sie ihn ändern möchten.

Clear saved secret keys: Setzen Sie ein Häkchen bei einem Schlüssel und klicken Sie auf Save, um ihn zu entfernen. Ein leeres Feld behält den gespeicherten Wert.

Zahlungsbenachrichtigungen

Im Merchant Portal muss nichts eingerichtet werden. Callback URLs zeigt zur Information die Adresse für die Rückkehr oder den Abbruch des Kunden und die Adresse für Zahlungsbenachrichtigungen an. Jede Transaktion enthält eigene Rückkehr-, Abbruch- und Benachrichtigungs-URLs, die aus diesen Adressen mit der Warenkorbnummer und einem angehängten Schlüssel gebildet werden. MakeCommerce sendet eine signierte Nachricht an die Benachrichtigungs-URL (Server zu Server) und über den 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 Modul verarbeitet diese MakeCommerce-Transaktionsstatus:

COMPLETED: die Zahlung wurde geleistet. Die Transaktion wird über die API erneut geprüft, und die Bestellung wird angelegt, wenn Betrag und Währung mit dem Warenkorb übereinstimmen.

APPROVED, PENDING: die Zahlung ist genehmigt oder wird von der Bank oder dem Kartennetzwerk verarbeitet. Noch wird keine Bestellung angelegt.

CANCELLED, EXPIRED, FAILED: der Kunde hat die Zahlung abgebrochen, sie ist abgelaufen oder fehlgeschlagen. Es wird keine Bestellung angelegt, der Warenkorb bleibt erhalten.

PART_REFUNDED, REFUNDED: die Transaktion wurde bei MakeCommerce erstattet. Es wird eine Notiz hinzugefügt; der Bestellstatus ändert sich nicht.

Die Zahlung wird auch bestätigt, wenn der Kunde in den Shop zurückkehrt. Kehrt der Kunde ohne signierte Nachricht zurück, fragt das Modul den Status bei der MakeCommerce-API ab.

Erweitert

Debug log: protokolliert API-Aufrufe und Zahlungsbenachrichtigungen in logs/wc_mkc_debug.log.php im Modulordner. Die Datei kann nicht über das Web geöffnet werden. Fehler werden immer protokolliert. Schlüssel und Kundendaten werden nie protokolliert. Standard: aus.

Log: zeigt die Größe und die neuesten Einträge des Protokolls. Klicken Sie auf Clear log, um es zu leeren.

Delete data: Wenn aktiviert, entfernt die Deinstallation des Moduls dessen Einstellungen und das Protokoll. Bestellungen und ihre MakeCommerce-Zahlungsdaten bleiben immer erhalten. Standard: aus.

Kasse

Im Zahlungsschritt wählt der Kunde die Zahlungsmethode (standardmäßig Bank link or card (MakeCommerce)) und bestätigt. Das Modul erstellt eine MakeCommerce-Transaktion über die Warenkorbsumme in der Warenkorbwährung und leitet den Kunden zur MakeCommerce-Zahlungsseite weiter. Dort wählt der Kunde einen Banklink oder eine Karte. Die E-Mail-Adresse und das Land des Kunden werden an MakeCommerce übergeben, und die Seite öffnet sich in der Shop-Sprache, sofern MakeCommerce diese unterstützt (Estnisch, Englisch, Lettisch, Litauisch, Finnisch, Russisch, Deutsch, Polnisch), andernfalls auf Englisch. Zu diesem Zeitpunkt existiert noch keine Bestellung.

Nach der Zahlung kehrt der Kunde in Ihren Shop zurück. Die Bestellung wird erst als bezahlt markiert, wenn MakeCommerce die Zahlung bestätigt hat: durch die signierte Benachrichtigung oder durch die signierte Rückkehr des Kunden, mit einer Prüfung der Transaktion über die MakeCommerce-API. Danach wird die Bestellung angelegt, und der Kunde sieht die übliche Bestellbestätigungsseite mit Your MakeCommerce payment has been received. Wurde die Bestellung zur Prüfung in die Warteschleife gesetzt, zeigt die Seite Your MakeCommerce payment was received and is being reviewed by the shop.

Ist die Zahlung genehmigt, aber noch nicht abgeschlossen, oder ist MakeCommerce nicht erreichbar, zeigt eine Seite Payment confirmation den Hinweis We could not confirm your payment yet. If you completed it, your order will be updated automatically — please do not pay again. mit den Schaltflächen Check again und Back to checkout. Die Benachrichtigung legt die Bestellung an, sobald die Zahlung abgeschlossen ist.

Bricht der Kunde auf der MakeCommerce-Seite ab oder läuft die Zahlung ab oder schlägt sie fehl, kehrt er mit einer Meldung in die Kasse zurück, zum Beispiel The payment was cancelled. You can try again or choose another payment method., The payment session expired. Please try again. oder The payment was not completed. Please try again or choose another payment method. Der Warenkorb bleibt erhalten, und der Kunde kann erneut zahlen. Jeder Versuch ist eine neue MakeCommerce-Transaktion. Ein älterer Zahlungslink desselben Warenkorbs funktioniert weiterhin, und der Warenkorb kann nicht zweimal in zwei Bestellungen bezahlt werden.

Kann MakeCommerce die Zahlung nicht starten, bleibt der Kunde in der Kasse mit 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 ins Protokoll geschrieben.

Die Bank oder Karte wird auf der MakeCommerce-Seite gewählt, nicht in Ihrer Kasse. Das Modul unterstützt keine gespeicherten Karten, wiederkehrenden Zahlungen oder Abonnements und keinen MakeCommerce-Versand (Paketautomaten, Versandetiketten).

Bestellungen und Erstattungen

Bestellstatus

No order yet: Der Kunde wurde zu MakeCommerce weitergeleitet und hat noch nicht bezahlt, oder MakeCommerce hat die Zahlung noch nicht bestätigt. Es existiert nur der Warenkorb.

Payment accepted: Die Zahlung wurde bestätigt. Sie wird mit der MakeCommerce-Transaktions-ID erfasst, und eine Notiz zeigt den Betrag, die Transaktion, die Umgebung und die Art der Prüfung (MakeCommerce-API oder signierte Benachrichtigung).

MakeCommerce payment on hold: Der gezahlte Betrag oder die Währung wich vom Warenkorb ab (etwa wenn der Warenkorb nach Beginn der Zahlung geändert wurde), der Betrag fehlte, die Transaktion bei MakeCommerce war noch nicht endgültig, obwohl sie als abgeschlossen gemeldet wurde, oder die Zahlung ist eingegangen, nachdem die Bestellung storniert worden war. Die Notiz erklärt es. Ist die gezahlte Währung die Bestellwährung, wird der tatsächlich gezahlte Betrag in der Bestellung erfasst. Eine Transaktion mit Abweichung bezahlt die Bestellung nie nachträglich; eine Transaktion, die noch nicht endgültig war, schließt die Bestellung ab, sobald MakeCommerce sie als abgeschlossen meldet. Prüfen Sie die Transaktion im Merchant Portal und bearbeiten Sie die Bestellung oder erstatten Sie die Zahlung.

Refunded: Die Zahlung wurde über das Modul vollständig erstattet.

Geht eine zweite Zahlung für eine bereits bezahlte Bestellung ein, bleibt die Bestellung unverändert. Eine Notiz fordert Sie auf, das Duplikat im MakeCommerce Merchant Portal zu erstatten.

MakeCommerce-Zahlungsblock

Die Bestellseite zeigt einen Block MakeCommerce payment mit allen MakeCommerce-Transaktionen des Warenkorbs (Datum, Transaktions-ID, ein Abzeichen Test für Testzahlungen, Betrag, MakeCommerce-Status und -Ergebnis), den bezahlten und den erstatteten Betrag, den Erstattungsverlauf und die MakeCommerce notes der Bestellung. Die Schaltflächen des Blocks benötigen nur das Recht, Bestellungen zu bearbeiten, nicht den Zugriff auf die Module.

Check MakeCommerce payment status: fragt den Status der Transaktionen des Warenkorbs bei der MakeCommerce-API ab (die neuesten zuerst), übernimmt ihn und fügt eine Notiz mit dem Ergebnis hinzu. Verwenden Sie sie, wenn ein Kunde sagt, dass er bezahlt hat, die Bestellung aber nicht abgeschlossen wurde.

Erstattungen

Geben Sie im Block MakeCommerce payment den Betrag ein (der noch nicht erstattete Betrag wird vorausgefüllt), optional einen Grund, und klicken Sie auf Refund via MakeCommerce. Bestätigen Sie die Frage Refund this amount via MakeCommerce? Vollständige und teilweise Erstattungen werden unterstützt. Erstattungen sind auf Betrag und Währung der MakeCommerce-Transaktion begrenzt. Nach einer Betragsabweichung können Sie daher bis zu dem Betrag erstatten, den der Kunde tatsächlich bezahlt hat, nicht die Bestellsumme. Die Erstattung wird an die Umgebung gesendet, in der die Zahlung erfolgt ist (Test oder Live), daher müssen deren Schlüssel eingerichtet sein. Der Grund wird als Kommentar an MakeCommerce übermittelt; ohne Grund lautet der Kommentar Refund for order und die Bestellreferenz. Lehnt MakeCommerce die Erstattung ab, zeigt der Block den Fehler, es wird eine Notiz hinzugefügt und keine Erstattung erfasst. Verarbeitet MakeCommerce die Zahlung noch, lautet die Meldung MakeCommerce is still processing this payment — try the refund again later. Eine erfolgreiche Erstattung wird mit der MakeCommerce-Erstattungs-ID im Erstattungsverlauf und in den Notizen erfasst. Eine vollständige Erstattung setzt die Bestellung auf Refunded. Eine teilweise Erstattung ändert den Status nicht. Erstattungen sind verfügbar, sobald MakeCommerce die Zahlung bestätigt hat.

Das Modul erstellt keine Gutschriften. Die Standard-Erstattungsschaltflächen von PrestaShop auf der Bestellseite senden kein Geld über MakeCommerce zurück.

Erstattungen, die im Merchant Portal vorgenommen werden, kommen mit dem Transaktionsstatus an und werden in den Notizen erfasst. Bestellstatus und Gutschriften werden nicht automatisch geändert.

Lizenzschlüssel

Das Modul arbeitet mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock License — VibeFox MakeCommerce Payment ist der erste Block auf Modules > Module Manager > VibeFox MakeCommerce Payment > Configure, oberhalb der Einstellungen. Fügen Sie den Schlüssel in License key ein und klicken Sie auf Activate. Danach zeigt der Block den Schlüssel maskiert, den Status (zum Beispiel das Datum, bis zu dem die Lizenz gültig ist, und Ihre Domain) sowie die Schaltflächen Check now, um den Status erneut zu prüfen, Change key, um einen anderen Schlüssel einzugeben, und Remove key, um den Schlüssel aus diesem Shop zu entfernen. Darunter stehen die Zeile Product: presta-payment-makecommerce und der Link Manage licenses and domains in your account, der Ihr vibefox.net-Konto öffnet. Nur Mitarbeiter mit der Berechtigung Configure für das Modul können den Schlüssel ändern. Die Texte des Blocks folgen der Sprache des Back Office (Englisch und Russisch sind enthalten).

Wird der Schlüssel nicht akzeptiert, nennt der Block den Grund, zum Beispiel Key not found, This key belongs to another product, Domain limit reached oder License expired on mit einem Datum. Nachdem sich die Shop-Adresse geändert hat oder nachdem Sie einen Domain-Platz in Ihrem Konto freigegeben haben, klicken Sie auf Check now. Ist der Lizenzserver nicht erreichbar, arbeitet das Modul mit dem zuletzt bekannten Status weiter.

Ein Schlüssel funktioniert auf einer Domain: der Domain des Hauptshops, auch bei einer Multistore-Konfiguration. Wenn Sie den Schlüssel aus dem Shop entfernen, wird sein Domain-Platz nicht frei. Geben Sie den Platz in Ihrem vibefox.net-Konto frei.

Ohne aktiven Schlüssel wird MakeCommerce Kunden in der Kasse nicht angezeigt. Versucht ein Kunde trotzdem zu bezahlen, sieht er This payment method is not available. Please choose another one. Die Storefront von PrestaShop weiß nicht, dass Sie im Back Office angemeldet sind; daher wird die Zahlungsmethode auch für Sie ausgeblendet: Sie können das Modul vor dem Kauf eines Schlüssels einrichten, aber nicht an der Kasse testen. Eine Erinnerung erscheint in Modules > Module Manager auf der Registerkarte Alerts. Bestehende Bestellungen sind nicht betroffen: Bereits begonnene Zahlungen werden weiterhin bestätigt, und Erstattungen funktionieren.

Läuft eine Lizenz ab, arbeitet das Modul weiter, Updates und Support benötigen jedoch eine Verlängerung. Der Status wird automatisch erneut geprüft, während Sie im Back Office arbeiten: einmal täglich in den ersten 14 Tagen nach Eingabe des Schlüssels, danach einmal wöchentlich. Ein Cron-Job ist nicht erforderlich. Das Deinstallieren oder Zurücksetzen des Moduls entfernt immer den Lizenzschlüssel und den Lizenzstatus.

Fehlerbehebung

MakeCommerce erscheint nicht in der Kasse: Prüfen Sie, ob die Lizenz aktiv ist, Enable/Disable eingeschaltet ist und die aktuelle Umgebung ihre Schlüssel hat: Test Shop ID und Test Secret key im Testmodus, Live Shop ID und Live Secret key im Live-Modus. Prüfen Sie, dass die Warenkorbwährung höchstens zwei Dezimalstellen hat. Prüfen Sie unter Payment > Preferences, ob das Modul für die Warenkorbwährung, das Land des Kunden und die Kundengruppe zugelassen ist.

Die Zahlung war erfolgreich, aber es wurde keine Bestellung angelegt: Die Benachrichtigungen konnten den Shop nicht erreichen, zum Beispiel wegen einer Firewall oder Basisauthentifizierung. Die Bestellung wird auch angelegt, wenn der Kunde in den Shop zurückkehrt oder auf Check again klickt. Prüfen Sie, dass die Schlüssel der Umgebung eingerichtet sind, in der die Zahlung erfolgt ist: Die Benachrichtigung wird mit dem Secret key dieser Umgebung geprüft, und ohne ihn erhält MakeCommerce einen Fehler und versucht es erneut. Aktivieren Sie das Debug log, um die Benachrichtigungen einzusehen.

Die Bestellung ist MakeCommerce payment on hold: Lesen Sie die MakeCommerce notes im Block auf der Bestellseite (siehe Bestellstatus), prüfen Sie die Transaktion im Merchant Portal und bearbeiten Sie dann die Bestellung oder erstatten Sie die Zahlung.

Benachrichtigungen werden abgelehnt: Eine Nachricht mit falscher Signatur, für einen anderen Warenkorb, einen anderen Shop oder eine nicht für den Warenkorb erstellte Transaktion wird abgelehnt, und nichts wird geändert. Prüfen Sie, dass Shop ID und Secret key zum selben MakeCommerce-Konto und zur selben Umgebung gehören.

Der Kunde sieht bei der Auswahl von MakeCommerce einen Fehler: Aktivieren Sie das Debug log und sehen Sie im Feld Log auf der Modulseite nach. Eine Währung, die MakeCommerce nicht abrechnen kann, führt zu MakeCommerce cannot process payments in und dem Währungscode.

Erstattung schlägt mit einer Meldung zur Umgebung fehl: Die Bestellung wurde in der Test- oder Live-Umgebung bezahlt, und die Schlüssel dieser Umgebung sind nicht eingerichtet. Geben Sie sie ein und versuchen Sie es erneut.

Erstattung schlägt mit No MakeCommerce transaction ID found for this order fehl: Die Bestellung hat keine bestätigte MakeCommerce-Zahlung. Erstatten Sie sie im Merchant Portal.

Deinstallation

Gehen Sie zu Modules > Module Manager, öffnen Sie das Menü neben VibeFox MakeCommerce Payment und wählen Sie Uninstall. Der Lizenzschlüssel und der Lizenzstatus dieses Moduls werden immer entfernt. Ist Delete data aktiviert, werden die Moduleinstellungen und das Protokoll entfernt. Ist es deaktiviert, bleiben alle Einstellungen für eine spätere Neuinstallation erhalten. Die MakeCommerce-Transaktionen und -Erstattungen sowie der Bestellstatus MakeCommerce payment on hold bleiben immer erhalten, sodass früher bezahlte Bestellungen auch nach einer Neuinstallation erstattet werden können. Bestehende Bestellungen behalten ihre Zahlungsnotizen und Transaktions-IDs.

MakeCommerce ist eine Marke ihres jeweiligen Inhabers. Dieses Modul ist nicht mit MakeCommerce verbunden und wird nicht von MakeCommerce unterstützt.