VibeFox 2C2P 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.

2C2P-Konto: Sie benötigen die Merchant ID und den Secret Key Ihres 2C2P-Händlerkontos. 2C2P stellt diese bei der Eröffnung Ihres Händlerkontos aus. Sandbox- und Live-Konten haben unterschiedliche Schlüssel. Die Entwicklerdokumentation und die Testkarten für die Sandbox finden Sie auf developer.2c2p.com.

Währung: Die Kassenwährung muss von der Erweiterung unterstützt und in Ihrem 2C2P-Konto aktiviert sein. Unterstützt werden unter anderem THB, SGD, MYR, PHP, IDR, VND, MMK, KHR, LAK, CNY, HKD, TWD, JPY, KRW, INR, AUD, NZD, USD, EUR und GBP. Wird die Währung des Kunden nicht unterstützt, wird die Zahlungsart auf der Kasse ausgeblendet.

VibeFox-Lizenzschlüssel: wird auf vibefox.net gekauft. Ein Schlüssel funktioniert 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_2c2p_payment-oc3-(version).ocmod.zip und das Paket für OpenCart 4 wcp_2c2p_payment.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_2c2p_payment-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 aus dem Archiv in das Stammverzeichnis Ihres Shops kopieren.

2. Gehen Sie zu Extensions > Extensions und wählen Sie den Typ Payments. Suchen Sie VibeFox 2C2P Payment und klicken Sie auf Install (der grüne +-Button). Ihr Admin-Benutzer benötigt 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 in License key im Lizenzblock oben auf der Seite ein und klicken Sie auf Activate (siehe License key).

4. Geben Sie Ihre Sandbox-Merchant-ID und den Sandbox-Secret-Key ein, aktivieren Sie Enable/Disable, klicken Sie auf Save und führen Sie eine Testbestellung durch.

5. Wenn Sie bereit sind, geben Sie die Live-Zugangsdaten ein und deaktivieren Sie Sandbox Mode.

OpenCart 4

1. Gehen Sie im Admin-Bereich zu Extensions > Installer, klicken Sie auf Upload und wählen Sie die Datei wcp_2c2p_payment.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 (der grüne +-Button).

3. Gehen Sie zu Extensions > Extensions und wählen Sie den Erweiterungstyp Payments. Suchen Sie VibeFox 2C2P Payment, klicken Sie auf Install (der grüne +-Button) und danach auf Edit (der Stift-Button).

4. Geben Sie den Lizenzschlüssel und die Einstellungen wie in den Schritten 3 bis 5 für OpenCart 3 ein. Die Einstellungsseite und ihre Felder sind in beiden Versionen gleich. Nur die Ergebnis-URLs sind anders (siehe Zahlungsseite).

Eine neue Installation startet mit deaktivierter Zahlungsart und aktiviertem Sandbox-Modus. Die Rückkehr- und Benachrichtigungs-URLs werden bei jeder Zahlung übermittelt. Im 2C2P-Portal muss nichts konfiguriert werden.

Konfiguration

Alle Einstellungen befinden sich auf der Seite der Erweiterung: Extensions > Extensions > Payments > VibeFox 2C2P Payment > Edit. Die Abschnitte sind links aufgelistet; der Button Save unter der Liste speichert die gesamte Seite. Oberhalb der Einstellungen zeigt die Seite Sandbox mode is active. No real transactions will be processed., solange der Sandbox-Modus aktiv ist. Sie wird gewarnt, wenn das Gateway aktiviert ist, die Merchant ID oder der Secret Key des aktuellen Modus aber leer ist, sowie wenn die Standardwährung des Shops nicht unterstützt wird. In beiden Fällen wird die Zahlungsart auf der Kasse ausgeblendet. Ohne das Recht, die Erweiterung zu ändern, zeigt die Seite die Einstellungen an, kann sie aber nicht speichern.

Wenn Sie Sandbox Mode ausgeschaltet speichern, zeigt die Seite Please enter your live Merchant ID. oder Please enter your live Secret Key., falls ein Live-Feld leer ist. Die Einstellungen werden trotzdem gespeichert. Sort Order muss eine ganze Zahl sein, Total eine Zahl von 0 oder mehr und Title höchstens 128 Zeichen lang; außerdem müssen die Geo Zone und die Bestellstatus existieren. Andernfalls wird nichts gespeichert und die Seite nennt das betreffende Feld.

2C2P

Enable/Disable: Enable 2C2P Payment Gateway schaltet die Zahlungsart ein oder aus. Standard: aus.

