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

HTTPS: Die Kartenfelder befinden sich auf Ihrer Kassenseite, daher sollte die Kasse über HTTPS laufen. Kartendaten erreichen trotzdem nie Ihren Server. Omise sendet Webhooks nur an HTTPS-Adressen, und die 3-D-Secure-Seite der Bank muss eine HTTPS-Adresse sein.

Währung: eine der folgenden: THB, JPY, SGD, MYR, USD, EUR, GBP, AUD, CAD, CHF, CNY, DKK, HKD. Bezahlt der Kunde in einer anderen Währung, wird die Zahlungsart in der Kasse ausgeblendet.

Omise-Konto: Sie benötigen den öffentlichen Schlüssel und den geheimen Schlüssel Ihres Omise-Kontos für den Test- und den Live-Modus, zu finden unter Settings > Keys im Omise-Dashboard, sowie einen Webhook-Endpunkt unter Settings > Webhooks (siehe Configuration).

VibeFox-Lizenzschlüssel: Erwerb über vibefox.net. 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_omise_payment-oc3-(version).ocmod.zip und das OpenCart-4-Paket wcp_omise_payment.ocmod.zip. Installieren Sie nur das Paket für Ihre OpenCart-Version. Der Lizenzschlüssel ist für beide Versionen derselbe.

OpenCart 3

1. Gehen Sie im Admin-Bereich zu Extensions > Installer, klicken Sie auf Upload und wählen Sie die Datei wcp_omise_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 Omise Payment und klicken Sie auf Install (die grüne Schaltfläche +). Ihr Admin-Benutzer benötigt das Recht, die Liste der Zahlungserweiterungen zu bearbeiten.

3. Klicken Sie auf Edit (die Schaltfläche mit dem Stift), um die Einstellungsseite zu öffnen. Fügen Sie Ihren VibeFox-Lizenzschlüssel in den Lizenzbereich oben auf der Seite unter License key ein und klicken Sie auf Activate (siehe License key).

4. Geben Sie Ihre Omise-Testschlüssel und Live-Schlüssel ein und fügen Sie die auf der Einstellungsseite angezeigte Webhook-URL im Omise-Dashboard hinzu (siehe Configuration).

5. Aktivieren Sie Enable/Disable und klicken Sie auf Save. Testen Sie eine Zahlung im Testmodus mit einer Omise-Testkarte, etwa 4242 4242 4242 4242, 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_omise_payment.ocmod.zip. Benennen Sie die Datei nicht um: OpenCart 4 übernimmt den Erweiterungscode aus 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 Omise 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 Omise-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 Zahlung und Webhook).

Bei einer neuen Installation ist die Zahlungsart zunächst deaktiviert und der Testmodus aktiviert.

Konfiguration

Alle Einstellungen befinden sich auf der Seite der Erweiterung: Extensions > Extensions > Payments > VibeFox Omise Payment > Edit. Die Abschnitte sind links aufgelistet; die Schaltfläche Save unter der Liste speichert die gesamte Seite. Über den Einstellungen zeigt die Seite Test mode is on — orders are charged with the test keys, no real money is moved., solange der Testmodus aktiv ist. Sie warnt außerdem, wenn der öffentliche oder der geheime Schlüssel des aktuellen Modus fehlt (die Zahlungsart wird dann in der Kasse ausgeblendet), und sie warnt, wenn Omise die Standardwährung Ihres Shops nicht akzeptiert. Ohne das Recht, die Erweiterung zu bearbeiten, zeigt die Seite die Einstellungen, kann sie aber nicht speichern.

Beim Speichern verhindern ein leerer Title oder einer mit mehr als 128 Zeichen, eine Sort Order, die keine ganze Zahl ist, ein Total, der keine Zahl größer oder gleich 0 ist, oder ein unbekannter Bestellstatus das Speichern: Nichts wird gespeichert, und der Fehler wird angezeigt. Ein Schlüssel mit dem falschen Präfix (zum Beispiel ein Testschlüssel in einem Live-Feld) wird nicht gespeichert: Der vorherige Wert bleibt erhalten, eine Warnung nennt das Feld, und die übrigen Felder werden gespeichert.

