VibeFox Helcim 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 und PCI DSS: Kartendaten werden auf Ihrer Kasse eingegeben und von Ihrem Server an Helcim übermittelt. Sie werden nie gespeichert oder protokolliert, doch sie laufen über Ihren Server. Ihr Shop braucht daher ein SSL-Zertifikat für die Kasse, und Ihr Hosting muss PCI DSS (SAQ D) erfüllen.

Währung: Helcim verarbeitet CAD und USD. Die Zahlungsart wird nur angezeigt, wenn die Währung der Kasse eine der in der Erweiterung eingestellten Account currencies ist.

Helcim-Konto: ein Helcim-Händlerkonto in Kanada oder den USA und ein API-Token mit Berechtigung zur Transaktionsverarbeitung (siehe Configuration). Ein Helcim-Testkonto (Developer) ist für Tests optional.

VibeFox-Lizenzschlüssel: wird auf vibefox.net gekauft. Ein Schlüssel funktioniert auf einer Domain.

Installation

Der Download ist eine einzige 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_helcim_gateway-oc3-(version).ocmod.zip und das OpenCart-4-Paket wcp_helcim_gateway.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_helcim_gateway-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 dieses Pakets in das Stammverzeichnis Ihres Shops kopieren.

2. Gehen Sie zu Extensions > Extensions und wählen Sie den Typ Payments. Suchen Sie VibeFox Helcim Gateway 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 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 License key).

4. Öffnen Sie in Helcim All Tools > Integrations > API Access Configuration, erstellen Sie einen API-Zugang mit Berechtigung zur Transaktionsverarbeitung (Käufe, Vorautorisierungen, Erfassungen und Erstattungen) und kopieren Sie dessen Token.

5. Fügen Sie das Token in Live API token ein und das Token Ihres Helcim-Testkontos in Test API token, falls Sie eines haben.

6. Wählen Sie den Transaction type und die Account currencies, aktivieren Sie Enable / Disable und klicken Sie auf Save. Zum Testen aktivieren Sie zuerst Test mode und bezahlen Sie mit Ihrem Testkonto; danach deaktivieren Sie den Testmodus wieder.

OpenCart 4

1. Gehen Sie im Admin-Bereich zu Extensions > Installer, klicken Sie auf Upload und wählen Sie die Datei wcp_helcim_gateway.ocmod.zip. Ändern Sie den Dateinamen nicht: OpenCart 4 übernimmt den Code der Erweiterung aus dem Dateinamen, und ein umbenanntes Paket funktioniert nicht.

2. Das Paket erscheint in der Liste der installierten Erweiterungen auf derselben Seite. 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 Helcim 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 API-Tokens und die Zahlungseinstellungen ein, wie in den Schritten 3 bis 6 für OpenCart 3. Die Einstellungsseite und ihre Felder sind in beiden Versionen gleich.

Nach einer Neuinstallation ist die Zahlungsart deaktiviert und der Testmodus ausgeschaltet.

Konfiguration

Alle Einstellungen befinden sich auf der Seite der Erweiterung: Extensions > Extensions > Payments > VibeFox Helcim Gateway > Edit. Die Abschnitte sind links aufgelistet; die Schaltfläche Save unter der Liste speichert die gesamte Seite. Oberhalb der Einstellungen warnt die Seite, wenn die Standardwährung Ihres Shops keine der Account currencies ist (Helcim wird dann nur für Bestellungen in einer erlaubten Währung angeboten), und, solange die Zahlungsart aktiviert ist, wenn das API-Token des aktuellen Modus leer ist (die Zahlungsart wird dann auf der Kasse ausgeblendet). Ohne das Recht zum Ändern der Erweiterung zeigt die Seite die Einstellungen an, kann sie aber nicht speichern.

Beim Speichern darf Title nicht leer sein (höchstens 128 Zeichen), Sort Order muss eine ganze Zahl sein, Total eine Zahl größer oder gleich 0, und jeder Bestellstatus muss existieren. Ist etwas falsch, wird nichts gespeichert, und die Seite listet die Fehler auf.

Helcim

Enable / Disable: Enable Helcim Gateway schaltet die Zahlungsart ein oder aus. Standard: aus.

Title: die Bezeichnung der Zahlungsart, die auf der Kasse angezeigt wird. Sie wird auch als Name der Zahlungsart in der Bestellung gespeichert. Standard: Credit card (Helcim). Pflichtfeld.

