VibeFox PayFast for OpenCart — Hilfe

Anforderungen

OpenCart: 3.0.x (getestet mit 3.0.5.0) oder 4.0.2 und neuer (getestet mit 4.1.0.3).

PHP: 8.0 oder neuer.

Currency: Südafrikanischer Rand (ZAR). PayFast rechnet ausschließlich in Rand ab, daher muss die Bestellung in ZAR erfolgen. Fügen Sie die Währung unter System > Localisation > Currencies hinzu, falls Ihr Shop sie noch nicht hat. Der Mindestbestellwert beträgt R5.00.

PayFast account: die Merchant ID und der Merchant Key Ihres PayFast-Kontos, zu finden unter Settings > Developer Settings im PayFast-Dashboard. Eine Passphrase wird dringend empfohlen; wenn in PayFast eine festgelegt ist, muss dieselbe Passphrase in der Erweiterung eingetragen werden. Für Tests benötigen Sie die Zugangsdaten der PayFast-Sandbox.

Reachable store: die Benachrichtigungs-URL für Zahlungen muss aus dem Internet erreichbar sein, ohne Basic Auth oder Firewall-Sperre.

VibeFox license key: erhältlich auf vibefox.net. Ein Schlüssel funktioniert für eine Domain.

Installation

Der Download ist eine einzige ZIP-Datei mit den Paketen für beide OpenCart-Versionen. Entpacken Sie sie auf Ihrem Computer. Sie enthält README.txt, das OpenCart-3-Paket wcp_payfast_pay-oc3-(version).ocmod.zip und das OpenCart-4-Paket wcp_payfast_pay.ocmod.zip. Installieren Sie nur das Paket für Ihre OpenCart-Version. Der Lizenzschlüssel ist für beide Versionen derselbe.

OpenCart 3

1. Gehen Sie im Admin-Bereich zu Extensions > Installer, klicken Sie auf Upload und wählen Sie die Datei wcp_payfast_pay-oc3-(version).ocmod.zip. Die Erweiterung enthält keine OCMOD-Modifikationen, daher muss Extensions > Modifications nicht aktualisiert werden. Statt des Installers können Sie auch den Inhalt des Ordners upload dieses Pakets in das Stammverzeichnis Ihres Shops kopieren.

2. Gehen Sie zu Extensions > Extensions und wählen Sie den Typ Payments. Suchen Sie VibeFox PayFast Pay Gateway und klicken Sie auf Install (die grüne +-Schaltfläche).

3. Klicken Sie auf Edit (die Stift-Schaltfläche), um die Einstellungsseite zu öffnen. Fügen Sie Ihren VibeFox-Lizenzschlüssel im Lizenzblock oben auf der Seite in License key ein und klicken Sie auf Activate (siehe Abschnitt Lizenzschlüssel).

4. Tragen Sie Merchant ID, Merchant Key und Passphrase ein. Für Tests lassen Sie Test mode eingeschaltet und geben Sie Ihre Sandbox-Zugangsdaten ein.

5. Schalten Sie Enable/Disable ein und klicken Sie auf Save. Führen Sie eine Testzahlung durch und schalten Sie danach Test mode aus, um echte Zahlungen anzunehmen.

OpenCart 4

1. Gehen Sie im Admin-Bereich zu Extensions > Installer, klicken Sie auf Upload und wählen Sie die Datei wcp_payfast_pay.ocmod.zip. Benennen Sie die Datei nicht um: OpenCart 4 entnimmt den Erweiterungscode dem Dateinamen, und ein umbenanntes Paket funktioniert nicht.

2. Das Paket erscheint in der Liste der installierten Erweiterungen auf derselben Seite. Klicken Sie daneben auf Install (die grüne +-Schaltfläche).

3. Gehen Sie zu Extensions > Extensions und wählen Sie den Typ Payments. Suchen Sie VibeFox PayFast Pay Gateway, klicken Sie auf Install (die grüne +-Schaltfläche) und danach auf Edit (die Stift-Schaltfläche).

4. Geben Sie den Lizenzschlüssel und die PayFast-Zugangsdaten ein und testen Sie die Zahlung wie in den Schritten 3 bis 5 für OpenCart 3. Die Einstellungsseite und ihre Felder sind in beiden Versionen gleich. Nur die Benachrichtigungs-URL ist anders (siehe Notification URL); auch sie wird mit jeder Zahlung an PayFast übermittelt.