Title: der Name der Zahlungsart, den Kunden auf der Kasse sehen. Er wird auch als Zahlungsart in der Bestellung gespeichert und darf daher höchstens 128 Zeichen lang sein. Ist das Feld leer, wird der Standard verwendet. Standard: 2C2P Payment.

Description: der Text, der dem Kunden im Schritt Confirm Order oberhalb des Bestätigungsbuttons angezeigt wird. Standard: Pay securely via credit/debit card, e-wallet, or internet banking through 2C2P. Im Sandbox-Modus wird (TEST MODE) ergänzt.

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

Geo Zone: bietet 2C2P nur für Zahlungsadressen in der gewählten Geo Zone an. Standard: All zones. Geo Zones werden unter System > Localisation > Geo Zones eingerichtet.

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

Testmodus (Sandbox)

Sandbox Mode: leitet Zahlungen an die 2C2P-Sandbox (demo2.2c2p.com) mit den unten angegebenen Sandbox-Zugangsdaten weiter. Standard: eingeschaltet. Schalten Sie ihn aus, um echte Zahlungen anzunehmen.

Sandbox Merchant ID: Ihre 2C2P-Sandbox-Merchant-ID.

Sandbox Secret Key: Ihr 2C2P-Sandbox-Secret-Key.

Live-API-Zugangsdaten

Werden verwendet, wenn der Sandbox-Modus ausgeschaltet ist.

Merchant ID: Ihre Live-Merchant-ID bei 2C2P.

Secret Key: Ihr Live-Secret-Key bei 2C2P. Der Schlüssel wird genau so gespeichert, wie er eingegeben wurde, einschließlich Anführungszeichen und Backslashes.

Gespeicherte Secret Keys werden nie wieder angezeigt. Das Feld bleibt leer und zeigt Saved — leave empty to keep it. an. Geben Sie nur dann einen neuen Wert ein, wenn Sie ihn ändern möchten. Um einen gespeicherten Schlüssel zu entfernen, aktivieren Sie unter dem Feld Clear the saved value on save und klicken Sie auf Save.

Zahlungsseite

Result URLs: zeigt zur Information die Frontend return URL und die Backend notification URL. Sie sehen etwa so aus: https://your-store/index.php?route=extension/payment/wcp_2c2p_payment/back und https://your-store/index.php?route=extension/payment/wcp_2c2p_payment/notify bei OpenCart 3 und https://your-store/index.php?route=extension/wcp_2c2p_payment/payment/wcp_2c_2p_payment.back und https://your-store/index.php?route=extension/wcp_2c2p_payment/payment/wcp_2c_2p_payment.notify bei OpenCart 4, und werden aus der Storefront-Adresse Ihrer OpenCart-Installation gebildet. Sie werden bei jeder Zahlung automatisch übermittelt. Ergebnisse werden stets mit der Merchant ID und dem Secret Key des Modus geprüft, in dem die Zahlung erfolgte: Eine im Sandbox-Modus gestartete Zahlung wird auch nach dem Umschalten auf Live mit dem Sandbox-Schlüssel verifiziert, und ein mit dem Schlüssel des anderen Modus signiertes Ergebnis wird abgelehnt.

Payment Page Language: die Sprache der 2C2P-Zahlungsseite. Standard: English.

Redirect API version: belassen Sie den Wert auf 8.5, sofern 2C2P Ihnen nicht mitgeteilt hat, dass Ihr Konto noch die alte Version 7.0 (SHA-1-Signaturen) verwendet. Ergebnisse von Zahlungen, die vor einer Umstellung gestartet wurden, werden weiterhin geprüft.

Order ID prefix: optional, nur Buchstaben und Ziffern (maximal 10), zum Beispiel SHOP1. 2C2P lehnt eine Bestell-ID ab, die bereits verwendet wurde. Legen Sie ein eindeutiges Präfix fest, wenn mehrere Shops ein 2C2P-Konto teilen, sowie in der Sandbox, in der Test-Händlerkonten gemeinsam genutzt werden. Die 2C2P-Bestell-ID besteht aus dem Präfix, der OpenCart-Bestellnummer und der Versuchsnummer, zum Beispiel SHOP1123A1. Andere Zeichen werden beim Speichern mit einer Warnung entfernt.

Bestellungen

OpenCart legt die Bestellung im Schritt Confirm Order ohne Status an (eine fehlende Bestellung). Die Bestellung erhält erst dann einen Status, wenn 2C2P das Ergebnis mit einer gültigen Signatur bestätigt hat. Jedes der folgenden Felder listet Ihre OpenCart-Bestellstatus auf.

