VibeFox Pin 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.

Pin-Payments-Konto: ein Pin-Payments-Händlerkonto (für Unternehmen in Australien oder Neuseeland; Kunden können von überall bezahlen). Sie benötigen den Publishable Key und den Secret Key, für den Live-Betrieb und für Tests die Werte der Testumgebung. Ein Webhook-Secret ist nicht nötig: Die Erweiterung verwendet keine Webhooks. Kartendaten werden vom Browser des Kunden über Pin.js direkt an Pin Payments gesendet und erreichen Ihren Shop nie; der Shop fällt daher unter PCI SAQ A-EP.

Währung: AUD, USD, NZD, SGD, EUR, GBP, CAD, HKD, JPY, MYR, THB, PHP, ZAR oder IDR. Die Bestellung wird in ihrer eigenen Währung belastet.

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

Installation

Der Download ist eine einzelne 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_pinpayments_gateway-oc3-(Version).ocmod.zip und das OpenCart-4-Paket wcp_pinpayments_gateway.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_pinpayments_gateway-oc3-(Version).ocmod.zip. Die Erweiterung hat keine OCMOD-Änderungen, daher muss Extensions > Modifications nicht aktualisiert werden. Statt des Installers können Sie den Inhalt des Ordners upload aus diesem Paket auch in das Stammverzeichnis Ihres Shops kopieren.

2. Gehen Sie zu Extensions > Extensions und wählen Sie den Typ Payments. Suchen Sie VibeFox Pin Payments Gateway und klicken Sie auf Install (die grüne +-Schaltfläche). Ihr Admin-Benutzer benötigt das Recht, die Liste der Zahlungserweiterungen zu ändern.

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 License key).

4. Öffnen Sie im Pin-Payments-Dashboard Account > API Keys und kopieren Sie Ihre Testschlüssel in Test publishable key und Test secret key. Lassen Sie Test mode aktiviert, schalten Sie Enable/Disable ein und klicken Sie auf Save.

5. Führen Sie eine Testbestellung mit einer Pin-Payments-Testkarte durch. Wenn alles funktioniert, geben Sie die Live-Schlüssel ein, deaktivieren Sie Test mode und speichern Sie.

OpenCart 4

1. Gehen Sie im Admin-Bereich zu Extensions > Installer, klicken Sie auf Upload und wählen Sie die Datei wcp_pinpayments_gateway.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 Pin Payments Gateway, klicken Sie auf Install (die grüne +-Schaltfläche) und dann auf Edit (die Stift-Schaltfläche).

4. Geben Sie den Lizenzschlüssel und die Pin-Payments-Schlüssel wie in den Schritten 3 bis 5 für OpenCart 3 ein. Die Einstellungsseite und ihre Felder sind in beiden Versionen gleich.

Eine neue Installation startet mit deaktivierter Zahlungsart und aktiviertem Testmodus.

Konfiguration

Alle Einstellungen befinden sich auf der Erweiterungsseite: Extensions > Extensions > Payments > VibeFox Pin Payments Gateway > Edit. Die Abschnitte sind links aufgelistet; die Schaltfläche Save unter der Liste speichert die gesamte Seite. Über den Einstellungen zeigt die Seite Pin Payments is in TEST MODE: the test API and test keys are used, no real charges are made., solange der Testmodus aktiv ist. Außerdem erscheint ein Fehler, solange der Publishable Key oder der Secret Key des aktuellen Modus leer ist (die Zahlungsart wird dann an der Kasse ausgeblendet), sowie ein Fehler, wenn Pin Payments die Standardwährung des Shops nicht unterstützt (mit der Liste der unterstützten Währungen). Ohne das Recht, die Erweiterung zu ändern, zeigt die Seite die Einstellungen, kann sie aber nicht speichern.

Beim Speichern wird nichts gespeichert, wenn ein Feld fehlerhaft ist: Title darf nicht leer sein (Enter a title for the payment method (at most 128 characters).), Sort Order muss eine ganze Zahl sein (negative Werte sind erlaubt), Total eine Zahl größer oder gleich 0, und Geo Zone sowie die Bestellstatus müssen existieren.

Pin Payments

Enable/Disable: Enable Pin Payments 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: Credit card (Pin Payments). Pflichtfeld, höchstens 128 Zeichen.

Description: der Text, den der Kunde im Schritt Confirm Order über dem Kartenformular sieht. Standard: Pay with your credit card via Pin Payments.

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

