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

Währung: Kolumbianischer Peso (COP) oder US-Dollar (USD). Wenn der Kunde in einer anderen Währung bezahlt, wird die Zahlungsart an der Kasse ausgeblendet.

ePayco-Konto: Sie benötigen die vier Schlüssel Ihres ePayco-Kontos: P_CUST_ID_CLIENTE, P_KEY, PUBLIC_KEY und PRIVATE_KEY. Sie finden sie im ePayco-Dashboard unter Integrations, API keys. Dieselben Schlüssel funktionieren im Testmodus und im Live-Modus. Welche Zahlungsarten der Kunde nutzen kann (Karten, PSE, Barzahlungsnetze, Wallets), richtet sich nach den Zahlungsarten, die in Ihrem ePayco-Konto aktiviert sind.

Öffentliche Website: Die Bestätigungs-URL Ihres Shops muss aus dem Internet erreichbar sein und darf nicht durch eine Firewall oder eine Basis-Authentifizierung blockiert werden.

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 OpenCart-3-Paket wcp_epayco_payment-oc3-(Version).ocmod.zip und das OpenCart-4-Paket wcp_epayco_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_epayco_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 dieses Pakets in das Stammverzeichnis Ihres Shops kopieren.

2. Gehen Sie zu Extensions > Extensions und wählen Sie den Typ Payments. Suchen Sie VibeFox ePayco Payment 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 Lizenzschlüssel).

4. Geben Sie die vier ePayco-Schlüssel ein und wählen Sie den Checkout-Typ (siehe Konfiguration).

5. Aktivieren Sie Enable/Disable und klicken Sie auf Save. Testen Sie eine Zahlung mit aktiviertem Test Mode und ePayco-Testkarten und deaktivieren Sie danach Test Mode.

OpenCart 4

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

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

4. Geben Sie den Lizenzschlüssel, die vier ePayco-Schlüssel und die Einstellungen ein wie in den Schritten 3 bis 5 für OpenCart 3. Die Einstellungsseite und ihre Felder sind in beiden Versionen gleich. Nur die Bestätigungs-URL ist anders (siehe Bestätigungs-URL).

Eine neue Installation startet mit deaktivierter Zahlungsart und deaktiviertem Testmodus. Die Bestätigungs-URL wird bei jeder Zahlung an ePayco übermittelt, daher muss im ePayco-Dashboard nichts eingerichtet werden.

Konfiguration

Alle Einstellungen befinden sich auf der Seite der Erweiterung: Extensions > Extensions > Payments > VibeFox ePayco Payment > Edit. Die Abschnitte sind links aufgelistet; die Schaltfläche Save unter der Liste speichert die gesamte Seite. Oberhalb der Einstellungen erklärt die Seite, dass die Bestellung erst nach der Bestätigung der Transaktion durch ePayco einen Status erhält. Sie warnt, wenn nicht alle vier Schlüssel eingegeben sind (dann wird die Zahlungsart an der Kasse ausgeblendet), und wenn die Standardwährung Ihres Shops nicht COP oder USD ist. Solange der Testmodus aktiv ist, zeigt sie Test mode is on: customers pay with ePayco test cards and no real money is charged.. Ohne das Recht, die Erweiterung zu ändern, zeigt die Seite die Einstellungen an, kann sie aber nicht speichern.

Beim Speichern darf Title höchstens 128 Zeichen lang sein, Sort Order muss eine ganze Zahl sein, Total muss eine Zahl von null oder mehr sein, und die Geozone sowie die Bestellstatus müssen vorhanden sein. Andernfalls nennt eine Fehlermeldung das Feld, und nichts wird gespeichert.

ePayco

Enable/Disable: Enable ePayco Payment 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. Bis zu 128 Zeichen; bleibt das Feld leer, sehen Kunden ePayco. Standard: ePayco.

Description: der Text, den der Kunde im Schritt Confirm Order über der Schaltfläche zum Bestätigen sieht. Standard: Pay securely with ePayco.

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

Geo Zone: bietet ePayco nur für Rechnungsadressen in der gewählten Geozone an. Standard: All zones. Geozonen richten Sie unter System > Localisation > Geo Zones ein.

