VibeFox MultiSafepay 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.

Währung: Die Warenkorbwä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 in der Kasse nicht angezeigt.

MultiSafepay-Konto: Sie benötigen den API-Schlüssel Ihrer Website in MultiSafepay Control. Test- und Live-Konten haben unterschiedliche Schlüssel. Sonst muss in MultiSafepay nichts eingerichtet werden: Die Benachrichtigungsadresse wird mit jeder Zahlung übermittelt.

Öffentlich erreichbare Website: MultiSafepay muss Ihren Shop erreichen können, um Benachrichtigungen zu senden. Andernfalls werden Bestellungen trotzdem angelegt, wenn der Kunde von MultiSafepay zurückkehrt.

VibeFox-Lizenzschlüssel: erhältlich auf vibefox.net. Ein Schlüssel gilt für eine 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 aus.

2. Klicken Sie nach dem Hochladen auf Configure, oder suchen Sie später VibeFox MultiSafepay Gateway in der Modulliste und klicken Sie auf Configure.

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

4. Fügen Sie den Test- und/oder Live-API-Schlüssel aus MultiSafepay Control ein (siehe Konfiguration).

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

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

Konfiguration

Alle Einstellungen befinden sich auf der Modulseite: Modules > Module Manager > VibeFox MultiSafepay Gateway > Configure. Jeder Abschnitt hat seine eigene Schaltfläche Save, die die gesamte Seite speichert. Oberhalb der Felder zeigt die Seite Test mode: new payments use the MultiSafepay test environment (no real payments)., solange der Testmodus aktiv ist. Sie warnt, wenn für den aktuellen Modus kein API-Schlüssel hinterlegt ist (die Zahlungsart wird dann in der Kasse nicht angezeigt), und wenn MultiSafepay die Standardwährung Ihres Shops nicht akzeptiert. Ohne Title lässt sich die Seite nicht speichern.

Kasse

Enable/Disable: Enable MultiSafepay schaltet die Zahlungsart ein oder aus. Standard: aus.

Title: der Name der Zahlungsart, den der Kunde in der Kasse sieht. Er wird auch als Zahlungsart in der Bestellung gespeichert. Standard: MultiSafepay. Pflichtfeld.

Description: der Text, der in der Kasse unter der Zahlungsart angezeigt wird. 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. Der Abschnitt verlinkt auf das Testkonto (testmerchant.multisafepay.com) und das Live-Konto (merchant.multisafepay.com). Sie 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). Umgeschaltet werden sowohl die API-Adresse als auch der 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. Solange er aktiv ist, sehen Kunden Test mode: no real payment will be made. unter der Zahlungsart.

Test API key: der API-Schlüssel Ihres MultiSafepay-Testkontos.

Live API key: der API-Schlüssel Ihres MultiSafepay-Live-Kontos.

Gespeicherte 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 keys: Markieren Sie einen Schlüssel und klicken Sie auf Save, um ihn zu entfernen. Ein leeres Feld behält den gespeicherten Wert.

Benachrichtigungen

Es ist nichts zu konfigurieren. Das Feld Notification URL zeigt die Adresse, die bei jeder Zahlung an MultiSafepay übermittelt wird. Mit sprechenden URLs sieht sie so aus: https://your-shop/module/wcp_multisafepay_gateway/webhook, möglicherweise mit einem Sprachcode wie /en/. Eine Benachrichtigung teilt dem Modul nur mit, welche Zahlung sich geändert hat: Status, Betrag und Währung werden immer über die MultiSafepay-API mit Ihrem API-Schlüssel abgefragt, bevor eine Bestellung angelegt oder geändert wird. Benachrichtigungen zu Zahlungen, die nicht in Ihrem Shop gestartet wurden, werden ignoriert. Die Benachrichtigung funktioniert auch, während der Shop im Wartungsmodus ist, und wird nicht durch die Länderbeschränkung Ihres Shops blockiert.

Bestellungen

Order status after payment: der Status einer bezahlten Bestellung. Der Status wird auf einmal gesetzt, mit einer Statusänderung und einer E-Mail an den Kunden.

Erweitert