Geo Zone: das Kartenformular nur für Rechnungsadressen in der gewählten Geo Zone anbieten. Standard: All zones. Geo Zones werden unter System > Localisation > Geo Zones eingerichtet.

Total: der Warenkorbwert in der Standardwährung des Shops, den eine Bestellung erreichen muss, bevor die Zahlungsart angeboten wird. Lassen Sie das Feld leer, um sie bei jedem Betrag anzubieten.

API-Schlüssel

Ihre Schlüssel finden Sie im Pin-Payments-Dashboard (die Seite verlinkt auf dashboard.pinpayments.com) unter Account > API Keys. Testschlüssel funktionieren nur mit der Test-API, Live-Schlüssel nur mit der Live-API. Der Publishable Key wird von Pin.js im Browser des Kunden verwendet. Der Secret Key verlässt Ihren Server nie.

Test mode: verwendet die Testumgebung von Pin Payments (test-api.pinpayments.com) und die Testschlüssel. Es werden keine echten Belastungen durchgeführt, und Kunden sehen TEST MODE — no real charges will be made. über dem Kartenformular. Ist die Option aus, werden die Live-API und die Live-Schlüssel verwendet. Erstattungen einer Bestellung verwenden immer die Schlüssel der Umgebung, in der die Bestellung bezahlt wurde. Standard: ein.

Test publishable key: der Publishable Key Ihres Pin-Payments-Testkontos.

Test secret key: der Secret Key Ihres Pin-Payments-Testkontos.

Live publishable key: der Publishable Key Ihres Live-Pin-Payments-Kontos.

Live secret key: der Secret Key Ihres Live-Pin-Payments-Kontos.

Leerzeichen um die Schlüssel werden entfernt. Gespeicherte Secret Keys werden nie wieder angezeigt. Das Feld bleibt leer und zeigt Gespeichert — zum Beibehalten leer lassen. Geben Sie nur dann einen neuen Wert ein, wenn Sie ihn ändern möchten. Um einen gespeicherten Secret Key zu entfernen, aktivieren Sie unter dem Feld Clear the saved value on save und klicken Sie auf Save.

Bestellungen

OpenCart legt die Bestellung im Schritt Confirm Order ohne Status an (eine fehlende Bestellung). Die Bestellung erhält erst dann einen Status, wenn Pin Payments die Belastung beantwortet hat. Jedes Feld unten listet Ihre OpenCart-Bestellstatus auf.

Order Status After Payment: die Karte wurde genau für den Bestellbetrag und die Bestellwährung belastet. Standard: Processing.

On Hold (Review) Status: der belastete Betrag oder die Währung weicht von der Bestellung ab, die Belastung ist autorisiert, aber nicht erfasst, oder Pin Payments hat keine eindeutige Antwort gegeben (Zeitüberschreitung, Serverfehler), sodass eine Belastung möglicherweise existiert. Eine Notiz sagt Ihnen, was Sie im Pin-Payments-Dashboard prüfen sollten. Standard: Pending, da OpenCart keinen Status „On hold“ hat. Sie können unter System > Localisation > Order Statuses einen eigenen Status anlegen und hier auswählen.

Refunded Status: wird gesetzt, nachdem die Zahlung über den Reiter der Bestellung vollständig erstattet wurde. Standard: Refunded.

Erweitert

Debug log: schreibt API-Aufrufe von Pin Payments in wc_ppg_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 wc_ppg_debug.old.log.php verschoben. Fehler und Warnungen werden immer protokolliert; schalten Sie diese Option ein, um zusätzlich jeden API-Aufruf zu protokollieren. Kartendaten, API-Schlüssel und personenbezogene Kundendaten werden nie protokolliert. 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 aktiviert, werden bei der Deinstallation der Erweiterung die Gateway-Einstellungen und das Protokoll entfernt. Die Zahlungsdaten der Bestellungen (Belastungen und Erstattungen) bleiben immer erhalten. Standard: aus.

Import / Export

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

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

Kasse

Die Zahlungsart wird angezeigt, wenn sie aktiviert ist, beide Schlüssel des aktuellen Modus gesetzt sind, die Bestellwährung eine der 14 unterstützten Währungen ist, die Zahlungsadresse in der gewählten Geo Zone liegt und die Bestellung den Total-Betrag erreicht.