Omise

Enable/Disable: Enable card payments via Omise schaltet die Zahlungsart ein oder aus. Standard: off.

Title: der Name der Zahlungsart, den der Kunde in der Kasse sieht. Er wird auch als Name der Zahlungsart in der Bestellung gespeichert. Standard: Credit / Debit Card. Pflichtfeld, bis zu 128 Zeichen.

Description: der Text, der im Schritt Confirm Order über dem Kartenformular angezeigt wird. Standard: Pay securely with your credit or debit card via Omise.

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

Geo Zone: zeigt das Kartenformular nur für Zahlungsadressen in der ausgewählten Geozone an. Standard: All zones. Geozonen werden unter System > Localisation > Geo Zones eingerichtet. Bei OpenCart 4 wird, wenn der Shop keine Zahlungsadresse verlangt, die Lieferadresse verwendet.

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

API-Schlüssel

Ihre Schlüssel finden Sie im Omise-Dashboard unter Settings > Keys (die Seite enthält einen Link dorthin). Testschlüssel beginnen mit pkey_test_ und skey_test_, Live-Schlüssel mit pkey_ und skey_.

Test mode: verwendet die Testschlüssel, ohne echte Belastungen. Er schaltet beide Schlüssel um. Erfassungen, Erstattungen und Statusabfragen einer Bestellung verwenden immer die Schlüssel des Modus, in dem die Bestellung bezahlt wurde. Standard: on.

Test public key: der öffentliche Schlüssel des Testmodus, pkey_test_..., der von Omise.js im Browser verwendet wird.

Test secret key: der geheime Schlüssel des Testmodus, skey_test_...

Live public key: der öffentliche Schlüssel des Live-Modus, pkey_..., der von Omise.js im Browser verwendet wird.

Live secret key: der geheime Schlüssel des Live-Modus, skey_...

Gespeicherte geheime Schlüssel werden 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. Um einen gespeicherten Schlüssel zu entfernen, aktivieren Sie unter dem Feld Clear the saved value on save und klicken Sie auf Save.

Zahlung und Webhook

Webhook URL: die Adresse des Webhooks Ihres Shops. In OpenCart 3 sieht sie etwa so aus: https://your-store/index.php?route=extension/payment/wcp_omise_payment/webhook, in OpenCart 4 so: https://your-store/index.php?route=extension/wcp_omise_payment/payment/wcp_omise_payment.webhook. Sie wird aus der Storefront-Adresse Ihrer OpenCart-Installation gebildet. Kopieren Sie sie genau so, wie die Einstellungen sie anzeigen, und fügen Sie sie im Omise-Dashboard unter Settings > Webhooks hinzu (nur HTTPS). Die Erweiterung verarbeitet diese Ereignisse (sie sind ebenfalls in diesem Abschnitt aufgeführt):

Omise signiert Webhooks nicht, daher wird der Webhook-Inhalt nie als vertrauenswürdig behandelt: Die Belastung muss von diesem Shop für diese Bestellung erstellt worden sein, und ihr Status wird mit dem geheimen Schlüssel des Zahlungsmodus erneut über die Omise-API abgefragt. Ohne den Webhook wird eine Bestellung, deren Kunde während 3-D Secure den Browser schließt, nicht automatisch aktualisiert, und im Omise-Dashboard vorgenommene Erfassungen werden erst übernommen, wenn Sie auf Sync payment status klicken.

Payment action: was mit dem Kartenbetrag geschieht.

Per-charge webhook: sendet die Webhook-URL mit jeder Belastung. Nützlich, wenn mehrere Shops ein Omise-Konto teilen. Funktioniert nur, wenn der Shop HTTPS verwendet; andernfalls wird der Dashboard-Webhook genutzt. Standard: off.

Bestellungen

