VibeFox Peach Payments 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 mit der OpenSSL-Erweiterung (wird zum Entschlüsseln von Webhooks benötigt).

Währung: Die Kassenwährung des Kunden muss ZAR, KES oder MUR sein. Ihr Shop braucht deshalb mindestens eine dieser Währungen unter System > Localisation > Currencies. Für Kunden, die in anderen Währungen bezahlen, wird die Zahlungsmethode ausgeblendet. Die Einstellungsseite warnt Sie, wenn die Standardwährung des Shops keine dieser Währungen ist.

Peach-Payments-Konto: Sie benötigen die Card-API-Zugangsdaten Ihres Peach-Payments-Kontos: die Entity ID und das Access Token. Testzugangsdaten stammen aus dem Sandbox-Dashboard von Peach Payments, Live-Zugangsdaten aus dem regulären Dashboard; sie sind unterschiedlich. Für Webhooks benötigen Sie außerdem einen Webhook-Entschlüsselungsschlüssel, den Peach Payments Ihnen sendet, sobald Card-Webhooks für Ihren Shop aktiviert sind (siehe Konfiguration). Ihr Shop muss aus dem Internet erreichbar sein, um Webhooks zu empfangen.

VibeFox-Lizenzschlüssel: wird auf vibefox.net gekauft. Ein Schlüssel gilt für eine Domain.

Installation

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

OpenCart 3

1. Gehen Sie im Admin-Bereich zu Extensions > Installer, klicken Sie auf Upload und wählen Sie die Datei wcp_peach_pay-oc3-(version).ocmod.zip. Die Erweiterung hat keine OCMOD-Änderungen, 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 Peach Payments Pay Gateway und klicken Sie auf Install (der grüne +-Button). Ihr Admin-Benutzer braucht das Recht, die Liste der Zahlungserweiterungen zu ändern.

3. Klicken Sie auf Edit (der Stift-Button), 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 Lizenzschlüssel).

4. Geben Sie die Test-Entity-ID und das Test-Access-Token aus dem Sandbox-Dashboard von Peach Payments ein. Bitten Sie Peach Payments außerdem, Card-Webhooks für die Webhook-URL zu aktivieren, die auf der Einstellungsseite angezeigt wird (siehe Konfiguration).

5. Aktivieren Sie Enable/Disable und klicken Sie auf Save. Lassen Sie Test mode eingeschaltet und führen Sie eine Zahlung mit einer Sandbox-Testkarte von Peach Payments in ZAR, KES oder MUR durch. Schalten Sie danach Test mode aus, geben Sie die Live-Zugangsdaten und den Live-Webhook-Schlüssel ein und klicken Sie auf Save.

OpenCart 4

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

2. Das Paket erscheint auf derselben Seite in der Liste der installierten Erweiterungen. 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 Peach Payments Pay Gateway, klicken Sie auf Install (die grüne +-Schaltfläche) und dann auf Edit (die Stift-Schaltfläche).

4. Geben Sie den Lizenzschlüssel, die Peach-Payments-Zugangsdaten und den Webhook wie in den Schritten 3 bis 5 für OpenCart 3 ein. Die Einstellungsseite und ihre Felder sind in beiden Versionen gleich. Nur die Webhook-URL ist unterschiedlich (siehe Webhook).

Eine neue Installation startet mit ausgeschalteter Zahlungsmethode und eingeschaltetem Testmodus.

Konfiguration

Alle Einstellungen befinden sich auf der Erweiterungsseite: Extensions > Extensions > Payments > VibeFox Peach Payments Pay Gateway > Edit. Die Abschnitte stehen links; der Button Save unter der Liste speichert die gesamte Seite. Über den Einstellungen zeigt die Seite Hinweise an: Test mode is on: payments go to the Peach Payments sandbox and no real money is charged.; einen Fehler, wenn die Entity ID oder das Access Token des aktuellen Modus fehlt (bis dahin wird die Zahlungsmethode an der Kasse nicht angezeigt); eine Warnung, wenn der Webhook-Entschlüsselungsschlüssel des aktuellen Modus fehlt (dann werden Zahlungen nur bestätigt, wenn der Kunde in den Shop zurückkehrt); und einen Hinweis, wenn die Standardwährung des Shops nicht unterstützt wird (die Zahlungsmethode wird dann nur Kunden angezeigt, die in einer unterstützten Währung bezahlen). Ohne das Recht, die Erweiterung zu ändern, zeigt die Seite die Einstellungen, kann sie aber nicht speichern.

