VibeFox Peach Payments for WooCommerce — Hilfe

Anforderungen

WordPress: 6.2 oder neuer.

WooCommerce: 8.0 oder neuer, installiert und aktiv. Ohne diese Erweiterung lässt sich das Plugin nicht aktivieren.

PHP: 8.0 oder neuer.

Currency: Die Shopwährung muss ZAR, KES oder MUR sein. Bei anderen Währungen wird die Zahlungsart ausgeblendet und die Einstellungsseite weist darauf hin.

Peach Payments account: Sie benötigen die Card API-Zugangsdaten Ihres Peach Payments-Kontos: Entity ID und Access Token. Test-Zugangsdaten stammen aus dem Peach Payments-Sandbox-Dashboard, Live-Zugangsdaten aus dem Peach Payments-Dashboard; sie unterscheiden sich. Für Webhooks benötigen Sie außerdem einen Entschlüsselungsschlüssel, den Peach Payments Ihnen beim Aktivieren der Card-Webhooks für Ihren Shop sendet (siehe Konfiguration). Ihre Website muss für Webhooks aus dem Internet erreichbar sein.

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

Installation

1. Öffnen Sie in WordPress Plugins > Add New > Upload Plugin, wählen Sie die ZIP-Datei des Plugins und klicken Sie auf Install Now. Sie können auch den Ordner wcp_peach_pay per FTP nach /wp-content/plugins/ hochladen.

2. Klicken Sie auf Activate.

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

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

5. Geben Sie Test-Entity ID und Access Token aus dem Peach Payments-Sandbox-Dashboard ein und bitten Sie Peach Payments, Card-Webhooks für die in den Einstellungen angezeigte Webhook-URL zu aktivieren (siehe Konfiguration).

6. Aktivieren Sie Enable/Disable und speichern Sie. Lassen Sie Test mode aktiviert und zahlen Sie mit einer Testkarte der Peach Payments-Sandbox. Deaktivieren Sie anschließend Test mode, geben Sie Live-Zugangsdaten und Live-Webhook-Schlüssel ein und speichern Sie.

Die Einstellungen der Version 1.0 werden nach dem Update automatisch in die neuen Felder übertragen.

Konfiguration

Alle Einstellungen befinden sich auf einer Seite: WooCommerce > Settings > Payments > Peach Payments. Oberhalb der Felder erscheinen Hinweise: Test mode is on: payments go to the Peach Payments sandbox and no real money is charged.; ein Hinweis bei fehlender Entity ID oder fehlendem Access Token des aktuellen Modus (bis dahin erscheint die Zahlungsart nicht an der Kasse); ein Hinweis bei fehlendem Webhook-Entschlüsselungsschlüssel des aktuellen Modus (dann werden Zahlungen erst bei der Rückkehr des Kunden bestätigt); und ein Hinweis bei nicht unterstützter Shopwährung. In der Zahlungsartenliste wird Peach Payments als einzurichten markiert, bis der aktuelle Modus eine Entity ID und einen Access Token hat. Beim Speichern werden Leerzeichen aus den Zugangsdaten entfernt; ist der Webhook-Schlüssel kein hexadezimaler Wert mit 64 Zeichen, erscheint ein Fehler.

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

Title: der dem Kunden an der Kasse angezeigte Name der Zahlungsart. Standard: Credit / Debit Card (Peach Payments).

Description: der Text unter der Zahlungsart an der Kasse. Standard: Pay securely with your card. You will enter the card details in the Peach Payments form on the next page.

API-Zugangsdaten

Access Token und Entity ID der Card API stehen im Peach Payments-Dashboard (Test-Zugangsdaten im Sandbox-Dashboard). Der Abschnitt verlinkt beide Dashboards und die Peach Payments-Entwicklerdokumentation.

Test mode: Enable test mode sendet neue Zahlungen mit den Test-Zugangsdaten an die Peach Payments-Sandbox; echtes Geld wird nicht belastet. Deaktivieren Sie es für echte Zahlungen mit den Live-Zugangsdaten. Eine in einem Modus begonnene Zahlung wird immer in diesem Modus geprüft, auch nach einem Wechsel. Standard: ein.

Test Entity ID: die Entity ID (3-D Secure-Kanal) Ihres Sandbox-Kontos.

Test Access Token: das Bearer-Zugriffstoken Ihres Sandbox-Kontos.

Test Webhook Decryption Key: der hexadezimale Schlüssel mit 64 Zeichen zum Entschlüsseln der Card-Webhooks der Sandbox.