Die Bestellung wird im Schritt Confirm Order ohne Status (eine fehlende Bestellung) angelegt und erhält erst dann einen Status, wenn Omise für die Karte geantwortet hat. OpenCart hat keinen Status „On hold“: Standardmäßig sind die Status für autorisiert, zu prüfen und ausstehend alle Pending, der Bestell-Reiter und die Notizen unterscheiden sie. Eigene Status können Sie unter System > Localisation > Order Statuses anlegen und hier auswählen.

Order Status After Payment: die Karte wurde belastet (Capture immediately oder später erfasst). Standard: Processing.

Authorized Status: Authorize only: der Betrag ist reserviert, aber noch nicht erfasst. Standard: Pending.

On Hold (Review) Status: der belastete Betrag oder die Währung weicht von der Bestellung ab. Standard: Pending.

Awaiting Payment Status: der Kunde hat den Vorgang abgeschlossen, aber Omise hat die Belastung noch nicht bestätigt. Standard: Pending.

Failed Status: eine ausstehende Belastung einer Bestellung mit einem Status ist später fehlgeschlagen. Standard: Failed.

Canceled Status: die Belastung ist abgelaufen oder die Autorisierung wurde storniert; es wurde kein Geld eingezogen. Standard: Canceled.

Refunded Status: wird gesetzt, nachdem die Zahlung im Bestell-Reiter vollständig erstattet wurde. Standard: Refunded.

Erweitert

Debug log: schreibt API-Anfragen und Zahlungsereignisse in die Datei omise_p_debug.log.php im Logs-Ordner von OpenCart (storage/logs). Die Datei kann nicht über das Web geöffnet werden; bei 5 MB wird sie nach omise_p_debug.old.log.php verschoben. Schlüssel, Tokens sowie Kartendaten werden nie protokolliert. Standard: off. Solange sie deaktiviert ist, wird nichts geschrieben, auch keine Fehler. Aktivieren Sie sie daher, wenn Sie einem Problem nachgehen.

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

Delete data on uninstall: ist die Option aktiviert, entfernt das Deinstallieren der Erweiterung die Einstellungen und das Debug-Protokoll. Die Omise-Belastungen und -Erstattungen von Bestellungen sind Zahlungsverlauf und bleiben immer erhalten. Standard: off.

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 Credit / Debit Card). Im Schritt Confirm Order sieht der Kunde Ihre Beschreibung und das Kartenformular: Name on card, Card number, Expiry month (MM), Expiry year (YYYY) und Security code (CVV). Im Testmodus zeigt das Formular TEST MODE — use Omise test cards (e.g. 4242 4242 4242 4242), no real charges are made. an. OpenCart legt die Bestellung in diesem Schritt an, weiterhin ohne Status. In OpenCart 4 wählt der Kunde die Zahlungsart mit der Schaltfläche Choose im Block der Zahlungsarten im Fenster Payment method options; das Kartenformular befindet sich im Bestätigungsbereich am Ende der Kassenseite oberhalb von Confirm Order. Wenn der Kunde auf Confirm Order klickt, wandelt Omise.js die Karte im Browser mithilfe der Zahlungsadresse der Bestellung (in OpenCart 4, wenn der Shop keine Zahlungsadresse verlangt, der Lieferadresse) in ein Einmal-Token um. Die Kartenfelder werden nie an Ihren Shop übermittelt. Fehlende oder ungültige Felder werden oberhalb des Formulars angezeigt, zum Beispiel Please enter a valid card number.

Ihr Shop erstellt die Belastung anschließend mit dem geheimen Schlüssel für den Bestellbetrag in der Bestellwährung. Die Belastungsbeschreibung ist der Shopname und die Bestellnummer, die Bestell-ID wird in den Metadaten der Belastung gespeichert. Verlangt die Bank 3-D Secure, wird der Kunde zur Bankseite und danach zurück in Ihren Shop geleitet, und das Ergebnis wird erneut über die Omise-API abgefragt.