Bei einer Neuinstallation ist die Zahlungsart zunächst ausgeschaltet und der Testmodus eingeschaltet.

Konfiguration

Alle Einstellungen befinden sich auf der Seite der Erweiterung: Extensions > Extensions > Payments > VibeFox PayFast Pay Gateway > Edit. Die Abschnitte sind links aufgeführt; die Schaltfläche Save unter der Liste speichert die gesamte Seite. Oberhalb der Einstellungen warnt die Seite, wenn die Zugangsdaten des aktuellen Modus leer sind (PayFast wird dann an der Kasse ausgeblendet), wenn die Standardwährung des Shops nicht ZAR ist, wenn der Livebetrieb die öffentliche Sandbox-Merchant-ID 10000100 verwendet und wenn keine Passphrase gesetzt ist. Solange der Testmodus eingeschaltet ist, zeigt sie Test mode is on: orders are paid in the PayFast sandbox, no real money is charged. an.

Beim Speichern darf Title nicht leer sein (bis zu 128 Zeichen), Sort Order muss eine ganze Zahl sein (negative Zahlen sind erlaubt), Total muss eine Zahl größer oder gleich 0 sein, und die gewählte Geozone und die Bestellstatus müssen existieren; andernfalls wird nichts gespeichert und die Seite nennt das betreffende Feld. Wenn Sie die Zahlungsart ohne die Zugangsdaten des aktuellen Modus aktivieren, werden die Einstellungen mit einer Warnung gespeichert.

PayFast

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

Title: der Name der Zahlungsart, den Kunden an der Kasse sehen. Er wird auch als Zahlungsart in der Bestellung gespeichert. Standard: PayFast. Pflichtfeld.

Description: der Text, der dem Kunden im Schritt Confirm Order oberhalb der Bestätigungsschaltfläche angezeigt wird. Standard: Pay securely by card, Instant EFT and other methods on the PayFast payment page.

Sort Order: die Position von PayFast unter den Zahlungsarten an der Kasse. Lassen Sie das Feld leer oder geben Sie eine ganze Zahl ein.

Geo Zone: bietet PayFast nur für Rechnungsadressen in der gewählten Geozone an. Standard: All zones. Geozonen werden unter System > Localisation > Geo Zones eingerichtet. Bei OpenCart 4 wird die Lieferadresse verwendet, wenn der Shop keine Rechnungsadresse abfragt.

Total: der Warenkorbbetrag in der Standardwährung des Shops, den eine Bestellung erreichen muss, damit PayFast angeboten wird. Lassen Sie das Feld leer, um PayFast bei jedem Betrag anzubieten. PayFast selbst benötigt immer mindestens R5.00.

PayFast-Konto (Live)

Ihre Merchant ID und Ihren Merchant Key finden Sie im PayFast-Dashboard unter Settings > Developer Settings (dort befinden sich die Links zum Abschnitt). Wenn Sie dort eine Passphrase festlegen, tragen Sie hier genau dieselbe Passphrase ein.

Merchant ID: Ihre Live-Merchant-ID von PayFast.

Merchant Key: Ihr Live-Merchant-Key von PayFast. Er wird mit jedem Zahlungsformular an PayFast gesendet, daher ist es ein normales Textfeld.

Passphrase: die Salt-Passphrase von PayFast unter Settings > Developer Settings. Dringend empfohlen: Sie signiert Zahlungen und Benachrichtigungen.

Sandbox (Testmodus)

Im Testmodus gehen Zahlungen an die PayFast-Sandbox, und es wird kein echtes Geld abgebucht. Die Sandbox-Zugangsdaten werden angezeigt, nachdem Sie sich in der PayFast-Sandbox angemeldet haben (der öffentliche Test-Merchant ist 10000100 / 46f0cd694581a).

Test mode: Use the PayFast sandbox and the sandbox credentials below. Solange die Option eingeschaltet ist, sieht der Kunde im Schritt Confirm Order den Hinweis TEST MODE: payments go to the PayFast sandbox, no real money is charged. Standard: eingeschaltet.

Sandbox Merchant ID: die Merchant ID Ihres Sandbox-Kontos.

Sandbox Merchant Key: der Merchant Key Ihres Sandbox-Kontos.

Sandbox Passphrase: nur, wenn in Ihrem Sandbox-Konto eine Passphrase gesetzt ist.

