VibeFox Razorpay for OpenCart — Hilfe

Voraussetzungen

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.

Razorpay-Konto: Sie benötigen die Key ID und das Key Secret Ihres Razorpay-Kontos für den Testmodus und für den Live-Modus, sobald Ihr Konto freigeschaltet ist. Ein Webhook mit einem Secret Ihrer Wahl wird dringend empfohlen (siehe Konfiguration). Zahlungen in anderen Währungen als INR erfordern, dass International Payments in Ihrem Razorpay-Konto aktiviert ist.

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_razorpay_payment-oc3-(version).ocmod.zip und das Paket für OpenCart 4 wcp_razorpay_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_razorpay_payment-oc3-(version).ocmod.zip. Die Erweiterung enthält keine OCMOD-Änderungen, daher muss Extensions > Modifications nicht aktualisiert werden. Statt des Installers können Sie auch den Inhalt des Ordners upload aus diesem Paket in das Stammverzeichnis Ihres Shops kopieren.

2. Gehen Sie zu Extensions > Extensions und wählen Sie den Typ Payments. Suchen Sie VibeFox Razorpay 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 Schaltfläche mit dem Stift), 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 Ihre Test Key ID und das Test Key Secret ein, richten Sie den Webhook im Razorpay Dashboard ein und tragen Sie dessen Secret ein (siehe Konfiguration).

5. Aktivieren Sie Enable/Disable und klicken Sie auf Save. Führen Sie eine Testzahlung mit eingeschaltetem Test mode durch. Wenn Sie bereit sind, geben Sie die Live-Schlüssel ein und schalten Sie Test mode aus.

OpenCart 4

1. Gehen Sie im Admin-Bereich zu Extensions > Installer, klicken Sie auf Upload und wählen Sie die Datei wcp_razorpay_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 Razorpay Payment, klicken Sie auf Install (die grüne +-Schaltfläche) und dann auf Edit (die Schaltfläche mit dem Stift).

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

Eine neue Installation startet mit ausgeschalteter Zahlungsmethode und eingeschaltetem Testmodus.

Konfiguration

Alle Einstellungen befinden sich auf der Seite der Erweiterung: Extensions > Extensions > Payments > VibeFox Razorpay Payment > Edit. Die Abschnitte sind links aufgelistet; die Schaltfläche Save unter der Liste speichert die gesamte Seite. Ohne das Recht, die Erweiterung zu ändern, zeigt die Seite die Einstellungen an, kann sie aber nicht speichern.

Oberhalb der Einstellungen erklärt die Seite, dass die Bestellung erst dann einen Status erhält, wenn die Zahlung bei Razorpay verifiziert wurde, und sie zeigt Hinweise an: Die Schlüssel des aktuellen Modus fehlen (dann wird Razorpay an der Kasse nicht angezeigt), die Key ID beginnt im Testmodus nicht mit rzp_test_ bzw. im Live-Modus nicht mit rzp_live_, der Testmodus ist eingeschaltet, das Webhook-Secret ist leer oder die Standardwährung des Shops ist nicht INR und erfordert International Payments in Ihrem Razorpay-Konto. Die Hinweise werden nach jedem Speichern aktualisiert.

Beim Speichern muss Title 1 bis 128 Zeichen lang sein (Enter a title for the payment method (1 to 128 characters).), Sort Order muss eine ganze Zahl sein (negative Zahlen sind erlaubt), Total muss eine Zahl von 0 oder größer sein, und die Geo Zone sowie jeder Bestellstatus müssen existieren. Andernfalls wird nichts gespeichert. Leerzeichen, die zusammen mit den Key IDs eingefügt wurden, werden entfernt.

Razorpay

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

Title: der Name der Zahlungsmethode, den Kunden an der Kasse sehen. Er wird auch als Name der Zahlungsmethode in der Bestellung gespeichert. Standard: UPI, Cards, NetBanking. Erforderlich, bis zu 128 Zeichen.

Description: der Text, den Kunden im Schritt Confirm Order über der Schaltfläche zum Bestätigen sehen. Standard: Pay securely via UPI, Credit/Debit Card, or Internet Banking through Razorpay.

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

