VibeFox CCAvenue for PrestaShop — Hilfe

Anforderungen

PrestaShop: 8.0 bis 9.x.

PHP: 8.0 oder neuer, mit der OpenSSL-Erweiterung (sie wird benötigt, um die Anfrage zu verschlüsseln und die Antwort zu entschlüsseln). Das Modul lässt sich auf älteren PHP-Versionen oder ohne OpenSSL nicht installieren.

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 dieselben Zugangsdaten für die Testumgebung; den Testzugang muss CCAvenue für Ihr Konto freischalten. Das Modul nutzt die Endpunkte von CCAvenue Indien.

Währung: Die Warenkorbwährung wird unverändert an CCAvenue übermittelt. 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 funktioniert für eine Domain.

Installation

1. Gehen Sie im Back Office zu Modules > Module Manager und klicken Sie auf Upload a module. Wählen Sie die ZIP-Datei des Moduls.

2. Wenn der Upload abgeschlossen ist, klicken Sie auf Configure, oder suchen Sie VibeFox CCAvenue Payment später in der Modulliste und klicken Sie dort auf Configure.

3. Geben Sie Ihren VibeFox-Lizenzschlüssel in License key im Lizenzblock oben auf der Seite Configure ein und klicken Sie auf Activate (siehe Lizenzschlüssel).

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

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

Bei der Installation legt das Modul zwei Bestellstatus an, Awaiting CCAvenue payment und CCAvenue payment on hold. PrestaShop aktiviert das neue Zahlungsmodul für alle Währungen, Länder und Kundengruppen. Sie können dies unter Payment > Preferences einschränken.

Konfiguration