Total: die Kassensumme in der Standardwährung des Shops, die eine Bestellung erreichen muss, damit ePayco angeboten wird. Lassen Sie das Feld leer, um ePayco bei jeder Summe anzubieten.

ePayco-Kontoschlüssel

Die vier Schlüssel finden Sie im ePayco-Dashboard unter Integrations, API keys (der Abschnitt verlinkt auf das Dashboard). P_CUST_ID_CLIENTE und P_KEY prüfen die Zahlungsbestätigungen; PUBLIC_KEY und PRIVATE_KEY erstellen die Checkout-Sitzungen. Dieselben Schlüssel funktionieren im Testmodus und im Live-Modus.

Customer ID (P_CUST_ID_CLIENTE): Ihre ePayco-Kundennummer (numerisch).

Secret Key (P_KEY): wird verwendet, um die Signatur der ePayco-Zahlungsbestätigungen zu prüfen. Halten Sie ihn geheim.

Public Key (PUBLIC_KEY): Ihr öffentlicher ePayco-API-Schlüssel.

Private Key (PRIVATE_KEY): Ihr privater ePayco-API-Schlüssel. Halten Sie ihn geheim.

Die gespeicherten Schlüssel Secret Key (P_KEY) und Private Key (PRIVATE_KEY) werden nicht erneut 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 das Häkchen bei Clear saved secret on save und klicken Sie auf Save.

Test Mode: Checkout-Sitzungen werden als Testtransaktionen angelegt. Kunden bezahlen mit ePayco-Testkarten, und es wird kein echtes Geld abgebucht. Testtransaktionen bezahlen niemals Bestellungen, die im Live-Modus angelegt wurden. Standard: aus. Solange er aktiv ist, sehen Kunden im Schritt Confirm Order und auf der Zahlungsseite TEST MODE — use ePayco test cards, no real money is charged..

Kasse

Checkout Type: so öffnet sich der ePayco-Checkout.

Bestätigungs-URL

Die Bestätigungs-URL teilt Ihrem Shop das Ergebnis einer Zahlung mit. Sie wird bei jeder Zahlung automatisch an ePayco übermittelt, daher ist im ePayco-Dashboard nichts einzurichten. Der Abschnitt zeigt die URL an. Unter OpenCart 3 sieht sie etwa so aus: https://your-store/index.php?route=extension/payment/wcp_epayco_payment/confirmation, unter OpenCart 4 so: https://your-store/index.php?route=extension/wcp_epayco_payment/payment/wcp_epayco_payment.confirmation. Sie wird aus der Storefront-Adresse Ihrer OpenCart-Installation gebildet. Sie muss aus dem Internet erreichbar sein und darf nicht durch eine Firewall oder eine Basis-Authentifizierung blockiert werden. Sie funktioniert auch, wenn der Shop im Wartungsmodus ist, weil OpenCart 3 Anfragen von Zahlungserweiterungen durchlässt und die Erweiterung auf OpenCart 4 dafür eine Startup-Aktion ergänzt.

Jede Bestätigung muss eine gültige Signatur haben, die mit Ihrer P_CUST_ID_CLIENTE und Ihrem P_KEY erstellt wurde. Bestätigungen ohne gültige Signatur werden abgelehnt und ändern nichts. Ohne die Bestätigung erhält eine Bestellung nur dann einen Status, wenn der Kunde nach der Zahlung in den Shop zurückkehrt.

Bestellungen

OpenCart legt die Bestellung im Schritt Confirm Order ohne Status an (eine fehlende Bestellung). Die Bestellung erhält erst einen Status, nachdem ePayco die Transaktion bestätigt hat. Eine abgelehnte oder abgebrochene Zahlung lässt die Bestellung ohne Status, und der Warenkorb bleibt erhalten. Jedes der folgenden Felder listet Ihre Bestellstatus aus OpenCart auf.

Order Status After Payment: ePayco hat die Zahlung genehmigt, und Betrag und Währung stimmen mit der Bestellung überein. Standard: Processing.

Awaiting Payment Status: ePayco hat die Zahlung als ausstehend oder zurückgehalten gemeldet (PSE-Überweisung, Barzahlungsnetze). Die Bestellung ändert sich automatisch, wenn ePayco sie genehmigt oder ablehnt. Standard: Pending.