Geo Zone: Razorpay nur für Zahlungsadressen in der ausgewählten Geo Zone anbieten. 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, damit Razorpay angeboten wird: eine Zahl von 0 oder größer. Lassen Sie das Feld leer, um Razorpay bei jedem Betrag anzubieten.

API-Schlüssel

Ihre Schlüssel erhalten Sie im Razorpay Dashboard unter Account & Settings > API Keys (die Seite verlinkt dorthin). Wechseln Sie das Dashboard in den Testmodus, um Testschlüssel (rzp_test_...) zu erzeugen. Live-Schlüssel (rzp_live_...) sind verfügbar, sobald Ihr Konto freigeschaltet ist.

Test mode: verwendet die Testmodus-Schlüssel, sodass kein echtes Geld belastet wird. Standard: ein. Schalten Sie es aus, um echte Zahlungen anzunehmen. Zahlungen, Erfassungen und Erstattungen einer Bestellung verwenden immer die Schlüssel des Modus, in dem die Bestellung bezahlt wurde. Ein späterer Moduswechsel betrifft daher bestehende Bestellungen nicht. Solange der Modus eingeschaltet ist, sehen Kunden im Schritt Confirm Order und auf der Zahlungsseite den Hinweis Razorpay Test mode: no real money will be charged.

Test Key ID: die Key ID aus dem Razorpay Dashboard im Testmodus. Sie beginnt mit rzp_test_.

Test Key Secret: das Key Secret aus dem Razorpay Dashboard im Testmodus.

Live Key ID: die Key ID aus dem Razorpay Dashboard im Live-Modus. Sie beginnt mit rzp_live_.

Live Key Secret: das Key Secret aus dem Razorpay Dashboard im Live-Modus.

Gespeicherte Secrets werden 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 einen gespeicherten Wert zu entfernen, setzen Sie unter dem Feld den Haken bei Clear the saved value on save und klicken Sie auf Save.

Zahlung

Payment Action: der Zeitpunkt, zu dem das Geld abgebucht wird. Standard: Authorize & Capture.

Authorize & Capture: der Kunde wird sofort belastet. Meldet Razorpay eine autorisierte Zahlung, erfasst die Erweiterung sie.

Authorize Only: das Geld wird reserviert. Die Bestellung erhält den Authorized Status, und Sie erfassen die Zahlung später mit Capture Razorpay payment im Reiter Razorpay der Bestellseite oder im Razorpay Dashboard. Razorpay erstattet autorisierte Zahlungen automatisch, wenn sie nicht rechtzeitig erfasst werden.

Webhook

Der Webhook bestätigt Zahlungen auch dann, wenn der Kunde den Browser direkt nach der Zahlung schließt, und erfasst Erstattungen, die im Razorpay Dashboard vorgenommen wurden. Gehen Sie im Razorpay Dashboard zu Account & Settings > Webhooks und legen Sie einen Webhook im Testmodus sowie einen weiteren im Live-Modus an. Verwenden Sie die URL, die unter Webhook URL in diesem Abschnitt angezeigt wird. Bei OpenCart 3 sieht sie so aus: https://your-store/index.php?route=extension/payment/wcp_razorpay_payment/webhook, bei OpenCart 4 so: https://your-store/index.php?route=extension/wcp_razorpay_payment/payment/wcp_razorpay_payment.webhook. Sie wird aus der Storefront-Adresse Ihrer OpenCart-Installation gebildet. Kopieren Sie sie genau so, wie die Einstellungen sie anzeigen. Geben Sie in Razorpay ein Secret Ihrer Wahl ein und wählen Sie diese Ereignisse aus (sie sind ebenfalls in diesem Abschnitt aufgelistet):

payment.authorized: eine Zahlung wurde autorisiert.

payment.captured: eine Zahlung wurde erfasst, auch wenn Sie sie im Razorpay Dashboard erfassen.

payment.failed: ein Zahlungsversuch ist fehlgeschlagen.

order.paid: die Razorpay-Bestellung der Zahlung wurde bezahlt.