Beim Speichern darf Title nicht leer sein und nicht mehr als 128 Zeichen haben (die Seite zeigt Enter a title for the payment method (up to 128 characters).). Sort Order muss eine ganze Zahl sein (negative Werte sind erlaubt), Total eine Zahl von 0 oder größer, und die Geozone und die Bestellstatus müssen existieren. Andernfalls wird nichts gespeichert. Leerzeichen werden aus den Zugangsdaten entfernt. Ein Webhook-Schlüssel, der kein 64-stelliger Hexadezimalwert ist, oder eine leere Liste von Kartenmarken wird mit einer Warnung gespeichert.

Peach Payments

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

Title: der Name der Zahlungsmethode, den der Kunde an der Kasse sieht. Er wird auch als Name der Zahlungsmethode in der Bestellung gespeichert. Standard: Credit / Debit Card (Peach Payments). Pflichtfeld, bis zu 128 Zeichen.

Description: der Text, den der Kunde im Schritt Confirm Order über dem Bestätigungsbutton neben einem Kartensymbol sieht. Standard: Pay securely with your card. You will enter the card details in the Peach Payments form on the next page.

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

Geo Zone: Peach Payments nur für Zahlungsadressen in der ausgewählten Geozone anbieten. Standard: All zones. Geozonen richten Sie unter System > Localisation > Geo Zones ein.

Total: der Kassenbetrag in der Standardwährung des Shops, den eine Bestellung erreichen muss, bevor Peach Payments angeboten wird. Lassen Sie das Feld leer, um es bei jedem Betrag anzubieten.

API-Zugangsdaten

Entity ID und Access Token der Card API finden Sie im Dashboard von Peach Payments (Testzugangsdaten im Sandbox-Dashboard). Der Abschnitt verlinkt auf beide Dashboards und auf die Entwicklerdokumentation von Peach Payments.

Test mode: sendet neue Zahlungen mit den Testzugangsdaten an die Sandbox von Peach Payments; es wird kein echtes Geld belastet. Schalten Sie die Option aus, um echte Zahlungen mit den Live-Zugangsdaten anzunehmen. Eine in einem Modus gestartete Zahlung wird immer in diesem Modus geprüft, auch nachdem Sie umgeschaltet haben. Standard: eingeschaltet. Solange sie eingeschaltet ist, sieht der Kunde im Schritt Confirm Order den Hinweis Test mode: no real payment will be made.

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

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

Test Webhook Decryption Key: der 64-stellige hexadezimale Schlüssel, mit dem die Card-Webhooks der Sandbox entschlüsselt werden.

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

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

Live Webhook Decryption Key: der 64-stellige hexadezimale Schlüssel, mit dem die Card-Webhooks Ihres Live-Kontos entschlüsselt werden.

Gespeicherte Access Tokens und Webhook-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. Um einen gespeicherten Wert zu entfernen, setzen Sie unter dem Feld den Haken bei Clear the saved value on save und klicken Sie auf Save.

Webhook

