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

Shop-Währung: IDR, PHP, VND, THB, MYR, USD oder SGD. Für andere Kassenwährungen wird die Zahlungsart nicht angezeigt. Welche Zahlungskanäle und Währungen tatsächlich verfügbar sind, hängt von Ihrem Xendit-Konto ab.

Xendit-Konto: Sie benötigen einen geheimen API-Schlüssel mit Schreibberechtigung für Money-in (Rechnungen) für den Testmodus und einen weiteren für den Livemodus sowie das Webhook-Verifizierungstoken jedes Modus (siehe Konfiguration). Verwendet werden nur die geheimen Schlüssel und die Verifizierungstoken. Ein öffentlicher Schlüssel wird nicht benötigt, da der Kunde auf der von Xendit gehosteten Rechnungsseite bezahlt.

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 OpenCart-3-Paket wcp_xendit_payment_gateway-oc3-(version).ocmod.zip und das OpenCart-4-Paket wcp_xendit_payment_gateway.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 Administrationsbereich zu Extensions > Installer, klicken Sie auf Upload und wählen Sie die Datei wcp_xendit_payment_gateway-oc3-(version).ocmod.zip. Die Erweiterung enthält keine OCMOD-Modifikationen, daher muss Extensions > Modifications nicht aktualisiert werden. Statt des Installers können Sie auch 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 Xendit Payment Gateway und klicken Sie auf Install (die grüne +-Schaltfläche). Ihr Administrator-Benutzer benötigt das Recht, die Liste der Zahlungserweiterungen zu ändern.

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

4. Fügen Sie Ihre geheimen Xendit-Schlüssel ein, tragen Sie die Webhook-URL im Xendit Dashboard ein und fügen Sie die Verifizierungstoken ein (siehe Konfiguration).

5. Aktivieren Sie Enable/Disable und klicken Sie auf Save. Führen Sie eine Testbestellung im Testmodus durch und deaktivieren Sie danach Test Mode, um echte Zahlungen anzunehmen.

OpenCart 4

1. Gehen Sie im Administrationsbereich zu Extensions > Installer, klicken Sie auf Upload und wählen Sie die Datei wcp_xendit_payment_gateway.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 Xendit Payment Gateway, klicken Sie auf Install (die grüne +-Schaltfläche) und dann auf Edit (die Stift-Schaltfläche).

4. Geben Sie den Lizenzschlüssel, die Xendit-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 Webhooks).

Eine Neuinstallation beginnt mit ausgeschalteter Zahlungsart und eingeschaltetem Testmodus.

Konfiguration

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

Oberhalb der Einstellungen zeigt ein Kasten den aktiven Modus: TEST MODE (Rechnungen werden mit dem Test-Schlüssel erstellt; es wird kein echtes Geld belastet) oder LIVE MODE (Rechnungen werden mit dem Live-Schlüssel erstellt und Kunden werden belastet). Die Seite warnt Sie, wenn der geheime Schlüssel des aktiven Modus fehlt oder ein falsches Präfix hat (die Zahlungsart wird dann an der Kasse ausgeblendet), und wenn das Webhook-Verifizierungstoken des aktiven Modus leer ist (Xendit-Benachrichtigungen werden dann abgewiesen, sodass Bestellungen nur aktualisiert werden, wenn der Kunde in Ihren Shop zurückkehrt).

Beim Speichern darf Title nicht leer sein (höchstens 128 Zeichen), Sort Order muss eine ganze Zahl sein (negative Zahlen sind erlaubt), Total muss eine Zahl sein, 0 oder größer, und die Geozone sowie die Bestellstatus müssen existieren. Andernfalls wird nichts gespeichert und die Seite nennt das betreffende Feld.

Xendit

Enable/Disable: Enable Xendit schaltet die Zahlungsart ein oder aus. Standard: off.

Title: der Name der Zahlungsart, den Kunden an der Kasse sehen. Er wird auch als Name der Zahlungsart in der Bestellung gespeichert. Standard: Xendit. Pflichtfeld, bis zu 128 Zeichen.

Description: der Text, der dem Kunden im Schritt Confirm Order über der Bestätigungsschaltfläche angezeigt wird. Standard: Pay with virtual accounts, e-wallets, QR codes, retail outlets or cards via Xendit.

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

Geo Zone: Xendit nur für Zahlungsadressen in der gewählten Geozone anbieten. Standard: All zones. Geozonen werden unter System > Localisation > Geo Zones eingerichtet.

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