refund.created: eine Zahlung wurde erstattet, zum Beispiel im Razorpay Dashboard.

Webhook Secret: das Secret, das Sie beim Anlegen des Webhooks eingegeben haben. Verwenden Sie dasselbe Secret für den Test- und den Live-Webhook, da die Erweiterung nur ein Feld für beide hat. Webhooks ohne gültige Signatur werden abgelehnt. Ohne Webhook wird eine Zahlung nur bestätigt, wenn der Kunde aus dem Popup zurückkehrt oder später erneut die Zahlung für denselben Warenkorb startet.

Bestellungen

OpenCart legt die Bestellung im Schritt Confirm Order ohne Status an (eine fehlende Bestellung). Die Bestellung erhält erst dann einen Status, wenn Razorpay die Zahlung bestätigt hat. Eine fehlgeschlagene oder abgebrochene Zahlung lässt sie ohne Status, und der Warenkorb bleibt erhalten. OpenCart kennt weder einen Status Authorized noch einen Status On hold, daher wählen Sie vorhandene Status aus; die Bestellnotizen erklären den Grund. Jedes der folgenden Felder listet Ihre OpenCart-Bestellstatus auf.

Order Status After Payment: die Zahlung ist erfasst und Betrag und Währung stimmen überein. Standard: In Bearbeitung.

Authorized Status: Authorize Only: das Geld ist reserviert, aber noch nicht erfasst. Standard: Ausstehend.

On Hold (Review) Status: manuelle Prüfung: Der gezahlte Betrag oder die Währung weicht von der Bestellsumme ab, eine Zahlung ist für eine stornierte Bestellung eingegangen, oder die Popup-Signatur war gültig, die Zahlung konnte aber nicht über die Razorpay-API verifiziert werden. Standard: Ausstehend. Sie können eigene Status unter System > Localisation > Order Statuses anlegen und hier auswählen.

Cancelled Status: Die Erweiterung setzt diesen Status nie. Er teilt der Erweiterung nur mit, welche Bestellungen storniert sind: Eine später erfasste Zahlung für eine solche Bestellung setzt sie in die Prüfung, statt sie wieder zu öffnen; eine autorisierte Zahlung fügt nur eine Notiz hinzu. Standard: Storniert.

Refunded Status: wird gesetzt, nachdem die Zahlung vollständig erstattet wurde, im Reiter der Bestellung oder im Razorpay Dashboard. Standard: Erstattet.

Erweitert

Enable Logging: Das Protokoll wird in razorpay_p_debug.log.php im Logs-Ordner von OpenCart (storage/logs) geschrieben. Die Datei kann nicht über das Web geöffnet werden. Fehler und Warnungen werden immer protokolliert; diese Option fügt die Debug-Details hinzu. Schlüssel, Signaturen und Kontaktdaten der Kunden werden nie protokolliert. Standard: aus.

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 eingeschaltet, entfernt das Deinstallieren der Erweiterung die Gateway-Einstellungen und das Protokoll. Bestellungen sowie deren Razorpay-Transaktionen und -Erstattungen 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 Zahlungsmethode (standardmäßig UPI, Cards, NetBanking). Im Schritt Confirm Order sieht der Kunde Ihre Beschreibung und den Hinweis After "Confirm Order" the Razorpay Checkout window opens to pay securely (UPI, cards, NetBanking, wallets). OpenCart legt die Bestellung in diesem Schritt an, weiterhin ohne Status. Wenn der Kunde auf Confirm Order klickt, erstellt die Erweiterung eine Razorpay-Bestellung für den exakten Bestellbetrag und die Währung und öffnet die Seite Razorpay payment Ihres Shops. Dort öffnet sich das Razorpay-Checkout-Popup automatisch, mit Name, E-Mail-Adresse und Telefonnummer des Kunden bereits ausgefüllt. Bei OpenCart 4 wählt der Kunde die Zahlungsmethode mit der Schaltfläche Choose im Block der Zahlungsmethode, im Fenster Payment method options, und klickt unten auf der Kassenseite auf Confirm Order. Die Zahlung erscheint in Razorpay als Order # mit der Bestellnummer. Wird das Popup geschlossen, kann der Kunde auf Pay Now klicken, um es erneut zu öffnen, oder auf Choose another payment method, um zur Kasse zurückzukehren. Der Warenkorb bleibt erhalten.

