VibeFox PayFast for WooCommerce — Hilfe

Anforderungen

WordPress: 6.2 oder neuer.

WooCommerce: 8.0 oder neuer, installiert und aktiv. Das Plugin lässt sich ohne WooCommerce nicht aktivieren.

PHP: 8.0 oder neuer.

Währung: Südafrikanischer Rand (ZAR), festgelegt unter WooCommerce > Settings > General. PayFast rechnet ausschließlich in Rand ab. Der Mindestbestellbetrag beträgt R5.00.

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

Erreichbare Website: Die URL für Zahlungsbenachrichtigungen muss aus dem Internet erreichbar sein, ohne Wartungsmodus, Basic-Authentifizierung oder Firewall-Sperre.

VibeFox-Lizenzschlüssel: wird auf vibefox.net gekauft. Ein Schlüssel funktioniert für eine 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_payfast_pay per FTP nach /wp-content/plugins/ hochladen.

2. Klicken Sie auf Activate.

3. Stellen Sie die Shop-Währung unter WooCommerce > Settings > General auf Südafrikanischer Rand um.

4. Öffnen Sie die Einstellungen: WooCommerce > Settings > Payments > PayFast > Manage, oder klicken Sie auf der Plugins-Seite unter dem Plugin-Namen auf Settings.

5. Geben Sie Ihren VibeFox-Lizenzschlüssel im Lizenzblock oben auf der Seite ein und klicken Sie auf Activate.

6. Geben Sie Merchant ID, Merchant Key und Passphrase ein. Lassen Sie für Tests Test mode eingeschaltet und tragen Sie Ihre Sandbox-Zugangsdaten ein.

7. Aktivieren Sie Enable/Disable und speichern Sie. Führen Sie eine Testzahlung durch und schalten Sie dann den Testmodus aus, um echte Zahlungen anzunehmen.

Konfiguration

Alle Einstellungen befinden sich auf einer Seite: WooCommerce > Settings > Payments > PayFast. Oberhalb der Felder warnt die Seite, wenn die Zugangsdaten des aktuellen Modus leer sind (PayFast wird dann an der Kasse ausgeblendet), wenn die Shop-Währung nicht ZAR ist, wenn der Live-Modus die öffentliche Sandbox-Merchant-ID 10000100 verwendet und wenn keine Passphrase gesetzt ist. Solange der Testmodus aktiv ist, zeigt sie Test mode is on: orders are paid in the PayFast sandbox, no real money is charged. In der Liste der Zahlungsarten wird PayFast als einrichtungsbedürftig markiert, bis Merchant ID und Merchant Key des aktuellen Modus eingetragen sind.

Allgemein

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

Title: der Name der Zahlungsart, den der Kunde an der Kasse sieht. Standard: PayFast.

Description: der Text unter der Zahlungsart an der Kasse. Standard: Pay securely by card, Instant EFT and other methods on the PayFast payment page.

PayFast-Konto (Live)

Ihre Merchant ID und Ihren Merchant Key finden Sie im PayFast-Dashboard unter Settings > Developer Settings. Haben Sie dort eine Passphrase festgelegt, geben Sie hier genau dieselbe Passphrase ein.

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

Merchant Key: Ihr Live-Merchant-Key bei PayFast. Er wird mit jedem Zahlungsformular an PayFast gesendet.

Passphrase: die Salt-Passphrase aus PayFast, 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 Testhändler ist 10000100 / 46f0cd694581a).

Test mode: Use the PayFast sandbox and the sandbox credentials below. An der Kasse sieht der Kunde TEST MODE: payments go to the PayFast sandbox, no real money is charged. Standard: an.

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.

Wenn Sie von Version 1.0 im Testmodus aktualisieren, werden Ihre vorhandenen Zugangsdaten in die Sandbox-Felder kopiert. Prüfen Sie die Live-Zugangsdaten, bevor Sie den Testmodus ausschalten.

Zahlungsbenachrichtigungen (ITN)

PayFast bestätigt jede Zahlung mit einer Server-zu-Server-Benachrichtigung an die URL, die in diesem Abschnitt angezeigt wird. Sie hat dieses Format: https://your-site/wc-api/payfast_pay/. Die Adresse wird mit jeder Zahlung übermittelt, daher muss in PayFast nichts eingerichtet werden, aber sie muss aus dem Internet erreichbar sein.

Herkunftsprüfung: Accept live notifications only from PayFast servers. Die Adressen stammen aus den DNS-Einträgen von PayFast. Deaktivieren Sie dies nur, wenn Ihre Website 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: an.

Erweitert

Debug log: Log payment steps schreibt die Schritte nach WooCommerce > Status > Logs, Quelle wcp_payfast_pay. Fehler werden immer protokolliert. Passphrasen und Kundendaten werden nicht geschrieben. Standard: aus.

