VibeFox CCAvenue 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 Verschlüsseln der Anfrage und zum Entschlüsseln der Antwort benötigt).

CCAvenue-Konto: Sie benötigen ein CCAvenue-Händlerkonto mit einer Merchant ID, einem Access Code und einem Working Key. Access Code und Working Key werden für eine Website-Domain ausgestellt, erzeugen Sie sie daher für die Domain dieses Shops. CCAvenue verwendet dieselben Zugangsdaten für die Testumgebung; der Testzugang muss für Ihr Konto von CCAvenue aktiviert werden. Die Erweiterung verwendet die Endpunkte von CCAvenue India.

Währung: Die Bestellwährung wird unverändert an CCAvenue übermittelt. CCAvenue-Konten akzeptieren standardmäßig INR; andere Währungen erfordern die Mehrwährungsverarbeitung in Ihrem CCAvenue-Konto.

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_ccavenue_payment-oc3-(version).ocmod.zip und das Paket für OpenCart 4 wcp_ccavenue_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 Administrationsbereich zu Extensions > Installer, klicken Sie auf Upload und wählen Sie die Datei wcp_ccavenue_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 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 CCAvenue Payment und klicken Sie auf Install (die grüne +-Schaltfläche). Ihr Administratorbenutzer benötigt das Recht, die Liste der Zahlungserweiterungen zu bearbeiten.

3. Klicken Sie auf Edit (die Stift-Schaltfläche), 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 Lizenzschlüssel).

4. Geben Sie die Merchant ID, den Access Code und den Working Key aus Ihrem CCAvenue-Dashboard ein, aktivieren Sie Enable/Disable und klicken Sie auf Save.

5. Lassen Sie Test mode während der Tests eingeschaltet und schalten Sie ihn danach aus, um echte Zahlungen anzunehmen. Im CCAvenue-Dashboard muss nichts eingerichtet werden: Die Rücksprung-Adresse wird bei jeder Zahlung mitgesendet.

OpenCart 4

1. Gehen Sie im Administrationsbereich zu Extensions > Installer, klicken Sie auf Upload und wählen Sie die Datei wcp_ccavenue_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 (die grüne +-Schaltfläche).

3. Gehen Sie zu Extensions > Extensions und wählen Sie den Typ Payments. Suchen Sie VibeFox CCAvenue Payment, klicken Sie auf Install (die grüne +-Schaltfläche) und danach auf Edit (die Stift-Schaltfläche).

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

Eine neue Installation startet mit deaktivierter Zahlungsart und eingeschaltetem Testmodus.

Konfiguration

Alle Einstellungen befinden sich auf der Erweiterungsseite: Extensions > Extensions > Payments > VibeFox CCAvenue Payment > Edit. Die Abschnitte sind links aufgelistet; die Schaltfläche Save unter der Liste speichert die gesamte Seite. Oberhalb der Einstellungen warnt die Seite, wenn CCAvenue aktiviert ist, aber Merchant ID, Access Code oder Working Key fehlt (die Zahlungsart wird an der Kasse dann ausgeblendet, bis alle drei gesetzt sind). Solange die Zahlungsart im Testmodus aktiviert ist, zeigt die Seite CCAvenue test mode is on: customers are sent to test.ccavenue.com and no real money is taken. an. Außerdem erinnert sie an die Mehrwährungsverarbeitung, wenn die Standardwährung des Shops nicht INR ist. Ohne das Recht, die Erweiterung zu bearbeiten, zeigt die Seite die Einstellungen an, kann sie aber nicht speichern.

Beim Speichern darf Title nicht leer sein (höchstens 128 Zeichen), Sort Order muss eine ganze Zahl sein, Total muss eine Zahl von 0 oder mehr sein, und die Geozone sowie die Bestellstatus müssen vorhanden sein; andernfalls wird nichts gespeichert.

CCAvenue

Enable/Disable: Enable CCAvenue Payment Gateway 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: CCAvenue. Pflichtfeld.

Description: der Text, den der Kunde im Schritt Confirm Order über der Bestätigungsschaltfläche sieht. Standard: Pay securely via Credit/Debit card, Net Banking, UPI or Wallet through CCAvenue.

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