Description: der Text, den der Kunde im Schritt Confirm Order über dem Kartenformular sieht. Standard: Pay securely with your credit card.

Sort Order: die Position der Zahlungsart auf der Kasse. Lassen Sie das Feld leer oder geben Sie eine ganze Zahl ein.

Geo Zone: das Kartenformular nur für Zahlungsadressen aus der gewählten Geo Zone anbieten. Standard: All zones. Geo Zones richten Sie unter System > Localisation > Geo Zones ein.

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

API-Zugangsdaten

Gehen Sie in Helcim zu All Tools > Integrations > API Access Configuration, erstellen Sie einen API-Zugang und kopieren Sie dessen Token. Geben Sie ihm die Berechtigung zur Transaktionsverarbeitung für Käufe, Vorautorisierungen, Erfassungen und Erstattungen. Helcim-Testkonten verwenden dieselbe API-Adresse wie Live-Konten, daher nutzt der Testmodus einfach das Token Ihres Helcim-Testkontos. Der Abschnitt enthält einen Link zur Helcim-API-Dokumentation.

Live API token: das API-Token Ihres Live-Helcim-Kontos. Es wird verwendet, wenn der Testmodus aus ist.

Test mode: verwendet das Test API token (Helcim-Testkonto). Zahlungen, Erfassungen und Erstattungen gehen an Ihr Helcim-Testkonto, und Kunden sehen einen Hinweis zum Testmodus. Erfassungen und Erstattungen einer Bestellung verwenden immer das Token des Modus, in dem die Bestellung bezahlt wurde. Standard: aus.

Test API token: das API-Token Ihres Helcim-Testkontos (Developer). Es wird verwendet, wenn der Testmodus an ist.

Gespeicherte 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 ein gespeichertes Token zu entfernen, setzen Sie unter dem Feld den Haken bei Clear the saved token on save und klicken Sie auf Save.

Zahlung

Transaction type: legt fest, wie die Karte belastet wird.

Account currencies: die Währungen, die Ihr Helcim-Konto verarbeiten kann. Bestellungen werden immer in der Bestellwährung belastet. Die Zahlungsart wird auf der Kasse für andere Währungen ausgeblendet.

Bestellungen

Die Bestellung wird im Schritt Confirm Order ohne Status angelegt (eine fehlende Bestellung) und erhält erst einen Status, nachdem Helcim die Karte genehmigt hat. Jedes Feld listet Ihre Bestellstatus aus OpenCart auf.

Order Status After Payment: die Karte wurde belastet (Kauf oder Erfassung einer Vorautorisierung). Standard: In Bearbeitung.

Authorized Status: Vorautorisierung: Der Betrag ist nur reserviert, noch nicht belastet. Erfassen Sie ihn mit Capture payment im Bestellreiter. Standard: Ausstehend, weil OpenCart keinen Status On hold hat.

On Hold (Review) Status: Die Antwort von Helcim passt nicht zur Bestellung (Teilgenehmigung, andere Währung, keine Transaktions-ID oder der Bestellbetrag weicht von der Belastung ab). Prüfen Sie die Transaktion in Helcim, bevor Sie die Bestellung ausführen; eine Notiz erklärt den Grund. Standard: Ausstehend. Sie können eigene Status unter System > Localisation > Order Statuses anlegen, um autorisierte und zu prüfende Bestellungen zu unterscheiden.

Canceled Status: eine nicht erfasste Vorautorisierung wurde im Bestellreiter aufgehoben (der Kunde wurde nicht belastet). Standard: Storniert.

Refunded Status: wird gesetzt, nachdem die Zahlung im Bestellreiter vollständig erstattet wurde. Standard: Erstattet.

Erweitert

Debug log: schreibt API-Anfragen und -Antworten in wc_hlg_debug.log.php im Logs-Ordner von OpenCart (storage/logs). Die Datei lässt sich nicht über den Browser öffnen. Kartennummern werden auf die letzten 4 Ziffern gekürzt. CVC, Ablaufdatum, Token, Namen, Adressen, E-Mail-Adressen und IP-Adressen werden nie protokolliert. Fehler (abgelehnte oder fehlgeschlagene Zahlungen, API-Fehler, fehlgeschlagene Erfassungen und Erstattungen) werden immer protokolliert, auch wenn diese Option aus ist. 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 an, entfernt das Deinstallieren der Erweiterung die Einstellungen des Gateways und seine Protokolldateien. Helcim-Transaktionen und -Erstattungen bleiben immer erhalten, sodass zuvor bezahlte Bestellungen nach einer Neuinstallation noch erfasst und erstattet werden können. Standard: aus.

