VibeFox CCAvenue for WooCommerce — Hilfe

Anforderungen

WordPress: 5.8 oder neuer.

WooCommerce: 6.0 oder neuer, installiert und aktiv. Das Plugin lässt sich ohne WooCommerce nicht aktivieren.

PHP: 8.0 oder neuer, mit der OpenSSL-Erweiterung (zum Verschlüsseln der Anfrage und Entschlüsseln der Antwort).

CCAvenue-Konto: Sie benötigen ein CCAvenue-Händlerkonto mit Merchant ID, Access Code und 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 für die Testumgebung dieselben Zugangsdaten; den Testzugang muss CCAvenue für Ihr Konto freischalten. Das Plugin nutzt die Endpunkte von CCAvenue Indien.

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

VibeFox-Lizenzschlüssel: erhältlich auf vibefox.net. Ein Schlüssel gilt für eine Domain.

Installation

1. Gehen Sie in WordPress zu Plugins > Add New > Upload Plugin, wählen Sie die ZIP-Datei des Plugins und klicken Sie auf Install Now. Alternativ können Sie den Ordner wcp_ccavenue_payment per FTP nach /wp-content/plugins/ hochladen.

2. Klicken Sie auf Activate.

3. Öffnen Sie die Einstellungen: WooCommerce > Settings > Payments > CCAvenue > Manage, oder klicken Sie auf der Plugins-Seite unter dem Plugin-Namen auf Settings.

4. Geben Sie Ihren VibeFox-Lizenzschlüssel im Lizenzblock oben auf der Seite ein und klicken Sie auf Activate.

5. Tragen Sie Merchant ID, Access Code und Working Key aus Ihrem CCAvenue-Dashboard ein und schalten Sie Enable/Disable ein.

6. Lassen Sie Test mode während der Tests eingeschaltet und schalten Sie ihn danach aus, um echte Zahlungen anzunehmen.

Konfiguration

Alle Einstellungen befinden sich auf einer Seite: WooCommerce > Settings > Payments > CCAvenue. Oberhalb der Felder warnt die Seite, wenn CCAvenue aktiviert ist, aber Merchant ID, Access Code oder Working Key fehlt (die Zahlungsmethode wird dann an der Kasse ausgeblendet, bis alle drei eingetragen sind). Solange der Testmodus eingeschaltet ist, zeigt sie CCAvenue test mode is on: customers are sent to test.ccavenue.com and no real money is taken. Ist die Shopwährung nicht INR, erinnert sie außerdem an die Mehrwährungsabwicklung.

Allgemein

Enable/Disable: Enable CCAvenue Payment Gateway schaltet die Zahlungsmethode ein oder aus. Standard: aus.

Title: der Name der Zahlungsmethode, den Kunden an der Kasse sehen. Standard: CCAvenue.

Description: der Text unter der Zahlungsmethode an der Kasse. Standard: Pay securely via Credit/Debit card, Net Banking, UPI or Wallet through CCAvenue.

API-Zugangsdaten