Nach einer erfolgreichen Zahlung sieht der Kunde Please wait while we process your payment... Die Erweiterung prüft die Razorpay-Signatur, ruft die Zahlung über die Razorpay-API ab und vergleicht Betrag und Währung mit der Bestellung. Die Bestellung wird erst dann als bezahlt markiert, wenn Razorpay dies bestätigt. 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 Erfolgsseite der OpenCart-Bestellung. Ist die Signatur gültig, die Zahlung aber in diesem Moment nicht abrufbar, erhält die Bestellung den On Hold (Review) Status, und der Webhook bestätigt sie später.

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 bei und aktualisiert sie, sodass der Kunde nach dem Schließen des Popups oder nach Choose another payment method dieselbe Bestellung bezahlt. Bevor eine neue Zahlung beginnt, prüft die Erweiterung die offenen Razorpay-Bestellungen desselben Warenkorbs: Eine bereits bezahlte, etwa weil der Kunde den Browser geschlossen hat und kein Webhook vorhanden ist, wird übernommen, statt eine zweite Zahlung zu verlangen, und die übrigen werden nicht mehr angeboten. Bezahlt der Kunde dieselbe Bestellung erneut, wird deren Razorpay-Bestellung wiederverwendet, sofern Betrag, Währung und Modus unverändert sind; andernfalls wird eine neue angelegt. Ist der Warenkorb bereits durch eine andere Bestellung bezahlt, gelangt der Kunde direkt zur Erfolgsseite.

Meldungen, die der Kunde sehen kann:

Payment was cancelled. Please click "Pay Now" to try again.

Payment could not be completed. Please try again.

Your session has expired. Please click "Pay Now" to try again.

We could not verify your payment. Die Meldung ergänzt, dass die Bestellung automatisch aktualisiert wird, sobald Razorpay bestätigt, falls Geld abgebucht wurde.

This payment method is not available right now. Please choose another payment method. Die Schlüssel fehlen oder sind falsch.

Razorpay is temporarily unavailable. Please try again in a few minutes.

Razorpay could not accept this payment: gefolgt vom Grund, den Razorpay nennt.

The order amount is too small to be paid with Razorpay.

Razorpay Checkout could not be loaded. Das Popup-Skript ist blockiert; die Meldung bittet, die Verbindung zu prüfen, Content-Blocker zu deaktivieren und die Seite neu zu laden.

Bei OpenCart 4 wird der Kunde zur Kasse zurückgeschickt, wenn die Bestellung der Kasse vom Shop geschlossen wurde oder bereits für einen anderen Warenkorb bezahlt ist (zum Beispiel weil sich der Warenkorb seitdem geändert hat, auch durch eine neue Menge). Dort erscheint die Meldung Your previous order is already closed or paid. Please confirm the order again: the cart will be paid with a new order., und der nächste Klick auf Confirm Order bezahlt eine neue Bestellung. Die Meldungen, die zurück zur Kasse führen, wie diese, Payment session not found. Please try again. und We could not verify your payment., werden oberhalb der Kassenseite angezeigt.

Der Webhook funktioniert auch, während der Shop im Wartungsmodus ist: OpenCart 3 lässt Anfragen von Zahlungserweiterungen durch, und bei OpenCart 4 fügt die Erweiterung eine Startaktion für den Webhook und das Ergebnis des Popups hinzu.

Die Erweiterung unterstützt nur einmalige Zahlungen. Es gibt keine Abonnements oder wiederkehrenden Zahlungen, keine gespeicherten Karten, kein Razorpay Magic Checkout, keine Payment Links oder Route (geteilte Zahlungen) sowie keine Angebots- oder Erschwinglichkeits-Widgets.

Bestellungen und Erstattungen

Bestellstatus

Kein Status (fehlende Bestellung): Der Kunde hat nicht bezahlt, der Zahlungsversuch ist fehlgeschlagen oder Razorpay hat die Zahlung noch nicht bestätigt. Unter Sales > Orders werden solche Bestellungen nur mit dem Filter Order Status auf Missing Orders angezeigt.