Im Schritt Payment Method wählt der Kunde die Zahlungsart (standardmäßig Credit card (Pin Payments)). OpenCart legt die Bestellung im Schritt Confirm Order an, weiterhin ohne Status. Dort sieht der Kunde Ihre Beschreibung, die Symbole für Visa, Mastercard und American Express und das Kartenformular: Card number, Expiry (MM / YY), CVC und Name on card. Auf OpenCart 4 wählt der Kunde die Zahlungsart mit der Schaltfläche Choose des Zahlungsartenblocks im Fenster Payment method options; das Kartenformular erscheint dann im Bestätigungsblock unten auf der Kassenseite, oberhalb der Schaltfläche Confirm Order. Vor dem Absenden prüft das Formular die Länge der Kartennummer, Ablaufmonat und -jahr, einen CVC mit 3 oder 4 Ziffern und den Namen.

Wenn der Kunde auf Confirm Order klickt, sendet Pin.js die Kartendaten und die Zahlungsadresse der Bestellung (auf OpenCart 4, wenn die Kasse keine Zahlungsadresse verlangt, die Lieferadresse) direkt aus dem Browser an Pin Payments und erhält ein Einmal-Kartentoken. Nur dieses Token wird an Ihren Shop gesendet. Die Erweiterung erstellt dann eine erfasste Belastung über den Bestellbetrag in der Bestellwährung, mit der E-Mail-Adresse und IP-Adresse des Kunden und der Beschreibung <store name> - Order <order number>. Pin Payments antwortet in derselben Anfrage.

Nach einer erfolgreichen Belastung erhält die Bestellung ihren Status auf die übliche OpenCart-Weise, mit den üblichen Bestell-E-Mails und der Bestandsaktualisierung; der Warenkorb wird geleert, und der Kunde sieht die Erfolgsseite der OpenCart-Bestellung mit Your card payment has been received. Wurde die Bestellung in den Prüfstatus gesetzt, zeigt die Seite Your card payment has been received and is being reviewed. We will update your order as soon as the review is complete.

Antwortet Pin Payments nicht (Zeitüberschreitung, Serverfehler, unlesbare Antwort), wurde unter Umständen trotzdem eine Belastung erstellt. Die Bestellung wird dann mit einer Notiz in den Prüfstatus gesetzt, und die Erfolgsseite zeigt We could not confirm your payment with Pin Payments. Please check your e-mail and card statement before paying again, or contact us. Das erneute Absenden desselben Warenkorbs erzeugt nie eine zweite Belastung.

Pro Warenkorb läuft nur ein Zahlungsversuch gleichzeitig. Ein zweites Absenden erhält This order is already being paid. Please wait a moment and check your e-mail before trying again. OpenCart 3 legt jedes Mal eine neue Bestellung an, wenn der Schritt Confirm Order angezeigt wird; OpenCart 4 aktualisiert die Bestellung der Kasse (nach einer abgelehnten Karte bezahlt der Kunde dieselbe Bestellung). Deshalb gelangt ein Warenkorb, der bereits mit einer anderen Bestellung bezahlt wurde, direkt zur Erfolgsseite, und ein früherer Versuch, der Geld belastet hat oder belastet haben könnte, gibt seinen Status an die Bestellung weiter, statt eine neue Belastung zu erzeugen. Ein Kartentoken kann nur einmal verwendet werden: Nach einem fehlgeschlagenen Versuch oder wenn der Kunde die Kartendaten ändert, wird ein neues Token erstellt.

OpenCart 4 behält die Bestellung in der Kasse, bis die Erfolgsseite angezeigt wird. Hat diese Bestellung bereits einen Status, wenn der Kunde einen neuen Kauf bestätigt (zum Beispiel wurde sie bezahlt und die Erfolgsseite nie geöffnet, oder Sie haben sie storniert), wird der Kunde zur Kasse zurückgebracht, und das nächste Confirm Order bezahlt eine neue Bestellung mit dem aktuellen Warenkorb. Über der Kassenseite sieht der Kunde Your previous order was cancelled or refunded by the store. Please confirm the order again to pay with a new order., wenn die Bestellung geschlossen wurde, oder Your previous order #(Nummer) has already been placed. Your cart has changed: please confirm the new order to pay for it., wenn sie für einen früheren Warenkorb angelegt wurde. Eine bezahlte Bestellung wird nie als bezahlt für einen anderen Warenkorb angezeigt.