Live Entity ID: die Entity ID (3-D Secure-Kanal) Ihres Live-Kontos.

Live Access Token: das Bearer-Zugriffstoken Ihres Live-Kontos.

Live Webhook Decryption Key: der hexadezimale Schlüssel mit 64 Zeichen zum Entschlüsseln der Card-Webhooks des Live-Kontos.

Webhook

Webhooks bestätigen Zahlungen auch dann, wenn der Kunde den Browser vor der Rückkehr zum Shop schließt. Der Abschnitt zeigt die Webhook-URL Ihres Shops, etwa https://your-site/wp-json/peach-pay/v1/webhook. Kopieren Sie die URL genau wie in den Einstellungen angezeigt. Bitten Sie Peach Payments (support@peachpayments.com), Card-Webhooks für Ihr Konto mit dieser URL zu aktivieren, und tragen Sie den erhaltenen Entschlüsselungsschlüssel im Feld Webhook Decryption Key desselben Modus ein.

Peach Payments verschlüsselt jeden Webhook (AES-256-GCM). Ein Webhook, der sich mit keinem Test- oder Live-Schlüssel entschlüsseln lässt, wird abgewiesen, sodass nur Peach Payments Ihre Bestellungen ändern kann. Ein mit dem Schlüssel eines Modus entschlüsselter Webhook gilt nur für in diesem Modus begonnene Zahlungen. Das Plugin verwendet Zahlungsbenachrichtigungen:

Andere Benachrichtigungen, etwa die Testbenachrichtigung beim Aktivieren des Webhooks, werden mit OK beantwortet und ignoriert. Ohne Webhook-Schlüssel wird eine Bestellung erst bestätigt, wenn der Kunde nach der Zahlung zum Shop zurückkehrt.

Zahlungsformular

Card brands: die im Peach Payments-Formular angezeigten Marken: Visa, Mastercard, American Express, Diners Club. Wählen Sie nur für Ihre Entity ID freigeschaltete Marken. Standard: Visa und Mastercard.

Erweitert

Logging: Log API requests and payment results schreibt Debug-Informationen nach WooCommerce > Status > Logs, Quelle wcp_peach_pay. Fehler und Warnungen werden immer protokolliert. Protokolle enthalten keine Kartendaten, Schlüssel oder Kundendaten. Standard: aus.

Delete data on uninstall: Delete the plugin settings and logs when the plugin is deleted. Eine Deaktivierung des Plugins löscht niemals Daten. In Bestellungen gespeicherte Peach Payments-Daten bleiben erhalten. Standard: aus.

Kasse

Der Kunde wählt die Zahlungsart (standardmäßig Credit / Debit Card (Peach Payments)) und klickt auf Continue to payment. Er gelangt zur Seite Pay for order Ihres Shops. Dort bereitet das Plugin einen Peach Payments-Checkout über den Gesamtbetrag in der Bestellwährung vor und zeigt das Peach Payments-Kartenformular mit den ausgewählten Marken in der Sprache der Website, sofern Peach Payments sie unterstützt. Im Testmodus erscheint Test mode: use a Peach Payments test card, no real payment will be made.. Die Kartendaten werden im Peach Payments-Formular eingegeben; das Formularskript wird mit einem Subresource Integrity-Hash geladen.

Nach der Zahlung kehrt der Kunde zum Shop zurück. Die Bestellung wird erst nach Bestätigung durch Peach Payments als bezahlt markiert: Der Shop liest das Checkout-Ergebnis dieser Bestellung über die Peach Payments API im ursprünglichen Modus aus und prüft, ob die Zahlung zu dieser Bestellung gehört. Der Webhook tut dies unabhängig ebenfalls: Was zuerst eintrifft, wendet das Ergebnis an, das andere ändert nichts. Der zahlende Kunde sieht die Seite Order received.

Wird die Zahlung nicht abgeschlossen, kehrt der Kunde mit einer Meldung zur Seite Pay for order zurück und kann es erneut versuchen: Payment failed: gefolgt vom Grund von Peach Payments und Please try again or use another card. oder The payment was not completed. Please try again.. Kann das Ergebnis noch nicht bestätigt werden (etwa weil Peach Payments nicht antwortet oder der Webhook gerade dieselbe Bestellung verarbeitet), erscheint We could not confirm your payment yet. If you were charged, the order will be updated automatically; otherwise please try again.. Ist für den Modus kein Webhook-Schlüssel hinterlegt, wird der Kunde stattdessen gebeten, Ihnen die Bestellnummer mitzuteilen.