Gespeicherte Passphrasen werden nie wieder angezeigt. Das Feld bleibt leer und zeigt Saved — leave empty to keep it. an. Geben Sie einen neuen Wert nur ein, wenn Sie ihn ändern möchten. Um eine gespeicherte Passphrase zu entfernen, setzen Sie unter dem Feld den Haken bei Clear the saved passphrase on save und klicken Sie auf Save.

Zahlungsbenachrichtigungen (ITN)

Notification URL: PayFast bestätigt jede Zahlung mit einer Server-zu-Server-Benachrichtigung an die hier angezeigte URL. Bei OpenCart 3 sieht sie so aus: https://your-store/index.php?route=extension/payment/wcp_payfast_pay/itn, bei OpenCart 4 so: https://your-store/index.php?route=extension/wcp_payfast_pay/payment/wcp_payfast_pay.itn. Sie wird aus der Shop-Adresse Ihrer OpenCart-Installation erzeugt. Die Adresse wird mit jeder Zahlung übermittelt, daher muss in PayFast nichts konfiguriert werden; sie muss aber aus dem Internet erreichbar sein. Bestellungen erhalten ihren Status nur durch diese geprüften Benachrichtigungen; wenn der Kunde in den Shop zurückkehrt, ändert sich die Bestellung dadurch nicht.

Source check: Live-Benachrichtigungen werden nur von PayFast-Servern angenommen. Die Adressen stammen aus den DNS-Einträgen von PayFast (6 Stunden zwischengespeichert; der Cache wird beim Speichern der Einstellungen zurückgesetzt) sowie aus den dokumentierten Adressbereichen von PayFast. Deaktivieren Sie die Prüfung nur, wenn Ihr Shop hinter einem Proxy oder CDN liegt, der die Besucheradresse verbirgt. Signatur und Serverbestätigung werden immer geprüft. Sandbox-Benachrichtigungen werden nicht anhand der Adresse geprüft. Standard: eingeschaltet.

Bestellungen

OpenCart legt die Bestellung im Schritt Confirm Order ohne Status an (eine fehlende Bestellung). Einen Status erhält sie erst durch eine geprüfte PayFast-Benachrichtigung. Eine abgebrochene, fehlgeschlagene oder aufgegebene Zahlung lässt die Bestellung ohne Status, und der Kunde kann erneut bezahlen. Jedes Feld unten listet Ihre Bestellstatus aus OpenCart auf.

Order Status (paid): der Status, nachdem PayFast die Zahlung bestätigt hat und Betrag und Währung übereinstimmen. Standard: In Bearbeitung.

Awaiting PayFast payment: PayFast hat die Zahlung als ausstehend gemeldet (zum Beispiel Instant EFT). Sie wechselt in den bezahlt-Status, sobald PayFast sie abschließt. Standard: Ausstehend.

PayFast payment on hold: eine Zahlung, die Ihre Prüfung benötigt (siehe Bestellstatus). Eine solche Bestellung wird nicht als bezahlt markiert; eine Notiz erklärt den Grund. Standard: Ausstehend, da OpenCart keinen Status On hold hat. Sie können unter System > Localisation > Order Statuses einen eigenen Status anlegen und hier auswählen.

Payment failed: eine ausstehende Zahlung ist fehlgeschlagen. Wenn PayFast sie später abschließt, wechselt die Bestellung in den bezahlt-Status. Standard: Fehlgeschlagen.

Erweitert

Debug log: protokolliert die Zahlungsschritte in payfast_p_debug.log.php im Logs-Ordner von OpenCart (storage/logs). Die Datei kann nicht über das Web geöffnet werden; bei 5 MB wird sie nach payfast_p_debug.old.log.php verschoben. Fehler und Warnungen werden immer protokolliert, auch wenn der Schalter aus ist. Passphrasen, Schlüssel und Kundendaten werden nicht geschrieben. Standard: aus.

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

Uninstall: Delete the gateway settings when the extension is uninstalled (Einstellungen, zwischengespeicherte PayFast-Adressen und Protokoll). Zahlungsdatensätze von PayFast und Bestellungen bleiben immer erhalten. Standard: aus.

Import / Export

Export: Download JSON speichert die Einstellungen als JSON-Datei. Passphrasen werden nicht exportiert.

Import: fügen Sie zuvor exportiertes JSON ein und klicken Sie auf Import, um die Einstellungen wiederherzustellen. Gespeicherte Passphrasen bleiben erhalten.