Import / Export

Export: Download JSON speichert die Einstellungen als JSON-Datei. API-Token werden nicht exportiert.

Import: fügen Sie zuvor exportiertes JSON ein und klicken Sie auf Import, um die Einstellungen wiederherzustellen. Gespeicherte API-Token bleiben erhalten.

Kasse

Im Schritt Payment Method wählt der Kunde die Zahlungsart (standardmäßig Credit card (Helcim)). Im Schritt Confirm Order sieht der Kunde ein Kartensymbol, Ihre Beschreibung und das Formular mit Card Number, Expiry (MM/YY), CVC und Cardholder Name. Im Testmodus zeigt das Formular TEST MODE — payments go to a Helcim test account, no real charges are made. OpenCart legt die Bestellung in diesem Schritt an, weiterhin ohne Status. Wenn der Kunde auf Confirm Order klickt, prüft die Erweiterung die Prüfziffer der Kartennummer, ob das Ablaufdatum gültig und nicht abgelaufen ist, ob der CVC 3 oder 4 Ziffern hat und ob der Name ausgefüllt ist. Fehler werden über dem Formular angezeigt, und es wird nichts an Helcim gesendet.

Auf OpenCart 4 wählt der Kunde die Zahlungsart mit der Schaltfläche Choose im Block der Zahlungsart, im Fenster Payment method options. Das Kartenformular erscheint dann im Bestätigungsblock der Bestellung unten auf der Kassenseite, oberhalb der Schaltfläche Confirm Order. Standardmäßig fragt OpenCart 4 nicht nach einer Zahlungsadresse; die Erweiterung sendet dann die Lieferadresse zusammen mit dem Namen des Karteninhabers zur Adressprüfung an Helcim.

Ihr Server sendet die Karte dann als Kauf oder Vorautorisierung über den Bestellbetrag in der Bestellwährung an Helcim. Name des Karteninhabers, Zahlungsadresse, Telefonnummer und E-Mail-Adresse werden zur Adressprüfung übermittelt. Die Zahlung erscheint in Helcim mit einer Rechnungsnummer aus der Bestellnummer, -OC und einem kurzen Code. Helcim antwortet in derselben Anfrage. Die Bestellung erhält ihren Status erst, nachdem Helcim die Transaktion genehmigt hat, auf die übliche Art von OpenCart, mit den üblichen Bestell-E-Mails und der Bestandsaktualisierung. Der Warenkorb wird sofort geleert, und der Kunde landet auf der Erfolgsseite der OpenCart-Bestellung.

Pro Warenkorb läuft jeweils nur ein Zahlungsversuch, und ein bereits bezahlter Warenkorb wird nie erneut belastet, auch wenn OpenCart inzwischen eine neue Bestellung dafür angelegt hat (OpenCart 3 legt jedes Mal eine neue Bestellung an, wenn der Schritt Confirm Order angezeigt wird; bei OpenCart 4 können eine frühere Bestellung oder ein zweiter Browser-Tab noch denselben Warenkorb halten). OpenCart 4 führt eine Bestellung für die Kasse und aktualisiert sie, daher bezahlt der Kunde nach einer abgelehnten Karte dieselbe Bestellung. Wurde diese Bestellung inzwischen geschlossen (zum Beispiel haben Sie sie storniert) oder ist sie bereits bezahlt und der Warenkorb enthält jetzt einen neuen Kauf, führt Confirm Order den Kunden mit dem Hinweis Your previous order is already closed (cancelled or refunded by the store) or paid for another cart. Please confirm the order again: the cart will be paid with a new order. darüber zurück zur Kasse; das nächste Confirm Order bezahlt eine neue Bestellung des Warenkorbs. Eine Änderung des Warenkorbs, auch eine neue Menge, gilt als neuer Warenkorb, der eine eigene Zahlung braucht. Jeder Versuch verwendet einen Idempotenz-Schlüssel. Antwortet Helcim nicht, bleibt die Bestellung ohne Status, und ein erneuter Versuch innerhalb von 5 Minuten liefert das ursprüngliche Ergebnis von Helcim zurück, statt die Karte zweimal zu belasten. Wurde die Zahlung genehmigt, der Bestellstatus konnte aber nicht gesetzt werden, setzt der nächste Versuch mit demselben Warenkorb den Status, ohne die Karte erneut zu belasten.