API-Schlüssel

Erstellen Sie einen geheimen API-Schlüssel mit Schreibberechtigung für Money-in (Rechnungen) unter Xendit Dashboard > Settings > Developers > API keys (der Abschnitt verlinkt dorthin), einmal im Testmodus und einmal im Livemodus. Der Schlüssel bestimmt, wo die Rechnung erstellt wird. Beim Speichern wird ein Schlüssel, der nicht mit dem Präfix seines Feldes beginnt, nicht gespeichert, und die Seite zeigt zum Beispiel Test secret key was not saved: it must start with xnd_development_. Die übrigen Einstellungen werden gespeichert.

Test Mode: erstellt Rechnungen mit dem Test-Schlüssel, daher wird kein echtes Geld belastet. Standard: on. Schalten Sie es aus, um echte Zahlungen mit dem Live-Schlüssel anzunehmen. Solange es eingeschaltet ist, sehen Kunden im Schritt Confirm Order den Hinweis Test mode: no real money is charged.

Test Secret Key: der geheime Schlüssel des Xendit-Testmodus. Er beginnt mit xnd_development_.

Live Secret Key: der geheime Schlüssel des Xendit-Livemodus. Er beginnt mit xnd_production_.

Gespeicherte Schlüssel und Token werden nie wieder angezeigt. Das Feld bleibt leer und zeigt Saved — leave empty to keep it. Geben Sie einen neuen Wert nur 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 und klicken Sie auf Save.

Webhooks

Der Webhook teilt Ihrem Shop mit, dass eine Rechnung bezahlt wurde. Stellen Sie im Xendit Dashboard > Settings > Developers > Webhooks (der Abschnitt verlinkt dorthin) die URL aus Webhook URL für Invoices > Invoice paid ein, im Testmodus und im Livemodus. Optional können Sie sie auch für Invoice expired eintragen. Auf OpenCart 3 sieht die URL etwa so aus: https://your-store/index.php?route=extension/payment/wcp_xendit_payment_gateway/webhook, auf OpenCart 4 so: https://your-store/index.php?route=extension/wcp_xendit_payment_gateway/payment/wcp_xendit_payment_gateway.webhook. Sie wird aus der Shop-Adresse Ihrer OpenCart-Installation gebildet. Kopieren Sie sie genau so, wie die Einstellungen sie anzeigen. Sie muss aus dem Internet erreichbar sein.

Kopieren Sie danach das Webhook verification token jedes Modus aus dem Xendit Dashboard in das passende Feld. Xendit sendet es im Header x-callback-token. Benachrichtigungen ohne das Token des Modus, in dem die Rechnung erstellt wurde, werden abgewiesen. Das Token belegt nur, dass die Benachrichtigung von Xendit stammt: Rechnungsstatus, Betrag und Währung werden immer erneut über die Xendit-API mit dem geheimen Schlüssel dieses Modus abgefragt. Ohne Webhook wird eine Bestellung nur bestätigt, wenn der Kunde nach der Zahlung in den Shop zurückkehrt.

Test Webhook Verification Token: das Webhook-Verifizierungstoken des Xendit-Testmodus.

Live Webhook Verification Token: das Webhook-Verifizierungstoken des Xendit-Livemodus.

Zahlung

Invoice Description: die Beschreibung, die auf der Xendit-Rechnung angezeigt wird. Sie können die Platzhalter {order_id} und {order_number} (beide sind die OpenCart-Bestellnummer) und {site_name} (der Shopname) verwenden. HTML wird entfernt und der Text auf 255 Zeichen gekürzt. Standard: Order #{order_id}.

Order Status After Payment: welchen Status eine bestätigte Zahlung in einem einzigen Statuswechsel setzt.

OpenCart legt die Bestellung im Schritt Confirm Order ohne Status an (eine fehlende Bestellung). Die Bestellung erhält erst einen Status, nachdem Xendit die Zahlung über die API bestätigt hat. Jedes der folgenden Felder listet Ihre OpenCart-Bestellstatus auf.

Paid Order Status: der Status nach einer bestätigten Zahlung mit Processing. Standard: Processing.

Complete Order Status: der Status nach einer bestätigten Zahlung mit Completed. Standard: Complete.

On Hold (Review) Status: eine Rechnung wurde mit einem anderen Betrag oder einer anderen Währung als die Bestellung bezahlt (der Warenkorb wurde nach der Rechnungserstellung geändert oder es liegt eine Teilzahlung vor). Eine Notiz erklärt den Grund. Standard: Pending, weil OpenCart keinen Status On hold hat. Sie können unter System > Localisation > Order Statuses einen eigenen Status anlegen und hier auswählen.