Order Status After Payment: eine erfolgreiche Zahlung (2C2P-Status 000). Standard: In Bearbeitung.

Awaiting Payment Status: eine ausstehende Zahlung (Status 001), zum Beispiel eine Bar- oder Überweisungszahlung, die der Kunde noch nicht geleistet hat. Standard: Ausstehend.

On Hold (Review) Status: 2C2P hat einen anderen Betrag oder eine andere Währung gemeldet als die Bestellsumme. 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.

Cancelled Payment Status: eine ausstehende Zahlung wurde anschließend abgelehnt, storniert oder ist fehlgeschlagen (Status 002, 003, 999). Standard: Storniert.

Erweiterte Einstellungen

Enable Logging: schreibt 2C2P-Ereignisse in tc2p_p_debug.log.php im Logs-Ordner von OpenCart (storage/logs). Die Datei kann nicht über das Web geöffnet werden, und bei 5 MB wird sie nach tc2p_p_debug.old.log.php verschoben. Es werden keine Kartendaten, Secret Keys, E-Mail-Adressen von Kunden oder Zahlungstoken protokolliert. Standard: aus. Solange sie aus ist, wird nichts geschrieben, auch keine Fehler.

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: Ist die Option eingeschaltet, werden beim Deinstallieren der Erweiterung die Gateway-Einstellungen und das Protokoll entfernt. Die 2C2P-Transaktionen bleiben immer erhalten, damit ein spätes Ergebnis einer alten Zahlung auch nach einer erneuten Installation verarbeitet wird. 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

Im Schritt Payment Method wählt der Kunde die Zahlungsart (standardmäßig 2C2P Payment). Im Schritt Confirm Order sieht der Kunde Ihre Beschreibung. OpenCart legt die Bestellung in diesem Schritt an, noch ohne Status. Wenn der Kunde auf Confirm Order klickt, zeigt die Seite Thank you for your order. You will be redirected to 2C2P to complete your payment. an und leitet den Kunden nach kurzer Zeit zur 2C2P-Zahlungsseite weiter. Geschieht das nicht, klickt der Kunde auf Pay via 2C2P.

Auf der 2C2P-Seite zahlt der Kunde mit jeder Methode, die in Ihrem 2C2P-Konto aktiviert ist, zum Beispiel mit Karten, E-Wallets, QR-Zahlungen, Online-Banking oder Barzahlungen. Die Erweiterung übergibt die Bestellsumme in der Bestellwährung, die E-Mail-Adresse des Kunden und die Namen der Produkte in der Bestellung. Die Zahlung kann innerhalb von 24 Stunden abgeschlossen werden. Jeder Klick auf Confirm Order startet einen neuen Versuch mit einer eigenen 2C2P-Bestell-ID, da 2C2P nie dieselbe Bestell-ID zweimal akzeptiert.

2C2P meldet das Ergebnis zweimal: Der Browser des Kunden kehrt in den Shop zurück, und 2C2P sendet eine Benachrichtigung von Server zu Server. Beide werden auf dieselbe Weise verarbeitet. Die Bestellung wird erst dann als bezahlt markiert, wenn 2C2P sie mit einer gültigen Signatur bestätigt. Das Ergebnis muss außerdem zur Zahlung gehören: Die 2C2P-Bestell-ID muss von Ihrem Shop vergeben worden sein, und die Merchant ID sowie das Zufalls-Token des Versuchs werden geprüft. Ergebnisse ohne gültige Signatur werden abgelehnt. Die Benachrichtigung funktioniert auch, während der Shop im Wartungsmodus ist, weil OpenCart Anfragen von Zahlungserweiterungen durchlässt. Bei OpenCart 4 fügt die Erweiterung dafür eine Startup-Aktion hinzu, die die signierten Ergebnisse von 2C2P durchlässt.

Nach einer erfolgreichen Zahlung 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 mit Your 2C2P payment has been received. Bei einer ausstehenden Zahlung zeigt die Seite Your 2C2P payment is pending (for example a cash or bank payment that is not made yet). The order will be processed as soon as 2C2P confirms the payment. Bei einer Bestellung in Prüfung zeigt sie Your payment was received and is being reviewed by the shop.