Webhooks bestätigen Zahlungen auch dann, wenn der Kunde den Browser schließt, bevor er in den Shop zurückkehrt. Das Feld Webhook URL zeigt die Webhook-URL Ihres Shops. Auf OpenCart 3 hat sie das Format https://your-store/index.php?route=extension/payment/wcp_peach_pay/webhook, auf OpenCart 4 https://your-store/index.php?route=extension/wcp_peach_pay/payment/wcp_peach_pay.webhook. Sie wird aus der Shop-Adresse Ihrer OpenCart-Installation gebildet. Kopieren Sie die URL genau so, wie die Einstellungen sie anzeigen. Bitten Sie Peach Payments (support@peachpayments.com), Card-Webhooks für Ihr Konto mit dieser URL zu aktivieren, und tragen Sie danach 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 weder mit dem Test- noch mit dem Live-Schlüssel entschlüsseln lässt, wird abgelehnt, sodass nur Peach Payments Ihre Bestellungen ändern kann. Ein mit dem Schlüssel eines Modus entschlüsselter Webhook wird nur auf Zahlungen angewendet, die in diesem Modus gestartet wurden. Die Erweiterung verwendet diese Zahlungsbenachrichtigungen:

Andere Benachrichtigungen, zum Beispiel die Testbenachrichtigung beim Aktivieren des Webhooks, werden mit ignored beantwortet. Ohne den Webhook-Schlüssel erhält eine Bestellung ihren Status nur, wenn der Kunde nach der Zahlung in den Shop zurückkehrt.

Zahlungsformular

Card brands: die Marken, die im Formular von Peach Payments angezeigt werden: Visa, Mastercard, American Express, Diners Club. Wählen Sie nur Marken aus, die für Ihre Entity ID aktiviert sind. Standard: Visa und Mastercard. Ist keine Marke ausgewählt, zeigt das Speichern eine Warnung, und das Formular zeigt Visa und Mastercard.

Bestellungen

Die Bestellung wird im Schritt Confirm Order ohne Status erstellt (eine fehlende Bestellung) und erhält erst dann einen Status, wenn Peach Payments die Zahlung bestätigt hat. Eine abgelehnte oder abgebrochene Zahlung lässt die Bestellung ohne Status, und der Warenkorb bleibt erhalten. Jedes Feld unten listet Ihre OpenCart-Bestellstatus auf.

Order Status After Payment: wird gesetzt, wenn Peach Payments die Zahlung bestätigt und Betrag und Währung übereinstimmen. Standard: In Bearbeitung.

Awaiting Payment Status: Peach Payments hat eine asynchrone Zahlung gemeldet, die auf eine Bestätigung wartet; der Webhook bestätigt sie später. Standard: Ausstehend, da OpenCart keinen Status On hold hat. Sie können einen eigenen Status unter System > Localisation > Order Statuses anlegen und hier auswählen.

On Hold (Review) Status: manuelle Prüfung: Der bezahlte Betrag oder die Währung weicht von der Bestellung ab, oder eine Zahlung kam, nachdem die Bestellung storniert wurde. Eine Notiz erklärt den Grund. Standard: Ausstehend.

Payment Failed Status: wird gesetzt, wenn die asynchrone Zahlung, auf die die Bestellung wartete, abgelehnt wird. Eine spätere erfolgreiche Zahlung schließt die Bestellung trotzdem ab. Standard: Fehlgeschlagen.

Canceled Status: die Erweiterung setzt ihn nicht. Eine Zahlung für eine Bestellung in diesem Status setzt sie in Prüfung, statt sie wieder zu öffnen. Standard: Storniert.

Refunded Status: die Erweiterung setzt ihn nicht. Eine Zahlung für eine Bestellung in diesem Status wird nur notiert; die Bestellung bleibt unverändert. Standard: Erstattet.

Erweitert

Logging: protokolliert API-Anfragen und Zahlungsergebnisse in peach_p_debug.log.php im Logs-Ordner von OpenCart (storage/logs). Die Datei lässt sich nicht über den Webbrowser lesen, und bei 5 MB wird sie nach peach_p_debug.old.log.php verschoben. Fehler und Warnungen werden immer protokolliert. Protokolle enthalten keine Kartendaten, Schlüssel oder Kundendaten. Standard: aus.

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 eingeschaltet, entfernt die Deinstallation der Erweiterung die Gateway-Einstellungen und das Protokoll. Die Peach-Payments-Daten der Bestellungen (Zahlungsversuche und Zahlungs-IDs) bleiben erhalten, da sie zu den Bestellungen gehören. Standard: aus.