Schlägt die Zahlung fehl, bleibt die Bestellung ohne Status. Der Kunde bleibt im Schritt Confirm Order, der Warenkorb bleibt erhalten, und über dem Kartenformular erscheint eine der folgenden Meldungen: Your card was declined. Please use another card or contact your bank.; Your card has insufficient funds. Please use another card.; Your card has expired. Please use another card.; The card security code (CVC) is incorrect.; This card type is not accepted. Please use Visa, Mastercard or American Express.; Payment failed: mit dem Grund von Pin Payments für abgelehnte Daten; Your card details have expired. Please enter them again and retry., wenn das Token nicht verwendet werden kann; The secure card form could not be loaded. Please reload the page or choose another payment method., wenn Pin.js nicht geladen wird; Card payments are temporarily unavailable. Please try again later or choose another payment method., wenn Pin Payments den Secret Key ablehnt; Your payment could not be processed. Please try again or choose another payment method. bei anderen Fehlern. Der technische Grund wird in das Protokoll geschrieben.

Die Erweiterung unterstützt kein 3-D-Secure-Verfahren. Verlangt Ihr Pin-Payments-Konto 3-D Secure, bleibt die Belastung ausstehend, die Bestellung erhält keinen Status, und der Kunde sieht Your card payment could not be completed (additional verification is required). Please try another card or another payment method. Es gibt keinen Modus nur zur Autorisierung mit späterer Erfassung, keine gespeicherten Karten, keine Abonnements, kein Apple Pay oder Google Pay und keine Webhooks.

Bestellungen und Erstattungen

Bestellstatus

Kein Status (fehlende Bestellung): Die Karte wurde abgelehnt, die Belastung erforderte 3-D Secure, oder der Kunde hat nicht bezahlt. Unter Sales > Orders werden solche Bestellungen nur mit dem Filter Order Status auf Missing Orders angezeigt.

Order Status After Payment (Standard Processing): Pin Payments hat eine erfolgreiche, erfasste Belastung für genau den Bestellbetrag und die Bestellwährung gemeldet. Eine Notiz zeigt den Betrag und das Belastungstoken (und TEST MODE bei Testzahlungen).

On Hold (Review) Status (Standard Pending): Die Belastung muss von Ihnen geprüft werden. Die Notiz erklärt den Grund: Pin Payments hat einen anderen Betrag oder eine andere Währung als die Bestellung belastet, die Belastung ist autorisiert, aber nicht erfasst (erfassen Sie sie im Pin-Payments-Dashboard und ändern Sie danach den Bestellstatus), oder Pin Payments hat keine eindeutige Antwort gegeben (suchen Sie im Pin-Payments-Dashboard nach der Belastungsbeschreibung, bevor die Bestellung versendet wird).

Refunded Status (Standard Refunded): Die Belastung wurde über die Erweiterung vollständig erstattet.

Wird für einen bereits bezahlten Warenkorb eine zweite Belastung durchgeführt, bleibt die bezahlte Bestellung unverändert. Eine Notiz bittet Sie, dies zu prüfen und im Pin-Payments-Dashboard zu erstatten.

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

VibeFox Pin Payments Gateway tab

Öffnen Sie unter Sales > Orders eine mit Pin Payments bezahlte Bestellung. Unten auf der Bestellseite, neben History und Additional, zeigt der Reiter VibeFox Pin Payments Gateway das Charge-Token mit dem Hinweis Test bei Testzahlungen, den Status, die Card-Marke und die letzten vier Ziffern, die Beträge Charged / order / refunded, die Charge description, das Erstattungsformular, den Erstattungsverlauf und die Pin Payments notes der Bestellung. Der Reiter wird Benutzern angezeigt, die Zugriff auf die Erweiterung haben.

Erstattungen