Debug log: Log API calls and notifications schreibt in logs/mspg_debug.log.php im Modulordner. Die Datei lässt sich nicht über den Webbrowser öffnen. Fehler und Warnungen werden immer protokolliert. API-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 on uninstall: Ist die Option aktiv, entfernt die Deinstallation des Moduls die Einstellungen und das Protokoll. Die MultiSafepay-Zahlungsdaten der Bestellungen und der Bestellstatus bleiben immer erhalten, sodass Erstattungen alter Bestellungen möglich bleiben. Das Deaktivieren des Moduls löscht nie etwas. Standard: aus.

Kasse

Im Zahlungsschritt wählt der Kunde die Zahlungsart (standardmäßig MultiSafepay, mit dem MultiSafepay-Logo) und bestätigt. Das Modul erstellt eine MultiSafepay-Zahlung über den Warenkorbbetrag in der Warenkorbwährung und leitet den Kunden zur MultiSafepay-Zahlungsseite weiter. Dort wählt der Kunde eine beliebige in Ihrem MultiSafepay-Konto aktivierte Zahlungsart und zahlt. Rechnungsadresse, E-Mail, Telefonnummer und Sprache des Kunden werden an MultiSafepay übergeben; die Zahlung erscheint als Order #, mit der Warenkorbnummer und dem Namen Ihres Shops. 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, nachdem MultiSafepay die Zahlung bestätigt hat: durch die Benachrichtigung oder durch eine Prüfung über die MultiSafepay-API, wenn der Kunde zurückkehrt. Danach wird die Bestellung angelegt, und der Kunde sieht die übliche Bestellbestätigungsseite mit Your payment with MultiSafepay has been received. Bei einer Bestellung auf Halten zeigt die Seite We are confirming your payment with MultiSafepay. The order will be updated automatically — please do not pay again. Schlägt die Zahlung später fehl, zeigt die Seite Your MultiSafepay payment was not completed. Please contact us about this order. Hat MultiSafepay die Zahlung bei der Rückkehr des Kunden noch nicht bestätigt (etwa wenn eine Banküberweisung erwartet wird), zeigt eine Seite Payment confirmation denselben Hinweis zur Bestätigung und eine Schaltfläche Check again. Die Benachrichtigung legt die Bestellung an, sobald MultiSafepay die Zahlung meldet.

Bricht der Kunde auf der MultiSafepay-Seite ab, wird die Zahlung abgelehnt oder läuft sie ab, kehrt der Kunde zur Kasse zurück. Der Warenkorb bleibt erhalten, und es erscheint eine dieser Meldungen: 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.

Bevor für denselben Warenkorb eine neue Zahlung angelegt wird, prüft das Modul die vorherige bei MultiSafepay. Ist sie bereits bezahlt oder wird sie gerade verarbeitet, wird die Bestellung angelegt, statt einer neuen Zahlung. Ist sie noch offen und der Betrag gleich, wird dieselbe Zahlungsseite wiederverwendet. Hat sich der Betrag geändert, wird die alte Zahlung bei MultiSafepay storniert, damit sie nicht mehr bezahlt werden kann.

Kann MultiSafepay die Zahlung nicht starten, bleibt der Kunde in der Kasse mit einer kurzen 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. Der technische Grund wird im Protokoll festgehalten.

Das Modul bietet eine Zahlungsart, die zur MultiSafepay-Seite führt. Es gibt keine eigenen PrestaShop-Zahlungsarten für jede MultiSafepay-Zahlungsmethode, keine eingebetteten Kartenfelder, keine Express-Schaltflächen für Apple Pay oder Google Pay, keine Abonnements, wiederkehrenden Zahlungen oder gespeicherten Karten, und keine Erfassung oder Stornierung über PrestaShop. Es werden keine Warenkorbdaten übermittelt. Daher bietet MultiSafepay für diese Bestellungen keine Zahlungsarten mit nachträglicher Zahlung an, die diese benötigen (zum Beispiel Klarna, in3 oder Riverty).

Bestellungen und Erstattungen

Bestellstatus

Noch keine Bestellung: Der Kunde wurde zu MultiSafepay weitergeleitet und hat nicht bezahlt, oder MultiSafepay hat die Zahlung noch nicht bestätigt. Es existiert nur der Warenkorb.

Payment accepted oder Delivered: MultiSafepay hat die Zahlung bestätigt (abgeschlossen oder versandt). Der Status folgt Order status after payment. Die Zahlung wird mit der MultiSafepay-Bestell-ID als Transaktions-ID erfasst, und eine Notiz zeigt die Zahlung, die Zahlungsart und die Umgebung.