Die Bestellung wird erst als bezahlt markiert, wenn Omise es bestätigt: Die Belastung muss erfasst sein, und Betrag und Währung müssen mit der Bestellung übereinstimmen. 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 OpenCart-Bestellerfolgsseite mit Your card payment has been received. Bei Authorize only lautet die Seite Your card payment has been authorized. The amount will be charged when your order is processed. Meldet Omise die Zahlung weiterhin als ausstehend, erhält die Bestellung den Awaiting Payment Status, und die Seite zeigt Your payment is being confirmed by Omise. You will receive an e-mail as soon as it is confirmed — please do not pay again. Bestätigt oder lehnt Omise die Zahlung später ab (über den Webhook oder die Rückkehr des Kunden), wird der neue Bestellstatus mit Kundenbenachrichtigung gesendet, sodass OpenCart ihm eine E-Mail schickt. Kann die Zahlung direkt nach 3-D Secure nicht bestätigt werden, zeigt eine Seite Payment confirmation den Text We could not confirm your payment yet. If your card was charged, the order will be updated automatically — please do not pay again. und eine Schaltfläche Check again.

Wird die Karte abgelehnt, bleibt die Bestellung ohne Status. Der Kunde bleibt im Schritt Confirm Order mit Payment failed: und einem Grund, zum Beispiel unzureichende Deckung, ein ungültiger Sicherheitscode oder eine Ablehnung durch den Kartenaussteller, und kann mit demselben Warenkorb erneut versuchen. Schlägt 3-D Secure fehl, kehrt der Kunde ebenfalls mit dem Grund zur Kasse zurück; war die Belastung in der Zwischenzeit abgelaufen oder storniert, lautet die Meldung The payment was not completed. Please try again. Bei OpenCart 4 werden diese Meldungen nach 3-D Secure oberhalb der Kassenseite angezeigt.

Ein erneuter Versuch belastet nie doppelt. 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 einer abgelehnten Karte oder einem fehlgeschlagenen 3-D Secure dieselbe Bestellung mit einer neuen Belastung bezahlt. Ist die vorherige Belastung des Warenkorbs aber bereits bezahlt oder autorisiert, erhält diese Bestellung ihren Status und es erfolgt keine neue Belastung. Ein unvollständiger 3-D-Secure-Versuch läuft ab, bevor eine neue Belastung erfolgt. Ist eine zweite Belastung für einen bereits bezahlten Warenkorb weiterhin bezahlt (zum Beispiel in einem anderen Browser-Tab), wird keine Bestellung geändert, und eine Notiz an der bezahlten Bestellung fordert Sie auf, sie im Omise-Dashboard zu erstatten oder zu stornieren.

OpenCart 4 behält die Bestellung in der Kasse, bis die Erfolgsseite angezeigt wird. Wurde diese Bestellung inzwischen geschlossen (zum Beispiel weil ihre Belastung fehlgeschlagen oder abgelaufen ist oder Sie sie storniert oder erstattet haben), wird der Kunde mit Your previous order was cancelled or refunded. Please confirm the order again to pay with a new order. zurück zur Kasse geschickt, und das nächste Confirm Order bezahlt eine neue Bestellung. Ist diese Bestellung bereits bezahlt und der Warenkorb enthält nun andere Produkte oder Mengen, wird der Kunde ebenfalls zurück zur Kasse geschickt, und der neue Warenkorb erhält eine neue Bestellung.

Der Webhook funktioniert auch, während sich der Shop im Wartungsmodus befindet: OpenCart 3 lässt Anfragen von Zahlungserweiterungen durch, und in OpenCart 4 fügt die Erweiterung eine Startaktion hinzu, die den Webhook und die Rückkehr des Kunden von 3-D Secure durchlässt.

Die Erweiterung unterstützt nur Karten. Sie bietet keine anderen Omise-Zahlungsarten (PromptPay, TrueMoney, Mobile Banking, Ratenzahlung), keine gespeicherten Karten oder Omise-Kunden, keine Abonnements und keine Teilerfassung.

Bestellungen und Erstattungen

Bestellstatus

Kein Status (fehlende Bestellung): Der Kunde befindet sich bei 3-D Secure oder die Karte wurde abgelehnt. Unter Sales > Orders werden solche Bestellungen nur mit dem Filter Order Status auf Missing Orders angezeigt.