Geo Zone: bietet CCAvenue nur für Rechnungsadressen in der ausgewählten Geozone an. Standard: All zones. Geozonen werden unter System > Localisation > Geo Zones eingerichtet.

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

API-Zugangsdaten

Melden Sie sich im CCAvenue-Händlerbereich (M.A.R.S.) an und öffnen Sie Settings > API Keys. Erzeugen Sie Access Code und Working Key für die Domain dieses Shops. Leerzeichen in den Zugangsdaten werden beim Speichern entfernt.

Merchant ID: Ihre numerische CCAvenue Merchant ID. Enthält sie etwas anderes als Ziffern, wird beim Speichern die Meldung CCAvenue: the Merchant ID must contain digits only — the previous value was kept. angezeigt. Der zuvor gespeicherte Wert bleibt erhalten, und die übrigen Einstellungen werden gespeichert.

Access Code: der Access Code für diese Website (Settings > API Keys).

Working Key: der Working Key (Verschlüsselungsschlüssel) für diese Website. Er verschlüsselt die Zahlungsanfrage und ist die einzige Möglichkeit, die Antwort von CCAvenue zu prüfen. Halten Sie ihn daher geheim. Ein gespeicherter Working Key wird 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 ihn zu entfernen, aktivieren Sie unter dem Feld Clear saved Working Key und klicken Sie auf Save.

Test mode: schickt Kunden in die Testumgebung von CCAvenue (test.ccavenue.com). CCAvenue verwendet dieselben Merchant ID, Access Code und Working Key für Test und Live; der Testzugang muss für Ihr Konto von CCAvenue aktiviert werden. Im Testmodus zeigt der Schritt Confirm Order die Meldung TEST MODE: no real transactions will be processed. Standard: an. Für echte Zahlungen ausschalten.

Rücksprung-URL

CCAvenue leitet den Kunden zu der Adresse zurück, die in diesem Abschnitt angezeigt wird. Sie hat in OpenCart 3 die Form https://your-store/index.php?route=extension/payment/wcp_ccavenue_payment/back und in OpenCart 4 die Form https://your-store/index.php?route=extension/wcp_ccavenue_payment/payment/wcp_ccavenue_payment.back. Sie wird aus der Shop-Adresse Ihrer OpenCart-Installation gebildet. Die Erweiterung sendet diese URL bei jeder Zahlung mit (als Weiterleitungs- und Abbruch-URL), daher muss in CCAvenue nichts eingerichtet werden. Sie muss zur bei CCAvenue registrierten Domain gehören.

Bestellungen

OpenCart legt die Bestellung im Schritt Confirm Order ohne Status an (eine fehlende Bestellung). Die Bestellung erhält erst dann einen Status, wenn die verschlüsselte Antwort von CCAvenue geprüft wurde. Eine fehlgeschlagene oder abgebrochene Zahlung lässt die Bestellung ohne Status, und der Kunde kehrt mit erhaltenem Warenkorb zur Kasse zurück. Jedes der folgenden Felder bietet Ihre Bestellstatus aus OpenCart zur Auswahl.

Order Status After Payment: eine erfolgreiche Zahlung (CCAvenue-Status Success, Betrag und Währung geprüft). Standard: In Bearbeitung.

Awaiting Payment Status: Awaited: Die Bank hat die Zahlung noch nicht bestätigt. Die Bestellung erhält Order Status After Payment, sobald CCAvenue für dieselbe Tracking-ID Success meldet. Standard: Zahlung ausstehend.

On Hold (Review) Status: CCAvenue meldete einen anderen Betrag oder eine andere Währung als die Bestellsumme, oder eine Zahlung ging für eine stornierte Bestellung ein. Eine Notiz erklärt dies. Standard: Zahlung ausstehend, da OpenCart keinen Status Wartend hat. Sie können unter System > Localisation > Order Statuses einen eigenen Status anlegen und hier auswählen.

Cancelled Payment Status: eine ausstehende Zahlung wurde danach abgebrochen (Aborted für dieselbe Tracking-ID). Standard: Storniert.

Failed Payment Status: eine ausstehende Zahlung ist danach fehlgeschlagen (Failure, Invalid oder Timeout für dieselbe Tracking-ID). Ein Fehler eines älteren Versuchs ändert die Bestellung nicht. Standard: Fehlgeschlagen.