Kann das Zahlungsformular nicht vorbereitet werden, sieht der Kunde eine kurze Meldung und die Schaltfläche Try again: The payment form is not available right now (payment configuration error). Please contact us or choose another payment method. (falsche Zugangsdaten), eine Meldung über vom Zahlungsanbieter abgelehnte Rechnungsdaten oder The payment form could not be loaded. Please try again in a moment.. Die Bestellung erhält eine Notiz mit Peach Payments-Code und Beschreibung.

Die Zahlungsart funktioniert in der klassischen Kasse, im Kassen-Block und auf der Seite Pay for order. Sie ist mit WooCommerce High-Performance Order Storage (HPOS) kompatibel.

Das Plugin bietet kein Kartenformular direkt auf der Kassenseite, keine gespeicherten Karten, Abonnements, Vorautorisierung und Erfassung sowie keine EFT-, BNPL-, QR- oder anderen Verfahren ohne Karte.

Bestellungen

Bestellstatus

Pending payment: Der Kunde hat noch nicht bezahlt oder die Zahlung wurde nicht abgeschlossen. Er kann dieselbe Bestellung erneut bezahlen.

Processing: Die Zahlung wurde bestätigt; Betrag und Währung stimmen mit der Bestellung überein. Die Bestellnotiz zeigt Ergebniscode, Beschreibung und Zahlungs-ID von Peach Payments; diese ist die Transaktions-ID der Bestellung. Hat Peach Payments die Zahlung zur manuellen Prüfung markiert, bittet die Notiz Sie um Prüfung im Peach Payments-Dashboard vor dem Versand.

On hold: Die Zahlung wartet auf Bestätigung durch Peach Payments (der Webhook schließt sie später ab oder markiert sie als fehlgeschlagen); Betrag oder Währung weichen ab (Notiz amount/currency mismatch — manual review required); oder die Zahlung traf nach der Stornierung ein. Die Bestellnotiz erklärt, was zu prüfen ist.

Failed: Peach Payments hat die Zahlung einer Bestellung mit ausstehender Zahlung oder die erwartete Zahlung einer wartenden Bestellung abgelehnt. Ein abgelehnter Versuch ändert niemals eine bezahlte, aus anderem Grund wartende oder stornierte Bestellung. Der Kunde kann erneut bezahlen.

Gelingt eine zweite Zahlung einer bereits bezahlten Bestellung, bleibt die Bestellung unverändert. Eine Notiz kennzeichnet die doppelte Zahlung und bittet um Erstattung im Peach Payments-Dashboard. Eine Zahlung für eine erstattete Bestellung wird nur als Notiz erfasst.

Erstattungen

Erstattungen über die WooCommerce-Bestellseite sind nicht verfügbar. Erstatten Sie im Peach Payments-Dashboard und erfassen Sie eine manuelle Erstattung in WooCommerce. Bei eingerichtetem Webhook werden Erstattungen, Stornierungen und Chargebacks aus Peach Payments als Notizen mit Betrag und ID hinzugefügt; der Bestellstatus bleibt unverändert.

Lizenzschlüssel

Das Plugin funktioniert mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock steht oben auf WooCommerce > Settings > Payments > Peach Payments. Fügen Sie den Schlüssel in License key ein und klicken Sie auf Activate. Der Block zeigt den Status, etwa das Gültigkeitsdatum 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 von einer Website gibt den Domainplatz nicht frei. Geben Sie ihn in Ihrem vibefox.net-Konto frei.

Ohne aktiven Schlüssel erscheint Peach Payments nicht für Kunden an der Kasse. Wird dennoch eine Zahlung gestartet, sieht der Kunde This payment method is not available. Please choose another one.. Angemeldete Shopmanager sehen die Zahlungsart weiterhin mit (unlicensed — visible to admins only), damit Sie das Plugin vor dem Schlüsselkauf einrichten und testen können. Eine Erinnerung erscheint auf der Plugin-Seite und den WooCommerce-Seiten. Bestehende Bestellungen bleiben unberührt: Bereits begonnene Zahlungen werden weiterhin durch Kundenrückkehr und Webhook bestätigt.

Nach Ablauf der Lizenz funktioniert das Plugin weiter; Updates und Support erfordern jedoch eine Verlängerung. Der Status wird automatisch im Hintergrund erneut geprüft.

Fehlerbehebung