Import / Export

Export: Download JSON speichert die Einstellungen als JSON-Datei. Access Tokens und Webhook-Schlüssel werden nicht exportiert.

Import: fügen Sie zuvor exportiertes JSON ein und klicken Sie auf Import, um die Einstellungen wiederherzustellen. Gespeicherte Access Tokens und Webhook-Schlüssel bleiben erhalten.

Kasse

Im Schritt Payment Method wählt der Kunde die Zahlungsmethode (standardmäßig Credit / Debit Card (Peach Payments)). Im Schritt Confirm Order sieht der Kunde ein Kartensymbol und Ihre Beschreibung. OpenCart erstellt die Bestellung in diesem Schritt, weiterhin ohne Status. Wenn der Kunde auf Confirm Order klickt, bereitet die Erweiterung eine Peach-Payments-Kasse für den Bestellbetrag in der Bestellwährung vor und öffnet die Seite Peach Payments payment Ihres Shops mit Please enter your card details to complete the payment:, dem Kartenformular von Peach Payments und den ausgewählten Kartenmarken, in der Sprache des Kunden, sofern Peach Payments diese unterstützt. Im Testmodus zeigt die Seite Test mode: use a Peach Payments test card, no real payment will be made. Die Kartendaten werden im Formular von Peach Payments eingegeben; das Skript des Formulars wird mit einem Subresource-Integrity-Hash geladen. Der Link Choose another payment method führt zurück zur Kasse. Beim Neuladen der Seite wird dieselbe Kasse bis zu 25 Minuten lang wiederverwendet, sofern sich der Bestellbetrag nicht geändert hat. Auf OpenCart 4 wählt der Kunde die Zahlungsmethode mit der Schaltfläche Choose im Block der Zahlungsmethode im Fenster Payment method options und klickt unten auf der Kassenseite auf Confirm Order.

Nach der Zahlung kehrt der Kunde in Ihren Shop zurück. Die Bestellung wird erst als bezahlt markiert, wenn Peach Payments die Zahlung bestätigt: Der Shop liest das Ergebnis der Kasse dieser Bestellung über die Peach-Payments-API im Modus, in dem die Kasse erstellt wurde, und prüft, ob die Zahlung zu dieser Bestellung gehört. Der Webhook macht dasselbe unabhängig davon; wer zuerst eintrifft, setzt den Bestellstatus, und die andere Meldung ändert nichts. Danach erhält die Bestellung ihren Status auf die übliche OpenCart-Weise, mit den üblichen Bestell-E-Mails und der Bestandsaktualisierung, und der Kunde sieht die Erfolgsseite der OpenCart-Bestellung. Auf OpenCart 4, wenn der Kunde von einer 3-D-Secure-Seite der Bank zurückkehrt, öffnet eine kurze Zwischenseite die Rücksprungadresse Ihres Shops erneut, sodass Warenkorb und Kundenanmeldung erhalten bleiben.

Wird die Zahlung nicht abgeschlossen, kehrt der Kunde mit einer Meldung zur Kasse zurück und kann es erneut versuchen: Payment failed: gefolgt vom Grund aus Peach Payments und Please try again or use another card., oder The payment was not completed. Please try again. Der Warenkorb bleibt erhalten. Kann das Ergebnis noch nicht bestätigt werden (zum Beispiel weil Peach Payments nicht geantwortet hat oder der Webhook genau in diesem Moment denselben Warenkorb verarbeitet), lautet die Meldung 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 der Zahlung kein Webhook-Schlüssel gesetzt, wird der Kunde stattdessen gebeten, sich mit Ihnen in Verbindung zu setzen. Auf OpenCart 4 werden diese Meldungen oberhalb der Kassenseite angezeigt.

OpenCart 3 erstellt jedes Mal eine neue Bestellung, wenn der Schritt Confirm Order angezeigt wird, OpenCart 4 aktualisiert die Bestellung der Kasse. Ein Warenkorb wird aber nur einmal bezahlt: Ist eine andere Bestellung desselben Warenkorbs bereits bezahlt, gelangt der Kunde direkt zur Erfolgsseite.