Erweitert

Debug Log: schreibt API-Anfragen und Webhooks in xendit_p_debug.log.php im Protokollordner von OpenCart (storage/logs). Die Datei kann nicht über das Web geöffnet werden und wird bei 5 MB nach xendit_p_debug.old.log.php verschoben. Fehler und Warnungen werden immer protokolliert, auch wenn dies ausgeschaltet ist. API-Schlüssel, Token und Kundendaten werden nicht protokolliert. Standard: off.

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 die Deinstallation der Erweiterung die Einstellungen des Gateways und das Protokoll. Bestelldaten (die Rechnungs-IDs der Bestellungen) bleiben immer erhalten. Standard: off.

Import / Export

Export: Download JSON speichert die Einstellungen als JSON-Datei. Geheime Schlüssel und Token werden nicht exportiert.

Import: fügen Sie zuvor exportiertes JSON ein und klicken Sie auf Import, um die Einstellungen wiederherzustellen. Die gespeicherten geheimen Schlüssel und Token bleiben erhalten.

Kasse

Die Zahlungsart wird angezeigt, wenn die Kassenwährung IDR, PHP, VND, THB, MYR, USD oder SGD ist. Der Kunde wählt sie im Schritt Payment Method (standardmäßig Xendit). Im Schritt Confirm Order sieht der Kunde Ihre Beschreibung. OpenCart legt die Bestellung in diesem Schritt an, noch ohne Status. Wenn der Kunde auf Confirm Order klickt, erstellt die Erweiterung eine Xendit-Rechnung über den Bestellbetrag in der Bestellwährung und leitet den Kunden zur Xendit-Rechnungsseite weiter. Beträge in IDR und VND werden auf ganze Zahlen gerundet, da Xendit dafür keine Dezimalstellen akzeptiert. Die E-Mail-Adresse des Kunden wird an Xendit übergeben. Auf der Rechnungsseite zahlt der Kunde mit einem der Zahlungskanäle, die in Ihrem Xendit-Konto für diese Währung aktiviert sind, zum Beispiel einem virtuellen Konto, einem E-Wallet, einem QR-Code, einer Einzelhandelsfiliale oder einer Karte. Auf OpenCart 4 wählt der Kunde die Zahlungsart mit der Schaltfläche Choose im Block der Zahlungsart im Fenster Payment method options und klickt unten auf der Kassenseite auf Confirm Order.

Nach der Zahlung kehrt der Kunde in Ihren Shop zurück. Die Bestellung wird erst als bezahlt markiert, wenn Xendit die Zahlung bestätigt hat: über den Webhook oder über eine serverseitige Anfrage an die Xendit-API, wenn der Kunde zurückkehrt. Die Bestellung erhält danach 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. Wenn Xendit die Zahlung noch nicht bestätigt hat, zeigt eine Seite Payment confirmation den Hinweis Your payment has not been confirmed by Xendit yet. Your order will be confirmed as soon as Xendit confirms it — please do not pay again. mit den Schaltflächen Check again und Back to checkout. Der Webhook setzt den Bestellstatus, sobald er eingeht.

Wenn die Rechnung fehlschlägt oder abläuft, sendet Xendit den Kunden zurück. Die Erweiterung prüft zuerst die Rechnung (sie könnte in einem anderen Tab bezahlt worden sein) und lässt sie danach ablaufen, sodass sie nicht mehr bezahlt werden kann. Der Kunde ist wieder an der Kasse, mit dem Hinweis The Xendit payment was not completed. You can try again or choose another payment method. Der Warenkorb bleibt erhalten.

OpenCart 3 legt jedes Mal eine neue Bestellung an, wenn der Schritt Confirm Order angezeigt wird; OpenCart 4 aktualisiert die Bestellung der Kasse und behält sie, daher wird nach einer fehlgeschlagenen oder abgelaufenen Rechnung beim nächsten Confirm Order eine neue Rechnung für dieselbe Bestellung erstellt. Ist eine andere Bestellung desselben Warenkorbs bereits bezahlt, gelangt der Kunde direkt zur Erfolgsseite und wird nicht zweimal belastet. Sind Bestellbetrag, Währung und Modus unverändert und ist die offene Rechnung dieser Bestellung noch mindestens fünf weitere Minuten gültig, wird der Kunde zur selben Rechnung geschickt. Andernfalls wird die alte Rechnung zuerst abgelaufen gelassen und eine neue erstellt, sodass es für einen Warenkorb nie zwei offene Rechnungen gibt. War die alte Rechnung bereits bezahlt, wird diese Zahlung bestätigt statt einer neuen.