On Hold (Review) Status: ePayco hat eine Zahlung genehmigt, deren Betrag oder Währung von der Bestellung abweicht, oder hat sie genehmigt, nachdem die Bestellung einen anderen Status erhalten hatte (zum Beispiel Canceled). Eine Notiz erklärt den Grund. Versenden Sie nicht, bevor Sie die Transaktion im ePayco-Dashboard geprüft haben. Standard: Pending, weil OpenCart keinen Status „On hold“ hat. Sie können unter System > Localisation > Order Statuses einen eigenen Status anlegen und hier auswählen.

Payment Failed Status: eine ausstehende Zahlung wurde abgelehnt, ist fehlgeschlagen, abgelaufen oder storniert. Eine neue genehmigte Zahlung bezahlt die Bestellung weiterhin. Standard: Failed.

Reversed Status: ePayco hat die Zahlung der Bestellung rückgängig gemacht. Standard: Refunded.

Erweitert

Logging: schreibt API-Fehler und Zahlungsbestätigungen in epc_p_debug.log.php im Logs-Ordner von OpenCart (storage/logs). Die Datei lässt sich nicht im Web öffnen; bei 5 MB wird sie nach epc_p_debug.old.log.php verschoben. Schlüssel und Kundendaten werden nicht protokolliert. Standard: aus. Fehler werden immer protokolliert, auch wenn diese Option aus ist.

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, entfernt das Deinstallieren der Erweiterung deren Einstellungen und das Protokoll. Die für Bestellungen gespeicherten ePayco-Daten bleiben immer erhalten. Standard: aus.

Import / Export

Export: Download JSON speichert die Einstellungen als JSON-Datei. Geheime Schlüssel werden nicht exportiert.

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

Kasse

Im Schritt Payment Method wählt der Kunde die Zahlungsart (standardmäßig ePayco). Im Schritt Confirm Order sieht der Kunde Ihre Beschreibung und den Hinweis After confirming the order you pay securely in the ePayco checkout (cards, PSE, cash, wallets). OpenCart legt die Bestellung in diesem Schritt an, weiterhin ohne Status. Auf OpenCart 4 wählt der Kunde die Zahlungsart über die Schaltfläche Choose des Zahlungsartblocks im Fenster Payment method options und klickt unten auf der Kassenseite auf Confirm Order. Wenn der Kunde auf Confirm Order klickt, erstellt die Erweiterung eine ePayco-Checkout-Sitzung für den Bestellbetrag in der Bestellwährung, mit den Steuern, der Bestellnummer sowie Rechnungsname, Adresse, E-Mail und Telefon. Die Zahlung erscheint bei ePayco als Order # mit der Bestellnummer. Die Sprache des Checkouts ist Spanisch oder Englisch, je nach Sprache des Kunden im Shop.

Anschließend sieht der Kunde die Seite ePayco payment mit Thank you for your order. The secure ePayco checkout opens automatically; if it does not, click the button below. Der ePayco-Checkout öffnet sich als Popup oder als Weiterleitung, je nach Checkout Type. Die Seite enthält außerdem die Schaltfläche Pay with ePayco und den Link Choose another payment method. Jedes neue Confirm Order erstellt eine neue ePayco-Sitzung (OpenCart 3 erstellt jedes Mal eine neue Bestellung, wenn der Schritt Confirm Order angezeigt wird, OpenCart 4 aktualisiert die Bestellung der Kasse, sodass ein neuer Versuch dieselbe Bestellung bezahlt). Ist für denselben Warenkorb bereits eine frühere Bestellung bezahlt oder wartet sie auf ePayco, wird der Kunde stattdessen zur Bestellerfolgsseite geleitet und nicht erneut belastet.

Im ePayco-Checkout bezahlt der Kunde mit einer der Zahlungsarten, die in Ihrem ePayco-Konto aktiviert sind. Danach sendet ePayco die Bestätigung an Ihren Shop und leitet den Kunden zurück. Die Bestellung wird erst als bezahlt markiert, wenn ePayco die Zahlung bestätigt hat: durch die signierte Bestätigung oder durch eine serverseitige Anfrage an ePayco, wenn der Kunde zurückkehrt. Die Rückkehr des Kunden allein bezahlt niemals eine Bestellung. 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 Bestellerfolgsseite von OpenCart.