Order Status After Payment (Standard In Bearbeitung): die Zahlung wurde erfasst und bestätigt. Eine Notiz zeigt die Razorpay-Zahlungs-ID (pay_...), den Betrag und die Art der Bestätigung (Callback, Webhook, Synchronisierung oder Administrator).

Authorized Status (Standard Ausstehend): die Zahlung wurde nur autorisiert (Authorize Only). Erfassen Sie sie, um die Bestellung abzuschließen.

On Hold (Review) Status (Standard Ausstehend): wird in diesen Fällen mit jeweils einer Notiz gesetzt: Der gezahlte Betrag oder die Währung stimmte nicht mit der Bestellung überein, die Zahlung wurde für eine stornierte Bestellung erfasst oder die Zahlung konnte in diesem Moment nicht über die Razorpay-API verifiziert werden. Prüfen Sie die Bestellung und bearbeiten Sie sie oder erstatten Sie die Zahlung.

Cancelled Status: Eine später eingehende Zahlung für eine stornierte Bestellung öffnet sie nicht automatisch wieder: Eine autorisierte Zahlung wird nicht erfasst und erhält nur eine Notiz, und eine erfasste Zahlung setzt die Bestellung in die Prüfung. Eine wiederholte Benachrichtigung über die Zahlung, die die Bestellung bereits bezahlt hat, ändert nichts, auch wenn Sie die Bestellung danach storniert haben.

Refunded Status (Standard Erstattet): die Zahlung wurde vollständig erstattet.

Geht eine zusätzliche Zahlung für eine bereits bezahlte Bestellung ein, bleibt die Bestellung unverändert. Eine Notiz bittet Sie, sie im Razorpay Dashboard zu erstatten, falls das nicht beabsichtigt war. Eine verspätete Zahlung zu einer älteren Bestellung eines bereits bezahlten Warenkorbs lässt diese ältere Bestellung ohne Status, und die bezahlte Bestellung erhält die Notiz. Eine verspätete payment.failed-Meldung für eine bezahlte Bestellung fügt nur eine Notiz hinzu.

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

Reiter VibeFox Razorpay Payment

Öffnen Sie unter Sales > Orders eine mit Razorpay bezahlte Bestellung. Unten auf der Bestellseite, neben History und Additional, zeigt der Reiter VibeFox Razorpay Payment die Payment ID mit einem Hinweis Test mode bei Testzahlungen, die Razorpay order, den Status der Zahlung, Paid / refunded (den von Razorpay belasteten und den erstatteten Betrag), die Schaltfläche zum Erfassen, das Erstattungsformular, den Erstattungsverlauf und die Razorpay notes der Bestellung. Der Reiter wird Benutzern angezeigt, die Zugriff auf die Erweiterung haben. Erfassung und Erstattungen erfordern das Recht, die Erweiterung zu ändern (festgelegt unter System > Users > User Groups).

Erfassung (Authorize Only)

Öffnen Sie die Bestellung im Status Authorized Status, klicken Sie im Reiter auf Capture Razorpay payment und bestätigen Sie Capture the authorized Razorpay payment? Die Zahlung wird in dem Modus erfasst, in dem sie autorisiert wurde, und die Bestellung wird auf Order Status After Payment gesetzt, ohne den Kunden zu benachrichtigen und ohne den Bestand zu ändern, wie bei einer manuellen Statusänderung. Lehnt Razorpay ab, zeigen der Reiter und die Notizen Razorpay capture failed: mit dem Grund an. Eine im Razorpay Dashboard vorgenommene Erfassung schließt die Bestellung über den Webhook ab.

Erstattungen