Alle Einstellungen befinden sich auf der Modulseite: Modules > Module Manager > VibeFox CCAvenue Payment > Configure. Jeder Abschnitt hat eine eigene Schaltfläche Save, die die gesamte Seite speichert. Oberhalb der Felder warnt Sie die Seite, wenn CCAvenue aktiviert ist, aber Merchant ID, Access Code oder Working Key fehlt (die Zahlungsart 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. an, und sie erinnert an die Mehrwährungsabwicklung, wenn die Standardwährung des Shops nicht INR ist.

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.

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

API-Zugangsdaten

Melden Sie sich im 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. Wenn sie etwas anderes als Ziffern enthält, erscheint beim Speichern die Meldung CCAvenue: the Merchant ID must contain digits only — the previous value was kept.; der bisher 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. an. Geben Sie nur dann einen neuen Wert ein, wenn Sie ihn ändern möchten.

Clear saved Working Key: Setzen Sie den Haken und klicken Sie auf Save, um den gespeicherten Working Key zu entfernen. Ein leeres Feld behält den gespeicherten Wert.

Test mode: schickt Kunden in die Testumgebung von CCAvenue (test.ccavenue.com). CCAvenue verwendet dieselbe Merchant ID, denselben Access Code und denselben Working Key für Test und Live; den Testzugang muss CCAvenue für Ihr Konto freischalten. Im Testmodus zeigt die Kasse unter der Zahlungsart TEST MODE: no real transactions will be processed. an. Standard: ein. Für echte Zahlungen ausschalten.

Return URL

CCAvenue leitet den Kunden zu der Adresse zurück, die in diesem Abschnitt angezeigt wird. Mit suchmaschinenfreundlichen URLs sieht sie so aus: https://your-shop/module/wcp_ccavenue_payment/return, gegebenenfalls mit einem Sprachcode wie /en/. Das Modul sendet diese URL bei jeder Zahlung (als Weiterleitungs- und Abbruch-URL), daher müssen Sie bei CCAvenue nichts einrichten. Sie muss zur bei CCAvenue registrierten Domain gehören.

Erweitert

Debug log: schreibt CCAvenue-Ereignisse in logs/ccavenue_p_debug.log.php im Modulordner. 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 Anschriften nicht. Standard: aus. Solange sie ausgeschaltet ist, wird nichts geschrieben, auch keine Fehler.

Log: zeigt die Größe und die letzten Einträge des Protokolls. Klicken Sie auf Clear log, um es zu leeren.

Delete data on uninstall: Wenn eingeschaltet, entfernt die Deinstallation des Moduls die Modul-Einstellungen, das Protokoll und die CCAvenue-Bestellreferenzen. Bestellungen und die Bestellstatus des Moduls bleiben erhalten. Standard: aus.

Kasse

Im Zahlungsschritt wählt der Kunde die Zahlungsart (standardmäßig CCAvenue) und bestätigt. Eine Seite zeigt Thank you for your order. You are being redirected to CCAvenue to complete the payment. an und leitet den Kunden zur CCAvenue-Zahlungsseite weiter. Ohne JavaScript klickt der Kunde auf Pay via CCAvenue oder Back to checkout. Zu diesem Zeitpunkt existiert noch keine Bestellung.

Jeder Versuch erhält eine neue CCAvenue-Bestellreferenz, die aus der Warenkorbnummer und der Uhrzeit besteht. Warenkorbsumme und -währung, die Rechnungsdaten, die Lieferadresse (wenn sie von der Rechnungsadresse abweicht) und ein geheimer 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 Bundesstaat werden als Namen gesendet, die Telefonnummer nur als Ziffern. Der Kunde wählt Karte, Netbanking, UPI, E-Wallet oder EMI auf der CCAvenue-Seite.

Nach der Zahlung kehrt der Kunde mit einer verschlüsselten Antwort zurück. Die Bestellung wird erst als bezahlt markiert, wenn CCAvenue dies bestätigt: Die Antwort muss sich mit Ihrem Working Key entschlüsseln lassen, zu einem Versuch dieses Shops gehören und denselben Betrag und dieselbe Währung wie gesendet und wie die Warenkorbsumme haben. Dann wird die Bestellung angelegt, und der Kunde sieht die Standard-Bestellbestätigung mit Your CCAvenue payment has been received. Bei einer Awaited-Zahlung 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 bei Betrag oder Währung zeigt sie Your payment was received and is being reviewed by the shop. Wird eine wartende Bestellung später ohne Zahlung storniert oder schlägt sie fehl, zeigt die Bestätigungsseite Your CCAvenue payment was not completed. Please contact us about this order.

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 CCAvenue-Seite ab, lautet die Meldung Payment was cancelled. You may try again. Kann die Antwort nicht geprüft werden, lautet sie We could not confirm the payment result. If your account was charged, please contact us before paying again. In diesen Fällen wird keine Bestellung angelegt und der Warenkorb bleibt erhalten, sodass der Kunde erneut bezahlen kann. Hat der Warenkorb bereits eine Bestellung, führt ein neuer Versuch direkt zu deren Bestätigungsseite statt zu einer zweiten Zahlung.

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, wird keine Bestellung angelegt; prüfen Sie die Zahlung dann im CCAvenue-Dashboard. Das Modul bietet keine Erstattungen aus PrestaShop, keine gespeicherten Karten, Abonnements oder wiederkehrenden Zahlungen, kein Kartenformular auf der Website und keine Unterstützung für CCAvenue UAE oder andere regionale Plattformen.

Bestellungen

Bestellstatus

No order yet: Der Kunde wurde zu CCAvenue geschickt und ist nicht zurückgekehrt, oder die Zahlung ist fehlgeschlagen oder abgebrochen worden. Es existiert nur der Warenkorb. Prüfen Sie die Zahlung im CCAvenue-Dashboard, wenn der Kunde nicht zurückkehrt.

Payment accepted: Die Zahlung wurde bestätigt. Sie wird mit der CCAvenue-Tracking-ID als Transaktions-ID erfasst, und eine Notiz zeigt die Bankreferenz, die Tracking-ID und den Zahlungsmodus.

Awaiting CCAvenue payment: 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 könnte. Prüfen Sie sie im CCAvenue-Dashboard, bevor Sie die Bestellung ausführen. Eine spätere Antwort mit derselben Tracking-ID wird trotzdem angewendet: Success setzt Payment accepted, Failure setzt Payment error und Aborted setzt Canceled.

CCAvenue payment on hold: CCAvenue hat eine Zahlung bestätigt, deren Betrag oder Währung vom Warenkorb oder vom Gesendeten abweicht (zum Beispiel, weil der Warenkorb in einem anderen Tab geändert wurde, nachdem die Zahlung begonnen hatte), oder der Kunde hat gezahlt, nachdem die Bestellung storniert worden war. Die Notiz zeigt den empfangenen und den erwarteten Betrag. Der von CCAvenue gemeldete Betrag wird als Zahlung zur Bestellung erfasst, wenn die Währung übereinstimmt. Prüfen Sie die Zahlung im CCAvenue-Dashboard und führen Sie dann die Bestellung aus oder erstatten Sie die Zahlung.

Ein verspätet eintreffender Fehlschlag ä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 verändert. Eine Notiz bittet Sie, das Duplikat im CCAvenue-Dashboard zu erstatten.

CCAvenue-Zahlungsblock

Die Bestellseite zeigt einen Block CCAvenue payment mit der CCAvenue-Bestell-ID, der Tracking-ID, dem Status, der Bankreferenz, dem Zahlungsmodus und dem Kartennamen, dem gesendeten und dem empfangenen Betrag, dem Datum und der CCAvenue-Meldung sowie einem Abzeichen Test mode für Testzahlungen. Die CCAvenue-Notizen sind private Nachrichten zur Bestellung und nur im Back Office sichtbar.

Erstattungen

Erstattungen aus PrestaShop werden nicht unterstützt. Erstatten Sie die Zahlung im CCAvenue-Dashboard und erfassen Sie die Erstattung anschließend manuell in PrestaShop.

Lizenzschlüssel

Das Modul funktioniert mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock License — VibeFox CCAvenue Payment ist der erste Block unter Modules > Module Manager > VibeFox CCAvenue Payment > Configure, oberhalb der Einstellungen. Geben Sie den Schlüssel in License key ein und klicken Sie auf Activate. Danach zeigt der Block den Schlüssel maskiert, den Status (zum Beispiel das Datum, bis zu dem die Lizenz gültig ist, und Ihre Domain) sowie die Schaltflächen Check now zum erneuten Prüfen des Status, Change key zum Eingeben eines anderen Schlüssels und Remove key zum Entfernen des Schlüssels aus diesem Shop. Darunter stehen die Zeile Product: presta-payment-ccavenue und der Link Manage licenses and domains in your account, der Ihr vibefox.net-Konto öffnet. Nur Mitarbeiter mit der Berechtigung Configure für das Modul können den Schlüssel ändern. Die Texte des Blocks folgen der Sprache des Back Office (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 das Modul mit dem zuletzt bekannten Status weiter.

Ein Schlüssel funktioniert für eine Domain: die Domain des Hauptshops, auch bei einem Multistore-Setup. 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 einen aktiven Schlüssel wird CCAvenue an der Kasse nicht angezeigt. Wird trotzdem eine Zahlung gestartet, sieht der Kunde This payment method is not available. Please choose another one. Die Storefront weiß nicht, dass Sie im Back Office angemeldet sind, daher wird die Zahlungsart auch für Sie ausgeblendet: Sie können das Modul vor dem Kauf eines Schlüssels einrichten, aber nicht an der Kasse testen. Ein Hinweis erscheint unter Modules > Module Manager auf der Registerkarte Alerts. Bestehende Bestellungen sind nicht betroffen: Bereits begonnene Zahlungen werden bestätigt, wenn der Kunde von CCAvenue zurückkehrt.

Läuft eine Lizenz ab, arbeitet das Modul weiter, doch Updates und Support erfordern eine Verlängerung. Der Status wird beim Arbeiten im Back Office automatisch erneut geprüft: einmal täglich in den ersten 14 Tagen nach der Eingabe des Schlüssels, danach einmal pro Woche. Ein Cron-Job ist nicht nötig. Die Deinstallation oder das Zurücksetzen des Moduls entfernt immer den Lizenzschlüssel und den Lizenzstatus.

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. Prüfen Sie unter Payment > Preferences, ob das Modul für die Warenkorbwährung, das Land des Kunden und die Kundengruppe zugelassen ist.

Die Zahlung war erfolgreich, aber es wurde keine Bestellung angelegt: Der Kunde ist nicht von CCAvenue zu Ihrem Shop zurückgekehrt, zum Beispiel weil der Browser geschlossen wurde. Das Modul hat keine Benachrichtigungen per Server-zu-Server-Verbindung. Prüfen Sie die Zahlung im CCAvenue-Dashboard und legen Sie die Bestellung manuell an oder aktualisieren Sie sie.

Jede Zahlung endet mit 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. Schalten Sie Debug log ein und sehen Sie sich das Feld Log auf der Modulseite an.

CCAvenue zeigt einen Fehler vor der Zahlungsseite: Prüfen Sie, ob Access Code und Working Key für diese Domain erzeugt wurden, ob die Return URL zur bei CCAvenue registrierten Domain gehört und ob im Testmodus der Testzugang für Ihr Konto bei CCAvenue aktiviert ist. 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 oder die Warenkorbsumme ist null. Debug log zeigt den Grund.

Der Kunde sieht This payment method is not available: Das Modul ist deaktiviert oder für die Warenkorbwährung, das Land oder die Kundengruppe unter Payment > Preferences nicht zugelassen.

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 Merchant ID ändert sich beim Speichern nicht: Der Wert enthält etwas anderes als Ziffern. Geben Sie nur die Zahlen Ihrer Merchant ID ein.

Bestellung ist CCAvenue payment on hold oder Awaiting CCAvenue payment: Lesen Sie die Bestellnotiz (siehe Bestellstatus). Prüfen Sie die Zahlung im CCAvenue-Dashboard und führen Sie dann die Bestellung aus oder erstatten Sie die Zahlung.

Für Entwickler bietet das Modul den Hook actionCcavenueRequestParams (ändert die an CCAvenue gesendeten Daten vor der Verschlüsselung, zum Beispiel merchant_param2 bis merchant_param5; Werte dürfen kein & enthalten; amount, currency, order_id und merchant_param1 nicht ändern).

Deinstallation

Gehen Sie zu Modules > Module Manager, öffnen Sie das Menü neben VibeFox CCAvenue Payment und wählen Sie Uninstall. Der Lizenzschlüssel und der Lizenzstatus dieses Moduls werden immer entfernt. Die Bestätigung weist darauf hin, dass Einstellungen und CCAvenue-Referenzen erhalten bleiben, sofern Delete data on uninstall nicht aktiviert ist. Ist es aktiviert, werden die Modul-Einstellungen, das Protokoll und die CCAvenue-Bestellreferenzen entfernt. Ist es deaktiviert, bleibt alles für eine spätere Neuinstallation erhalten. Die Bestellstatus Awaiting CCAvenue payment und CCAvenue payment on hold bleiben immer erhalten. Bestehende Bestellungen behalten ihre Zahlungsnotizen und Transaktions-IDs.

CCAvenue ist eine Marke ihres jeweiligen Inhabers. Dieses Modul ist weder mit CCAvenue verbunden noch wird es von CCAvenue empfohlen.