Wurde die Zahlung auf der 2C2P-Seite nicht abgeschlossen oder abgebrochen, bleibt die Bestellung ohne Status. Der Kunde landet wieder an der Kasse mit Payment was not completed. Please try again or choose a different payment method. Der Warenkorb bleibt erhalten, und der Kunde kann erneut bezahlen oder eine andere Zahlungsart wählen. Kann das Ergebnis nicht bestätigt werden, sieht der Kunde We could not confirm the payment result. If your account was charged, please contact us before paying again. Kann die Zahlung nicht gestartet werden, weil zum Beispiel die Bestellwährung nicht unterstützt wird oder die Bestellsumme null ist, bleibt der Kunde im Schritt Confirm Order mit This payment method is currently unavailable for this order. Please contact us or choose another payment method.

Hat die Bestellung bereits einen Status (bezahlt oder wartend auf eine ausstehende Zahlung), wird kein zweites Zahlungsformular erstellt. Der Kunde wird auf die Erfolgsseite der Bestellung geleitet.

Bei OpenCart 4 wählt der Kunde die Zahlungsart mit dem Button Choose im Block der Zahlungsart im Fenster Payment method options und klickt unten auf der Kassenseite auf Confirm Order. Meldungen über eine nicht abgeschlossene oder nicht bestätigbare Zahlung werden über der Kassenseite angezeigt. OpenCart 4 behält eine Bestellung für die Kasse und aktualisiert sie: Nach einer fehlgeschlagenen Zahlung bezahlt der Kunde dieselbe Bestellung mit einem neuen Versuch (eine neue 2C2P-Bestell-ID, zum Beispiel SHOP1123A2). Wurde diese Bestellung inzwischen ohne Zahlung geschlossen (zum Beispiel weil eine ausstehende Zahlung storniert wurde oder Sie die Bestellung storniert haben), wird der Kunde mit Payment was not completed. Please try again or choose a different payment method. zurück zur Kasse geschickt, und das nächste Confirm Order bezahlt eine neue Bestellung. Wurde die Bestellung nach einer Zahlung geschlossen oder hat sie bereits einen Status aus der Zahlung eines anderen Warenkorbs, lautet die Meldung This order can no longer be paid. Please confirm your order again. Eine bezahlte Bestellung wird für einen anderen Warenkorb nie als bezahlt angezeigt. Eine Änderung des Warenkorbs, auch eine neue Menge, gilt als neuer Warenkorb, der eine eigene Zahlung braucht.

Die Erweiterung bietet keine Erstattungen aus OpenCart, keine gespeicherten Karten, keine wiederkehrenden Zahlungen oder Abonnements, keine Kartenfelder auf Ihrer Website und keine Unterstützung der 2C2P PGW 4.x API.

Bestellungen

Bestellstatus

No status (missing order): Der Kunde wurde zu 2C2P weitergeleitet, und noch ist kein Ergebnis eingegangen, oder die Zahlung ist fehlgeschlagen. Unter Sales > Orders werden solche Bestellungen nur mit dem Filter Order Status auf Missing Orders angezeigt.

Order Status After Payment (default Processing): 2C2P hat eine erfolgreiche Zahlung gemeldet. Eine Notiz zeigt die 2C2P-Transaktion, den Genehmigungscode, das Datum und den Zahlungskanal.

Awaiting Payment Status (default Pending): Die Zahlung ist bei 2C2P ausstehend, zum Beispiel eine Barzahlung, die der Kunde noch nicht geleistet hat. Die Bestellung wechselt zu Order Status After Payment, sobald 2C2P die Zahlung meldet. OpenCart benachrichtigt den Kunden über diese Änderung.

On Hold (Review) Status (default Pending): 2C2P hat einen anderen Betrag oder eine andere Währung als die Bestellsumme gemeldet. Die Notiz zeigt die erhaltenen und die erwarteten Werte. Prüfen Sie die Bestellung und die Transaktion im 2C2P-Portal.

Cancelled Payment Status (default Canceled): Eine ausstehende Zahlung wurde anschließend abgelehnt, storniert oder ist fehlgeschlagen. Die Notiz zeigt den Status und den Grund. Ein fehlgeschlagenes Ergebnis eines älteren Versuchs storniert keine Bestellung, die auf einen anderen Versuch wartet.