Bei einer ausstehenden Zahlung (zum Beispiel PSE oder Barzahlung) erhält die Bestellung den Status Awaiting Payment Status, und die Erfolgsseite zeigt Your ePayco payment is being confirmed. We will e-mail you as soon as it is approved.. Wenn die ausstehende Zahlung bei der Rückkehr des Kunden bereits abgelehnt wurde oder abgelaufen ist, zeigt die Seite Your ePayco payment was not completed. Please contact us about this order.. Hat ePayco die Zahlung bei der Rückkehr des Kunden noch nicht bestätigt, zeigt eine Seite Payment confirmation den Text We are waiting for ePayco to confirm your payment. This page does not need to stay open. und die Schaltfläche Check again.

Wurde die Zahlung abgelehnt, kehrt der Kunde zur Kasse zurück und sieht Your ePayco payment was declined or could not be completed. You can try again or choose another payment method.. Kehrt der Kunde ohne Zahlung zurück, lautet die Meldung The ePayco payment was not completed. If you already paid, the order will be updated as soon as ePayco confirms it; otherwise you can try again.. Der Warenkorb bleibt erhalten, und die Bestellung bleibt ohne Status. Auf OpenCart 4 erscheinen diese Meldungen oberhalb der Kassenseite.

OpenCart 4 behält die Bestellung in der Kasse, bis die Erfolgsseite angezeigt wird. Wurde diese Bestellung inzwischen ohne ePayco-Zahlung geschlossen (etwa weil die ausstehende Zahlung fehlgeschlagen ist oder Sie storniert haben), wird der Kunde mit der Meldung über die abgelehnte Zahlung zurück zur Kasse geschickt, und der nächste Klick auf Confirm Order bezahlt eine neue Bestellung des Warenkorbs. Hat diese Bestellung bereits einen Status, der Warenkorb wurde seitdem aber geändert, auch durch eine neue Menge, wird der Kunde zur Kasse zurückgeschickt, und der nächste Klick auf Confirm Order bezahlt den neuen Warenkorb mit einer neuen Bestellung. Eine bezahlte Bestellung wird niemals als bezahlt für einen anderen Warenkorb angezeigt.

Wenn ePayco die Zahlung nicht starten kann, bleibt der Kunde im Schritt Confirm Order mit einer kurzen Meldung über der Schaltfläche, zum Beispiel We could not connect to ePayco. Please try again in a moment or choose another payment method.. Der technische Grund wird im Protokoll festgehalten.

Die Erweiterung unterstützt nur Einmalzahlungen. Es gibt keine Erstattungen aus dem Shop, keine gespeicherten Karten, Abonnements oder Teilzahlungen, und sie fragt ePayco nicht nach ausstehenden Transaktionen ab: Bestellungen werden durch die Bestätigung von ePayco und die Rückkehr des Kunden aktualisiert.

Bestellungen

Bestellstatus

No status (missing order): der Kunde wurde zu ePayco weitergeleitet und hat nicht bezahlt, ePayco hat die Zahlung noch nicht bestätigt, oder die Zahlung wurde abgelehnt. Unter Sales > Orders werden solche Bestellungen nur mit dem Filter Order Status auf Missing Orders angezeigt.

Order Status After Payment (default Processing): ePayco hat die Zahlung genehmigt. Eine Notiz zeigt die ePayco-Referenz, den Status, den Betrag, die Zahlungsart und den Genehmigungscode.

Awaiting Payment Status (default Pending): ePayco hat die Zahlung als ausstehend oder zurückgehalten gemeldet, zum Beispiel eine PSE-Überweisung oder eine Barzahlung. Wenn ePayco sie genehmigt, wechselt die Bestellung zu Order Status After Payment; wird sie abgelehnt, fehlgeschlagen, abgelaufen oder storniert, wechselt sie zu Payment Failed Status. OpenCart informiert den Kunden per E-Mail über diese Änderungen.