Uninstall: Delete the gateway settings and logs when the plugin is deleted. Standard: aus.

Kasse

Der Kunde wählt die Zahlungsart (standardmäßig PayFast) und gibt die Bestellung auf. Der Kunde gelangt auf die Seite Pay for order der Bestellung, die Thank you for your order. You are being redirected to PayFast to complete the payment. anzeigt, und das signierte Zahlungsformular wird automatisch an PayFast gesendet. Wenn der Browser nicht von selbst weiterleitet, klickt der Kunde auf Pay with PayFast; mit Cancel order wird die Bestellung storniert. Das Formular enthält den Bestellbetrag in ZAR, Order # mit der Bestellnummer, Name und E-Mail des Kunden sowie den Bestellschlüssel. Es wird bei jedem Öffnen der Seite neu erstellt, sodass der Kunde es nach der Rückkehr von PayFast erneut öffnen kann.

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

Die Rückkehr des Kunden zur Seite „Bestellung eingegangen“ ändert die Bestellung nicht. Solange die Benachrichtigung nicht eingetroffen ist, zeigt die Seite PayFast is confirming your payment. You will receive an e-mail as soon as it is confirmed — there is no need to pay again. Ist die Bestellung in Wartestellung, heißt es Your payment is being reviewed. We will contact you if anything else is needed.

Storniert der Kunde auf der PayFast-Seite, wird die Bestellung auf die übliche WooCommerce-Weise storniert. Verlässt der Kunde die Seite, ohne zu zahlen, bleibt die Bestellung unbezahlt und kann über die Seite Pay for order erneut bezahlt werden.

Die Zahlungsart funktioniert in der klassischen Kasse, im Kassen-Block und auf der Seite Pay for order. Sie wird ausgeblendet, wenn die Zugangsdaten des aktuellen Modus fehlen, wenn die Shop- oder Bestellwährung nicht ZAR ist oder wenn der Gesamtbetrag unter R5.00 liegt. Sie ist mit WooCommerce High-Performance Order Storage (HPOS) kompatibel.

Das Plugin nimmt nur einmalige Zahlungen in ZAR an. Es bietet keine Erstattungen aus WooCommerce, keine Abonnements, keine gespeicherten (tokenisierten) Karten, keine Vorbestellungen und keine Split-Zahlungen.

Bestellungen

Bestellstatus

Pending payment: der Kunde wurde zu PayFast geschickt, und die Zahlungsbenachrichtigung ist noch nicht eingetroffen.

Processing: PayFast hat die Zahlung bestätigt. Dies ist der Standardstatus von WooCommerce nach der Zahlung; Bestellungen, die nur virtuelle herunterladbare Produkte enthalten, werden auf Abgeschlossen gesetzt. Die Bestellnotiz zeigt die PayFast-Zahlungs-ID, die auch die Transaktions-ID der Bestellung ist. Eine Sandbox-Zahlung erhält die Notiz, dass kein echtes Geld abgebucht wurde. Die PayFast-Gebühr und der Nettobetrag werden in der Bestellung gespeichert.

On hold: PayFast hat die Zahlung als ausstehend gemeldet; oder der bezahlte Betrag weicht von der Bestellsumme ab, oder die Bestellung ist nicht in ZAR; oder eine Zahlung ist für eine bereits stornierte Bestellung eingegangen. Die Bestellnotiz erklärt es. Prüfen Sie die Bestellung und Ihr PayFast-Dashboard und versenden Sie die Bestellung dann oder erstatten Sie die Zahlung in PayFast.

Failed: PayFast hat die Zahlung als fehlgeschlagen gemeldet, während die Bestellung unbezahlt war. Der Kunde kann erneut bezahlen.

Cancelled: der Kunde hat auf der PayFast-Seite storniert, oder Sie haben die Bestellung storniert, oder sie wurde durch das Zeitlimit der WooCommerce-Lagerreservierung storniert.

Eine wiederholte Benachrichtigung zur selben Zahlung ändert nichts. Trifft eine weitere abgeschlossene Zahlung für eine bereits bezahlte Bestellung ein, erinnert eine Notiz Sie daran, das Duplikat in PayFast zu erstatten. Eine Zahlung für eine erstattete Bestellung fügt nur eine Notiz hinzu. Eine Sandbox-Zahlung, die eingeht, während das Gateway im Live-Modus läuft, fügt eine Notiz hinzu und markiert die Bestellung nicht als bezahlt.

Erstattungen

Erstattungen aus WooCommerce werden nicht unterstützt. Erstatten Sie die Zahlung in Ihrem PayFast-Dashboard und legen Sie danach in WooCommerce eine manuelle Erstattung an.

Lizenzschlüssel