Im Reiter VibeFox Pin Payments Gateway geben Sie den Amount ein (der noch nicht erstattete Betrag ist vorausgefüllt), optional einen Reason (optional), und klicken Sie auf Refund via Pin Payments. Bestätigen Sie die Abfrage Diesen Betrag über Pin Payments erstatten? Dies kann nicht rückgängig gemacht werden. Voll- und Teilerstattungen werden unterstützt. Sie benötigen das Recht, die Erweiterung zu ändern (festgelegt unter System > Users > User Groups). Erstattungen sind auf den Betrag und die Währung begrenzt, die Pin Payments tatsächlich belastet hat; nach einer Abweichung von Betrag oder Währung können Sie also bis zu dem erstatten, was der Kunde bezahlt hat, nicht bis zum Bestellbetrag. Die Erstattung wird an die Umgebung (Test oder Live) gesendet, in der die Bestellung bezahlt wurde, daher muss der Secret Key dieses Modus gesetzt sein. Pin Payments verarbeitet Erstattungen asynchron, daher ist der Status meist Pending. Eine erfolgreiche Anfrage wird mit dem Erstattungstoken von Pin Payments und seinem Status dem Erstattungsverlauf und den Notizen hinzugefügt. Eine vollständige Erstattung setzt die Bestellung auf den Refunded Status, ohne den Kunden zu benachrichtigen und ohne Produkte in den Bestand zurückzubuchen, genau wie eine manuelle Statusänderung. Eine Teilerstattung ändert den Status nicht. Lehnt Pin Payments die Erstattung ab oder antwortet nicht, zeigt der Reiter den Fehler, und es wird keine Erstattung erfasst.

Ist für die Bestellung keine Belastung erfasst (Pin Payments hat keine eindeutige Antwort gegeben), zeigt der Reiter kein Erstattungsformular, sondern sagt Ihnen, nach welcher Beschreibung Sie im Pin-Payments-Dashboard suchen müssen.

Produktrücksendungen unter Sales > Returns schicken kein Geld über Pin Payments zurück. Im Pin-Payments-Dashboard vorgenommene Erstattungen werden nicht nach OpenCart übertragen; führen Sie Erstattungen daher über die Bestellseite durch.

Lizenzschlüssel

Die Erweiterung funktioniert mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock License — VibeFox Pin Payments Gateway ist der erste Block unter Extensions > Extensions > Payments > VibeFox Pin Payments 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 gültig ist, und Ihre Domain) sowie die Schaltflächen Check now zur erneuten Statusprüfung, 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-pinpayments 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 sich die Shop-Adresse geändert hat 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 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 Pin Payments Kunden an der Kasse nicht angezeigt. Wird trotzdem eine Zahlung gestartet, sieht der Kunde Diese Zahlungsart ist nicht verfügbar. Bitte wählen Sie eine andere. Ein Admin-Benutzer, der im Admin-Bereich im selben Browser angemeldet ist, sieht die Zahlungsart im Shop weiterhin, markiert mit (nicht lizenziert — nur für Admins sichtbar), sodass Sie die Erweiterung vor dem Kauf eines Schlüssels einrichten und testen können. Auf OpenCart 4 ist diese Vorschau nicht verfügbar: Der Shop sieht die Admin-Anmeldung nicht, daher wird die Zahlungsart ohne aktiven Schlüssel für alle ausgeblendet. Nachdem Sie die Seite Edit einmal geöffnet haben, erscheint auf dem Dashboard im Admin-Bereich eine Erinnerung. Schließen Sie sie mit ×, um sie 7 Tage lang auszublenden. Bestehende Bestellungen sind nicht betroffen: Erstattungen von zuvor bezahlten Bestellungen funktionieren weiterhin.

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

Fehlerbehebung

Pin Payments erscheint nicht an der Kasse: Prüfen Sie, ob die Lizenz aktiv ist, Enable/Disable eingeschaltet ist, beide Schlüssel des aktuellen Modus eingetragen sind (Test publishable key und Test secret key im Testmodus, sonst die Live-Schlüssel) und die Bestellwährung eine der 14 unterstützten Währungen ist. Prüfen Sie außerdem, ob die Zahlungsadresse in der gewählten Geo Zone liegt und ob die Bestellung den in den Einstellungen festgelegten Total-Betrag erreicht. Die Einstellungsseite zeigt einen Fehler für fehlende Schlüssel und für eine nicht unterstützte Shop-Währung.

Die Zahlung ist erfolgt, aber die Bestellung ist im Prüfstatus: Lesen Sie die Notizen im Reiter VibeFox Pin Payments Gateway (siehe Bestellstatus). Hat Pin Payments keine eindeutige Antwort gegeben, suchen Sie im Pin-Payments-Dashboard nach einer Belastung mit der Beschreibung <store name> - Order <order number> und bearbeiten Sie dann die Bestellung oder erstatten Sie die Belastung im Dashboard.

Der Kunde sieht „Your payment was received, but the order could not be completed automatically“: Die Karte wurde belastet, aber der Bestellstatus konnte nicht gesetzt werden (zum Beispiel, weil die Bestellung inzwischen gelöscht wurde). Der Grund steht im Protokoll. Der Kunde wird gebeten, nicht erneut zu bezahlen; das erneute Absenden desselben Warenkorbs gibt der Bestellung ihren Status ohne neue Belastung.