Erweitert

Debug log: schreibt CCAvenue-Ereignisse in ccavenue_p_debug.log.php im Logs-Ordner von OpenCart (storage/logs). Die Datei kann nicht über das Web geöffnet werden. Protokolliert werden nur Bestellreferenzen, Tracking-IDs und Status; Schlüssel, Kartendaten, E-Mail-Adressen und Adressen werden nicht protokolliert. Standard: aus. Solange er ausgeschaltet 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, entfernt die Deinstallation der Erweiterung deren Einstellungen und das Protokoll. Bestellungen und die CCAvenue-Zahlungsreferenzen bleiben erhalten, sodass die verspätete Rückkehr einer alten Zahlung auch nach einer Neuinstallation verarbeitet wird. Standard: aus.

Import / Export

Export: Download JSON speichert die Einstellungen als JSON-Datei. Der Working Key wird nicht exportiert.

Import: Fügen Sie zuvor exportiertes JSON ein und klicken Sie auf Import, um die Einstellungen wiederherzustellen. Der gespeicherte Working Key bleibt erhalten.

Kasse

Im Schritt Payment Method wählt der Kunde die Zahlungsart (standardmäßig CCAvenue). Im Schritt Confirm Order sieht der Kunde Ihre Beschreibung. OpenCart legt die Bestellung in diesem Schritt an, weiterhin ohne Status. Wenn der Kunde auf Confirm Order klickt, zeigt der Schritt Thank you for your order. You are being redirected to CCAvenue to complete the payment. an und leitet den Kunden zur Zahlungsseite von CCAvenue weiter. Während der Browser dorthin wechselt, wird eine Schaltfläche Pay via CCAvenue angezeigt. In OpenCart 4 wählt der Kunde die Zahlungsart mit der Schaltfläche Choose im Block der Zahlungsarten im Fenster Payment method options und klickt unten auf der Kassenseite auf Confirm Order.

Jeder Versuch erhält eine neue CCAvenue-Bestellreferenz, die aus der OpenCart-Bestellnummer und der Uhrzeit besteht. Bestellsumme und Währung, die Rechnungsdaten, die Lieferadresse (wenn die Bestellung versendet wird und die Lieferadresse von der Rechnungsadresse abweicht) sowie ein geheimes Token des Versuchs werden in der verschlüsselten Anfrage übermittelt. Namen und Adressen werden auf die Zeichen und Längen bereinigt, die CCAvenue akzeptiert; Land und Bundesland werden als Namen übermittelt, die Telefonnummer nur als Ziffern. Der Kunde wählt auf der Seite von CCAvenue Karte, Net Banking, UPI, Wallet oder EMI. OpenCart 4 fragt standardmäßig keine Zahlungsadresse ab; die Rechnungsdaten werden dann aus der Lieferadresse übernommen.

Nach der Zahlung leitet CCAvenue den Kunden mit einer verschlüsselten Antwort zurück. Die Bestellung wird erst als bezahlt markiert, wenn CCAvenue die Zahlung bestätigt: Die Antwort muss mit Ihrem Working Key entschlüsselt werden, zu einem Versuch dieses Shops gehören und denselben Betrag und dieselbe Währung aufweisen wie gesendet und wie die Bestellsumme. Danach erhält die Bestellung ihren Status auf die übliche Weise von OpenCart, mit den üblichen Bestell-E-Mails und der Bestandsaktualisierung, und der Kunde sieht die Erfolgsseite der OpenCart-Bestellung mit Your CCAvenue payment has been received. Bei einer Zahlung mit dem Status Awaited zeigt die Seite Your CCAvenue payment is awaiting confirmation from your bank. The order will be processed as soon as the payment is confirmed. Nach einer Abweichung von Betrag oder Währung zeigt sie Your payment was received and is being reviewed by the store. In OpenCart 4 sendet der Browser die Sitzung des Shops nicht mit, wenn CCAvenue den Kunden zurückschickt. Daher zeigt die Erweiterung nach der Verarbeitung der Antwort eine kurze Seite, die die Rücksprung-Adresse erneut von Ihrem Shop aus öffnet: Der Kunde behält den Warenkorb und die Anmeldung.