Auf OpenCart 4 bleibt die Bestellung in der Kasse, bis die Erfolgsseite angezeigt wird. Nach einem abgelehnten Versuch bezahlt der Kunde dieselbe Bestellung erneut mit einer neuen Peach-Payments-Kasse. Wurde diese Bestellung inzwischen geschlossen (zum Beispiel weil die ausstehende Zahlung fehlgeschlagen ist oder Sie sie storniert haben), wird der Kunde mit der Meldung Your previous order is already closed or paid. Please confirm the order again: the cart will be paid with a new order. zur Kasse zurückgeschickt, und das nächste Confirm Order bezahlt eine neue Bestellung. Wurde die Bestellung bezahlt und danach von Ihnen storniert oder erstattet, lautet die Meldung This order was cancelled or refunded by the store. Please contact the store about its payment, or confirm the order again: the cart will be paid with a new order.

Kann das Zahlungsformular nicht vorbereitet werden, bleibt der Kunde im Schritt Confirm Order mit einer kurzen Meldung: The payment form is not available right now (payment configuration error). Please contact us or choose another payment method. (fehlende oder falsche Zugangsdaten), eine Meldung, dass einige Rechnungsdaten vom Zahlungsanbieter nicht akzeptiert wurden, oder The payment form could not be loaded. Please try again in a moment. Der technische Grund wird in das Protokoll geschrieben.

Der Webhook funktioniert auch, während der Shop im Wartungsmodus ist, weil OpenCart Anfragen für Zahlungserweiterungen durchlässt. Auf OpenCart 4 fügt die Erweiterung dafür eine eigene Startaktion hinzu, die außerdem die Rückkehr des Kunden zulässt.

Die Erweiterung hat auf der Kassenseite selbst kein Kartenformular, keine gespeicherten Karten, keine Abonnements, keine Vorautorisierung mit anschließender Erfassung und keine EFT-, BNPL-, QR- oder sonstigen Nicht-Kartenmethoden.

Bestellungen

Bestellstatus

Kein Status (fehlende Bestellung): der Kunde hat nicht bezahlt, die Zahlung wurde abgelehnt oder nicht abgeschlossen, oder Peach Payments hat sie noch nicht bestätigt. Der Kunde kann erneut bezahlen. In Sales > Orders werden solche Bestellungen nur mit dem Filter Order Status auf Missing Orders angezeigt. Auf OpenCart 4.1 kann eine solche Bestellung auch den Status Voided haben, den OpenCart setzt, wenn der Bestätigungsschritt erneut angezeigt wird; die Erweiterung zählt sie als Bestellung ohne Status.

Order Status After Payment (default Processing): die Zahlung wurde bestätigt, und Betrag und Währung stimmen mit der Bestellung überein. Eine Notiz zeigt den Ergebniscode, die Beschreibung und die Zahlungs-ID von Peach Payments. Hat Peach Payments die Zahlung zur manuellen Prüfung markiert, bittet Sie die Notiz, sie vor dem Versand im Peach-Payments-Dashboard zu prüfen.

Awaiting Payment Status (default Pending): Peach Payments hat eine Zahlung gemeldet, die auf eine Bestätigung wartet. Der Webhook setzt die Bestellung später auf Order Status After Payment oder auf Payment Failed Status.

On Hold (Review) Status (default Pending): der bezahlte Betrag oder die Währung weicht von der Bestellung ab (Notiz amount/currency mismatch — manual review required), oder die Zahlung kam, nachdem die Bestellung storniert wurde. Prüfen Sie die Zahlung im Peach-Payments-Dashboard und bearbeiten Sie dann die Bestellung oder erstatten Sie die Zahlung.

Payment Failed Status (default Failed): Peach Payments hat die Zahlung abgelehnt, auf die die ausstehende Bestellung wartete. Ein abgelehnter Versuch ändert nie eine Bestellung, die bezahlt ist oder in Prüfung steht.