Bei OpenCart 4 kann eine unbezahlte Bestellung der Kasse den Status Voided erhalten, den OpenCart 4 setzt, wenn der Kunde zum Schritt Confirm Order zurückkehrt. Die Erweiterung behandelt eine solche Bestellung als Bestellung ohne Status, und eine spätere Zahlung bestätigt sie trotzdem.

Order Status After Payment (Standard Processing): die Zahlung wurde bestätigt. Eine Notiz zeigt den Betrag, die Omise-Belastung (chrg_...) und wie sie bestätigt wurde (Checkout, Rückkehr von 3-D Secure, Webhook, erneuter Zahlungsversuch, manuelle Erfassung oder manuelle Synchronisierung).

Authorized Status (Standard Pending): die Karte wurde mit Authorize only autorisiert. Nutzen Sie Capture payment oder Void authorization.

Awaiting Payment Status (Standard Pending): Omise hat die Zahlung noch nicht bestätigt. Der Webhook oder Sync payment status aktualisiert die Bestellung.

On Hold (Review) Status (Standard Pending): der Belastungsbetrag oder die Währung weicht von der Bestellung ab, zum Beispiel weil die Bestellung während 3-D Secure geändert wurde. Die Notiz zeigt beide Werte. Prüfen Sie die Bestellung und erfüllen Sie sie oder erstatten Sie die Zahlung.

Failed Status (Standard Failed): eine ausstehende Zahlung ist später fehlgeschlagen. Eine bezahlte Bestellung wird durch ein späteres Fehlerereignis nie herabgestuft.

Canceled Status (Standard Canceled): die Belastung ist abgelaufen oder die Autorisierung wurde storniert.

Refunded Status (Standard Refunded): die Zahlung wurde über die Erweiterung vollständig erstattet.

Trifft eine bezahlte oder autorisierte Belastung für eine Bestellung ein, die bereits den Status „canceled“ oder „refunded“ hat, wird die Bestellung nicht wieder geöffnet. Eine Notiz bittet Sie, das Omise-Dashboard zu prüfen und die Bestellung manuell zu erstatten oder wieder zu öffnen.

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

VibeFox Omise Payment-Reiter

Öffnen Sie unter Sales > Orders eine mit Omise bezahlte Bestellung. Unten auf der Bestellseite, neben History und Additional, zeigt der Reiter VibeFox Omise Payment die Belastungs-ID mit dem Kennzeichen Test bei Testzahlungen, die Zahlungsaktion, den Belastungsstatus, die Kartenmarke und die letzten Ziffern, die Beträge Charged / order / refunded, die Schaltflächen, das Erstattungsformular, den Erstattungsverlauf und die Omise notes der Bestellung. Der Reiter wird Benutzern angezeigt, die Zugriff auf die Erweiterung haben. Die Schaltflächen erfordern das Recht, die Erweiterung zu bearbeiten (festzulegen unter System > Users > User Groups), sowie den geheimen Schlüssel des Modus, in dem die Zahlung erfolgte. Das Ergebnis jeder Aktion wird im Reiter angezeigt.

Capture payment: erfasst den vollen autorisierten Betrag und setzt die Bestellung auf Order Status After Payment. Wird nur bei autorisierten Bestellungen angezeigt.

Void authorization: storniert die Autorisierung; es wird kein Geld erfasst, und die Bestellung wird auf Canceled Status gesetzt. Wird nur bei autorisierten Bestellungen angezeigt.

Sync payment status: liest die Belastung erneut von Omise, zum Beispiel nach einer Erfassung oder Erstattung im Omise-Dashboard, aktualisiert die Bestellung und fügt eine Notiz mit dem Belastungsstatus und dem bei Omise insgesamt erstatteten Betrag hinzu.

Statusänderungen im Reiter benachrichtigen den Kunden nicht und verschieben keine Bestände, genau wie eine manuelle Statusänderung.

Erstattungen