Schlägt die Zahlung fehl, kehrt der Kunde mit Payment was not completed. Please try again or choose a different payment method. zur Kasse zurück. Bricht der Kunde auf der Seite von CCAvenue ab, lautet die Meldung Payment was cancelled. You may try again. Kann die Antwort nicht geprüft werden, lautet die Meldung We could not confirm the payment result. If your account was charged, please contact us before paying again. Bei OpenCart 4 werden diese Meldungen oberhalb der Kassenseite angezeigt. In diesen Fällen bleibt die Bestellung ohne Status und der Warenkorb wird erhalten, sodass der Kunde erneut zahlen kann. OpenCart 3 legt jedes Mal eine neue Bestellung an, wenn der Schritt Confirm Order angezeigt wird; OpenCart 4 behält eine Bestellung für die Kasse und aktualisiert sie. Jeder Versuch erhält seine eigene CCAvenue-Bestellreferenz. CCAvenue kann eine begonnene Zahlung nicht abbrechen; daher wird eine verspätete erfolgreiche Zahlung eines älteren Versuchs trotzdem seiner eigenen Bestellung zugeordnet. Ein Warenkorb wird nur einmal bezahlt: Ein Warenkorb, der bereits durch eine andere Bestellung bezahlt wurde, wird nicht erneut an CCAvenue gesendet (der Kunde gelangt zur Erfolgsseite). Wird derselbe Warenkorb trotzdem zweimal bezahlt (zum Beispiel in zwei Browser-Tabs), bleibt die zweite Bestellung ohne Status, und die bezahlte Bestellung erhält eine Notiz, dass der Kunde möglicherweise doppelt belastet wurde, damit Sie die Zahlung im CCAvenue-Dashboard zurückerstatten können.

OpenCart 4 behält die Bestellung in der Kasse, bis die Erfolgsseite angezeigt wird. Wurde diese Bestellung inzwischen ohne Zahlung geschlossen (zum Beispiel, weil ihre ausstehende Zahlung abgebrochen wurde oder fehlgeschlagen ist, oder weil Sie sie geschlossen haben), schickt Confirm Order den Kunden zurück zur Kasse, und das nächste Confirm Order bezahlt eine neue Bestellung des Warenkorbs. Die Meldung lautet Payment was cancelled. You may try again., wenn eine ausstehende Zahlung abgebrochen wurde, Payment was not completed. Please try again or choose a different payment method., wenn sie fehlgeschlagen ist, und This order can no longer be paid (it was closed by the store). Please confirm your order again., wenn Sie eine Bestellung mit einer Zahlung geschlossen haben. Hat die Bestellung bereits einen Status und hat sich der Warenkorb seitdem geändert (andere Produkte oder Mengen), lautet die Meldung Your previous order is already paid. Please confirm the order again: the cart will be paid with a new order.

Das Ergebnis wird nur aus der Rückkehr des Kunden von CCAvenue übernommen: Es gibt keine Benachrichtigungen von Server zu Server und keine Statusabfragen. Schließt der Kunde den Browser, bevor er zurückkehrt, bleibt die Bestellung ohne Status; prüfen Sie die Zahlung dann im CCAvenue-Dashboard. Die Erweiterung unterstützt keine Erstattungen aus OpenCart, keine gespeicherten Karten, Abonnements oder wiederkehrenden Zahlungen, kein Kartenformular im Shop und keine Unterstützung für CCAvenue UAE oder andere regionale Plattformen.

Bestellungen

Bestellstatus

Kein Status (fehlende Bestellung): Der Kunde wurde zu CCAvenue weitergeleitet und ist nicht zurückgekehrt, oder die Zahlung ist fehlgeschlagen oder abgebrochen worden. In Sales > Orders werden solche Bestellungen nur mit dem Filter Order Status auf Missing Orders angezeigt. Prüfen Sie die Zahlung im CCAvenue-Dashboard, wenn der Kunde nicht zurückkehrt.

Order Status After Payment (default Processing): Die Zahlung wurde bestätigt. Eine Notiz zeigt die Bankreferenz, die Tracking-ID und den Zahlungsmodus.