Kasse

Im Schritt Payment Method wählt der Kunde die Zahlungsart (standardmäßig PayFast). Im Schritt Confirm Order sieht der Kunde Ihre Beschreibung und den Hinweis Thank you for your order. You will be redirected to PayFast to complete the payment. OpenCart legt die Bestellung in diesem Schritt an, noch ohne Status. Bei OpenCart 4 wählt der Kunde die Zahlungsart mit der Schaltfläche Choose im Block der Zahlungsarten im Fenster Payment method options und klickt unten auf der Kassenseite auf Confirm Order. Wenn der Kunde auf Confirm Order klickt, sendet die Erweiterung das signierte Zahlungsformular an PayFast. Das Formular enthält den Bestellbetrag in ZAR, Order # mit der Bestellnummer, Name und E-Mail-Adresse des Kunden, die Zahlungsreferenz (Bestellnummer und Versuch) sowie ein zufälliges Token des Versuchs. Jeder neue Versuch erhält eine neue Referenz und ein neues Token.

Auf der PayFast-Seite bezahlt der Kunde per Karte, Instant EFT oder einer anderen Methode Ihres PayFast-Kontos. PayFast sendet dann die Zahlungsbenachrichtigung (ITN) an Ihren Shop. Die Bestellung wird erst als bezahlt markiert, wenn PayFast die Zahlung mit einer Benachrichtigung bestätigt, die alle Prüfungen besteht:

Die Bestellung erhält anschließend ihren Status auf die übliche Weise von OpenCart, mit den üblichen Bestell-E-Mails und der Bestandsaktualisierung. Benachrichtigungen zu einem Warenkorb werden nacheinander verarbeitet; wenn eine andere Benachrichtigung desselben Warenkorbs gerade verarbeitet wird, erhält PayFast eine Fehlerantwort und sendet die Benachrichtigung erneut. Die Benachrichtigungs-URL funktioniert auch, wenn der Shop im Wartungsmodus ist: OpenCart 3 lässt Anfragen von Zahlungserweiterungen durch, und bei OpenCart 4 fügt die Erweiterung eine Startup-Aktion hinzu, die die Benachrichtigung und die Rückkehr des Kunden von PayFast durchlässt.

Wenn der Kunde zurückkehrt und die Bestellung einen Status hat, wird die Erfolgsseite der OpenCart-Bestellung angezeigt. Hat PayFast die Zahlung als ausstehend gemeldet, steht dort außerdem PayFast is confirming your payment. You will receive an e-mail as soon as it is confirmed — there is no need to pay again. Befindet sich die Bestellung in Prüfung, steht dort Your payment is being reviewed. We will contact you if anything else is needed. Ist eine ausstehende Zahlung später fehlgeschlagen, steht dort Your PayFast payment was not completed. Please contact us about this order. (bei OpenCart 4 wird der Kunde stattdessen zurück zur Kasse geschickt, siehe unten). Ist die Benachrichtigung noch nicht eingegangen, zeigt eine Seite Payment confirmation, dass PayFast die Zahlung bestätigt, mit den Schaltflächen Check again und Back to checkout.

Bricht der Kunde auf der PayFast-Seite ab, kehrt er zur Kasse zurück, wo The PayFast payment was cancelled. You can try again or choose another payment method. steht. Hat PayFast die Zahlung als fehlgeschlagen gemeldet, lautet die Meldung The payment was not completed. You can try again or choose another payment method. Der Warenkorb bleibt erhalten und kann erneut bezahlt werden. Bei OpenCart 4 werden diese Meldungen über der Kassenseite angezeigt. OpenCart 3 legt bei jeder Anzeige des Schritts Confirm Order eine neue Bestellung an; OpenCart 4 behält für die Kasse eine Bestellung bei und aktualisiert sie, sodass der Kunde nach einer abgebrochenen oder fehlgeschlagenen Zahlung dieselbe Bestellung mit einem neuen Versuch bezahlt. Wurde eine andere Bestellung desselben Warenkorbs bereits von PayFast verarbeitet (zum Beispiel in einem zweiten Browser-Tab), wird der Kunde statt einer erneuten Zahlung zur Erfolgsseite geleitet.