Meldungen, die der Kunde oberhalb des Formulars sehen kann: Your card was declined. Please check the card details or use another card., wenn Helcim ablehnt; Payment failed: mit dem Grund von Helcim bei anderen abgelehnten Anfragen; We could not confirm your payment with the card processor. Please try again in a minute; if the problem persists, contact us before using another card., wenn Helcim nicht antwortet; This payment method is temporarily unavailable. Please choose another payment method., wenn das API-Token abgelehnt wird; Your payment is already being processed. Please wait a moment and check your e-mail before trying again. bei einer doppelten Übermittlung; Your payment was received, but the order could not be completed automatically. Please contact us — do not pay again., wenn die Zahlung genehmigt wurde, der Bestellstatus aber nicht gesetzt werden konnte. Der Kunde bleibt im Schritt Confirm Order mit demselben Warenkorb. Technische Details werden im Protokoll festgehalten.

Die Erweiterung verwendet weder HelcimPay.js noch Helcim.js, daher laufen Kartendaten über Ihren Server. Es gibt keine gespeicherten Karten, Abonnements, ACH- oder Banküberweisungen, Apple Pay, Google Pay oder 3-D Secure und keine Helcim-Webhooks.

Bestellungen und Erstattungen

Bestellstatus

Kein Status (fehlende Bestellung): die Karte wurde abgelehnt, Helcim hat nicht geantwortet oder der Kunde hat noch nicht bezahlt. Ablehnungen und Fehler werden im Protokoll festgehalten und als Notizen hinzugefügt. Unter Sales > Orders werden solche Bestellungen nur mit dem Filter Order Status auf Missing Orders angezeigt.

Order Status After Payment (Standard Processing): ein Kauf wurde genehmigt oder eine Vorautorisierung wurde erfasst. Eine Notiz zeigt die Transaktions-ID, den Genehmigungscode, den Kartentyp, die letzten 4 Ziffern und den Modus.

Authorized Status (Standard Pending): eine Vorautorisierung wurde genehmigt. Der Betrag ist nur reserviert. Erfassen oder freigeben Sie ihn durch eine vollständige Erstattung.

On Hold (Review) Status (Standard Pending): Helcim hat eine Transaktion genehmigt, aber Betrag, Währung oder Transaktions-ID in der Antwort stimmen nicht mit der Bestellung überein, etwa nach einer Teilgenehmigung oder wenn sich der Bestellbetrag während der Zahlung geändert hat. Die Notiz lautet Helcim response verification FAILED. Prüfen Sie die Transaktion in Helcim, bevor Sie die Bestellung ausführen.

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

Canceled Status (Standard Canceled): eine nicht erfasste Vorautorisierung wurde aufgehoben. Der Kunde wurde nicht belastet.

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

Reiter VibeFox Helcim Gateway

Öffnen Sie unter Sales > Orders eine mit Helcim bezahlte Bestellung. Am unteren Ende der Bestellseite, neben History und Additional, zeigt der Reiter VibeFox Helcim Gateway die Transaction ID (und nach einer Erfassung die ID der Vorautorisierung) mit einer Kennzeichnung Test mode bei Testzahlungen, den Transaction type und den Erfassungsstatus, die Invoice, die Card und den Genehmigungscode, die Beträge Approved / order / refunded, die Erfassungsschaltfläche und das Erstattungsformular, den Erstattungsverlauf und die Helcim notes der Bestellung. Der Reiter wird Benutzern angezeigt, die Zugriff auf die Erweiterung haben; Erfassungen und Erstattungen erfordern das Recht zum Ändern (festgelegt unter System > Users > User Groups).

Erfassung

