VibeFox Flow for OpenCart — Hilfe

Anforderungen

OpenCart: 3.0.x (getestet mit 3.0.5.0) oder 4.0.2 oder neuer (getestet mit 4.1.0.3).

PHP: 8.0 oder neuer.

Währung: chilenischer Peso (CLP) oder US-Dollar (USD). Bei anderen Kassenwährungen wird die Zahlungsmethode an der Kasse ausgeblendet. Stellen Sie für CLP die Dezimalstellen der Währung CLP unter System > Localisation > Currencies auf 0, weil Flow ganze Pesos berechnet.

Flow-Konto: Sie benötigen den API Key und den Secret Key Ihres Flow-Kontos, in Flow unter Mis datos, Datos técnicos. Für Tests erstellen Sie ein separates Sandbox-Konto auf sandbox.flow.cl und verwenden dessen Schlüssel. Sandbox- und Live-Schlüssel sind verschieden. Im Flow-Konto muss nichts konfiguriert werden.

Öffentliche Website: Die Bestätigungs-, Rückkehr- und Erstattungs-URLs Ihres Shops müssen aus dem Internet erreichbar sein, ohne Passwortschutz oder Firewall, die Flow blockiert. Der Wartungsmodus des Shops blockiert sie nicht.

VibeFox-Lizenzschlüssel: Er wird auf vibefox.net gekauft. Ein Schlüssel funktioniert für eine 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_flow_gateway-oc3-(version).ocmod.zip und das OpenCart-4-Paket wcp_flow_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 zu Extensions > Installer, klicken Sie auf Upload und wählen Sie die Datei wcp_flow_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 Flow 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 Lizenzschlüssel).

4. Geben Sie den Sandbox-API Key und den Sandbox-Secret Key ein, aktivieren Sie Enable / Disable, klicken Sie auf Save und legen Sie eine Testbestellung an.

5. Um echte Zahlungen anzunehmen, tragen Sie die Live-Schlüssel ein, deaktivieren Sie Sandbox mode und klicken Sie auf Save.

OpenCart 4

1. Gehen Sie im Admin zu Extensions > Installer, klicken Sie auf Upload und wählen Sie die Datei wcp_flow_gateway.ocmod.zip. Benennen Sie die Datei nicht um: OpenCart 4 entnimmt den Erweiterungscode 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 Flow Gateway, klicken Sie auf Install (die grüne +-Schaltfläche) und danach auf Edit (die Stift-Schaltfläche).

4. Geben Sie den Lizenzschlüssel und die Flow-Schlüssel ein, wie in den Schritten 3 bis 5 für OpenCart 3. Die Einstellungsseite und ihre Felder sind in beiden Versionen gleich. Nur die Flow URLs sind anders (siehe Flow URLs); sie werden bei jeder Zahlung übermittelt, daher muss im Flow-Konto nichts geändert werden.

Eine Neuinstallation startet mit deaktivierter Zahlungsmethode und aktiviertem Sandbox-Modus.

Konfiguration

Alle Einstellungen befinden sich auf der Erweiterungsseite: Extensions > Extensions > Payments > VibeFox Flow 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 Schlüssel des aktuellen Modus leer sind (Flow wird dann an der Kasse ausgeblendet), wenn die Standardwährung des Shops weder CLP noch USD ist und wenn die Währung CLP Dezimalstellen hat (stellen Sie sie auf 0, damit Preise, Summen und Erstattungen genau übereinstimmen). Im Sandbox-Modus zeigt sie Sandbox mode — payments go to sandbox.flow.cl, no real money is charged. Ohne das Recht, die Erweiterung zu ändern, zeigt die Seite die Einstellungen an, kann sie aber nicht speichern.

Beim Speichern muss Title 1 bis 128 Zeichen haben, Sort Order muss leer oder eine ganze Zahl sein, Total muss leer oder eine Zahl von 0 oder mehr sein, und die gewählte Geozone und die Bestellstatus müssen vorhanden sein. Andernfalls wird nichts gespeichert, und die Seite zeigt, was zu korrigieren ist.

Flow.cl

Enable / Disable: Enable Flow.cl payments schaltet die Zahlungsmethode ein oder aus. Standard: aus.

Title: der Name der Zahlungsmethode, den der Kunde an der Kasse sieht. Er wird auch als Name der Zahlungsmethode in der Bestellung gespeichert. Standard: Flow. Pflichtfeld, bis zu 128 Zeichen.