Gelingt eine zweite Zahlung für eine bereits bezahlte Bestellung oder eine Zahlung für eine andere Bestellung eines bereits bezahlten Warenkorbs, bleibt die bezahlte Bestellung unverändert. Eine Notiz weist auf eine doppelte Zahlung hin und bittet darum, sie im Peach-Payments-Dashboard zu erstatten. Eine Zahlung, die für eine erstattete Bestellung eingeht, wird nur an der Bestellung vermerkt.

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

Registerkarte VibeFox Peach Payments Pay Gateway

Öffnen Sie unter Sales > Orders eine mit Peach Payments bezahlte Bestellung. Unten auf der Bestellseite, neben History und Additional, zeigt die Registerkarte der Erweiterung die Payment ID (bei Testzahlungen mit der Kennzeichnung Test mode), die Checkout ID, die Merchant transaction ID, den Amount sent to Peach Payments, das Result mit dem Ergebniscode und die Peach Payments notes der Bestellung. Die Registerkarte wird Benutzern angezeigt, die Zugriff auf die Erweiterung haben.

Erstattungen

Erstattungen aus OpenCart sind nicht verfügbar. Erstatten Sie die Zahlung im Peach-Payments-Dashboard und erfassen Sie sie bei Bedarf in OpenCart. Ist der Webhook eingerichtet, werden in Peach Payments vorgenommene Erstattungen, Stornierungen und Chargebacks mit Betrag und ID den Bestellnotizen hinzugefügt; der Bestellstatus ändert sich nicht. Produktrücksendungen unter Sales > Returns erstatten kein Geld über Peach Payments.

Lizenzschlüssel

Die Erweiterung funktioniert mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock License — VibeFox Peach Payments Pay Gateway ist der erste Block unter Extensions > Extensions > Payments > VibeFox Peach Payments Pay Gateway > Edit, über den 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 Buttons Check now zum erneuten Prüfen des Status, Change key zum Eingeben eines anderen Schlüssels und Remove key, um den Schlüssel aus diesem Shop zu entfernen. Darunter stehen die Zeile Product: opencart-payment-peach und der Link Lizenzen und Domains in Ihrem Konto verwalten, der Ihr vibefox.net-Konto öffnet. Nur Admin-Benutzer mit dem Recht „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, zeigt 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 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 gilt 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 Peach Payments 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 Admin-Bereich im selben Browser angemeldet ist, sieht die Zahlungsmethode im Shop weiterhin, markiert als (unlicensed — visible to admins only). So können Sie die Erweiterung vor dem Kauf eines Schlüssels einrichten und testen. Auf OpenCart 4 ist diese Vorschau nicht verfügbar: Die Shop-Seite sieht die Admin-Anmeldung nicht, daher wird die Zahlungsmethode ohne aktiven Schlüssel für alle ausgeblendet. Nachdem Sie die Seite Edit einmal geöffnet haben, erscheint auf dem Dashboard des Admin-Bereichs eine Erinnerung. Mit × schließen Sie sie; sie bleibt dann 7 Tage ausgeblendet. Bestehende Bestellungen sind nicht betroffen: Bereits gestartete Zahlungen werden weiterhin durch die Rückkehr des Kunden und den Webhook bestätigt.

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

Fehlerbehebung

Peach Payments erscheint nicht an der Kasse: prüfen Sie, ob die Lizenz aktiv ist, Enable/Disable eingeschaltet ist, die Entity ID und das 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 der Kunde in ZAR, KES oder MUR bezahlt. Prüfen Sie außerdem, ob die Zahlungsadresse in der ausgewählten Geo Zone liegt und ob die Bestellung den in den Einstellungen festgelegten Total-Betrag erreicht. Die Hinweise oben auf der Einstellungsseite benennen das Problem.