On Hold (Review) Status (default Pending): ePayco hat eine Zahlung genehmigt, deren Betrag oder Währung von der Bestellung abweicht, oder eine Zahlung genehmigt, nachdem Sie der Bestellung einen anderen Status gegeben haben (zum Beispiel Canceled). Die Notiz erklärt es. Prüfen Sie die Transaktion im ePayco-Dashboard, bevor Sie versenden.

Payment Failed Status (default Failed): eine ausstehende Zahlung ist nicht durchgegangen. Die Notiz zeigt den Grund von ePayco. Eine neue genehmigte Zahlung bezahlt die Bestellung weiterhin. Ein verspäteter Fehler verändert nie eine bezahlte Bestellung.

Reversed Status (default Refunded): ePayco hat die Zahlung, mit der diese Bestellung bezahlt wurde, rückgängig gemacht.

Meldet ePayco eine weitere genehmigte Zahlung für eine bereits bezahlte Bestellung, bleibt der Status unverändert. Eine Notiz bittet Sie, auf eine doppelte Belastung zu prüfen und diese bei Bedarf in ePayco zu erstatten. Bezahlt der Kunde eine zweite Bestellung desselben Warenkorbs (zum Beispiel aus zwei geöffneten ePayco-Fenstern), erhält diese Bestellung keinen Status, der Kunde sieht die Bestellerfolgsseite, und die bezahlte Bestellung erhält eine Notiz, die Sie bittet, die zweite Zahlung in ePayco zu erstatten. Eine Testtransaktion für eine im Live-Modus aufgegebene Bestellung sowie eine Transaktion, die bereits zu einer anderen Bestellung gehört, werden ignoriert. Notizen sind Einträge im History der Bestellung, die der Kunde nicht sieht.

Registerkarte VibeFox ePayco Payment

Öffnen Sie unter Sales > Orders eine mit ePayco bezahlte Bestellung. Unten auf der Bestellseite, neben History und Additional, zeigt die Registerkarte VibeFox ePayco Payment die ePayco reference (ref_payco), die Transaction ID, den State, die Payment method, den Approval code, das Transaction date, den Mode (mit der Bezeichnung Test mode bei Testzahlungen), den Attempt status und die ePayco notes der Bestellung. Bei einer Bestellung in der Prüfung zeigt die Registerkarte eine Warnung, die Transaktion vor dem Versand zu prüfen. Die Registerkarte ist nur lesbar und wird Benutzern angezeigt, die Zugriff auf die Erweiterung haben.

Erstattungen

Erstattungen aus dem Shop werden nicht unterstützt. Erstatten Sie die Zahlung im ePayco-Dashboard und aktualisieren Sie die Bestellung bei Bedarf manuell in OpenCart. Eine Stornierung der Zahlungstransaktion, die ePayco meldet, setzt die Bestellung auf Reversed Status. Produktrücksendungen unter Sales > Returns überweisen kein Geld über ePayco zurück.

Lizenzschlüssel

Die Erweiterung funktioniert mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock License — VibeFox ePayco Payment ist der erste Block unter Extensions > Extensions > Payments > VibeFox ePayco 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 gültig ist, und Ihre Domain) sowie die Schaltflächen Check now, um den Status erneut zu prüfen, Change key, um einen anderen Schlüssel einzugeben, und Remove key, um den Schlüssel aus diesem Shop zu entfernen. Darunter stehen die Zeile Product: opencart-payment-epayco 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 Adresse des Shops geändert hat oder 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 den Domain-Platz nicht frei. Geben Sie den Platz in Ihrem vibefox.net-Konto frei.

Ohne aktiven Schlüssel wird ePayco 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 Zahlungsart im Shop weiterhin, markiert mit (unlicensed — visible to admins only), damit 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 ohne aktiven Schlüssel die Zahlungsart für alle ausgeblendet. Nachdem Sie die Seite Edit einmal geöffnet haben, erscheint ein Hinweis auf dem Admin-Dashboard. 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, aber Updates und Support benötigen 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 wöchentlich. Ein Cron-Job ist nicht nötig. Das Deinstallieren der Erweiterung entfernt immer den Lizenzschlüssel und den Lizenzstatus.

Fehlerbehebung