Eine bezahlte Bestellung wird durch ein späteres Ergebnis nie verändert, und ein wiederholtes altes Ergebnis öffnet eine stornierte Bestellung nicht erneut. Trifft eine zweite Zahlung für eine bereits bezahlte Bestellung ein, bleibt die Bestellung unverändert. Eine Notiz fordert Sie auf, dies zu prüfen und das Duplikat im 2C2P-Händlerportal zu erstatten. OpenCart 3 erstellt jedes Mal eine neue Bestellung, wenn der Kunde den Schritt Confirm Order erreicht; ein Warenkorb kann daher mehrere Bestellungen haben (OpenCart 4 behält eine Bestellung für die Kasse, aber eine frühere Bestellung oder ein zweiter Browser-Tab kann denselben Warenkorb noch haben). Sobald eine davon bezahlt ist oder auf eine ausstehende Zahlung wartet, wird für denselben Warenkorb keine neue Zahlung gestartet, und eine Zahlung, die noch für eine andere Bestellung dieses Warenkorbs eintrifft, verändert sie nicht. Die bezahlte Bestellung erhält die Notiz, das Duplikat zu erstatten.

Bei OpenCart 4 kann eine unbezahlte Bestellung 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.

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

Registerkarte VibeFox 2C2P Payment

Öffnen Sie unter Sales > Orders eine mit 2C2P bezahlte Bestellung. Unten auf der Bestellseite, neben History und Additional, zeigt die Registerkarte VibeFox 2C2P Payment die 2C2P-Bestell-ID mit dem Hinweis Sandbox bei Sandbox-Zahlungen, die Transaktion, den Zahlungsstatus, den erhaltenen Betrag, den Kanal, den Genehmigungscode, die maskierte Kartennummer, das Datum, die Antwort des Kanals, die API-Version und die 2C2P notes der Bestellung. Die Registerkarte wird Benutzern angezeigt, die Zugriff auf die Erweiterung haben.

Erstattungen

Erstattungen aus OpenCart werden nicht unterstützt. Erstatten Sie die Zahlung im 2C2P-Händlerportal und erfassen Sie die Erstattung anschließend manuell in OpenCart, zum Beispiel indem Sie den Bestellstatus ändern.

Lizenzschlüssel

Die Erweiterung funktioniert mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock License — VibeFox 2C2P Payment ist der erste Block unter Extensions > Extensions > Payments > VibeFox 2C2P Payment > 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 Buttons Check now zur erneuten Statusprüfung, Change key zur Eingabe eines anderen Schlüssels und Remove key zum Entfernen des Schlüssels aus diesem Shop. Darunter stehen die Zeile Product: opencart-payment-2c2p 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. 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 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 2C2P Kunden auf 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 Zahlungsart im Shop weiterhin, markiert mit (unlicensed — visible to admins only), damit Sie die Erweiterung einrichten und testen können, bevor Sie einen Schlüssel kaufen. Bei OpenCart 4 gibt es diese Vorschau nicht: Der Shop sieht die Anmeldung im Admin-Bereich nicht, daher ist die Zahlungsart ohne aktiven Schlüssel für alle ausgeblendet. Nachdem Sie die Seite Edit einmal geöffnet haben, erscheint ein Hinweis auf dem Dashboard des Admin-Bereichs. Schließen Sie ihn mit ×, um ihn 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, Updates und Support erfordern jedoch eine Verlängerung. Der Status wird automatisch erneut geprüft, wenn Sie das Dashboard oder die Seite Edit im Admin-Bereich öffnen: an den ersten 14 Tagen nach Eingabe des Schlüssels einmal täglich, danach einmal pro Woche. Ein Cronjob ist nicht nötig. Das Deinstallieren der Erweiterung entfernt immer den Lizenzschlüssel und den Lizenzstatus.

Fehlerbehebung

2C2P erscheint nicht auf der Kasse: Prüfen Sie, ob die Lizenz aktiv ist, Enable/Disable eingeschaltet ist und der aktuelle Modus eine Merchant ID und einen Secret Key hat: die Sandbox-Felder im Sandbox-Modus, die Live-Felder im Live-Modus. Prüfen Sie, ob die Währung des Kunden unterstützt wird. Die Einstellungsseite zeigt eine Warnung, wenn Zugangsdaten fehlen oder die Standardwährung nicht unterstützt wird. Prüfen Sie außerdem, ob die Zahlungsadresse in der gewählten Geo Zone liegt und die Bestellung die in den Einstellungen festgelegte Total erreicht.