Awaiting Payment Status (default Pending): CCAvenue hat die Zahlung als Awaited gemeldet (die Bank hat sie noch nicht bestätigt). Die Bestellung wird nie als fehlgeschlagen markiert, solange das Geld noch eingezogen werden kann, und eine Notiz bittet, die Zahlung im CCAvenue-Dashboard zu prüfen, bevor die Bestellung bearbeitet wird. Eine spätere Antwort mit derselben Tracking-ID wird trotzdem angewendet: Success setzt Order Status After Payment, Failure setzt Failed Payment Status, Aborted setzt Cancelled Payment Status. OpenCart benachrichtigt den Kunden über diese Änderungen.

On Hold (Review) Status (default Pending): CCAvenue hat eine Zahlung bestätigt, deren Betrag oder Währung von der Bestellsumme oder von dem Gesendeten abweicht, oder der Kunde hat gezahlt, nachdem die Bestellung storniert oder fehlgeschlagen war. Die Notiz zeigt den erhaltenen und den erwarteten Betrag. Prüfen Sie die Zahlung im CCAvenue-Dashboard und bearbeiten Sie dann die Bestellung oder erstatten Sie die Zahlung.

Ein verspäteter Fehlschlag ändert nie eine bezahlte Bestellung, und eine Bestellung, die Sie manuell abgeschlossen haben, wird nicht geändert. Trifft eine weitere erfolgreiche Zahlung für eine bereits bezahlte Bestellung ein (zum Beispiel aus zwei Browser-Tabs), wird die Bestellung nicht geändert. Eine Notiz bittet, das Duplikat im CCAvenue-Dashboard zu erstatten.

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

VibeFox CCAvenue Payment tab

Öffnen Sie in Sales > Orders eine mit CCAvenue bezahlte Bestellung. Am unteren Rand der Bestellseite zeigt der Reiter VibeFox CCAvenue Payment, neben History und Additional, die CCAvenue order ID mit der Kennzeichnung Test mode bei Testzahlungen, die Tracking ID, den Status, die Bank reference, den Payment mode und den Kartennamen, den Amount sent und den Amount received, das Date, die Message von CCAvenue und die CCAvenue notes der Bestellung. Der Reiter wird Benutzern angezeigt, die Zugriff auf die Erweiterung haben.

Erstattungen

Erstattungen aus OpenCart werden nicht unterstützt. Erstatten Sie die Zahlung im CCAvenue-Dashboard und erfassen Sie die Erstattung danach manuell in OpenCart, zum Beispiel durch Änderung des Bestellstatus.

Lizenzschlüssel