Bei einer nicht erfassten Vorautorisierung klicken Sie im Reiter auf Capture payment (die Schaltfläche zeigt den Betrag) und bestätigen Sie Capture the pre-authorized amount through Helcim? Erfasst wird der aktuelle Bestellbetrag abzüglich der Erstattungen. Er kann niedriger sein als der autorisierte Betrag, aber nicht höher. Die Erfassung verwendet das Token des Modus, in dem die Bestellung bezahlt wurde. Nach einer erfolgreichen Erfassung erhält die Bestellung Order Status After Payment. Schlägt die Erfassung fehl, zeigt der Reiter den Grund an und fügt ihn den Notizen hinzu.

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 Helcim. Bestätigen Sie Refund this amount through Helcim? This cannot be undone. Vollständige und teilweise Erstattungen eines Kaufs oder einer erfassten Vorautorisierung werden unterstützt, bis zum Betrag, den Helcim tatsächlich belastet hat. Nach einer Teilgenehmigung können Sie daher nicht mehr erstatten, als der Kunde bezahlt hat. Bei einer nicht erfassten Vorautorisierung lautet die Schaltfläche Release pre-authorization: Freigegeben werden kann nur der volle Betrag, die Reservierung wird entfernt und die Bestellung erhält Canceled Status.

Die Erstattung wird im Modus gesendet, in dem die Bestellung bezahlt wurde, daher muss das Token dieses Modus gesetzt sein. Sie zählt nur, wenn Helcim sie genehmigt. Lehnt Helcim sie ab, zeigt der Reiter den Fehler an, und es wird keine Erstattung erfasst. Eine erfolgreiche Erstattung wird dem Erstattungsverlauf und den Notizen mit der Transaktions-ID der Helcim-Erstattung 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, wie bei einer manuellen Statusänderung. Eine Teilerstattung ändert den Status nicht. Ein erneuter Versuch nach einem Timeout erstattet nicht doppelt.

Produktrücksendungen unter Sales > Returns zahlen über Helcim kein Geld zurück. Die Erweiterung empfängt keine Helcim-Webhooks: Erfassungen, Erstattungen und Stornierungen, die im Helcim-Dashboard vorgenommen werden, erscheinen nicht in OpenCart, nehmen Sie sie daher auf der Bestellseite vor.

Lizenzschlüssel