Description: die Beschreibung der Zahlungsmethode, die im Schritt Confirm Order über der Bestätigungsschaltfläche angezeigt wird. Standard: Pay with Webpay, credit or debit card, bank transfer and other methods. You will be redirected to Flow to complete the payment.

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

Geo Zone: bietet Flow nur für Zahlungsadressen in der gewählten Geozone an. Standard: All zones. Geozonen richten Sie unter System > Localisation > Geo Zones ein.

Total: die Kassensumme in der Standardwährung des Shops, die eine Bestellung erreichen muss, bevor Flow angeboten wird. Lassen Sie das Feld leer, um Flow bei jeder Summe anzubieten.

Flow-API-Zugangsdaten

Kopieren Sie den API Key und den Secret Key aus Ihrem Flow-Konto (Mis datos, Datos técnicos): Live-Schlüssel auf www.flow.cl, Sandbox-Schlüssel auf sandbox.flow.cl (ein separates Sandbox-Konto). Der Sandbox-Modus verwendet nur die Sandbox-Schlüssel, der Live-Modus nur die Live-Schlüssel.

Sandbox mode: verwendet die Flow-Sandbox (sandbox.flow.cl) und die Sandbox-Schlüssel. Im Sandbox-Modus wird kein echtes Geld belastet. Standard: an. Schalten Sie ihn aus und tragen Sie die Live-Schlüssel ein, um echte Zahlungen anzunehmen. Erstattungen verwenden immer die Umgebung, in der die Bestellung bezahlt wurde. Solange er aktiv ist, sehen Kunden im Schritt Confirm Order den Hinweis SANDBOX MODE — Payments go to the Flow sandbox. No real charges.

Sandbox API Key: der API Key Ihres Kontos auf sandbox.flow.cl.

Sandbox Secret Key: der Secret Key Ihres Kontos auf sandbox.flow.cl. Er wird verwendet, um jede Anfrage zu signieren.

Live API Key: der API Key Ihres Kontos auf www.flow.cl.

Live Secret Key: der Secret Key Ihres Kontos auf www.flow.cl. Halten Sie ihn geheim.

Gespeicherte Schlüssel 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 Schlüssel zu entfernen, setzen Sie unter dem Feld den Haken bei Clear the saved key on save und klicken Sie auf Save.

Benachrichtigungen

Die Erweiterung sendet bei jeder Zahlung und jeder Erstattung drei URLs an Flow, daher muss im Flow-Konto nichts konfiguriert werden. Das Feld Flow URLs in diesem Abschnitt listet sie zur Information auf. Sie werden aus der Shop-Adresse Ihrer OpenCart-Installation gebildet und sehen so aus:

Bei OpenCart 4 folgt der Methodenname einem Punkt: https://your-store/index.php?route=extension/wcp_flow_gateway/payment/wcp_flow_gateway.confirmation, ….back und ….refundCallback.

Die Bestätigung enthält nur einen Zahlungstoken. Die Erweiterung sucht den Token unter den von ihr erstellten Zahlungen, fragt Flow mit einer signierten Anfrage in der Umgebung, in der die Zahlung erstellt wurde, nach dem Zahlungsstatus und übernimmt nur die Antwort von Flow. Eine Zahlung, die dieser Shop nicht erstellt hat, wird ohne Rückfrage bei Flow abgelehnt. Ohne die Bestätigung erhält die Bestellung ihren Status, wenn der Kunde von Flow zurückkehrt.

Bestellungen

OpenCart legt die Bestellung im Schritt Confirm Order ohne Status an (eine fehlende Bestellung, „missing order“). Sie erhält erst einen Status, nachdem Flow die Zahlung gemeldet hat, durch die Bestätigung oder die Rückkehr des Kunden. Der Status wird immer mit einer signierten Anfrage bei Flow abgefragt. Jedes der folgenden Felder listet Ihre Bestellstatus aus OpenCart auf.

Order Status After Payment: der Status, der nach einer geprüften Flow-Zahlung gesetzt wird. Standard: Verarbeitung.

Awaiting Flow Payment Status: der Kunde hat einen Barzahlungsgutschein erzeugt (Servipag, Multicaja und ähnliche). Das Geld kommt später an, und Flow bestätigt es. Standard: Ausstehend.