Das Plugin arbeitet mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock befindet sich oben unter WooCommerce > Settings > Payments > PayFast. Fügen Sie den Schlüssel in License key ein und klicken Sie auf Activate. Der Block zeigt den Status, etwa 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 Website. Der Link Manage licenses and domains in your account öffnet Ihr vibefox.net-Konto.

Ein Schlüssel funktioniert für eine Domain. Das Entfernen des Schlüssels von einer Website gibt deren 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. Angemeldete Shop-Manager sehen die Zahlungsart weiterhin, markiert mit (unlicensed — visible to admins only), sodass Sie das Plugin vor dem Kauf eines Schlüssels einrichten und testen können. Ein Hinweis erscheint auf der Plugins-Seite und auf WooCommerce-Seiten. Bestehende Bestellungen sind nicht betroffen: bereits gestartete Zahlungen werden weiterhin bestätigt.

Läuft eine Lizenz ab, arbeitet das Plugin weiter; Updates und Support erfordern jedoch eine Verlängerung. Der Status wird im Hintergrund automatisch erneut geprüft.

Fehlerbehebung

PayFast erscheint nicht an der Kasse: prüfen Sie, ob die Lizenz aktiv ist, Enable/Disable eingeschaltet ist, Merchant ID und Merchant Key des aktuellen Modus ausgefüllt sind, die Shop-Währung ZAR ist und der Gesamtbetrag mindestens R5.00 beträgt. Die Einstellungsseite zeigt eine Warnung, wenn etwas fehlt.

Die Zahlung ist erfolgt, aber die Bestellung bleibt auf „Ausstehende Zahlung“: PayFast konnte die Zahlungsbenachrichtigung nicht zustellen oder sie wurde abgelehnt. Aktivieren Sie das Debug log und prüfen Sie WooCommerce > Status > Logs, Quelle wcp_payfast_pay. Typische Ursachen: Die Website ist nicht aus dem Internet erreichbar (Wartungsmodus, Basic-Authentifizierung, Firewall), in PayFast und im Plugin ist eine unterschiedliche Passphrase hinterlegt, oder – im Live-Modus hinter einem Proxy oder CDN – die Herkunftsprüfung. Schalten Sie in diesem Fall Source check aus.

Die Benachrichtigung antwortet Invalid signature: die Passphrase im Plugin ist nicht die, die für diesen Modus in PayFast festgelegt wurde.

Die Benachrichtigung antwortet 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 Ihre Website hinter einem Proxy oder CDN liegt.

Die Benachrichtigung antwortet Merchant mismatch oder Order mismatch: die Zahlung wurde an ein anderes PayFast-Konto gesendet oder gehört nicht zu dieser Bestellung. Es wird nichts geändert.

Die Benachrichtigung antwortet Confirmation unavailable oder Busy: PayFast konnte für die Serverbestätigung nicht erreicht werden, oder eine andere Benachrichtigung zur selben Bestellung wurde im selben Moment verarbeitet. PayFast wiederholt die Benachrichtigung.

Die Benachrichtigung antwortet Not configured: die Zugangsdaten des Modus, in dem die Bestellung bezahlt wurde, fehlen.

Der Kunde sieht PayFast accepts payments from R5.00: der Gesamtbetrag der Bestellung liegt unter dem PayFast-Mindestbetrag.

Bestellung steht auf On hold: PayFast hat eine Zahlung bestätigt, die nicht zur Bestellung passt (anderer Betrag oder eine Währung außer ZAR), oder die Zahlung ist für eine bereits stornierte Bestellung eingegangen. Prüfen Sie die Bestellnotizen und Ihr PayFast-Dashboard.

Eine Sandbox-Zahlung hat die Bestellung nicht bezahlt: das Gateway ist im Live-Modus. Sandbox-Zahlungen bezahlen im Live-Modus nie eine Bestellung; eine Notiz an der Bestellung weist darauf hin.

Der Lizenzblock zeigt einen Fehler: folgen Sie der Meldung im Block. Ist der Schlüssel zum Beispiel bereits auf einer anderen Domain verwendet, geben Sie in Ihrem vibefox.net-Konto einen Platz frei und klicken Sie auf Check now. Hat sich die Adresse der Website geändert, klicken Sie auf Check now, um den Schlüssel für die neue Domain zu aktivieren. Kann der Lizenzserver nicht erreicht werden, 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 Einstellungen der Zahlungsart, die übrigen Optionen des Plugins, die zwischengespeicherten PayFast-Adressen und seine Protokolle werden nur entfernt, wenn Delete the gateway settings and logs when the plugin is deleted aktiviert war. Andernfalls bleiben sie für eine spätere Neuinstallation erhalten. Bestehende Bestellungen behalten ihre Zahlungsnotizen und Transaktions-IDs.

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