Melden Sie sich in Ihrem CCAvenue-Händler-Dashboard (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 andere Zeichen als Ziffern, erscheint beim Speichern eine Fehlermeldung, und der zuvor gespeicherte Wert bleibt erhalten.

Access Code: der Access Code für diese Website.

Working Key: der Working Key (Verschlüsselungsschlüssel) für diese Website. Er verschlüsselt die Zahlungsanfrage und ist der einzige Weg, die Antwort von CCAvenue zu prüfen. Halten Sie ihn daher geheim.

Test mode: Send customers to the CCAvenue test environment (test.ccavenue.com). CCAvenue verwendet dieselbe Merchant ID, denselben Access Code und denselben Working Key für Test- und Live-Betrieb; den Testzugang muss CCAvenue für Ihr Konto freischalten. Im Testmodus zeigt die Kasse TEST MODE: no real transactions will be processed. Standard: ein. Schalten Sie ihn für echte Zahlungen aus.

Rückkehr-URL

CCAvenue leitet den Kunden an die Adresse zurück, die in diesem Abschnitt angezeigt wird. Sie sieht so aus: https://your-site/wc-api/ccavenue_p_callback/. Das Plugin übergibt diese URL bei jeder Zahlung, daher müssen Sie in CCAvenue nichts einrichten. Sie muss zur Domain gehören, die bei CCAvenue registriert ist.

Erweitert

Debug log: Log CCAvenue events schreibt Bestell-IDs, CCAvenue-Referenzen und Status in WooCommerce > Status > Logs, Quelle wcp_ccavenue_payment. Schlüssel, Karten- und Adressdaten werden nicht protokolliert. Standard: aus.

Delete data on uninstall: Remove the plugin settings, logs and CCAvenue order references when the plugin is deleted. Das Deaktivieren des Plugins löscht nie etwas. Standard: aus.

Kasse

Der Kunde wählt die Zahlungsmethode (standardmäßig CCAvenue) und gibt die Bestellung auf. Die Seite Pay for order zeigt Thank you for your order. You are being redirected to CCAvenue to complete the payment. und leitet den Kunden zur CCAvenue-Zahlungsseite weiter. Ohne JavaScript klickt der Kunde auf Pay via CCAvenue oder Cancel order. Jeder Versuch erhält eine neue CCAvenue-Bestellreferenz. Bestellbetrag und Währung, Rechnungs- und Lieferdaten sowie der Bestellschlüssel werden in der verschlüsselten Anfrage übermittelt. Namen und Adressen werden auf die Zeichen und Längen bereinigt, die CCAvenue akzeptiert; Land und Bundesstaat werden als Namen gesendet, die Telefonnummer nur als Ziffern.

Nach der Zahlung kehrt der Kunde mit einer verschlüsselten Antwort von CCAvenue zurück. Die Bestellung wird erst als bezahlt markiert, wenn CCAvenue die Zahlung bestätigt: Die Antwort muss sich mit Ihrem Working Key entschlüsseln lassen, zu dieser Bestellung gehören und denselben Betrag und dieselbe Währung wie die Bestellung ausweisen. Danach gelangt der Kunde auf die Bestellbestätigungsseite.

Schlägt die Zahlung fehl, kehrt der Kunde zur Kasse zurück und sieht Payment was not completed. Please try again or choose a different payment method. Bricht der Kunde auf der CCAvenue-Seite ab, lautet die Meldung Payment was cancelled. You may try again. Lässt sich die Antwort nicht prüfen, lautet die Meldung We could not confirm the payment result. If your account was charged, please contact us before paying again. Der Kunde kann eine unbezahlte Bestellung erneut bezahlen, zum Beispiel über die Seite Pay for order. Wurde die Zahlung von der Seite Pay for order aus gestartet und ist der Warenkorb leer, zeigt WooCommerce die Meldung auf der Warenkorbseite; eine fehlgeschlagene Bestellung kann über My account > Orders erneut bezahlt werden.

Die Zahlungsmethode funktioniert auf der klassischen Kasse, im Kassen-Block und auf der Seite Pay for order. Sie ist mit WooCommerce High-Performance Order Storage (HPOS) kompatibel. Die Kundentexte sind ins Hindi übersetzt.

Das Ergebnis wird nur aus der Rückkehr des Kunden von CCAvenue übernommen: Es gibt keine Benachrichtigungen per Server-zu-Server-Verbindung und keine Statusabfragen. Schließt der Kunde den Browser, bevor er zurückkehrt, bleibt die Bestellung auf Zahlung ausstehend. Das Plugin bietet keine Erstattungen aus WooCommerce, keine gespeicherten Karten, Abonnements oder wiederkehrenden Zahlungen, kein iframe und kein Kartenformular auf der Website und keine Unterstützung für CCAvenue UAE oder andere regionale Plattformen.

Bestellungen

Bestellstatus

Pending payment: Der Kunde wurde zu CCAvenue weitergeleitet und ist noch nicht zurückgekehrt. Kehrt der Kunde nicht zurück, prüfen Sie die Zahlung im CCAvenue-Dashboard.

Processing: Die Zahlung wurde bestätigt (Bestellungen mit ausschließlich virtuellen, herunterladbaren Produkten werden, wie in WooCommerce voreingestellt, auf Abgeschlossen gesetzt). Die Bestellnotiz zeigt die Bankreferenz, die CCAvenue-Tracking-ID und den Zahlungsmodus. Die Transaktions-ID der Bestellung ist die CCAvenue-Tracking-ID.

On hold, amount/currency mismatch: CCAvenue hat eine Zahlung bestätigt, deren Betrag oder Währung von der Bestellung abweicht, etwa weil die Bestellung bearbeitet wurde, nachdem der Kunde mit der Zahlung begonnen hatte, oder weil ein CCAvenue-Rabattangebot angewendet wurde. Die Notiz zeigt den erhaltenen und den erwarteten Betrag. Prüfen Sie die Zahlung im CCAvenue-Dashboard und schließen Sie die Bestellung anschließend ab oder erstatten Sie sie.

On hold, awaiting bank confirmation: CCAvenue hat die Zahlung als Awaited gemeldet. Die Bestellung wird nie als fehlgeschlagen markiert, solange das Geld noch eingezogen werden könnte. Prüfen Sie die Zahlung im CCAvenue-Dashboard, bevor Sie die Bestellung erfüllen, und ändern Sie den Status manuell. Eine spätere Antwort mit derselben Tracking-ID wird weiterhin berücksichtigt.

On hold, payment for a cancelled order: Der Kunde hat gezahlt, nachdem die Bestellung storniert worden war. Prüfen Sie den Bestand und erfüllen Sie die Bestellung oder erstatten Sie die Zahlung.

Cancelled: Der Kunde hat die Zahlung auf der CCAvenue-Seite abgebrochen.

Failed: Die Zahlung ist fehlgeschlagen, oder CCAvenue hat Invalid, Timeout oder einen anderen erfolglosen Status zurückgegeben. Die Notiz zeigt die Meldung von CCAvenue. Ein verspäteter Fehler verändert nie eine bezahlte Bestellung.

Trifft eine weitere erfolgreiche Zahlung für eine bereits bezahlte Bestellung ein (zum Beispiel aus zwei Browser-Tabs), wird die Bestellung nicht erneut verändert. Eine Notiz bittet Sie, das Duplikat im CCAvenue-Dashboard zu erstatten.

Erstattungen: Erstattungen aus WooCommerce werden nicht unterstützt. Erstatten Sie die Zahlung im CCAvenue-Dashboard und erfassen Sie sie manuell in WooCommerce.

Lizenzschlüssel

Das Plugin funktioniert mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock befindet sich oben unter WooCommerce > Settings > Payments > CCAvenue. Fügen Sie den Schlüssel in License key ein und klicken Sie auf Activate. Der Block zeigt den Status, zum Beispiel das Datum, bis zu dem die Lizenz aktiv ist, und Ihre Domain. Mit Check now prüfen Sie den Status erneut, mit Change key geben Sie einen anderen Schlüssel ein und mit Remove key entfernen Sie ihn von dieser Website. Der Link Manage licenses and domains in your account öffnet Ihr vibefox.net-Konto.

Ein Schlüssel gilt für eine Domain. Das Entfernen des Schlüssels von einer Website gibt deren 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. Versucht trotzdem jemand, eine Zahlung zu starten, sieht der Kunde This payment method is not available. Please choose another one. Angemeldete Shop-Manager sehen die Zahlungsmethode weiterhin, markiert mit (unlicensed — visible to admins only), damit Sie das Plugin einrichten und testen können, bevor Sie einen Schlüssel kaufen. Auf der Plugins-Seite und auf WooCommerce-Seiten erscheint ein Hinweis. Bestehende Bestellungen bleiben unberührt: Kunden, die von bereits begonnenen Zahlungen zurückkehren, werden weiterhin verarbeitet.

Läuft eine Lizenz ab, arbeitet das Plugin weiter, doch Updates und Support erfordern eine Verlängerung. Der Status wird im Hintergrund automatisch erneut geprüft.

Fehlerbehebung

CCAvenue erscheint nicht an der Kasse: prüfen Sie, ob die Lizenz aktiv ist, Enable/Disable eingeschaltet ist und alle drei Zugangsdaten eingetragen sind: Merchant ID, Access Code und Working Key. Die Einstellungsseite zeigt eine Warnung, wenn eines fehlt.

Die Zahlung ist durchgegangen, aber die Bestellung bleibt bei Pending payment: Der Kunde ist nicht von CCAvenue in Ihren Shop zurückgekehrt, zum Beispiel weil der Browser geschlossen wurde. Das Plugin verwendet keine Benachrichtigungen per Server-zu-Server-Verbindung. Prüfen Sie die Zahlung im CCAvenue-Dashboard und aktualisieren Sie die Bestellung manuell.

Jede Zahlung endet mit We could not confirm the payment result: Die Antwort lässt sich nicht entschlüsseln. 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. Schalten Sie das Debug log ein und prüfen Sie WooCommerce > Status > Logs, Quelle wcp_ccavenue_payment.

CCAvenue zeigt einen Fehler vor der Zahlungsseite: prüfen Sie, ob Access Code und Working Key für diese Domain erzeugt wurden, ob die Rückkehr-URL zur bei CCAvenue registrierten Domain gehört und ob CCAvenue im Testmodus den Testzugang für Ihr Konto freigeschaltet hat. Für eine andere Währung als INR muss die Mehrwährungsabwicklung in Ihrem CCAvenue-Konto aktiviert sein.

Der Kunde sieht This payment method is temporarily unavailable: Eines der Zugangsdaten fehlt.

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

Die Bestellung ist nach der Zahlung auf On hold: Lesen Sie die Bestellnotiz. Der bezahlte Betrag oder die Währung wich von der Bestellung ab, die Zahlung wartet auf die Bestätigung durch die Bank, oder die Bestellung war storniert worden. Prüfen Sie die Zahlung im CCAvenue-Dashboard und erfüllen Sie dann die Bestellung oder erstatten Sie die Zahlung.

Der Lizenzblock zeigt einen Fehler: folgen Sie der Meldung im Block. Ist der Schlüssel zum Beispiel bereits auf einer anderen Domain verwendet, geben Sie in Ihrem vibefox.net-Konto einen Platz frei und klicken Sie auf Check now. Hat sich die Adresse der Website geändert, klicken Sie auf Check now, um den Schlüssel für die neue Domain zu aktivieren. Ist der Lizenzserver nicht erreichbar, arbeitet das Plugin mit dem zuletzt bekannten Status weiter.

Für Entwickler: In der Readme-Datei ist der Filter ccavenue_p_request_params aufgeführt (ändert die Daten, die an CCAvenue gesendet werden, zum Beispiel merchant_param2 bis merchant_param5 oder promo_code; Betrag, Währung, order_id und merchant_param1 dürfen nicht geändert werden) sowie der Filter ccavenue_p_icon für das Symbol an der Kasse.

Deinstallation

Beim Deaktivieren des Plugins bleiben alle Daten erhalten. Zum Entfernen deaktivieren und löschen Sie es auf der Seite Plugins. Der Lizenzschlüssel und der Lizenzstatus dieses Plugins werden immer entfernt. Die Gateway-Einstellungen, die Protokolle und die an den Bestellungen gespeicherten CCAvenue-Referenzen werden nur entfernt, wenn Delete data on uninstall eingeschaltet war. Andernfalls bleiben sie für eine spätere Neuinstallation erhalten. Bestehende Bestellungen behalten ihre Zahlungsnotizen und Transaktions-IDs.

CCAvenue ist eine Marke ihres jeweiligen Inhabers. Dieses Plugin ist weder mit CCAvenue verbunden noch von CCAvenue empfohlen.