Geben Sie im Reiter den Amount ein (der noch nicht erstattete Betrag wird vorausgefüllt), optional einen Reason (optional), und klicken Sie auf Refund via Omise. Bestätigen Sie die Abfrage Refund this amount through Omise? This cannot be undone. Vollständige und Teilerstattungen werden unterstützt. Erstattungen erfolgen in dem Betrag und der Währung, die Omise belastet hat; nach einer Abweichung von Betrag oder Währung können Sie daher bis zu dem Betrag erstatten, den der Kunde tatsächlich bezahlt hat, nicht den Bestellbetrag. Die Erstattung wird im Modus gesendet, in dem die Zahlung erfolgte, daher muss dessen geheimer Schlüssel gesetzt sein. Der Grund wird bei Omise zusammen mit der Erstattung gespeichert. Eine erfolgreiche Erstattung wird dem Erstattungsverlauf und den Notizen mit der Omise-Erstattungs-ID hinzugefügt. Eine vollständige Erstattung setzt die Bestellung auf Refunded Status; eine Teilerstattung ändert den Status nicht. Bei einer noch nicht erfassten Autorisierung ist nur eine vollständige Erstattung möglich, und sie storniert die Autorisierung. Lehnt Omise die Erstattung ab, zeigt der Reiter Refund failed. mit der Omise-Meldung an, und es wird keine Erstattung erfasst.

Produktrücksendungen unter Sales > Returns zahlen kein Geld über Omise zurück. Im Omise-Dashboard vorgenommene Erstattungen werden nicht in OpenCart erfasst; Sync payment status zeigt den erstatteten Gesamtbetrag an.

Lizenzschlüssel

Die Erweiterung arbeitet mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzbereich License — VibeFox Omise Payment ist der erste Bereich unter Extensions > Extensions > Payments > VibeFox Omise Payment > Edit, oberhalb der Einstellungen. Fügen Sie den Schlüssel unter License key ein und klicken Sie auf Activate. Danach zeigt der Bereich den Schlüssel maskiert, den Status (zum Beispiel das Datum, bis zu dem die Lizenz aktiv ist, und Ihre Domain) sowie die Schaltflächen Check now zur erneuten Statusprüfung, Change key zur Eingabe eines anderen Schlüssels und Remove key, um den Schlüssel aus diesem Shop zu entfernen. Darunter stehen die Zeile Product: opencart-payment-omise 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 Bereichs folgen der Admin-Sprache (Englisch und Russisch sind enthalten).

Wird der Schlüssel nicht akzeptiert, nennt der Bereich den Grund, zum Beispiel Key not found, This key belongs to another product, Domain limit reached oder License expired on mit einem Datum. Klicken Sie nach einer Änderung der Shopadresse oder nachdem Sie in Ihrem Konto einen Domain-Platz freigegeben haben, 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 Shopadresse 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 Omise Kunden in 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), sodass Sie die Erweiterung einrichten und testen können, bevor Sie einen Schlüssel kaufen. Nachdem Sie die Seite Edit einmal geöffnet haben, erscheint auf dem Dashboard des Admin-Bereichs 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, und Erstattungen funktionieren weiterhin.

Läuft eine Lizenz ab, arbeitet die Erweiterung weiter, Updates und Support erfordern jedoch eine Verlängerung. Der Status wird automatisch erneut geprüft, wenn Sie das Dashboard oder die Seite Edit im Admin-Bereich öffnen: einmal täglich in den ersten 14 Tagen nach der Eingabe des Schlüssels, danach einmal pro Woche. Ein Cronjob ist nicht erforderlich. Beim Deinstallieren der Erweiterung werden Lizenzschlüssel und Lizenzstatus immer entfernt.

Fehlerbehebung