Die Zahlung ist durchgegangen, aber die Bestellung bleibt ohne Status: der Kunde ist nicht in den Shop zurückgekehrt, und der Webhook ist nicht angekommen. Prüfen Sie, ob Peach Payments Card-Webhooks genau für die auf der Einstellungsseite angezeigte URL aktiviert hat, ob der Webhook Decryption Key des Modus eingetragen ist, in dem bezahlt wurde, und ob keine Firewall und kein Passwortschutz die URL blockiert. Aktivieren Sie Logging und sehen Sie im Feld Log nach abgelehnten Webhooks.

Der Webhook antwortet Decryption failed: der Webhook konnte weder mit dem Test- noch mit dem Live-Schlüssel entschlüsselt werden. Der Schlüssel ist falsch oder gehört zu einem anderen Konto oder Modus. Geben Sie den Schlüssel ein, den Peach Payments für diese Webhook-URL gesendet hat.

Der Webhook antwortet Webhook key not configured: es ist weder ein Webhook-Schlüssel gesetzt noch ein gültiger. Geben Sie den 64-stelligen Schlüssel ein. Peach Payments sendet den Webhook später erneut.

Der Webhook antwortet Busy, retry later: der Warenkorb wurde im selben Moment durch die Rückkehr des Kunden verarbeitet. Es wurde nichts geändert, und Peach Payments sendet den Webhook erneut. Das Protokoll zeigt den Grund.

Der Webhook antwortet Missing or malformed data: die Anfrage hatte keinen verschlüsselten Inhalt oder keine Header X-Initialization-Vector / X-Authentication-Tag, zum Beispiel weil ein Proxy sie verändert hat. Es wurde nichts geändert.

Der Webhook antwortet ignored: die Benachrichtigung ist echt, gehört aber zu keiner Kasse dieses Shops (anderer Shop mit derselben Entity ID) oder stammt aus einem anderen Modus als die Zahlung. Es wurde nichts geändert.

Die Webhook-URL zeigt im Browser Method not allowed: das ist normal. Die URL akzeptiert nur Anfragen von Peach Payments.

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

Der Kunde sieht The payment session was not found. Please confirm the order again.: die Zahlungsseite wurde für eine Bestellung geöffnet, die nicht mehr die aktuelle Bestellung des Kunden ist, oder die Zahlungsmethode wurde inzwischen ausgeschaltet. Der Kunde bestätigt die Bestellung erneut.

Die Bestellung ist nach der Zahlung im Prüfstatus: lesen Sie die Notizen auf der Registerkarte der Erweiterung. Der bezahlte Betrag oder die Währung wich von der Bestellung ab, oder die Zahlung kam, nachdem die Bestellung storniert worden war. Prüfen Sie die Zahlung im Peach-Payments-Dashboard und bearbeiten Sie dann die Bestellung oder erstatten Sie die Zahlung.

Beim Speichern erscheint der Hinweis, dass der Webhook-Schlüssel der 64-stellige hexadezimale Schlüssel sein muss: der Wert ist nicht der Schlüssel von Peach Payments. Webhooks lassen sich erst entschlüsseln, wenn er korrigiert ist.

Deinstallation

Gehen Sie zu Extensions > Extensions, wählen Sie den Typ Payments und klicken Sie neben VibeFox Peach Payments Pay Gateway auf Uninstall (der rote −-Button). 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 im Bereich Orders, die bei einer Neuinstallation auf ihre Standardwerte zurückgesetzt werden. Ist Delete data on uninstall eingeschaltet, werden die übrigen Gateway-Einstellungen (Titel, Beschreibung, Testmodus, Zugangsdaten, Webhook-Schlüssel, Kartenmarken, Logging) und das Protokoll entfernt. Ist die Option aus, bleiben sie für eine spätere Neuinstallation erhalten. Die Kassenversuche und Zahlungs-IDs bleiben immer erhalten. Auf OpenCart 4 werden die Ereignisse der Erweiterung und ihre Startaktion, über die Webhook und Rückkehr des Kunden im Wartungsmodus durchgelassen werden, immer entfernt. Bestehende Bestellungen behalten ihre Zahlungsnotizen.

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

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