Die Zahlung ist erfolgt, aber die Bestellung bleibt ohne Status: Es ist kein gültiges Ergebnis in Ihrem Shop angekommen. Prüfen Sie, ob die Merchant ID und der Secret Key des Modus, in dem die Zahlung erfolgte, zum 2C2P-Konto passen, und ob die Redirect API version zu Ihrem Konto passt. Ein Ergebnis mit falscher Signatur oder für eine andere Merchant ID wird abgelehnt. Aktivieren Sie Enable Logging und suchen Sie im Feld Log nach Meldungen zu hash oder Merchant ID. Prüfen Sie außerdem, ob Ihr Server Anfragen von 2C2P an die Backend-Benachrichtigungs-URL annimmt.

Die Backend-Benachrichtigung antwortet mit 400 FAIL: Das Ergebnis hat fehlende Felder, eine falsche Signatur, eine andere Merchant ID oder ein falsches Token. 404 FAIL bedeutet, dass die 2C2P-Bestell-ID nicht von diesem Shop vergeben wurde. 503 RETRY bedeutet, dass die Bestellung gerade von einer anderen Anfrage bestätigt wurde oder die Verarbeitung fehlgeschlagen ist; 2C2P versucht es später erneut. Aktivieren Sie Enable Logging, um den Grund zu sehen.

Die Benachrichtigungs-URL zeigt im Browser FAIL an: Das ist normal. Die URL akzeptiert nur POST-Anfragen von 2C2P.

2C2P meldet, dass die Bestell-ID bereits existiert: 2C2P akzeptiert dieselbe Bestell-ID nicht zweimal. Das passiert, wenn mehrere Shops ein 2C2P-Konto teilen oder in der Sandbox, in der Demo-Händlerkonten von vielen Entwicklern gemeinsam genutzt werden. Legen Sie ein eindeutiges Order ID prefix fest.

Eine Zahlung wurde getätigt, die Bestellung steht aber im Status für ausstehende Zahlung oder Prüfung: Entweder ist die Zahlung bei 2C2P noch ausstehend (zum Beispiel eine Barzahlung, die der Kunde noch nicht geleistet hat), oder der bezahlte Betrag oder die Währung stimmte nicht mit der Bestellung überein. Prüfen Sie die Notizen auf der Registerkarte VibeFox 2C2P Payment und die Transaktion im 2C2P-Portal.

Der Kunde sieht This payment method is currently unavailable for this order: Die Bestellwährung wird nicht unterstützt, die Merchant ID oder der Secret Key des aktuellen Modus ist leer, oder die Bestellsumme ist null.

Der Kunde sieht 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.

Beim Speichern Please enter your live Merchant ID or Please enter your live Secret Key on save: Der Sandbox-Modus ist ausgeschaltet, und ein Live-Feld ist leer. Geben Sie die Live-Zugangsdaten ein oder schalten Sie Sandbox Mode wieder ein.

Für Entwickler: Bevor das Zahlungsformular signiert wird, löst die Erweiterung das OpenCart-Ereignis tc2p_p_payment_fields mit den Formularfeldern und der Bestellung aus.

Deinstallation

Gehen Sie zu Extensions > Extensions, wählen Sie den Typ Payments und klicken Sie neben VibeFox 2C2P Payment auf Uninstall (der rote −-Button). 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 im Abschnitt Orders, die bei einer erneuten Installation auf ihre Standardwerte zurückgesetzt werden. Auch das OpenCart-Ereignis der Erweiterung wird entfernt (bei OpenCart 4 auch dessen Ereignisse und die Startup-Aktion, die die 2C2P-Ergebnisse im Wartungsmodus durchlässt). Ist Delete Data on Uninstall eingeschaltet, werden die übrigen Gateway-Einstellungen (Titel, Beschreibung, Sandbox-Modus, Zugangsdaten, Einstellungen der Zahlungsseite, Protokollierung) und das Protokoll entfernt. Ist die Option ausgeschaltet, bleiben sie für eine spätere erneute Installation erhalten. Die 2C2P-Transaktionen bleiben immer erhalten, damit ein spätes Ergebnis einer alten Zahlung auch nach einer erneuten Installation verarbeitet wird. Bestehende Bestellungen behalten ihre Zahlungsnotizen.

Bei OpenCart 4 entfernen Sie außerdem die Dateien der Erweiterung: Gehen Sie nach der Deinstallation zu Extensions > Installer, klicken Sie in der Liste der installierten Erweiterungen neben VibeFox 2C2P Payment auf Uninstall (der orangefarbene −-Button) und danach auf Delete (der rote Papierkorb-Button), um das hochgeladene Paket zu entfernen.

2C2P ist eine Marke ihres jeweiligen Inhabers. Diese Erweiterung ist nicht mit 2C2P verbunden und wird von 2C2P nicht empfohlen.