Auf OpenCart 4, wenn die Bestellung der Kasse vom Shop inzwischen geschlossen wurde (zum Beispiel storniert oder erstattet) oder bereits bezahlt ist, der Warenkorb seitdem aber geändert wurde, auch durch eine neue Menge, wird der Kunde mit Your previous order is already closed or paid. Please confirm the order again: the cart will be paid with a new order. zur Kasse zurückgeschickt, und der nächste Confirm Order bezahlt eine neue Bestellung. Auf OpenCart 4 werden diese Meldung, die Meldung zur nicht abgeschlossenen Zahlung und We could not match this payment to an order. If you were charged, please contact us. über der Kasse angezeigt.

Wenn Xendit die Zahlung nicht starten kann, bleibt der Kunde im Schritt Confirm Order mit einer kurzen Meldung über der Schaltfläche, zum Beispiel Xendit is temporarily unavailable. Please try again in a few minutes or choose another payment method., einer Meldung, dass die Währung für Ihr Konto nicht akzeptiert wird, oder dass der Bestellbetrag außerhalb der Betragsgrenzen von Xendit liegt. Der technische Grund wird ins Protokoll geschrieben. Eine Bestellung mit dem Betrag null kann nicht mit Xendit bezahlt werden.

Der Webhook und die Rückkehr des Kunden funktionieren auch, während der Shop im Wartungsmodus ist: OpenCart 3 lässt Anfragen von Zahlungserweiterungen durch, und auf OpenCart 4 fügt die Erweiterung dafür eine Startaktion hinzu.

Die Zahlung erfolgt immer auf der Xendit-Seite. Die Erweiterung bietet keine Erstattungen aus dem Administrationsbereich, keine gespeicherten Karten, Abonnements oder wiederkehrenden Zahlungen, keine Karten- oder E-Wallet-Felder auf der Kassenseite, kein getrenntes Autorisieren und Erfassen und keine xenPlatform-Unterkonten.

Bestellungen

Bestellstatus

Kein Status (fehlende Bestellung): der Kunde wurde zu Xendit weitergeleitet und hat nicht bezahlt, oder Xendit hat die Zahlung noch nicht bestätigt. Unter Sales > Orders werden solche Bestellungen nur mit dem Filter Order Status auf Missing Orders angezeigt.

Paid Order Status oder Complete Order Status (Standard Processing oder Complete): die Zahlung wurde bestätigt. Der Status folgt Order Status After Payment. Eine Notiz zeigt die Rechnungs-ID, den bezahlten Betrag, den Zahlungskanal und den Modus.

On Hold (Review) Status (Standard Pending): die bezahlte Rechnung entsprach nicht dem Bestellbetrag oder der Bestellwährung, oder es wurde weniger als der Gesamtbetrag gezahlt (zum Beispiel wurde der Warenkorb nach der Rechnungserstellung geändert). Die Notiz erklärt es. Prüfen Sie die Zahlung im Xendit Dashboard und bearbeiten Sie danach die Bestellung oder erstatten Sie die Zahlung. Wird später eine andere Rechnung derselben Bestellung mit dem richtigen Betrag bezahlt, wechselt die Bestellung in den bezahlten Status.

Wird eine Rechnung für eine Bestellung bezahlt, die einen anderen Status hat, zum Beispiel storniert oder erstattet, bleibt der Bestellstatus unverändert. Eine Notiz bittet Sie, die Zahlung im Xendit Dashboard zu erstatten oder die Bestellung manuell wiederherzustellen. Wird eine zweite Rechnung für eine bereits bezahlte Bestellung oder für eine andere Bestellung eines bereits bezahlten Warenkorbs bezahlt, bleibt die Bestellung unverändert, und eine Notiz an der bezahlten Bestellung bittet Sie, die doppelte Zahlung im Xendit Dashboard zu erstatten.

Notizen sind Einträge im History der Bestellung, die der Kunde nicht sieht. Sie beginnen mit dem Wort Xendit.

Reiter VibeFox Xendit Payment Gateway