MultiSafepay payment 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 wechselt automatisch in den bezahlten Status, sobald MultiSafepay die Zahlung als abgeschlossen meldet.

MultiSafepay payment on hold after payment: MultiSafepay hat einen anderen Betrag oder eine andere Währung bestätigt als den Warenkorbbetrag (zum Beispiel wurde der Warenkorb geändert, nachdem die Zahlung begonnen hatte), eine Testzahlung wurde abgeschlossen, während das Modul im Live-Modus lief (kein echtes Geld eingegangen, keine Zahlung erfasst), oder die Zahlung wurde abgeschlossen, nachdem die Bestellung storniert worden war. Die Notiz erklärt es. Prüfen Sie die Transaktion in MultiSafepay Control und bearbeiten oder erstatten Sie die Bestellung.

MultiSafepay payment on hold after a chargeback: MultiSafepay hat eine Rückbuchung für eine bezahlte Bestellung gemeldet: Das Geld wurde von Ihrem Konto zurückgebucht.

Payment error: Eine nicht abgeschlossene oder reservierte Zahlung wurde später abgelehnt, storniert, ist abgelaufen oder wurde annulliert.

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

Eine bezahlte oder erstattete Bestellung wird durch eine verspätete Benachrichtigung nie wieder geöffnet. Wird für einen bereits bezahlten Warenkorb eine zweite Zahlung abgeschlossen, bleibt die Bestellung unverändert. Eine Notiz fordert Sie auf, das Duplikat in MultiSafepay Control zu erstatten.

MultiSafepay-Zahlungsblock

Die Bestellseite zeigt einen Block MultiSafepay payment mit der MultiSafepay-Bestell-ID, der Zahlungsart, dem Status, dem bezahlten und erstatteten Betrag, einem Kennzeichen Test mode für Testzahlungen, dem Erstattungsverlauf und den MultiSafepay notes der Bestellung.

Erstattungen

Geben Sie im Block MultiSafepay payment den Betrag ein (der noch nicht erstattete Betrag ist vorausgefüllt), optional einen Grund, und klicken Sie auf Refund via MultiSafepay. Bestätigen Sie die Abfrage Refund this amount through MultiSafepay? This cannot be undone. Volle und teilweise Erstattungen sind möglich. Sie benötigen das Recht, Bestellungen zu bearbeiten; Zugriff auf die Modulseiten ist nicht erforderlich. Erstattungen erfolgen in dem Betrag und der Währung, die MultiSafepay belastet hat. Nach einer Betragsabweichung können Sie daher bis zu dem Betrag erstatten, den der Kunde tatsächlich bezahlt hat, nicht den Bestellbetrag. 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. Lehnt MultiSafepay die Erstattung ab, zeigt der Block MultiSafepay refund failed: mit der Fehlermeldung von MultiSafepay, und es wird keine Erstattung erfasst. Eine erfolgreiche Erstattung wird dem Erstattungsverlauf und den Notizen mit der MultiSafepay-Erstattungs-ID hinzugefügt. Eine volle Erstattung setzt die Bestellung auf Refunded. Eine teilweise Erstattung ändert den Status nicht. Erstattungen sind verfügbar, sobald MultiSafepay die Zahlung gemeldet hat.

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

In MultiSafepay Control vorgenommene Erstattungen werden den Notizen hinzugefügt, sobald MultiSafepay sie meldet. Bestellstatus und Gutschriften werden nicht automatisch geändert. Aktualisieren Sie sie bei Bedarf manuell.

Lizenzschlüssel

Das Modul funktioniert mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock License — VibeFox MultiSafepay Gateway ist der erste Block auf Modules > Module Manager > VibeFox MultiSafepay Gateway > Configure, oberhalb der Einstellungen. Fügen Sie den Schlüssel in das Feld 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-multisafepay und der Link Manage licenses and domains in your account, der Ihr vibefox.net-Konto öffnet. Den Schlüssel können nur Mitarbeiter mit der Berechtigung Configure für das Modul ändern. Die Texte des Blocks folgen der Sprache des Back-Office (Englisch und Russisch sind enthalten).

Wird der Schlüssel nicht akzeptiert, zeigt der Block den Grund an, 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 in Ihrem Konto einen Domainplatz freigegeben haben, klicken Sie auf Check now. Ist der Lizenzserver nicht erreichbar, arbeitet das Modul mit dem zuletzt bekannten Status weiter.