Bei OpenCart 4 behält die Kasse die Bestellung, bis die Erfolgsseite angezeigt wird. Wurde diese Bestellung inzwischen ohne Zahlung geschlossen (zum Beispiel weil ihre ausstehende Zahlung fehlgeschlagen oder Sie sie storniert haben), wird der Kunde mit Your previous order was cancelled or its payment failed. Please confirm the order again. zurück zur Kasse geschickt, und das nächste Confirm Order bezahlt eine neue Bestellung. Hat diese Bestellung bereits einen Status und enthält der Warenkorb jetzt andere Produkte oder Mengen, lautet die Meldung Your previous order has already been placed for other cart contents. Please confirm the order of your current cart again.

Die Zahlungsart wird ausgeblendet, wenn die Zugangsdaten des aktuellen Modus fehlen, wenn die Kassenwährung nicht ZAR ist oder wenn der Betrag unter R5.00 liegt. Erreicht der Kunde die Zahlung trotzdem, erklärt ein kurzer Hinweis über dem Button den Grund, zum Beispiel PayFast accepts payments from R5.00. Please choose another payment method.

Die Erweiterung akzeptiert nur einmalige Zahlungen in ZAR. Sie bietet keine Erstattungen über die Bestellseite, keine Abonnements, keine gespeicherten (tokenisierten) Karten und keine geteilten Zahlungen.

Bestellungen

Bestellstatus

No status (missing order): der Kunde wurde zu PayFast geschickt, und die Zahlungsbenachrichtigung ist noch nicht eingegangen, oder PayFast hat die Zahlung als fehlgeschlagen gemeldet. Unter Sales > Orders werden solche Bestellungen nur mit dem Filter Order Status auf Missing Orders angezeigt.

Bei OpenCart 4 kann eine unbezahlte Bestellung aus der Kasse den Status Voided erhalten, den OpenCart 4 setzt, wenn der Kunde zum Schritt Confirm Order zurückkehrt. Die Erweiterung behandelt eine solche Bestellung als Bestellung ohne Status, und eine spätere Zahlung bestätigt sie trotzdem.

Order Status (paid) (default Processing): PayFast hat die Zahlung bestätigt. Eine Notiz zeigt die PayFast-Zahlungs-ID. Eine Sandbox-Zahlung erhält die Notiz, dass kein echtes Geld abgebucht wurde.

Awaiting PayFast payment (default Pending): PayFast hat die Zahlung als ausstehend gemeldet. Die Bestellung wechselt in den bezahlt-Status, sobald PayFast die Zahlung abschließt, oder in Payment failed, wenn die Zahlung fehlschlägt; der Kunde wird über diese Änderungen per E-Mail informiert.

Payment failed (default Failed): eine ausstehende Zahlung ist fehlgeschlagen. Wenn PayFast sie später abschließt, wechselt die Bestellung in den bezahlt-Status.

PayFast payment on hold (default Pending): der bezahlte Betrag weicht vom Bestellbetrag ab oder die Bestellung ist nicht in ZAR; eine Zahlung ging für eine Bestellung ein, deren Status Sie inzwischen geändert haben (zum Beispiel storniert) oder deren Zahlungsart nicht mehr PayFast ist; oder eine Sandbox-Zahlung ging ein, während das Gateway im Livebetrieb war. Die Notiz erklärt es. Prüfen Sie die Bestellung und Ihr PayFast-Dashboard und setzen Sie die Bestellung dann auf den bezahlt-Status oder stornieren Sie sie und erstatten Sie die Zahlung in PayFast.

Eine wiederholte Benachrichtigung zu derselben Zahlung ändert nichts. Verspätete fehlgeschlagene oder ausstehende Benachrichtigungen ändern nie eine bezahlte Bestellung. Wenn für eine bereits bezahlte Bestellung oder für eine zweite Bestellung eines bereits bezahlten Warenkorbs eine weitere abgeschlossene Zahlung eingeht, bittet Sie eine Notiz an der bezahlten Bestellung, die Dublette in PayFast zu erstatten.

Notizen sind Einträge im History der Bestellung, die der Kunde nicht sieht.

Reiter VibeFox PayFast Pay Gateway

Öffnen Sie unter Sales > Orders eine mit PayFast bezahlte Bestellung. Unten auf der Bestellseite, neben History und Additional, zeigt der Reiter VibeFox PayFast Pay Gateway die Payment reference (m_payment_id), die PayFast payment ID, die Environment (Live oder Sandbox), den angeforderten Betrag, den Status, die Beträge brutto, Gebühr und netto in ZAR sowie die PayFast notes. Bei einer Bestellung in Prüfung erscheint ein Hinweis, die Zahlung zu prüfen. Der Reiter wird Benutzern angezeigt, die Zugriff auf die Erweiterung haben.