Peach Payments erscheint nicht an der Kasse: Prüfen Sie, ob die Lizenz aktiv und Enable/Disable eingeschaltet ist, Entity ID und Access Token des aktuellen Modus eingetragen sind (Test Entity ID und Test Access Token im Testmodus, Live Entity ID und Live Access Token im Live-Modus) und die Shopwährung ZAR, KES oder MUR ist. Die Hinweise oben in den Einstellungen nennen das Problem. Entwickler können die Währungsliste mit dem Filter peach_p_supported_currencies ändern; ergänzen Sie nur Währungen, die Ihr Peach Payments-Konto verarbeitet.

Die Zahlung war erfolgreich, aber die Bestellung bleibt Pending payment: Der Kunde ist nicht zurückgekehrt und der Webhook ist nicht eingetroffen. Prüfen Sie, ob Peach Payments Card-Webhooks für exakt die angezeigte URL aktiviert hat, die Webhook Decryption Key des Zahlungsmodus eingetragen ist und weder Wartungsmodus, Firewall noch Passwortschutz die URL blockiert. Suchen Sie unter WooCommerce > Status > Logs, Quelle wcp_peach_pay, nach abgewiesenen Webhooks.

Webhook antwortet Decryption failed: Der Webhook ließ sich mit keinem Test- oder Live-Schlüssel entschlüsseln. Der Schlüssel ist falsch oder gehört zu einem anderen Konto oder Modus. Geben Sie den von Peach Payments für diese Webhook-URL gesendeten Schlüssel ein.

Webhook antwortet Webhook key not configured: Kein Webhook-Schlüssel ist hinterlegt oder gültig. Geben Sie den Schlüssel mit 64 Zeichen ein. Peach Payments sendet den Webhook später erneut.

Webhook antwortet Order busy, retry later: Die Bestellung wurde gleichzeitig durch die Kundenrückkehr aktualisiert. Nichts wurde geändert; Peach Payments sendet den Webhook erneut.

Webhook antwortet Missing or malformed data: Die Anfrage enthielt keinen verschlüsselten Inhalt oder keine X-Initialization-Vector / X-Authentication-Tag-Header, etwa durch Änderungen eines Proxys. Nichts wurde geändert.

Webhook antwortet ignored: Die Benachrichtigung ist echt, gehört aber zu keinem Checkout dieses Shops (anderer Shop mit derselben Entity ID, gelöschte Bestellung) oder stammt aus einem anderen Modus als die Zahlung. Nichts wurde geändert.

Der Kunde sieht The payment form is not available right now: Access Token oder Entity ID des aktuellen Modus ist falsch. Prüfen Sie Zugangsdaten und Modus und lesen Sie den Peach Payments-Code in der Bestellnotiz.

Die Bestellung steht nach der Zahlung auf On hold: Lesen Sie die Bestellnotiz. Betrag oder Währung wichen ab, die Zahlung kam nach der Stornierung an oder Peach Payments wartet noch auf Bestätigung. Prüfen Sie die Zahlung im Peach Payments-Dashboard und bearbeiten Sie dann die Bestellung oder erstatten Sie die Zahlung.

Beim Speichern wird ein hexadezimaler Webhook-Schlüssel mit 64 Zeichen verlangt: Der Wert ist nicht der Schlüssel von Peach Payments. Bis zur Korrektur können Webhooks nicht entschlüsselt werden.

Der Lizenzblock zeigt einen Fehler: Befolgen Sie die Meldung. Wird der Schlüssel bereits auf einer anderen Domain verwendet, geben Sie einen Platz in Ihrem vibefox.net-Konto frei und klicken Sie auf Check now. Hat sich die Websiteadresse 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 letzten bekannten Status weiter.

Deinstallation

Beim Deaktivieren bleiben alle Daten erhalten. Zum Entfernen deaktivieren und löschen Sie das Plugin auf der Seite Plugins. Lizenzschlüssel und Lizenzstatus werden immer entfernt. Einstellungen und Protokolle (Protokolldateien und Datenbank-Protokolleinträge der Quelle wcp_peach_pay) werden nur entfernt, wenn Delete data on uninstall aktiviert war. Andernfalls bleiben sie für eine spätere Neuinstallation erhalten. Bestehende Bestellungen behalten Zahlungsnotizen, Transaktions-IDs und Peach Payments-Checkout-Daten.

Peach Payments ist eine Marke des jeweiligen Inhabers. Dieses Plugin ist weder mit Peach Payments verbunden noch von diesem Anbieter empfohlen.