Öffnen Sie unter Sales > Orders eine mit Xendit bezahlte Bestellung. Unten auf der Bestellseite, neben History und Additional, zeigt der Reiter VibeFox Xendit Payment Gateway die Xendit invoice, den Mode (mit der Bezeichnung Test bei Testzahlungen), den Status der Zahlung, die Tabelle Invoices of this order and its cart (Datum, Bestellung, Rechnungs-ID, externe ID, Modus, Betrag, bezahlter Betrag, Status, Zahlungskanal) und die Payment notes der Bestellung. Der Reiter wird Benutzern angezeigt, die Zugriff auf die Erweiterung haben.

Erstattungen

Erstattungen werden vom Shop aus nicht an Xendit gesendet. Erstatten Sie die Zahlung im Xendit Dashboard (suchen Sie nach der Rechnungs-ID, die im Reiter angezeigt wird) und ändern Sie danach den Bestellstatus in OpenCart. Produktrücksendungen unter Sales > Returns erstatten kein Geld über Xendit.

Lizenzschlüssel

Die Erweiterung funktioniert mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock License — VibeFox Xendit Payment Gateway ist der erste Block auf Extensions > Extensions > Payments > VibeFox Xendit Payment Gateway > Edit, über den Einstellungen. Fügen 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 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 zum Entfernen des Schlüssels aus diesem Shop. Darunter stehen die Zeile Product: opencart-payment-xendit und der Link Manage licenses and domains in your account, der Ihr vibefox.net-Konto öffnet. Den Schlüssel können nur Administratoren mit dem Recht Modify für die Erweiterung ändern. Die Texte des Blocks folgen der Administrationssprache (Englisch und Russisch sind enthalten).

Wenn der Schlüssel nicht akzeptiert wird, zeigt 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. Nachdem sich die Shop-Adresse geändert hat oder nachdem Sie in Ihrem Konto einen Domain-Platz 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 für eine Domain: die 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 einen aktiven Schlüssel wird Xendit Kunden an 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 Administrationsbereich im selben Browser angemeldet ist, sieht die Zahlungsart im Shop weiterhin, markiert als (unlicensed — visible to admins only), damit Sie die Erweiterung einrichten und testen können, bevor Sie einen Schlüssel kaufen. Unter OpenCart 4 ist diese Vorschau nicht verfügbar: Der Shop sieht die Admin-Anmeldung nicht, daher wird die Zahlungsart ohne aktiven Schlüssel für alle ausgeblendet. Nachdem Sie die Seite Edit einmal geöffnet haben, erscheint ein Hinweis auf dem Dashboard des Administrationsbereichs. Schließen Sie ihn mit ×, um ihn 7 Tage lang auszublenden. Bestehende Bestellungen sind davon nicht betroffen: bereits gestartete Zahlungen werden weiterhin bestätigt.

Wenn eine Lizenz abläuft, 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 Eingabe des Schlüssels, danach einmal pro Woche. Ein Cron-Job ist nicht nötig. Beim Deinstallieren der Erweiterung werden immer der Lizenzschlüssel und der Lizenzstatus entfernt.

Fehlerbehebung

Xendit erscheint nicht an der Kasse: prüfen Sie, ob die Lizenz aktiv ist, Enable/Disable eingeschaltet ist, der aktive Modus einen geheimen Schlüssel mit dem richtigen Präfix hat (Test Secret Key mit xnd_development_ im Testmodus, Live Secret Key mit xnd_production_ im Livemodus) und die Kassenwährung IDR, PHP, VND, THB, MYR, USD oder SGD ist. Die Einstellungsseite zeigt eine Warnung, wenn der Schlüssel fehlt oder falsch ist. Prüfen Sie außerdem, ob die Zahlungsadresse in der gewä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 Xendit Dashboard des genutzten Modus (Test oder Live), ob die unter Webhook URL angezeigte URL für Invoice paid eingetragen ist und ob das Verifizierungstoken dieses Modus im passenden Feld gespeichert ist. Das Xendit Dashboard zeigt für jeden Webhook die Antwort Ihres Shops an. Die Bestellung erhält ihren Status auch, wenn der Kunde nach der Zahlung in den Shop zurückkehrt.

Webhook answers Webhook verification token is not configured: es ist kein Verifizierungstoken gesetzt. Fügen Sie das Token in die Einstellungen ein.

Webhook answers Unauthorized: das von Xendit gesendete Token stimmt mit keinem Token in den Einstellungen überein. Kopieren Sie das Token des richtigen Modus erneut.

