VibeFox ifthenpay for WooCommerce — Hilfe
Anforderungen
WordPress: 6.0 oder neuer.
WooCommerce: 7.0 oder neuer, installiert und aktiv. Das Plugin lässt sich ohne WooCommerce nicht aktivieren.
PHP: 8.0 oder neuer.
Währung: nur Euro (EUR). Die Zahlungsmethode wird ausgeblendet, wenn die Shop- oder Bestellwährung nicht EUR ist. ifthenpay akzeptiert Summen von 0,01 bis 99.999,99 EUR.
ifthenpay-Konto: Registrieren Sie sich auf 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 finden Sie im ifthenpay-Backoffice (backoffice.ifthenpay.com) oder sie werden 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 in WordPress zu Plugins > Add New > Upload Plugin, wählen Sie die ZIP-Datei des Plugins und klicken Sie auf Install Now. Alternativ können Sie den Ordner wcp_ifthenpay_gateway per FTP nach /wp-content/plugins/ hochladen.
2. Klicken Sie auf Activate. Das Plugin erzeugt seinen Anti-Phishing-Schlüssel.
3. Öffnen Sie die Einstellungen: WooCommerce > Settings > Payments > ifthenpay > Manage, oder klicken Sie auf der Seite Plugins 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. Wählen Sie die Payment Method und geben Sie den zugehörigen ifthenpay-Schlüssel ein. Speichern Sie, damit die Callback URL zur gewählten Methode passt.
6. 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).
7. Aktivieren Sie Enable/Disable.
Konfiguration
Alle Einstellungen befinden sich auf einer Seite: WooCommerce > Settings > Payments > ifthenpay. Ohne den Schlüssel der gewählten Methode wird die Zahlungsmethode auf der Kasse nicht angezeigt, und in der Liste der Zahlungsmethoden ist sie als handlungsbedürftig markiert. Wenn Sie ein aktiviertes Gateway ohne diesen Schlüssel speichern, zeigt die Seite ifthenpay: enter the key of the selected payment method, otherwise the method is not shown at checkout. an.
Enable/Disable: Enable ifthenpay Payment schaltet die Zahlungsmethode ein oder aus. Standard: aus.
Title: der Titel der Zahlungsmethode auf der Kasse. Standard: ifthenpay.
Description: die Beschreibung der Zahlungsmethode auf der Kasse. Standard: Pay via Multibanco, MB WAY or Credit Card. Passen Sie sie an die von Ihnen angebotene Methode an.
Payment Method: die auf der Kasse angebotene Methode. Nur der Schlüssel dieser Methode ist erforderlich.
ifthenpay-Schlüssel
Die Schlüssel (Format ABC-123456) finden Sie im ifthenpay-Backoffice, oder sie werden 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 Kreditkarte. Er prüft außerdem die Signatur der Rückleitung des Kunden von der Kartenseite.
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 unten genannten Anti-Phishing-Schlüssel und der Callback-URL. Multibanco- und MB-WAY-Bestellungen werden nur durch den Callback bestätigt; Kartenzahlungen zusätzlich durch die signierte Rückleitung von der Kartenseite.
Anti-phishing Key: vom Plugin erzeugt, zum Kopieren angezeigt. ifthenpay sendet ihn in jedem Callback zurück; Callbacks ohne ihn werden abgelehnt.
Callback URL: die Callback-URL der gewählten Zahlungsmethode mit den Platzhaltern von ifthenpay, zum Kopieren angezeigt. Sie beginnt mit https://your-site/wc-api/ifthenpay_payment_callback/ und enthält 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 Bestellung dieses Gateways passen: bei Multibanco über Entität und Referenz, bei MB WAY über die Bestellung und eine ihrer MB-WAY-Anfragen, bei Kreditkarte über die Bestellung und ihre Kartenanfrage. Ohne funktionierenden Callback werden Multibanco- und MB-WAY-Bestellungen nie bestätigt, und Kartenzahlungen nur durch die signierte Rückleitung.
Erweitert
Test Mode: Enable test/sandbox 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 mit einem Testschlüssel von ifthenpay. Auf der Kasse erscheint ein Abzeichen TEST MODE. Standard: aus.
Order Status After Payment: der Bestellstatus nach einer bestätigten Zahlung, mit einer einzigen Statusänderung und einer einzigen E-Mail an den Kunden. Bestellungen mit ausschließlich virtuellen, herunterladbaren Produkten werden immer von WooCommerce abgeschlossen.
Debug Log: Enable logging. API-Anfragen und Callbacks werden in WooCommerce > Status > Logs geschrieben, Quelle wcp_ifthenpay_gateway. Fehler werden immer protokolliert. Schlüssel, der Anti-Phishing-Schlüssel und Telefonnummern werden nie protokolliert. Standard: aus.
Delete Data on Uninstall: Remove the plugin settings, the anti-phishing key and the logs when the plugin is deleted (orders are kept). Standard: aus.
Kasse
Multibanco. Auf der Kasse sieht der Kunde You will receive a Multibanco reference to complete the payment. Beim Abschicken der Bestellung erstellt das Plugin eine dynamische Multibanco-Referenz für die Bestellsumme. Die Bestellung wird auf Wartend gesetzt, der Lagerbestand reduziert und der Warenkorb geleert. Die Bestellbestätigungsseite und die Bestellmails, die versendet werden, solange die Bestellung wartet, zeigen Multibanco Payment Details: Entität, Referenz und Betrag, mit Please use these details to pay at any Multibanco ATM or through your online banking. Gibt der Kunde die Bestellung mit demselben Betrag erneut auf, wird dieselbe Referenz verwendet. Die Bestellung wird bestätigt, sobald 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 Rechnungstelefonnummer wird übernommen. Das Plugin sendet eine Zahlungsanfrage an das Telefon, die Bestellung wird auf Wartend gesetzt, der Lagerbestand reduziert und der Warenkorb geleert. Die Bestellbestätigungsseite zeigt A payment request has been sent to your phone via MB WAY. Please confirm it in the MB WAY app. Alle Anfragen der Bestellung bleiben erhalten, daher wird eine frühere, in der App bestätigte Anfrage weiterhin akzeptiert. Die Bestellung wird durch den Callback bestätigt.
Kreditkarte. Der Kunde sieht You will be redirected to a secure page to enter your card details. und wird zur Kartenseite von ifthenpay weitergeleitet. Die Bestellung bleibt auf Zahlung ausstehend, bis sie bezahlt ist; der Lagerbestand wird vorher nicht reduziert. Nach erfolgreicher Zahlung kehrt der Kunde in Ihren Shop zurück. Die Rückleitung wird nur mit einer gültigen ifthenpay-Signatur, dem Bestellschlüssel, einem Geheimnis dieses Versuchs und der Kartenanfrage der Bestellung akzeptiert; dann wird die Bestellung als bezahlt markiert. Lässt sich die Rückleitung nicht prüfen, bleibt die Bestellung unverändert, und die Bestellbestätigungsseite zeigt Your card payment is being confirmed by ifthenpay. You will receive an e-mail as soon as it is confirmed. Eine fehlgeschlagene Kartenzahlung setzt die Bestellung auf Fehlgeschlagen, eine abgebrochene lässt sie auf Zahlung ausstehend. In beiden Fällen gelangt der Kunde zur Seite Pay for order 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.
Die Bestellung wird erst als bezahlt markiert, nachdem ifthenpay die Zahlung bestätigt hat, und der Betrag wird auf den Cent genau mit der Bestellsumme verglichen. Kann die Zahlung nicht gestartet werden, sieht der Kunde eine kurze Meldung, zum Beispiel 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.
Die Zahlungsmethode funktioniert auf der klassischen Kasse, im Warenkorb- und im Kassen-Block (mit dem Telefonfeld für MB WAY) und auf der Seite Pay for order. Sie ist mit der High-Performance-Bestellspeicherung (HPOS) von WooCommerce kompatibel.
Das Plugin bietet jeweils 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
Order statuses
On hold (waiting for payment): eine Multibanco-Referenz wurde erstellt oder eine MB-WAY-Anfrage gesendet. Unbezahlte Referenzen werden nicht automatisch storniert; stornieren Sie solche Bestellungen bei Bedarf selbst.
Pending payment: eine Kartenzahlung wurde begonnen und ist noch nicht bestätigt, oder sie wurde abgebrochen.
Processing or Completed: die Zahlung wurde bestätigt. Der Status folgt Order Status After Payment. Die Bestellnotiz zeigt Entität und Multibanco-Referenz, die MB-WAY-Transaktion oder die Kartenanfrage-ID.
On hold after payment: der erhaltene Betrag wich von der Bestellsumme ab, oder die Zahlung kam an, nachdem die Bestellung storniert wurde. Die Bestellnotiz erklärt es. Prüfen Sie die Zahlung im ifthenpay-Backoffice und schließen Sie die Bestellung ab oder erstatten Sie sie manuell.
Failed: der Kunde ist mit einem Fehler von der Kartenseite zurückgekehrt.
Eine zweite Zahlungsbenachrichtigung 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.
Erstattungen
Erstattungen aus WooCommerce werden nicht unterstützt. Erstatten Sie die Zahlung im ifthenpay-Backoffice und erfassen Sie sie manuell in WooCommerce. Ein Callback für eine Erstattung (DEVOLVIDO) fügt nur eine Bestellnotiz hinzu. Andere Status, die ifthenpay meldet, fügen ebenfalls nur eine Notiz hinzu.
Lizenzschlüssel
Das Plugin arbeitet mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzbereich befindet sich oben unter WooCommerce > Settings > Payments > ifthenpay. 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 Seite. 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 Seite gibt deren Domain-Platz nicht frei. Geben Sie den Platz in Ihrem vibefox.net-Konto frei.
Ohne aktiven Schlüssel wird ifthenpay Kunden auf 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 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 begonnene Zahlungen werden weiterhin bestätigt.
Läuft eine Lizenz ab, arbeitet das Plugin weiter, doch Updates und Support erfordern eine Verlängerung. Der Status wird im Hintergrund automatisch erneut geprüft.
Fehlerbehebung
ifthenpay erscheint nicht auf 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 Währung EUR ist und die Summe zwischen 0,01 und 99.999,99 EUR liegt. Auf der Seite Pay for order zählt die Bestellwährung.
Der Kunde hat bezahlt, aber die Bestellung bleibt On hold oder Pending payment: 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. Die Seite muss aus dem Internet erreichbar sein, nicht auf localhost und nicht hinter einem Login. Suchen Sie in WooCommerce > Status > Logs, Quelle wcp_ifthenpay_gateway, nach Zeilen mit Callback rejected.
Callback antwortet 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.
Callback antwortet 503 Not configured: der Anti-Phishing-Schlüssel wurde noch nicht erzeugt. Öffnen Sie die Einstellungsseite einmal; ifthenpay wiederholt den Callback.
Callback antwortet Order not found: die Referenz oder Anfrage gehört nicht zu einer Bestellung dieses Gateways, zum Beispiel weil die Zahlungsmethode nach der Bestellung gewechselt wurde.
Warum wurde eine bezahlte Bestellung auf On hold gesetzt? Der erhaltene Betrag wich von der Bestellsumme ab, oder die Zahlung kam an, nachdem die Bestellung storniert wurde. Lesen Sie die Bestellnotiz, 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 das falsche Format. Verwenden Sie 912 345 678 oder 351#912345678 für Nummern anderer Länder.
Testmodus und MB WAY: ifthenpay hat keine Sandbox für MB WAY; verwenden Sie einen von ifthenpay bereitgestellten Testschlüssel.
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 einen Platz in Ihrem vibefox.net-Konto frei und klicken Sie auf Check now. Wurde die Adresse der Seite 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, der Anti-Phishing-Schlüssel und die Logs werden nur entfernt, wenn Delete Data on Uninstall aktiviert war. Andernfalls bleiben sie für eine spätere Neuinstallation erhalten. Bestellungen und ihre ifthenpay-Daten (Referenzen, Anfrage-IDs) bleiben immer erhalten. Bestehende Bestellungen behalten ihre Zahlungsnotizen und Transaktions-IDs.
ifthenpay ist eine Marke ihres jeweiligen Inhabers. Dieses Plugin ist nicht mit ifthenpay verbunden und wird nicht von ifthenpay unterstützt.