Omise erscheint nicht in der Kasse: Prüfen Sie, ob die Lizenz aktiv ist, Enable/Disable eingeschaltet ist, beide Schlüssel des aktuellen Modus eingegeben sind (Testschlüssel im Testmodus, Live-Schlüssel sonst) und der Kunde in einer der unterstützten Währungen bezahlt. Die Einstellungsseite zeigt eine Warnung, wenn Schlüssel 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 ging durch, aber die Bestellung bleibt ohne Status oder im Awaiting Payment Status: Der Webhook funktioniert nicht. Prüfen Sie im Omise-Dashboard, ob die Webhook-URL genau der unter Webhook URL angezeigten entspricht und HTTPS verwendet. Klicken Sie bei einer bestehenden Bestellung auf Sync payment status. Aktivieren Sie Debug log, um die Antworten des Webhooks zu sehen.

Webhook antwortet Charge ID does not match order oder Order not found: Die Belastung im Ereignis wurde nicht von diesem Shop für diese Bestellung erstellt. Es wird nichts verändert.

Webhook antwortet Order is being processed, retry later oder Failed to verify charge: Der Warenkorb wurde im selben Moment von einer anderen Anfrage gesperrt, die Omise-API war nicht erreichbar, oder der geheime Schlüssel des Zahlungsmodus fehlt. Omise wiederholt den Webhook.

Webhook antwortet The order status could not be set, retry later: Der Bestellstatus konnte in diesem Moment nicht gesetzt werden. Omise wiederholt den Webhook. Aktivieren Sie Debug log, um den Grund zu sehen.

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

Warnung beim Speichern: key must start with ... oder must be a live key: Ein Schlüssel wurde in das falsche Feld eingefügt und nicht gespeichert. Testschlüssel beginnen mit pkey_test_ / skey_test_, Live-Schlüssel mit pkey_ / skey_.

Der Kunde sieht Card payments are temporarily unavailable: Die Schlüssel sind falsch, oder das Karten-Token gehört zum anderen Modus (ein Test-Token im Live-Modus oder umgekehrt). Prüfen Sie die Schlüssel und Test mode.

Der Kunde sieht We could not reach the payment provider: Beim Erstellen der Belastung kam keine gültige Antwort von Omise. Eine Belastung könnte dennoch angelegt worden sein; prüfen Sie das Omise-Dashboard, bevor der Kunde erneut bezahlt.

Der Kunde sieht This order is already being paid: Die Kasse wurde gleichzeitig zweimal abgeschickt. Der Kunde wartet kurz und prüft die E-Mail, bevor er es erneut versucht.

Bestellung ist nach der Zahlung im Prüfstatus: Lesen Sie die Notizen im Reiter VibeFox Omise Payment (siehe Order statuses) und erfüllen Sie dann die Bestellung oder erstatten Sie die Zahlung.

Erstattung schlägt mit einer Meldung zum Modus fehl: Die Zahlung erfolgte im Test- oder Live-Modus, und der geheime Schlüssel dieses Modus ist nicht gesetzt. Geben Sie ihn ein und versuchen Sie es erneut.

Teilerstattung einer autorisierten Bestellung schlägt fehl: Die Zahlung ist nur autorisiert. Erfassen Sie sie zuerst oder erstatten Sie den vollen Betrag, um sie zu stornieren.

Deinstallation

Gehen Sie zu Extensions > Extensions, wählen Sie den Typ Payments und klicken Sie neben VibeFox Omise 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-Ereignis der Erweiterung wird entfernt (bei OpenCart 4 auch dessen Ereignisse und Startaktion, die den Webhook und die Rückkehr von 3-D Secure im Wartungsmodus durchlässt). Ist Delete data on uninstall aktiviert, werden die übrigen Einstellungen (Titel, Beschreibung, Testmodus, Schlüssel, Zahlungsaktion, Webhook- und Protokollierungsoptionen) und das Debug-Protokoll entfernt. Ist die Option deaktiviert, bleiben sie für eine spätere Neuinstallation erhalten. Omise-Belastungen und -Erstattungen bleiben immer erhalten, sodass zuvor bezahlte Bestellungen nach einer Neuinstallation weiterhin erstattet werden können. Bestehende Bestellungen behalten ihre Zahlungsnotizen.

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

Omise ist eine Marke ihres jeweiligen Inhabers. Diese Erweiterung ist nicht mit Omise verbunden und wird von Omise weder unterstützt noch empfohlen.