Die Erweiterung arbeitet mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock License — VibeFox Helcim Gateway ist der erste Block unter Extensions > Extensions > Payments > VibeFox Helcim Gateway > Edit, oberhalb der 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 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-helcim und der Link Manage licenses and domains in your account, der Ihr Konto auf vibefox.net öffnet. Nur Admin-Benutzer mit der Berechtigung Modify für die Erweiterung können den Schlüssel ändern. Die Texte des Blocks folgen der Sprache des Admin-Bereichs (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 die Erweiterung mit dem zuletzt bekannten Status weiter.

Ein Schlüssel funktioniert auf einer Domain: der Shop-Adresse aus der OpenCart-Konfiguration. Das Entfernen des Schlüssels aus dem Shop gibt den Domain-Platz nicht frei. Geben Sie den Platz in Ihrem vibefox.net-Konto frei.

Ohne aktiven Schlüssel wird Helcim Kunden auf 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 selben Browser im Admin-Bereich angemeldet ist, sieht die Zahlungsart im Shop weiterhin, gekennzeichnet 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 erkennt die Anmeldung im Admin-Bereich nicht, daher ist ohne aktiven Schlüssel die Zahlungsart für alle ausgeblendet. 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 bleiben unberührt: Bereits erfolgte Zahlungen bleiben erhalten, und Erfassungen und Erstattungen funktionieren weiter.

Läuft eine Lizenz ab, arbeitet die Erweiterung weiter, Updates und Support erfordern aber eine Verlängerung. Der Status wird beim Öffnen des Dashboard oder der Seite Edit im Admin-Bereich 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. Das Deinstallieren der Erweiterung entfernt immer den Lizenzschlüssel und den Lizenzstatus.

Fehlerbehebung

Helcim erscheint nicht auf der Kasse: Prüfen Sie, ob die Lizenz aktiv ist, Enable / Disable eingeschaltet ist, der aktuelle Modus sein API-Token hat (Live API token oder im Testmodus Test API token) und die Währung der Kasse eine der Account currencies ist. Die Einstellungsseite zeigt eine Warnung, wenn das Token fehlt oder die Shop-Währung nicht erlaubt 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.

Der Kunde sah We could not confirm your payment: Helcim hat nicht geantwortet, daher wurde die Karte eventuell belastet. Die Bestellnotiz und das Protokoll nennen die Helcim-Rechnung. Prüfen Sie diese Rechnung in Helcim, bevor Sie den Kunden erneut belasten. Ein erneuter Versuch innerhalb von 5 Minuten liefert das ursprüngliche Ergebnis zurück und belastet nicht doppelt.

Kunden sehen This payment method is temporarily unavailable: Helcim hat das API-Token abgelehnt. Die Bestellnotiz fordert dazu auf, das Token und seine Berechtigungen zu prüfen. Stellen Sie sicher, dass der API-Zugang die Berechtigung zur Transaktionsverarbeitung hat.

Kunden sehen This payment method is not available. Please reload the checkout page.: Die Kassensitzung passt nicht mehr zur Bestellung, die Zahlungsart wurde inzwischen deaktiviert, oder das Token bzw. die Währung passt nicht mehr. Der Kunde lädt die Kasse neu.

Zahlung fehlgeschlagen mit einem Helcim-Grund: Helcim hat die Anfrage abgelehnt, etwa wegen der Karte oder der Rechnungsdaten. Die Bestellnotiz und das Protokoll enthalten die Details.

Der Kunde sah Your payment was received, but the order could not be completed: Helcim hat die Zahlung genehmigt, OpenCart konnte den Bestellstatus aber nicht setzen. Das Protokoll nennt den Grund. Sendet der Kunde denselben Warenkorb erneut, wird der Status aus der genehmigten Zahlung gesetzt, ohne zweite Belastung.

Bestellung im Prüfstatus: Lesen Sie die Notizen im Reiter VibeFox Helcim Gateway. Die Antwort von Helcim passte nicht zur Bestellung (Prüfung der Antwort fehlgeschlagen). Prüfen Sie die Transaktion in Helcim und führen Sie dann die Bestellung aus oder erstatten Sie die Zahlung.

Erfassung nicht möglich: Der zu erfassende Betrag muss größer als 0 und darf nicht höher als der autorisierte Betrag sein, und das Token des Modus, in dem die Bestellung bezahlt wurde, muss gesetzt sein.

Erstattung schlägt fehl: Lesen Sie die Meldung. Eine nicht erfasste Vorautorisierung kann nur vollständig freigegeben werden. Eine Meldung zum Modus bedeutet, dass das Token des Modus, in dem die Bestellung bezahlt wurde, leer ist. Eine abgelehnte Erstattung wird nicht erfasst. You do not have permission to capture or refund (modify this extension). bedeutet, dass Ihre Benutzergruppe nicht das Recht hat, die Erweiterung zu ändern.

Testzahlungen: Der Testmodus sendet Zahlungen, Erfassungen und Erstattungen an Ihr Helcim-Testkonto. Bestellungen behalten den Modus, in dem sie bezahlt wurden, daher verschiebt ein späterer Moduswechsel ihre Erfassungen und Erstattungen nicht auf das andere Konto.

Deinstallation

Gehen Sie zu Extensions > Extensions, wählen Sie den Typ Payments und klicken Sie neben VibeFox Helcim 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 aus dem Bereich Orders, die bei einer Neuinstallation auf ihre Standardwerte zurückgesetzt werden. Bei OpenCart 4 wird außerdem das OpenCart-Ereignis der Erweiterung entfernt, das die Meldung oberhalb der Kassenseite anzeigt. Ist Delete data on uninstall aktiviert, werden die übrigen Gateway-Einstellungen (Titel, Beschreibung, API-Token, Testmodus, Transaktionstyp, Kontowährungen, Schalter für das Debug-Protokoll) und das Protokoll entfernt. Ist die Option aus, bleiben sie für eine spätere Neuinstallation erhalten. Helcim-Transaktionen und -Erstattungen bleiben immer erhalten, sodass zuvor bezahlte Bestellungen nach einer Neuinstallation noch erfasst und erstattet werden können. Bestehende Bestellungen behalten ihre Zahlungsnotizen.

Um auch die Dateien der Erweiterung zu entfernen, gehen Sie bei OpenCart 4 nach der Deinstallation zu Extensions > Installer, klicken Sie neben VibeFox Helcim Gateway in der Liste der installierten Erweiterungen auf Uninstall (die orangefarbene −-Schaltfläche) und dann auf Delete (die rote Papierkorb-Schaltfläche), um das hochgeladene Paket zu entfernen.

Helcim ist eine Marke ihres jeweiligen Inhabers. Diese Erweiterung ist weder mit Helcim verbunden noch von Helcim unterstützt oder empfohlen.