VibeFox ifthenpay 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: nur Euro (EUR). Die Zahlungsmethode wird ausgeblendet, wenn die Warenkorbwährung nicht EUR ist. ifthenpay akzeptiert Beträge von 0,01 bis 99.999,99 EUR.
ifthenpay-Konto: Registrieren Sie sich bei ifthenpay.com. Sie benötigen den Schlüssel der Methode, die Sie anbieten: Multibanco, MB WAY oder Credit Card (Format ABC-123456). Die Schlüssel werden im ifthenpay-Backoffice (backoffice.ifthenpay.com) angezeigt oder von ifthenpay gesendet, wenn die Methode für Ihr Konto aktiviert wird. ifthenpay muss außerdem den Callback für Ihren Schlüssel aktivieren (siehe Konfiguration), und Ihr Shop muss aus dem Internet erreichbar sein.
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 aus.
2. Wenn der Upload abgeschlossen ist, klicken Sie auf Configure, oder suchen Sie VibeFox ifthenpay Gateway später in der Modulliste und klicken Sie auf Configure. Das Modul erzeugt bei der Installation seinen Anti-Phishing-Schlüssel.
3. Geben Sie Ihren VibeFox-Lizenzschlüssel im Feld License key im Lizenzblock oben auf der Seite Configure ein und klicken Sie auf Activate (siehe Lizenzschlüssel).
4. Wählen Sie die Payment Method, geben Sie den ifthenpay-Schlüssel dafür ein und klicken Sie auf Save, damit die Callback URL zur gewählten Methode passt.
5. Kopieren Sie den Anti-phishing Key und die Callback URL aus den Einstellungen und bitten Sie ifthenpay, den Callback für Ihren Schlüssel zu aktivieren (im Backoffice oder über den ifthenpay-Support).
6. Aktivieren Sie Enable/Disable und klicken Sie auf Save.
Bei der Installation legt das Modul zwei Bestellstatus an: Awaiting ifthenpay payment und ifthenpay payment on hold. PrestaShop aktiviert ein neues Zahlungsmodul für alle Währungen, Länder und Kundengruppen. Sie können dies unter Payment > Preferences einschränken; EUR muss erlaubt bleiben.
Konfiguration
Alle Einstellungen befinden sich auf der Modulseite: Modules > Module Manager > VibeFox ifthenpay Gateway > Configure. Jeder Abschnitt mit einer Schaltfläche Save speichert die gesamte Seite. Ohne den Schlüssel der gewählten Methode wird die Zahlungsmethode an der Kasse nicht angezeigt. Ist das Gateway ohne diesen Schlüssel aktiviert, zeigt die Seite ifthenpay: enter the key of the selected payment method, otherwise the method is not shown at checkout. an.
ifthenpay
Enable/Disable: Enable ifthenpay Payment schaltet die Zahlungsmethode ein oder aus. Standard: off.
Title: der Titel der Zahlungsmethode, der an der Kasse angezeigt wird. Er ist zugleich der Name der Zahlungsmethode, der in der Bestellung gespeichert wird. Standard: ifthenpay.
Description: die Beschreibung der Zahlungsmethode, die an der Kasse angezeigt wird. Standard: Pay via Multibanco, MB WAY or Credit Card. Passen Sie sie an die von Ihnen angebotene Methode an.
Payment Method: die Methode, die an der Kasse angeboten wird. Erforderlich ist nur der Schlüssel dieser Methode.
ifthenpay-Schlüssel
Die Schlüssel (Format ABC-123456) werden im ifthenpay-Backoffice angezeigt oder von ifthenpay gesendet, wenn die Zahlungsmethode für Ihr Konto aktiviert wird.
Multibanco Key: Ihr ifthenpay-Schlüssel für Multibanco (MB) für dynamische Referenzen.
MB WAY Key: Ihr ifthenpay-Schlüssel für MB WAY.
Credit Card Key: Ihr ifthenpay-Schlüssel für Kreditkarten. Er prüft außerdem die Signatur der Rückleitung des Kunden von der Kartenseite.
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 bei.
Callback (Zahlungsbenachrichtigungen)
Der Callback teilt Ihrem Shop mit, dass eine Zahlung erfolgt ist. Bitten Sie ifthenpay, den Callback für jeden verwendeten Schlüssel zu aktivieren, mit dem Anti-Phishing-Schlüssel und der unten angegebenen Callback-URL. Multibanco- und MB-WAY-Bestellungen werden nur durch den Callback bestätigt; Kartenzahlungen werden zusätzlich durch die signierte Rückleitung von der Kartenseite bestätigt.
Anti-phishing Key: wird vom Modul erzeugt und zum Kopieren angezeigt. ifthenpay sendet ihn bei jedem Callback zurück; Callbacks ohne ihn werden abgelehnt.
Callback URL: die Callback-URL für die gewählte Zahlungsmethode mit den Platzhaltern von ifthenpay, zum Kopieren angezeigt. Bei aktivierten URLs mit lesbaren Pfaden beginnt sie etwa so: https://your-shop/module/wcp_ifthenpay_gateway/callback, eventuell mit einem Sprachcode wie /en/, und enthält anschließend die Parameter der Methode. Kopieren Sie die gesamte URL genau so, wie die Einstellungen sie anzeigen.
Der Anti-Phishing-Schlüssel jedes Callbacks wird mit Ihrem verglichen. Ein fehlender oder falscher Schlüssel wird mit 403 beantwortet, und die Bestellung wird nicht geändert. Der Callback muss außerdem zu einer Zahlung dieses Moduls passen: bei Multibanco über Entität und Referenz, bei MB WAY über den Warenkorb und eine seiner MB-WAY-Anfragen, bei Kreditkarte über den Warenkorb und eine seiner Kartenanfragen. Ohne funktionierenden Callback werden Multibanco- und MB-WAY-Bestellungen nie bestätigt, und Kartenzahlungen werden nur durch die signierte Rückleitung bestätigt. Der Callback funktioniert, während der Shop im Wartungsmodus ist, und wird nicht durch die Ländereinschränkung Ihres Shops blockiert.
Erweitert
Test Mode: Kreditkarte und Multibanco nutzen die Sandbox-Endpunkte von ifthenpay; es wird kein echtes Geld abgebucht, und Sie verwenden die von ifthenpay bereitgestellten Testschlüssel. MB WAY hat keine Sandbox: Testen Sie es mit einem Testschlüssel von ifthenpay. An der Kasse wird ein Abzeichen TEST MODE angezeigt. Standard: off.
Order Status After Payment: der Bestellstatus, der nach einer bestätigten Zahlung gesetzt wird, mit einer einzigen Statusänderung.
Debug Log: API-Anfragen und Callbacks werden in logs/ifthenpay_p_debug.log.php im Modulordner geschrieben. Die Datei kann nicht über das Web geöffnet werden. Fehler werden immer protokolliert. Schlüssel, der Anti-Phishing-Schlüssel und vollständige Telefonnummern werden nie protokolliert. Standard: off.
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: Wenn aktiviert, werden beim Deinstallieren des Moduls die Moduleinstellungen, der Anti-Phishing-Schlüssel und das Protokoll entfernt. Bestellungen und die Zahlungsdaten von ifthenpay bleiben immer erhalten. Standard: off.
Kasse
Multibanco. An der Kasse sieht der Kunde You will receive a Multibanco reference to complete the payment. Wenn der Kunde bestätigt, erstellt das Modul eine dynamische Multibanco-Referenz für den Warenkorbbetrag, und die Bestellung wird mit Awaiting ifthenpay payment angelegt. Die Bestellbestätigungsseite zeigt Multibanco Payment Details: Entität, Referenz und Betrag, mit Please use these details to pay at any Multibanco ATM or through your online banking. Dieselben Angaben werden in die Bestellbestätigungs-E-Mail aufgenommen. Die Bestellung wird bezahlt, wenn ifthenpay den Zahlungs-Callback sendet.
MB WAY. Der Kunde gibt die MB WAY phone number ein (912 345 678, +351 912 345 678 oder 351#912345678 für andere Länder); die Telefonnummer der Rechnungsadresse wird vorausgefüllt. Das Modul sendet eine Zahlungsanfrage an das Telefon, und die Bestellung wird mit Awaiting ifthenpay payment angelegt. Die Bestellbestätigungsseite lautet: A payment request has been sent to your phone via MB WAY. Please confirm it in the MB WAY app. Die Bestellung wird bezahlt, wenn ifthenpay den Callback sendet. Es wird nur eine maskierte Telefonnummer gespeichert.
Kreditkarte. Der Kunde sieht You will be redirected to a secure page to enter your card details. und wird zur Kartenseite von ifthenpay weitergeleitet. Es existiert noch keine Bestellung, und der Warenkorb bleibt erhalten. Nach einer erfolgreichen Zahlung kehrt der Kunde in Ihren Shop zurück. Die Rückleitung wird nur mit einer gültigen ifthenpay-Signatur, dem sicheren Schlüssel des Warenkorbs, einem Geheimnis dieses Versuchs und der Kartenanfrage des Warenkorbs akzeptiert; dann wird die Bestellung als bezahlt angelegt, und der Kunde sieht die übliche Bestellbestätigungsseite. Kann die Rückleitung nicht geprüft werden, ändert sich nichts, und eine Seite Payment confirmation zeigt Your card payment is being confirmed by ifthenpay. You will receive an e-mail as soon as it is confirmed. mit einer Schaltfläche Check again; der Callback legt die Bestellung an, sobald er eintrifft. Schlägt die Kartenzahlung fehl oder wird sie abgebrochen, kehrt der Kunde zur Kasse zurück mit The card payment was not completed. You can try again or choose another payment method. oder The card payment was cancelled. You can try again or choose another payment method. Jeder Kartenversuch des Warenkorbs wird gespeichert, sodass eine Zahlung aus einem älteren Tab trotzdem akzeptiert wird.
Die Bestellung wird erst als bezahlt markiert, wenn ifthenpay dies bestätigt, und der Betrag wird auf den Cent genau mit der Bestellsumme verglichen. Kann die Zahlung nicht gestartet werden, bleibt der Kunde an der Kasse mit einer kurzen Meldung, etwa The Multibanco reference could not be created. Please try again or choose another payment method., The MB WAY payment request could not be sent. Please check that the phone number is linked to MB WAY, or choose another payment method. oder The payment service is temporarily unavailable. Please try again in a few minutes. Der technische Grund wird im Protokoll festgehalten.
Das Modul bietet jeweils nur eine ifthenpay-Methode an. Es unterstützt kein Payshop, Cofidis Pay, Apple Pay, Google Pay, PIX oder Pay-by-Link, keine Abonnements oder gespeicherten Karten, kein automatisches Ablaufen oder Stornieren unbezahlter Multibanco-Referenzen und keine Abfrage des Zahlungsstatus.
Bestellungen
Bestellstatus
No order yet: Eine Kartenzahlung wurde gestartet und ist noch nicht bestätigt, oder sie ist fehlgeschlagen oder abgebrochen worden. Es existiert nur der Warenkorb.
Awaiting ifthenpay payment: Eine Multibanco-Referenz wurde ausgestellt oder eine MB-WAY-Anfrage gesendet. PrestaShop reduziert den Lagerbestand, wenn die Bestellung angelegt wird. Unbezahlte Referenzen und abgelehnte MB-WAY-Anfragen stornieren die Bestellung nicht automatisch; stornieren Sie solche Bestellungen bei Bedarf selbst.
Payment accepted or Delivered: Die Zahlung wurde bestätigt. Der Status richtet sich nach Order Status After Payment. Die Zahlung wird mit der Multibanco-Referenz, der MB-WAY-Anfrage-ID oder der Kartenanfrage-ID als Transaktions-ID erfasst, und eine Notiz zeigt, wie sie bestätigt wurde.
ifthenpay payment on hold: Der eingegangene Betrag wich vom Bestellbetrag ab (zum Beispiel wurde der Warenkorb geändert, nachdem eine Kartenzahlung begonnen hatte), oder die Zahlung ging ein, nachdem die Bestellung storniert worden war. Die Notiz erklärt dies, und der Kunde wird nicht erneut zur Zahlung aufgefordert. Prüfen Sie die Zahlung im ifthenpay-Backoffice und schließen Sie die Bestellung ab oder erstatten Sie sie manuell. Eine spätere korrekte Zahlung für eine solche Bestellung ändert sie nicht.
Eine zweite Zahlung für eine bereits bezahlte Bestellung fügt nur eine Notiz hinzu, damit Sie im ifthenpay-Backoffice auf eine doppelte Zahlung prüfen können. Erstattete Bestellungen und nach der Zahlung stornierte Bestellungen werden nie wieder geöffnet.
ifthenpay-Zahlungsblock
Die Bestellseite zeigt einen Block ifthenpay payment mit den Zahlungsversuchen der Bestellung (Datum, Methode, ein Abzeichen Sandbox für Testzahlungen, Betrag, Multibanco-Entität und -Referenz oder die maskierte MB-WAY-Telefonnummer, ifthenpay-Anfrage-ID und Status), eine Warnung Manual review, solange die Bestellung auf ifthenpay payment on hold steht, und die ifthenpay notes der Bestellung.
Erstattungen
Erstattungen aus PrestaShop werden nicht unterstützt. Erstatten Sie die Zahlung im ifthenpay-Backoffice und erfassen Sie sie manuell in PrestaShop. Ein Callback mit dem Status erstattet (DEVOLVIDO) fügt nur eine Notiz hinzu. Andere Status, die ifthenpay meldet, fügen ebenfalls nur eine Notiz hinzu.
Lizenzschlüssel
Das Modul arbeitet mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock License — VibeFox ifthenpay Gateway ist der erste Block unter Modules > Module Manager > VibeFox ifthenpay Gateway > Configure, oberhalb der Einstellungen. Fügen Sie den Schlüssel in License key ein und klicken Sie auf Activate. Danach zeigt der Block den maskierten Schlüssel, den Status (zum Beispiel das Datum, bis zu dem die Lizenz gültig ist, und Ihre Domain) sowie die Schaltflächen Check now zum erneuten Prüfen des Status, Change key zum Eingeben eines anderen Schlüssels und Remove key zum Entfernen des Schlüssels aus diesem Shop. Darunter stehen die Zeile Product: presta-payment-ifthenpay 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. Nach einer Änderung der Shop-Adresse 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 gilt für eine Domain: die Domain des Hauptshops, auch bei einer Multistore-Einrichtung. Das Entfernen des Schlüssels aus dem Shop gibt seinen Domain-Platz nicht frei. Geben Sie den Platz in Ihrem vibefox.net-Konto frei.
Ohne aktiven Schlüssel wird ifthenpay Kunden im Bestellvorgang nicht angezeigt. Versucht dennoch jemand eine Zahlung, sieht der Kunde This payment method is not available. Please choose another one. Der PrestaShop-Shop weiß nicht, dass Sie im Back Office angemeldet sind, daher wird die Zahlungsart auch für Sie ausgeblendet: Sie können das Modul vor dem Kauf eines Schlüssels einrichten, aber nicht im Bestellvorgang testen. Eine Erinnerung erscheint unter Modules > Module Manager auf dem Reiter Alerts. Bestehende Bestellungen sind nicht betroffen: bereits gestartete Zahlungen werden weiterhin bestätigt.
Läuft eine Lizenz ab, arbeitet das Modul weiter, aber Updates und Support benötigen eine Verlängerung. Der Status wird während Ihrer Arbeit im Back Office automatisch erneut geprüft: einmal täglich in den ersten 14 Tagen nach Eingabe des Schlüssels, danach einmal pro Woche. Ein Cron-Job ist nicht nötig. Beim Deinstallieren oder Zurücksetzen des Moduls werden der Lizenzschlüssel und der Lizenzstatus immer entfernt.
Fehlerbehebung
ifthenpay erscheint nicht an der Kasse: Prüfen Sie, ob die Lizenz aktiv ist, Enable/Disable eingeschaltet ist, der Schlüssel der gewählten Payment Method eingetragen ist, die Warenkorbwährung EUR ist und der Gesamtbetrag zwischen 0,01 und 99.999,99 EUR liegt. Prüfen Sie unter Payment > Preferences, ob das Modul für EUR, das Land des Kunden und die Kundengruppe erlaubt ist.
Der Kunde hat bezahlt, aber die Bestellung bleibt bei Awaiting ifthenpay payment oder es wurde keine Bestellung angelegt: Der Callback erreicht Ihren Shop nicht. Prüfen Sie, ob ifthenpay die Callback-URL und den Anti-Phishing-Schlüssel für den verwendeten Schlüssel aktiviert hat und ob die URL zur gewählten Methode gehört. Der Shop muss aus dem Internet erreichbar sein, nicht über localhost und nicht hinter einem Login. Suchen Sie im Feld Log auf der Modulseite nach Zeilen mit Callback rejected.
Der Callback antwortet mit 403 Forbidden: Der Anti-Phishing-Schlüssel im Callback fehlt oder weicht von dem in den Einstellungen ab. Senden Sie den in den Einstellungen angezeigten Schlüssel erneut an ifthenpay.
Der Callback antwortet mit 503 Not configured: Der Anti-Phishing-Schlüssel wurde noch nicht erzeugt. Öffnen Sie einmal die Moduleinstellungen; ifthenpay wiederholt den Callback.
Der Callback antwortet mit 503 Busy: Derselbe Warenkorb wurde in diesem Moment von einer anderen Anfrage verarbeitet. ifthenpay wiederholt den Callback.
Der Callback antwortet Order not found: Die Referenz oder Anfrage gehört nicht zu einer Zahlung dieses Moduls, oder der Warenkorb wurde mit einer anderen Zahlungsmethode bestellt.
Warum wurde eine bezahlte Bestellung angehalten? Der eingegangene Betrag wich vom Bestellbetrag ab, oder die Zahlung ging ein, nachdem die Bestellung storniert worden war. Lesen Sie die Notizen im Block ifthenpay payment, prüfen Sie die Zahlung im ifthenpay-Backoffice und schließen Sie die Bestellung ab oder erstatten Sie sie manuell.
MB-WAY-Anfrage konnte nicht gesendet werden: Die Telefonnummer ist nicht mit MB WAY verknüpft oder hat ein falsches Format. Verwenden Sie 912 345 678 oder für Nummern anderer Länder 351#912345678.
Testmodus und MB WAY: ifthenpay hat keine MB-WAY-Sandbox; verwenden Sie einen von ifthenpay bereitgestellten Testschlüssel.
Deinstallation
Gehen Sie zu Modules > Module Manager, öffnen Sie das Menü neben VibeFox ifthenpay Gateway und wählen Sie Uninstall. Der Lizenzschlüssel und der Lizenzstatus dieses Moduls werden immer entfernt. Ist Delete Data on Uninstall aktiviert, werden die Moduleinstellungen, der Anti-Phishing-Schlüssel und das Protokoll entfernt; nach einer erneuten Installation wird ein neuer Anti-Phishing-Schlüssel erzeugt, der erneut an ifthenpay gesendet werden muss. Ist die Option deaktiviert, bleiben alle Einstellungen für eine spätere Neuinstallation erhalten. Die Zahlungsdaten von ifthenpay (Referenzen und Anfrage-IDs) sowie die Bestellstatus Awaiting ifthenpay payment und ifthenpay payment on hold bleiben immer erhalten, damit Callbacks für zuvor ausgestellte Referenzen nach einer Neuinstallation ihre Bestellungen noch finden. Bestehende Bestellungen behalten ihre Zahlungsnotizen und Transaktions-IDs.
ifthenpay ist eine Marke ihres jeweiligen Inhabers. Dieses Modul ist nicht mit ifthenpay verbunden und wird nicht von ifthenpay unterstützt.