Geben Sie im Reiter den Amount ein (der noch nicht erstattete Betrag ist vorausgefüllt), optional einen Reason (optional), und klicken Sie auf Refund via Razorpay. Bestätigen Sie die Abfrage Refund this amount through Razorpay? This cannot be undone. Vollständige und teilweise Erstattungen werden unterstützt. Erstattungen erfolgen in dem Betrag und der Währung, die Razorpay belastet hat. Nach einer Betragsabweichung können Sie daher bis zu dem Betrag erstatten, den der Kunde tatsächlich bezahlt hat, nicht bis zur Bestellsumme. Ein höherer Betrag führt zu Invalid refund amount: at most gefolgt vom Betrag. Die Erstattung wird mit den Schlüsseln des Modus gesendet, in dem die Zahlung erfolgte. Akzeptiert Razorpay die Erstattung nicht, zeigt der Reiter Razorpay refund failed: mit dem Grund, und es wird keine Erstattung erfasst. Eine erfolgreiche Erstattung wird mit der Razorpay-Erstattungs-ID, dem Betrag und dem Status dem Erstattungsverlauf und den Notizen hinzugefügt. Eine vollständige Erstattung setzt die Bestellung auf Refunded Status, ohne den Kunden zu benachrichtigen und ohne Produkte in den Bestand zurückzubuchen. Eine Teilerstattung ändert den Status nicht. Erstattungen sind verfügbar, sobald die Zahlung erfasst wurde.

Produktrücksendungen unter Sales > Returns erstatten kein Geld über Razorpay.

Im Razorpay Dashboard vorgenommene Erstattungen gelangen über den Webhook zu Ihnen und werden einmal im Erstattungsverlauf (als Razorpay Dashboard markiert) und in den Notizen erfasst. Ist die Bestellung vollständig erstattet, wechselt ihr Status auf Refunded Status. Eine Erstattung im Dashboard in einer anderen Währung oder über dem erstattungsfähigen Betrag wird nicht automatisch erfasst; eine Notiz bittet Sie, sie manuell zu erfassen.

Lizenzschlüssel

Die Erweiterung arbeitet mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock License — VibeFox Razorpay Payment ist der erste Block unter Extensions > Extensions > Payments > VibeFox Razorpay 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 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: opencart-payment-razorpay 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 einen Domainplatz in Ihrem Konto 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 Domainplatz nicht frei. Geben Sie den Platz in Ihrem vibefox.net-Konto frei.

Ohne aktiven Schlüssel wird Razorpay 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 Admin-Benutzer, der im selben Browser im Admin angemeldet ist, sieht die Zahlungsmethode im Shop weiterhin, markiert mit (unlicensed — visible to admins only), sodass Sie die Erweiterung vor dem Kauf eines Schlüssels einrichten und testen können. Bei OpenCart 4 ist diese Vorschau nicht verfügbar: Der Shop sieht die Anmeldung im Admin nicht, daher wird ohne aktiven Schlüssel die Zahlungsmethode für alle ausgeblendet. Nachdem Sie die Seite Edit einmal geöffnet haben, erscheint auf dem Dashboard des Admins eine Erinnerung. Schließen Sie sie mit ×, um sie 7 Tage lang auszublenden. Bestehende Bestellungen bleiben unberührt: Bereits begonnene Zahlungen werden weiterhin bestätigt, und Erfassungen und Erstattungen funktionieren.

Läuft eine Lizenz ab, arbeitet die Erweiterung weiter, Updates und Support erfordern aber eine Verlängerung. Der Status wird automatisch erneut geprüft, wenn Sie das Dashboard oder die Seite Edit des Admins ö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

Razorpay erscheint nicht an der Kasse: Prüfen Sie, ob die Lizenz aktiv ist, Enable/Disable eingeschaltet ist und der aktuelle Modus beide Schlüssel hat: Test Key ID und Test Key Secret im Testmodus, Live Key ID und Live Key Secret im Live-Modus. Die Einstellungsseite zeigt einen Hinweis, wenn sie fehlen. Prüfen Sie außerdem, ob die Zahlungsadresse in der ausgewählten Geo Zone liegt und ob die Bestellung den in den Einstellungen festgelegten Total erreicht.