Der Kunde sieht den Hinweis „This payment method is not available. Please reload the checkout page.“: Die Kassensitzung passt nicht mehr zur Bestellung, oder die Zahlungsart wurde inzwischen deaktiviert. Der Kunde lädt die Kasse neu.

Kunden sehen „Card payments are temporarily unavailable“: Pin Payments hat den Secret Key abgelehnt, oder der Schlüssel des aktuellen Modus fehlt. Testschlüssel funktionieren nur im Testmodus, Live-Schlüssel nur im Live-Modus. Das Protokoll zeigt den Grund.

Bestellungen schlagen mit „additional verification is required“ fehl: Ihr Pin-Payments-Konto verlangt 3-D Secure, das die Erweiterung nicht unterstützt. Bitten Sie Pin Payments, die Pflicht zu 3-D Secure zu deaktivieren.

Das sichere Kartenformular konnte nicht geladen werden: Pin.js vom CDN von Pin Payments wurde im Browser nicht geladen, zum Beispiel wegen eines Script-Blockers oder einer Erweiterung, die Skripte zusammenfasst oder verändert. Schließen Sie die Kasse von solchen Optimierungen aus.

Pin Payments hat nicht geantwortet: Das Kartentoken wurde im Browser nicht innerhalb von 30 Sekunden erstellt. Der Kunde kann die Verbindung prüfen und es erneut versuchen; es wurde nichts belastet.

Zahlung fehlgeschlagen mit einem Grund von Pin Payments: Pin Payments hat die Belastungsdaten abgelehnt, zum Beispiel einen Betrag unterhalb des Mindestbetrags für die Währung. Der Kunde sieht den Grund, und das Protokoll enthält den Fehlercode.

Erstattung schlägt fehl: Lesen Sie die Meldung im Reiter. Eine Meldung zu TEST- oder LIVE-Modus bedeutet, dass der Secret Key des Modus, in dem die Bestellung bezahlt wurde, leer ist. Pin Payments did not confirm the refund bedeutet, dass keine Antwort kam; prüfen Sie die Belastung im Pin-Payments-Dashboard, bevor Sie es erneut versuchen. at most zeigt den Betrag, der von der Belastung noch erstattet werden kann.

Testzahlungen: Der Testmodus verwendet die Testumgebung und die Testschlüssel. Verwenden Sie die Testkarten aus der Entwicklerdokumentation von Pin Payments, zum Beispiel 4200 0000 0000 0000 (erfolgreich), mit einem beliebigen zukünftigen Ablaufdatum und einem beliebigen CVC. Bestellungen behalten den Modus, in dem sie bezahlt wurden, daher gehen Erstattungen nach einem Moduswechsel an die richtige Umgebung.

Fehler finden: Fehler werden immer in das Protokoll geschrieben; siehe das Feld Log auf der Erweiterungsseite. Aktivieren Sie Debug log, um jeden API-Aufruf zu sehen.

Deinstallation

Gehen Sie zu Extensions > Extensions, wählen Sie den Typ Payments und klicken Sie neben VibeFox Pin Payments Gateway auf Uninstall (die rote −-Schaltfläche). Der Lizenzschlüssel und der Lizenzstatus dieser Erweiterung werden immer entfernt. OpenCart entfernt immer die eigenen Einstellungen der Erweiterung: Enable/Disable, Sort Order, Geo Zone, Total und die Bestellstatus aus dem Abschnitt Bestellungen, die bei einer Neuinstallation auf ihre Standardwerte zurückgesetzt werden. Das OpenCart-Ereignis der Erweiterung wird ebenfalls entfernt (auf OpenCart 4 seine beiden Ereignisse, die die Meldungen auf der Erfolgsseite und über der Kasse anzeigen). Ist Delete data on uninstall aktiviert, werden die übrigen Gateway-Einstellungen (Titel, Beschreibung, Testmodus, Schlüssel, Schalter für das Debug-Protokoll) und das Protokoll entfernt. Ist die Option aus, bleiben sie für eine spätere Neuinstallation erhalten. Die Belastungen und Erstattungen von Pin Payments bleiben immer erhalten, sodass zuvor bezahlte Bestellungen nach einer Neuinstallation weiterhin erstattet werden können. Bestehende Bestellungen behalten ihre Zahlungsnotizen.

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

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