Flow Payment On Hold Status: bezahlt, aber der Betrag oder die Währung weicht von der Bestellung ab, oder das Geld ist für eine stornierte Bestellung eingegangen. Eine Notiz erklärt den Grund; prüfen Sie die Zahlung manuell. Standard: Ausstehend, weil OpenCart keinen Status „On hold“ hat. Sie können unter System > Localisation > Order Statuses einen eigenen Status anlegen und hier auswählen.

Payment Rejected Status: eine Bestellung, die auf eine Gutschein-Zahlung wartet, deren Flow-Zahlung abgelehnt wurde. Standard: Fehlgeschlagen.

Payment Annulled Status: eine Bestellung, die auf eine Gutschein-Zahlung wartet, deren Flow-Zahlung storniert (annulliert) wurde. Standard: Storniert.

Refunded Status: wird gesetzt, nachdem die Zahlung auf der Bestellseite vollständig erstattet wurde. Standard: Erstattet.

Erweitert

Debug log: schreibt API-Aufrufe und Benachrichtigungen in flw_p_debug.log.php im Logordner von OpenCart (storage/logs). Die Datei lässt sich nicht über das Web öffnen; bei 5 MB wird sie nach flw_p_debug.old.log.php verschoben. Schlüssel, Signaturen und Kundendaten werden nie protokolliert. Fehler werden immer protokolliert, auch wenn die Option ausgeschaltet 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: ist diese Option eingeschaltet, entfernt die Deinstallation der Erweiterung ihre Einstellungen und das Protokoll. Bei Bestellungen gespeicherte Flow-Daten bleiben erhalten. Standard: aus.

Import / Export

Export: Download JSON speichert die Einstellungen als JSON-Datei. API Keys und Secret Keys werden nicht exportiert.

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

Kasse

Im Schritt Payment Method wählt der Kunde die Zahlungsmethode (standardmäßig Flow). Im Schritt Confirm Order sieht der Kunde Ihre Beschreibung und den Hinweis You will be redirected to Flow to complete the payment. OpenCart legt die Bestellung in diesem Schritt an, noch ohne Status. Bei OpenCart 4 wählt der Kunde die Zahlungsmethode über die Schaltfläche Choose im Zahlungsmethodenblock im Fenster Payment method options und klickt unten auf der Kassenseite auf Confirm Order. Wenn der Kunde auf Confirm Order klickt, erstellt die Erweiterung eine Flow-Zahlung über die Bestellsumme in der Bestellwährung mit dem Betreff Order #, gefolgt von der Bestellnummer und dem Namen des Shops, und leitet den Kunden zur Zahlungsseite von Flow weiter. Die E-Mail-Adresse des Kunden wird an Flow übergeben. Dort wählt der Kunde eine Zahlungsmethode, die in Ihrem Flow-Konto aktiviert ist. Die Bestellung erhält die Notiz Flow payment started mit dem Betrag, der Flow-Bestellnummer und der Umgebung.

Nach der Zahlung kehrt der Kunde in Ihren Shop zurück. Die Bestellung wird erst als bezahlt markiert, wenn Flow sie bestätigt: durch die Bestätigung oder durch eine signierte Statusanfrage, wenn der Kunde zurückkehrt. 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. Hat der Kunde einen Servipag- oder Multicaja-Gutschein erzeugt, erhält die Bestellung Awaiting Flow Payment Status, und die Seite zeigt außerdem Your Flow payment coupon was generated. The order will be processed as soon as Flow confirms the payment. Stimmte der Betrag nicht überein, zeigt die Seite Your Flow payment was received and is being reviewed by the store.

Wenn Flow bei der Rückkehr des Kunden nicht erreichbar ist oder gerade eine andere Anfrage die Bestellung bestätigt, zeigt eine Seite Payment confirmation den Text We could not confirm your Flow payment yet. If you completed it, you will receive a confirmation e-mail shortly — please do not pay again. mit einer Schaltfläche Check again und einer Schaltfläche Back to checkout.

Wurde die Zahlung abgelehnt, kehrt der Kunde mit Your Flow payment was rejected. Please try again or choose another payment method. zur Kasse zurück. Die Bestellung bleibt ohne Status. Hat der Kunde die Flow-Seite ohne Zahlung verlassen, lautet die Meldung The Flow payment was not completed. You can try again or choose another payment method. Konnte die Rückkehr keiner Zahlung zugeordnet werden, lautet die Meldung We could not confirm your Flow payment yet. If you completed it, you will receive a confirmation e-mail shortly; otherwise please try again. Der Warenkorb bleibt erhalten. Bei OpenCart 4 werden diese Meldungen über der Kassenseite angezeigt.