ePayco does not appear at checkout: prüfen Sie, ob die Lizenz aktiv ist, Enable/Disable eingeschaltet ist, alle vier Schlüssel eingegeben sind und der Kunde in COP oder USD bezahlt. Die Einstellungsseite zeigt eine Warnung, wenn Schlüssel fehlen. Prüfen Sie außerdem, ob die Rechnungsadresse in der gewählten Geo Zone liegt und ob die Bestellung die in den Einstellungen festgelegte Total erreicht.

The payment went through, but the order stays without a status: die Bestätigung von ePayco erreicht Ihren Shop nicht. Prüfen Sie, ob die in den Einstellungen angezeigte Bestätigungs-URL aus dem Internet erreichbar ist und nicht durch eine Firewall, eine Sicherheitserweiterung oder eine Basis-Authentifizierung blockiert wird. Sehen Sie sich das Feld Log auf der Erweiterungsseite an; aktivieren Sie Logging, um jede Bestätigung zu sehen. Die Bestellung erhält ihren Status auch, wenn der Kunde nach der Zahlung in den Shop zurückkehrt.

Confirmation answers Invalid signature: Customer ID (P_CUST_ID_CLIENTE) oder Secret Key (P_KEY) stimmt nicht mit dem ePayco-Konto überein, das die Zahlung erhalten hat. Kopieren Sie beide erneut aus dem ePayco-Dashboard.

Confirmation answers Gateway not configured: P_CUST_ID_CLIENTE oder P_KEY ist leer. Tragen Sie sie in den Einstellungen ein.

Confirmation answers Order not found: die Bestätigung bezieht sich auf eine Bestellung ohne eine ePayco-Zahlung dieses Shops.

Confirmation answers Busy, retry later: die Bestellung wurde im selben Moment von einer anderen Anfrage aktualisiert. ePayco wiederholt die Bestätigung. Der Grund steht im Protokoll.

The customer sees We could not connect to ePayco: ePayco hat PUBLIC_KEY und PRIVATE_KEY abgelehnt. Das Protokoll zeigt die Antwort von ePayco. Kopieren Sie beide Schlüssel erneut.

The customer sees ePayco could not start the payment: ePayco hat die Checkout-Sitzung nicht erstellt. Lesen Sie im Protokoll den ePayco-Fehler.

The customer sees This payment method is not available right now: die Checkout-Sitzung passt nicht mehr zur Bestellung, die Zahlungsart wurde zwischenzeitlich deaktiviert oder die Schlüssel wurden entfernt. Der Kunde lädt die Kasse neu.

The ePayco checkout does not open: der Kunde sieht The ePayco checkout could not be loaded. Please reload the page or choose another payment method. Das Skript des ePayco-Checkouts konnte auf der Zahlungsseite nicht geladen werden. Der Kunde kann die Seite neu laden oder Choose another payment method verwenden.

A test payment did not pay the order: Testtransaktionen bezahlen niemals Bestellungen, die im Live-Modus aufgegeben wurden. Geben Sie die Testbestellung auf, während Test Mode aktiv ist.

Order is in the review status after payment: lesen Sie die Notizen auf der Registerkarte VibeFox ePayco Payment (siehe Bestellstatus) und prüfen Sie die Transaktion im ePayco-Dashboard, bevor Sie versenden.

Deinstallation

Gehen Sie zu Extensions > Extensions, wählen Sie den Typ Payments und klicken Sie neben VibeFox ePayco Payment 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 im Bereich Orders, die bei einer erneuten Installation auf ihre Standardwerte zurückgesetzt werden. Auch das OpenCart-Event der Erweiterung wird entfernt (auf OpenCart 4 seine Events und seine Startup-Aktion, die die Bestätigung und die Rückkehr des Kunden im Wartungsmodus durchlässt). Ist Delete Data on Uninstall aktiviert, werden die übrigen Zahlungseinstellungen (Titel, Beschreibung, Schlüssel, Testmodus, Checkout-Typ, Logging) und das Protokoll entfernt. Ist die Option deaktiviert, bleiben sie für eine spätere Neuinstallation erhalten. Die für Bestellungen gespeicherten ePayco-Daten bleiben immer erhalten, sodass späte Bestätigungen alter Bestellungen nach einer Neuinstallation weiterhin funktionieren. Bestehende Bestellungen behalten ihre Zahlungsnotizen.

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

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