Die Zahlung ist erfolgt, aber die Bestellung bleibt ohne Status: Der Webhook funktioniert nicht. Prüfen Sie im Razorpay Dashboard, ob der Webhook im verwendeten Modus (Test oder Live) existiert, ob seine URL exakt der unter Webhook URL angezeigten entspricht und ob alle fünf Ereignisse ausgewählt sind. Prüfen Sie, ob Webhook Secret dasselbe Secret wie in Razorpay ist. Die Bestellung erhält ihren Status auch, wenn der Kunde aus dem Popup zurückkehrt oder die Zahlung für denselben Warenkorb erneut startet.

Der Webhook antwortet Webhook secret not configured: Webhook Secret ist leer. Geben Sie das Secret des Razorpay-Webhooks ein. Razorpay sendet das Ereignis später erneut.

Der Webhook antwortet Invalid signature oder Missing signature: Das Secret in den Einstellungen unterscheidet sich vom Secret des Razorpay-Webhooks. Tragen Sie an beiden Stellen dasselbe Secret ein, für den Test- und den Live-Webhook.

Der Webhook antwortet Retry later: Die Erweiterung konnte eine Erfassung nicht bei der Razorpay-API bestätigen, der Bestellstatus konnte nicht gesetzt werden, oder der Warenkorb wurde im selben Moment von einer anderen Anfrage aktualisiert. Razorpay sendet das Ereignis automatisch erneut. Der Grund steht im Log.

Die Webhook-URL zeigt im Browser Method not allowed: Das ist normal. Die URL akzeptiert nur Anfragen von Razorpay.

Eine Bestellung befindet sich im Prüfstatus: Lesen Sie die Notizen im Reiter VibeFox Razorpay Payment. Betrag oder Währung stimmten nicht mit der Bestellung überein, die Zahlung ist für eine stornierte Bestellung eingegangen, oder sie konnte in diesem Moment nicht über die Razorpay-API verifiziert werden und wartet auf den Webhook.

Der Kunde sieht beim Bezahlen einen Fehler: Sehen Sie sich das Feld Log auf der Seite der Erweiterung an. Fehler werden auch dann protokolliert, wenn Enable Logging ausgeschaltet ist. Falsche Schlüssel führen zur Meldung, dass die Zahlungsmethode derzeit nicht verfügbar ist. Andere Gründe von Razorpay werden nach Razorpay could not accept this payment: angezeigt.

Das Popup öffnet sich nicht: Das Skript von Razorpay Checkout wurde durch einen Content-Blocker oder die Verbindung blockiert. Der Kunde sieht eine Meldung und kann die Seite neu laden.

Im Reiter fehlt das Formular für Erfassung oder Erstattung: Der Reiter nennt den Grund: Die Zahlung ist noch nicht erfasst, sie ist vollständig erstattet, Ihre Benutzergruppe hat kein Recht, die Erweiterung zu ändern, oder die Schlüssel des Modus, in dem die Zahlung erfolgte, sind nicht eingerichtet (The payment was made in Test mode, but the Test Key ID / Key Secret are not configured. oder dasselbe für den Live-Modus). Tragen Sie die Schlüssel dieses Modus ein und versuchen Sie es erneut.

Deinstallation

Gehen Sie zu Extensions > Extensions, wählen Sie den Typ Payments und klicken Sie neben VibeFox Razorpay 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 des Bereichs Orders, die bei einer Neuinstallation auf ihre Standardwerte zurückgesetzt werden. Bei OpenCart 4 werden außerdem die Events der Erweiterung und ihre Startaktion entfernt, die den Webhook im Wartungsmodus durchlässt. Ist Delete Data on Uninstall eingeschaltet, werden die übrigen Gateway-Einstellungen (Titel, Beschreibung, Testmodus, Schlüssel, Zahlungsaktion, Webhook-Secret, Protokollierung) und das Protokoll entfernt. Ist die Option aus, bleiben sie für eine spätere Neuinstallation erhalten. Die Razorpay-Transaktionen und -Erstattungen bleiben immer erhalten, sodass zuvor bezahlte Bestellungen nach einer Neuinstallation weiterhin erfasst und erstattet werden können. 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 Razorpay Payment auf Uninstall (die orangefarbene −-Schaltfläche) und danach auf Delete (die rote Papierkorb-Schaltfläche), um das hochgeladene Paket zu entfernen.

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