Ein Kunde kann es erneut versuchen. OpenCart 3 legt jedes Mal, wenn der Schritt Confirm Order angezeigt wird, eine neue Bestellung an; OpenCart 4 aktualisiert die Bestellung an der Kasse, sodass ein neuer Versuch dieselbe Bestellung mit einer neuen Flow-Zahlung bezahlt. Flow kann eine bereits gestartete Zahlung nicht abbrechen. Deshalb werden vor einer neuen Zahlung die offenen Flow-Zahlungen dieser Bestellung und anderer Bestellungen desselben Warenkorbs der letzten zwei Tage bei Flow geprüft. Ist eine davon bezahlt oder hat einen Gutschein, gelangt der Kunde zur Erfolgsseite, statt erneut zu zahlen. Wurde derselbe Warenkorb bereits über eine andere Bestellung mit Flow bezahlt, wird ebenfalls keine neue Zahlung gestartet. Wird derselbe Warenkorb doppelt bezahlt, etwa in zwei Browser-Tabs, erhält nur die erste Zahlung ihre Bestellung als Status: die andere Bestellung bleibt ohne Status, und die bezahlte Bestellung erhält eine Notiz, dass Sie die zweite Zahlung in Ihrem Flow-Konto erstatten sollten.

OpenCart 4 behält die Bestellung an der Kasse, bis die Erfolgsseite angezeigt wird. Wurde diese Bestellung inzwischen ohne Zahlung geschlossen (zum Beispiel haben Sie sie storniert), wird der Kunde mit The Flow payment was not completed. You can try again or choose another payment method. zurück an die Kasse geschickt, und das nächste Confirm Order bezahlt eine neue Bestellung des Warenkorbs. Ist diese Bestellung bereits bezahlt oder hat sie einen Gutschein, der Warenkorb wurde aber inzwischen geändert (auch die Menge), wird der Kunde zurück an die Kasse geschickt, und das nächste Confirm Order bezahlt den neuen Warenkorb mit einer neuen Bestellung. Eine bezahlte Bestellung wird nie als bezahlt für einen anderen Warenkorb angezeigt.

Kann Flow die Zahlung nicht starten, bleibt der Kunde im Schritt Confirm Order mit einer kurzen Meldung, zum Beispiel Could not connect to Flow. Please try again in a moment. Die Details stehen im Protokoll.

Die Erweiterung unterstützt nur einmalige Zahlungen. Sie hat keine gespeicherten Karten, Abonnements, wiederkehrenden Belastungen oder Zahlungslinks und wählt keine Flow-Zahlungsmethode vor. Bezahlt ein Kunde eine alte Flow-Zahlung, nachdem die Bestellung bereits bezahlt war, erhält die Bestellung eine Notiz, dass Sie das Duplikat in Flow erstatten sollten.

Bestellungen und Erstattungen

Bestellstatus

Ohne Status (missing order): der Kunde wurde zu Flow weitergeleitet und hat nicht bezahlt, die Zahlung wurde abgelehnt oder nicht abgeschlossen, oder Flow 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 (default Processing): Flow hat die Zahlung als bezahlt gemeldet, und Betrag und Währung stimmen überein. Eine Notiz zeigt den Betrag und die Flow-Bestellnummer.

Awaiting Flow Payment Status (default Pending): der Kunde hat einen Barzahlungsgutschein erzeugt. Eine Notiz nennt die Art des Gutscheins. Die Bestellung wechselt zu Order Status After Payment, wenn Flow die Zahlung bestätigt.

Flow Payment On Hold Status (default Pending): Flow hat einen anderen Betrag oder eine andere Währung als die Bestellsumme gemeldet, oder eine Zahlung ist für eine stornierte Bestellung eingegangen. Die Zahlung, die Flow eingezogen hat, wird erfasst, und die Notiz erklärt es. Prüfen Sie die Bestellung und versenden Sie sie oder erstatten Sie die Zahlung.

Payment Rejected Status (default Failed): Flow hat die Gutschein-Zahlung einer wartenden Bestellung abgelehnt.

Payment Annulled Status (default Canceled): die Gutschein-Zahlung einer wartenden Bestellung wurde in Flow annulliert.

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

Geht eine weitere Zahlung für eine bereits bezahlte Bestellung ein, bleibt die Bestellung unverändert. Eine Notiz bittet Sie, das Duplikat in Ihrem Flow-Konto zu erstatten. Eine erstattete Bestellung wird nie wieder geöffnet.

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