Webhook answers Token does not match the mode of this invoice: die Rechnung wurde im anderen Modus erstellt. Eine Testbenachrichtigung bestätigt nie eine Live-Zahlung und umgekehrt. Richten Sie Webhook und Token in dem Modus ein, in dem die Bestellung bezahlt wurde.

Webhook answers Ignored: not an invoice of this store: die Rechnung wurde nicht von diesem Shop erstellt, zum Beispiel durch eine andere Integration auf demselben Xendit-Konto. Die Schaltfläche Test im Xendit Dashboard erhält ebenfalls diese Antwort, was bestätigt, dass URL und Token funktionieren. Ignored: unknown order und Ignored: unknown invoice bedeuten, dass die Bestellung oder die Rechnung diesem Shop nicht bekannt ist.

Webhook answers Temporary error: die Xendit-API konnte zur Prüfung der Rechnung nicht erreicht werden, der geheime Schlüssel des Modus der Rechnung fehlt oder der Warenkorb wurde gleichzeitig durch eine andere Anfrage aktualisiert. Xendit wiederholt den Webhook. Prüfen Sie, ob beide geheimen Schlüssel gesetzt sind, wenn Zahlungen in beiden Modi begonnen wurden, und schalten Sie Debug Log ein, um den Grund zu sehen.

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

Ein Schlüssel wird nicht gespeichert: der Wert beginnt nicht mit dem Präfix seines Feldes. Testschlüssel beginnen mit xnd_development_, Live-Schlüssel mit xnd_production_.

Der Kunde sieht This payment method is temporarily unavailable: Xendit hat die Anfrage abgelehnt, etwa weil der geheime Schlüssel falsch ist oder die Schreibberechtigung für Money-in (Rechnungen) fehlt. Sehen Sie im Feld Log auf der Erweiterungsseite nach. Eine Meldung zu den Rechnungsdaten bedeutet, dass Xendit die Anfragedaten nicht akzeptiert hat, zum Beispiel die E-Mail-Adresse.

Der Kunde sieht A payment for this order was already received by Xendit and is being reviewed: eine frühere Rechnung dieses Warenkorbs wurde bezahlt, die Bestellung konnte aber noch nicht bestätigt werden. Prüfen Sie die Zahlung im Xendit Dashboard und im Protokoll.

Der Kunde sieht We could not match this payment to an order: der Rückkehr-Link von Xendit gehört nicht zu einer Bestellung dieses Shops, oder die Rechnung konnte keiner Bestellung zugeordnet werden. Prüfen Sie die Zahlung im Xendit Dashboard und im Protokoll.

Die Bestellung ist nach der Zahlung im Prüfstatus: lesen Sie die Notizen im Reiter VibeFox Xendit Payment Gateway. Der bezahlte Betrag oder die Währung wich von der Bestellung ab. Bearbeiten Sie die Bestellung oder erstatten Sie die Zahlung im Xendit Dashboard.

Für Entwickler: Die Erweiterung löst die OpenCart-Ereignisse xendit_p_invoice_request, xendit_p_supported_currencies und xendit_p_currency_decimals aus, um die Rechnungsanfrage, die Währungsliste und die Anzahl der Dezimalstellen je Währung zu ändern.

Deinstallation

Gehen Sie zu Extensions > Extensions, wählen Sie den Typ Payments und klicken Sie neben VibeFox Xendit Payment Gateway 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 Abschnitts Payment, die bei einer Neuinstallation auf ihre Standardwerte zurückgesetzt werden. Auf OpenCart 4 werden außerdem das Ereignis der Erweiterung und ihre Startaktion entfernt, die im Wartungsmodus den Webhook und die Rückkehr des Kunden durchlässt. Ist Delete Data on Uninstall eingeschaltet, werden die übrigen Gateway-Einstellungen (Titel, Beschreibung, Testmodus, Schlüssel, Token, Rechnungsbeschreibung, Bestellstatus nach der Zahlung, Protokollierung) und das Protokoll entfernt. Ist es ausgeschaltet, bleiben sie für eine spätere Neuinstallation erhalten. Die Xendit-Rechnungsdaten der Bestellungen bleiben immer erhalten. Bestehende Bestellungen behalten ihre Zahlungsnotizen.

Auf OpenCart 4 entfernen Sie die Dateien der Erweiterung ebenfalls, indem Sie nach der Deinstallation zu Extensions > Installer gehen, neben VibeFox Xendit Payment Gateway 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.

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