Erstattungen

Erstattungen von der Bestellseite aus werden nicht unterstützt. Erstatten Sie die Zahlung in Ihrem PayFast-Dashboard und aktualisieren Sie die Bestellung anschließend manuell in OpenCart.

Lizenzschlüssel

Die Erweiterung arbeitet mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock License — VibeFox PayFast Pay Gateway ist der erste Block unter Extensions > Extensions > Payments > VibeFox PayFast Pay Gateway > Edit, 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 aktiv 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: opencart-payment-payfast und der Link Manage licenses and domains in your account, der Ihr vibefox.net-Konto öffnet. Nur Admin-Benutzer mit der Berechtigung Modify für die Erweiterung können den Schlüssel ändern. Die Texte des Blocks folgen der Admin-Sprache (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 Sie die Shop-Adresse geändert oder in Ihrem Konto einen Domain-Platz freigegeben haben, klicken Sie auf Check now. Ist der Lizenzserver nicht erreichbar, arbeitet die Erweiterung mit dem zuletzt bekannten Status weiter.

Ein Schlüssel funktioniert für eine Domain: die Shop-Adresse aus der OpenCart-Konfiguration. 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 PayFast Kunden an der Kasse nicht angezeigt. Wird trotzdem eine Zahlung gestartet, sieht der Kunde This payment method is not available. Please choose another one. Ein Admin-Benutzer, der im selben Browser im Admin angemeldet ist, sieht die Zahlungsart im Shop weiterhin, markiert mit (unlicensed — visible to admins only), damit Sie die Erweiterung vor dem Kauf eines Schlüssels einrichten und testen können. Bei OpenCart 4 gibt es diese Vorschau nicht: Der Shop erkennt die Admin-Anmeldung nicht, daher ist die Zahlungsart ohne aktiven Schlüssel für alle ausgeblendet. Nachdem Sie die Seite Edit einmal geöffnet haben, erscheint im Admin-Dashboard eine Erinnerung. Schließen Sie sie mit ×, um sie 7 Tage lang auszublenden. Bestehende Bestellungen sind nicht betroffen: bereits gestartete Zahlungen werden weiterhin bestätigt.

Läuft eine Lizenz ab, arbeitet die Erweiterung weiter, aber Updates und Support erfordern eine Verlängerung. Der Status wird automatisch erneut geprüft, wenn Sie das Admin-Dashboard oder die Seite Edit öffnen: in den ersten 14 Tagen nach der Eingabe des Schlüssels einmal täglich, danach einmal pro Woche. Ein Cron-Job ist nicht nötig. Beim Deinstallieren der Erweiterung werden Lizenzschlüssel und Lizenzstatus immer entfernt.

Fehlerbehebung

PayFast does not appear at checkout: prüfen Sie, ob die Lizenz aktiv ist, Enable/Disable eingeschaltet ist, Merchant ID und Merchant Key des aktuellen Modus ausgefüllt sind, die Kassenwährung ZAR ist und der Bestellbetrag mindestens R5.00 beträgt. Die Einstellungsseite zeigt eine Warnung, wenn etwas fehlt. Prüfen Sie außerdem, ob die Rechnungsadresse in der gewählten Geo Zone liegt und ob die Bestellung den in den Einstellungen festgelegten Total-Wert erreicht.

The payment went through, but the order stays without a status: PayFast konnte die Zahlungsbenachrichtigung nicht zustellen oder sie wurde abgelehnt. Schauen Sie im Feld Log auf der Erweiterungsseite nach; Fehler und abgelehnte Benachrichtigungen werden immer protokolliert, und Debug log ergänzt jeden Schritt. Typische Ursachen: Der Shop ist aus dem Internet nicht erreichbar (Basic Auth, Firewall), eine andere Passphrase in PayFast und in der Erweiterung oder – im Livebetrieb hinter einem Proxy oder CDN – die Quellenprüfung. Schalten Sie in diesem Fall Source check aus.

The notification answers Invalid signature: die Passphrase in der Erweiterung ist nicht die, die in PayFast für den Modus gesetzt ist, in dem die Zahlung erfolgte.

The notification answers Invalid source: die Benachrichtigung stammte nicht von einer PayFast-Adresse, oder ein Proxy oder CDN verbirgt die echte Adresse. Schalten Sie Source check aus, wenn Ihr Shop hinter einem Proxy oder CDN liegt.

The notification answers Merchant mismatch or Order mismatch: die Zahlung ging an ein anderes PayFast-Konto oder gehört nicht zu diesem Zahlungsversuch. Es wird nichts geändert.

The notification answers Order not found: die Zahlungsreferenz ist diesem Shop unbekannt. Es wird nichts geändert.

The notification answers Confirmation unavailable, Busy or Temporary error: PayFast konnte für die Serverbestätigung nicht erreicht werden, eine andere Benachrichtigung zum selben Warenkorb wurde gerade verarbeitet, oder der Bestellstatus konnte nicht gesetzt werden. PayFast wiederholt die Benachrichtigung. Das Protokoll zeigt den Grund.

The notification answers Not configured: die Zugangsdaten des Modus, in dem die Zahlung gestartet wurde, fehlen. Geben Sie sie erneut ein, zum Beispiel die Sandbox-Zugangsdaten für eine Testzahlung.

The customer sees PayFast accepts payments in South African rand (ZAR) only: die Bestellung ist in einer anderen Währung. Lassen Sie den Kunden in Rand bezahlen oder ihn eine andere Zahlungsart wählen.

The customer sees This payment method is not available. Please reload the checkout page. Die Kassensitzung passt nicht mehr zur Bestellung, oder die Zahlungsart wurde inzwischen ausgeschaltet. Der Kunde lädt die Kasse neu.

Order is in the on-hold status: lesen Sie die Notizen im Reiter VibeFox PayFast Pay Gateway (siehe Bestellstatus) und Ihr PayFast-Dashboard und setzen Sie dann den bezahlt-Status oder erstatten Sie die Zahlung.

A sandbox payment did not pay the order: das Gateway ist im Livebetrieb. Sandbox-Zahlungen bezahlen im Livebetrieb nie eine Bestellung; eine Notiz an der Bestellung weist darauf hin.

Für Entwickler: Bevor das Zahlungsformular signiert wird, löst die Erweiterung das OpenCart-Ereignis payfast_p_payment_data mit den Formularfeldern und der Bestellung aus. Die Händlerzugangsdaten, URLs, Zahlungsreferenz, Betrag und Token können dadurch nicht geändert werden.

Deinstallation

Gehen Sie zu Extensions > Extensions, wählen Sie den Typ Payments und klicken Sie neben VibeFox PayFast Pay Gateway auf Uninstall (die rote −-Schaltfläche). Lizenzschlüssel und Lizenzstatus dieser Erweiterung werden immer entfernt. OpenCart entfernt immer die eigenen Einstellungen der Erweiterung: Enable/Disable, Sort Order, Geo Zone, Total und die Bestellstatus des Abschnitts Orders, die bei einer Neuinstallation auf ihre Standardwerte zurückgesetzt werden. Auch das OpenCart-Ereignis der Erweiterung wird entfernt (bei OpenCart 4 seine Ereignisse und seine Startup-Aktion, die die Benachrichtigung und die Rückkehr des Kunden im Wartungsmodus durchlässt). Ist Delete the gateway settings when the extension is uninstalled eingeschaltet, werden die übrigen Gateway-Einstellungen (Titel, Beschreibung, Zugangsdaten, Passphrasen, Testmodus, Quellenprüfung, Protokollierung), die zwischengespeicherten PayFast-Adressen und das Protokoll entfernt. Ist es ausgeschaltet, bleiben sie für eine spätere Neuinstallation erhalten. Die Zahlungsdatensätze von PayFast und die Bestellungen bleiben immer erhalten. Bestehende Bestellungen behalten ihre Zahlungsnotizen.

Um bei OpenCart 4 auch die Dateien der Erweiterung zu entfernen, gehen Sie nach der Deinstallation zu Extensions > Installer und klicken Sie in der Liste der installierten Erweiterungen neben VibeFox PayFast Pay Gateway auf Uninstall (die orangefarbene −-Schaltfläche) und danach auf Delete (die rote Papierkorb-Schaltfläche), um das hochgeladene Paket zu entfernen.

PayFast ist eine Marke ihres jeweiligen Inhabers. Diese Erweiterung ist nicht mit PayFast verbunden und wird von PayFast nicht unterstützt.