Registerkarte VibeFox Flow Gateway

Öffnen Sie unter Sales > Orders eine mit Flow bezahlte Bestellung. Am Ende der Bestellseite, neben History und Additional, zeigt die Registerkarte VibeFox Flow Gateway die Flow order-Nummer mit der Zahlungsmethode und einem Hinweis Sandbox bei Sandbox-Zahlungen, die Referenz commerceOrder (und die Anzahl der Versuche), den Status der Zahlung, die Beträge Paid / refunded, das Erstattungsformular, den Erstattungsverlauf und die Flow notes der Bestellung. Die Registerkarte wird Benutzern angezeigt, die Zugriff auf die Erweiterung haben.

Erstattungen

Geben Sie auf der Registerkarte den Amount ein (der noch nicht erstattete Betrag wird eingetragen), optional einen Reason (optional), und klicken Sie auf Refund via Flow. Bestätigen Sie die Frage Refund this amount via Flow? Flow e-mails the customer to complete the refund. Vollständige und teilweise Erstattungen werden unterstützt. Sie benötigen das Recht, die Erweiterung zu ändern (einzustellen unter System > Users > User Groups). Erstattungen sind auf den Betrag begrenzt, den Flow tatsächlich belastet hat. Nach einer Betragsabweichung können Sie also bis zu dem erstatten, was der Kunde bezahlt hat, nicht die Bestellsumme. CLP-Erstattungen müssen ganze Beträge sein. Die Erstattung wird an die Umgebung gesendet, in der die Zahlung erfolgte (Sandbox oder Live). Deren Schlüssel müssen daher gesetzt sein, und der Kunde braucht eine gültige E-Mail-Adresse. Lehnt Flow die Erstattung ab, zeigt die Registerkarte den Fehler, und es wird keine Erstattung erfasst. Eine erfolgreiche Anfrage wird dem Erstattungsverlauf und den Notizen mit der Flow-Erstattungsnummer und dem Status hinzugefügt. Eine vollständige Erstattung setzt die Bestellung auf den Refunded Status, ohne den Kunden zu benachrichtigen und ohne Produkte wieder in den Bestand zu übernehmen, wie bei einer manuellen Statusänderung. Eine teilweise Erstattung ändert den Status nicht. Erstattungen sind verfügbar, sobald Flow die Zahlung bestätigt hat.

Spätere Statusänderungen der Erstattung, die Flow meldet, werden den Notizen hinzugefügt. Lehnt Flow eine Erstattung später ab oder storniert sie, vermerkt die Notiz, dass das Geld nicht an den Kunden zurückgegeben wurde, und der Betrag kann erneut erstattet werden. Produktrückgaben unter Sales > Returns senden kein Geld über Flow zurück. Erstattungen, die im Flow-Dashboard angelegt wurden, werden nicht in OpenCart importiert.

Lizenzschlüssel

Die Erweiterung arbeitet mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock License — VibeFox Flow Gateway ist der erste Block auf Extensions > Extensions > Payments > VibeFox Flow 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 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, um den Status erneut zu prüfen, Change key, um einen anderen Schlüssel einzugeben, und Remove key, um den Schlüssel aus diesem Shop zu entfernen. Darunter stehen die Zeile Product: opencart-payment-flow und der Link Manage licenses and domains in your account, der Ihr Konto auf vibefox.net öffnet. Nur Admin-Benutzer mit dem Recht 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 Domain-Platz 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 Domain-Platz nicht frei. Geben Sie den Platz in Ihrem vibefox.net-Konto frei.

Ohne aktiven Schlüssel wird Flow 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 selben Browser im Admin angemeldet ist, sieht die Zahlungsmethode im Shop weiterhin, markiert mit (unlicensed — visible to admins only). So können Sie die Erweiterung einrichten und testen, bevor Sie einen Schlüssel kaufen. Bei OpenCart 4 ist diese Vorschau nicht verfügbar: Der Shop sieht die Admin-Anmeldung 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 Admin 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.

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

Fehlerbehebung

Flow erscheint nicht an der Kasse: prüfen Sie, ob die Lizenz aktiv ist, Enable / Disable eingeschaltet ist, die Schlüssel des aktuellen Modus ausgefüllt sind (Sandbox-Schlüssel im Sandbox-Modus, Live-Schlüssel im Live-Modus) und die Kassenwährung CLP oder USD 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: die Bestätigung von Flow erreicht Ihren Shop nicht, und der Kunde ist nicht zurückgekehrt. Prüfen Sie, ob die Bestätigungs-URL unter Flow URLs aus dem Internet erreichbar ist und nicht durch einen Passwortschutz oder eine Firewall blockiert wird. Aktivieren Sie Debug log und sehen Sie im Feld Log auf der Erweiterungsseite nach.