Ein Schlüssel gilt für eine Domain: die Domain des Hauptshops, auch bei einem Multistore-Setup. Das Entfernen des Schlüssels aus dem Shop gibt seinen Domainplatz nicht frei. Geben Sie den Platz in Ihrem vibefox.net-Konto frei.

Ohne aktiven Schlüssel wird MultiSafepay Kunden in der Kasse nicht angezeigt. Wird trotzdem eine Zahlung gestartet, sieht der Kunde This payment method is not available. Please choose another one. Der Storefront von PrestaShop erkennt nicht, dass Sie im Back-Office angemeldet sind, daher ist die Zahlungsart auch für Sie ausgeblendet: Sie können das Modul einrichten, bevor Sie einen Schlüssel kaufen, aber nicht in der Kasse testen. Eine Erinnerung erscheint unter Modules > Module Manager auf dem Tab Alerts. Bestehende Bestellungen sind nicht betroffen: Bereits gestartete Zahlungen werden weiterhin bestätigt, und Erstattungen funktionieren.

Läuft eine Lizenz ab, arbeitet das Modul weiter, aber Updates und Support erfordern 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 der Eingabe des Schlüssels, danach einmal pro Woche. Ein Cron-Job ist nicht erforderlich. Die Deinstallation oder das Zurücksetzen des Moduls entfernt immer den Lizenzschlüssel und den Lizenzstatus.

Fehlerbehebung

MultiSafepay erscheint nicht in der Kasse: Prüfen Sie, ob die Lizenz aktiv ist, Enable/Disable eingeschaltet ist, für den aktuellen Modus ein API-Schlüssel hinterlegt ist (Test API key im Testmodus, Live API key im Live-Modus) und MultiSafepay die Warenkorbwährung akzeptiert. Die Einstellungsseite zeigt eine Warnung, wenn der Schlüssel fehlt oder die Shop-Währung nicht akzeptiert wird. 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 Benachrichtigung hat Ihren Shop nicht erreicht. Prüfen Sie, ob der Shop aus dem Internet erreichbar ist und ob der API-Schlüssel der Umgebung der Zahlung hinterlegt ist, denn das Modul liest den Status über die MultiSafepay-API. Ist die API nicht erreichbar oder fehlt der Schlüssel, antwortet die Benachrichtigung mit ERROR, und MultiSafepay wiederholt sie. Die Bestellung wird auch angelegt, wenn der Kunde in den Shop zurückkehrt und wenn er versucht, denselben Warenkorb erneut zu bezahlen.

Die Benachrichtigung antwortet Invalid request: Die Anfrage hatte keine gültige Transaktions-ID. Benachrichtigungen von MultiSafepay enthalten immer eine.

Der Kunde sieht bei der Auswahl von MultiSafepay einen Fehler: Aktivieren Sie Debug log und sehen Sie sich das Feld Log auf der Modulseite an. 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.

Bestellung ist MultiSafepay payment on hold: Lesen Sie die Notizen im Block MultiSafepay payment. Die Zahlung ist möglicherweise nicht abgeschlossen oder reserviert, der bezahlte Betrag oder die Währung wich vom Warenkorb ab, eine Testzahlung kam im Live-Modus an, die Zahlung kam nach der Stornierung der Bestellung, oder es gab eine Rückbuchung. Prüfen Sie die Transaktion in MultiSafepay Control.

Testzahlungen bestätigen keine Live-Bestellung: Eine Testzahlung bezahlt nie eine Bestellung, während das Modul im Live-Modus läuft; die Bestellung wird stattdessen 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. Tragen Sie ihn ein und versuchen Sie es erneut.

Deinstallation

Gehen Sie zu Modules > Module Manager, öffnen Sie das Menü neben VibeFox MultiSafepay Gateway und wählen Sie Uninstall. Der Lizenzschlüssel und der Lizenzstatus dieses Moduls werden immer entfernt. Ist Delete data on uninstall aktiv, werden die Einstellungen und das Protokoll entfernt. Ist die Option aus, bleiben alle Einstellungen für eine spätere Neuinstallation erhalten. Die MultiSafepay-Zahlungsdaten der Bestellungen und der Bestellstatus MultiSafepay 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.

MultiSafepay ist eine Marke ihres jeweiligen Inhabers. Dieses Modul ist weder mit MultiSafepay verbunden, noch wird es von MultiSafepay empfohlen.