Die Erweiterung arbeitet mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock License — VibeFox CCAvenue Payment ist der erste Block unter Extensions > Extensions > Payments > VibeFox CCAvenue 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-ccavenue und der Link Manage licenses and domains in your account, der Ihr vibefox.net-Konto öffnet. Nur Administratoren mit der Berechtigung Modify für die Erweiterung können den Schlüssel ändern. Die Texte des Blocks folgen der Administrationssprache (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 einen Domain-Platz in Ihrem Konto freigegeben haben, klicken Sie auf Check now. Kann der Lizenzserver nicht erreicht werden, arbeitet die Erweiterung mit dem zuletzt bekannten Status weiter.

Ein Schlüssel funktioniert auf einer Domain: der 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 CCAvenue Kunden an der Kasse nicht angezeigt. Wird dennoch eine Zahlung gestartet, sieht der Kunde This payment method is not available. Please choose another one. Ein Administrator, der im Administrationsbereich im selben Browser angemeldet ist, sieht die Zahlungsart im Shop weiterhin, gekennzeichnet als (unlicensed — visible to admins only), damit Sie die Erweiterung vor dem Kauf eines Schlüssels einrichten und testen können. Bei OpenCart 4 steht diese Vorschau nicht zur Verfügung: Der Shop sieht die Anmeldung im Administrationsbereich 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 des Administrationsbereichs eine Erinnerung. Schließen Sie sie mit ×, um sie 7 Tage lang auszublenden. Bestehende Bestellungen sind nicht betroffen: Bereits gestartete Zahlungen werden weiterhin bestätigt, wenn der Kunde von CCAvenue zurückkehrt.

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

Fehlerbehebung

CCAvenue does not appear at checkout: Prüfen Sie, ob die Lizenz aktiv ist, Enable/Disable eingeschaltet ist und alle drei Zugangsdaten gesetzt sind: Merchant ID, Access Code und Working Key. Die Einstellungsseite zeigt eine Warnung, wenn eines davon fehlt. Prüfen Sie außerdem, ob die Rechnungsadresse in der gewählten Geo Zone liegt und ob die Bestellung den in den Einstellungen festgelegten Total erreicht.

The payment went through, but the order stays without a status: Der Kunde ist nicht von CCAvenue zu Ihrem Shop zurückgekehrt, zum Beispiel weil der Browser geschlossen wurde. Die Erweiterung hat keine Benachrichtigungen von Server zu Server. Prüfen Sie die Zahlung im CCAvenue-Dashboard und aktualisieren Sie die Bestellung manuell.

Every payment ends with We could not confirm the payment result: Die Antwort kann nicht entschlüsselt werden. Der Working Key ist falsch, gehört zu einer anderen Domain oder wurde mit zusätzlichen Zeichen kopiert. Erzeugen Sie die Schlüssel für die Domain dieses Shops und fügen Sie sie erneut ein. Aktivieren Sie Debug log und sehen Sie sich das Feld Log auf der Erweiterungsseite an.

CCAvenue shows an error before the payment page: Prüfen Sie, ob Access Code und Working Key für diese Domain erzeugt wurden, ob die Rücksprung-URL zur bei CCAvenue registrierten Domain gehört und ob CCAvenue im Testmodus den Testzugang für Ihr Konto aktiviert hat. Für eine andere Währung als INR muss die Mehrwährungsverarbeitung in Ihrem CCAvenue-Konto aktiviert sein.

The customer sees This payment method is temporarily unavailable: Eine der Zugangsdaten fehlt oder der Bestellbetrag ist null. Debug log zeigt den Grund.

The customer sees This payment method is not available. Please reload the checkout page.: Die Sitzung der Kasse passt nicht mehr zur Bestellung, oder die Zahlungsart wurde in der Zwischenzeit ausgeschaltet. Der Kunde lädt die Kasse neu.

The customer sees Payment gateway error: encryption failed: Die Anfrage konnte nicht verschlüsselt werden. Prüfen Sie, ob die PHP-Erweiterung OpenSSL installiert ist.

The Merchant ID does not change on save: Der Wert enthält etwas anderes als Ziffern. Geben Sie nur die Zahlen Ihrer Merchant ID ein.

Order is in the review or awaiting status: Lesen Sie die Notizen im Reiter VibeFox CCAvenue Payment (siehe Bestellstatus). Prüfen Sie die Zahlung im CCAvenue-Dashboard und bearbeiten Sie dann die Bestellung oder erstatten Sie die Zahlung.

Für Entwickler: Bevor die Anfrage verschlüsselt wird, löst die Erweiterung das OpenCart-Ereignis ccavenue_p_request_params mit den Anfrageparametern und der Bestellung aus (zum Beispiel, um merchant_param2 bis merchant_param5 zu setzen; ändern Sie amount, currency, order_id oder merchant_param1 nicht).

Deinstallation

Gehen Sie zu Extensions > Extensions, wählen Sie den Typ Payments und klicken Sie neben VibeFox CCAvenue 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 Neuinstallation auf ihre Standardwerte zurückgesetzt werden. Auch das OpenCart-Ereignis der Erweiterung wird entfernt (bei OpenCart 4 auch deren Ereignisse und Startaktion, die die Rückkehr des Kunden im Wartungsmodus durchlässt). Ist Delete data on uninstall eingeschaltet, werden die übrigen Einstellungen der Erweiterung (Titel, Beschreibung, Zugangsdaten, Testmodus, Protokollierung) und das Protokoll entfernt. Ist die Option ausgeschaltet, bleiben sie für eine spätere Neuinstallation erhalten. Die CCAvenue-Zahlungsreferenzen bleiben immer erhalten. 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 CCAvenue Payment auf Uninstall (der orangefarbene −-Button) und danach auf Delete (der rote Papierkorb-Button), um das hochgeladene Paket zu entfernen.

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