Die Bestätigung antwortet Payment does not belong to the order: der Token gehört zu keiner Zahlung, die dieser Shop erstellt hat, oder Flow hat dafür eine andere Referenz gemeldet. Es wird nichts geändert.

Die Bestätigung antwortet Gateway not configured: die Schlüssel des Zahlungsumfelds sind leer. Geben Sie sie erneut ein. Flow wiederholt die Bestätigung.

Die Bestätigung antwortet Flow API unavailable or Busy, retry: die Statusanfrage an Flow ist fehlgeschlagen, oder die Bestellung wurde im selben Moment von einer anderen Anfrage bestätigt. Flow wiederholt die Bestätigung.

Der Kunde sieht Flow payments are not available at the moment: Schlüssel fehlen, oder Flow hat sie abgelehnt. Prüfen Sie den API Key und den Secret Key des aktuellen Modus.

Der Kunde sieht This payment method is not available. Please reload the checkout page.: die Kassensitzung passt nicht mehr zur Bestellung, oder die Zahlungsmethode wurde inzwischen deaktiviert. Der Kunde lädt die Kasse neu.

Der Kunde sieht A valid billing email is required for Flow payments: Flow benötigt die E-Mail-Adresse des Kunden.

Der Kunde sieht The order total is too small to be paid with Flow: die Bestellsumme wird in der Bestellwährung auf null gerundet.

Der Kunde hat bezahlt, aber die Bestellung ist im Status „awaiting“ oder „on hold“: lesen Sie die Notizen auf der Registerkarte VibeFox Flow Gateway. Der Kunde hat einen Barzahlungsgutschein erzeugt, der noch nicht bezahlt ist, oder der Betrag bzw. die Währung, die Flow meldet, stimmt nicht mit der Bestellung überein. Summen in CLP mit Dezimalstellen werden auf ganze Pesos gerundet. Stellen Sie die Dezimalstellen von CLP daher auf 0.

Kein Erstattungsformular auf der Registerkarte: die Registerkarte nennt den Grund: Die Zahlung ist noch nicht bestätigt, sie ist vollständig erstattet, Ihre Benutzergruppe hat kein Recht, die Erweiterung zu ändern, oder die Schlüssel der Umgebung, in der die Zahlung erfolgte, sind leer.

Erstattung schlägt fehl mit einer Meldung zu Sandbox- oder Live-Schlüsseln: die Bestellung wurde in dieser Umgebung bezahlt, und deren Schlüssel sind leer. Geben Sie sie ein und versuchen Sie es erneut.

Erstattung schlägt fehl mit Flow accepts CLP refunds in whole units only: geben Sie einen ganzen Betrag ein.

Für Entwickler löst die Erweiterung die OpenCart-Ereignisse wc_flw_supported_currencies (Währungen, für die die Zahlungsmethode angeboten wird) und wc_flw_payment_subject (der an Flow gesendete Zahlungsbetreff) aus.

Deinstallation

Gehen Sie zu Extensions > Extensions, wählen Sie den Typ Payments und klicken Sie neben VibeFox Flow 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 im Abschnitt Orders, die bei einer Neuinstallation auf ihre Standardwerte zurückgesetzt werden. Auch das OpenCart-Ereignis der Erweiterung wird entfernt (bei OpenCart 4 auch dessen Ereignisse und die Startaktion, die die Flow URLs im Wartungsmodus durchlässt). Ist Delete data on uninstall eingeschaltet, werden die übrigen Einstellungen (Titel, Beschreibung, Sandbox-Modus, Schlüssel, Schalter des Debug-Logs) und das Protokoll entfernt. Ist die Option ausgeschaltet, bleiben sie für eine spätere Neuinstallation erhalten. Die Zahlungs- und Erstattungsdaten von Flow bleiben immer erhalten, sodass früher bezahlte Bestellungen auch nach einer Neuinstallation erstattet werden können. Bestehende Bestellungen behalten ihre Zahlungsnotizen.

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

Flow ist eine Marke ihres jeweiligen Inhabers. Diese Erweiterung ist weder mit Flow verbunden, noch wird sie von Flow unterstützt.