VibeFox Square for OpenCart — Hilfe

Voraussetzungen

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: Die Bestellwährung muss die Währung Ihres Square-Standorts sein: USD, CAD, AUD, JPY, GBP oder EUR. Bei anderen Währungen wird die Zahlungsart an der Kasse ausgeblendet. JPY wird in ganzen Yen belastet.

Square-Konto: Sie benötigen eine Anwendung im Square Developer Dashboard. Daraus kopieren Sie die Application ID und den Access Token (Seite Credentials) sowie die Location ID (Seite Locations). Sandbox und Production haben getrennte Werte. Ein Webhook ist nicht erforderlich: Die Erweiterung erhält das Zahlungsergebnis direkt aus der Antwort von Square.

VibeFox-Lizenzschlüssel: Erwerb auf 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 Paket für OpenCart 3 wcp_square_gateway-oc3-(version).ocmod.zip und das Paket für OpenCart 4 wcp_square_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_square_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 Square Gateway und klicken Sie auf Install (der grüne +-Button). Ihr Admin-Benutzer benötigt das Recht, die Liste der Zahlungserweiterungen zu ändern.

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

4. Lassen Sie Sandbox Mode eingeschaltet und tragen Sie die Sandbox-Application-ID, den Access Token und die Location ID ein (siehe Konfiguration). Klicken Sie auf Save: Die Erweiterung prüft die Zugangsdaten bei Square.

5. Schalten Sie Enable/Disable ein, speichern Sie und testen Sie eine Zahlung mit den Testkarten aus Squares Anleitung für Sandbox-Tests. Schalten Sie danach Sandbox Mode aus, tragen Sie die Zugangsdaten für den Live-Betrieb ein und speichern Sie erneut.

OpenCart 4

1. Gehen Sie im Admin zu Extensions > Installer, klicken Sie auf Upload und wählen Sie die Datei wcp_square_gateway.ocmod.zip. Benennen Sie die Datei nicht um: OpenCart 4 liest den Code der Erweiterung 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 (der grüne +-Button).

3. Gehen Sie zu Extensions > Extensions und wählen Sie den Typ Payments. Suchen Sie VibeFox Square Gateway, klicken Sie auf Install (der grüne +-Button) und danach auf Edit (der Stift-Button).

4. Tragen Sie den Lizenzschlüssel und die Square-Zugangsdaten wie in den Schritten 3 bis 5 für OpenCart 3 ein. Die Einstellungsseite und ihre Felder sind in beiden Versionen gleich.

Eine neue Installation startet mit deaktivierter Zahlungsart und eingeschaltetem Sandbox-Modus.

Konfiguration

Alle Einstellungen befinden sich auf der Erweiterungsseite: Extensions > Extensions > Payments > VibeFox Square Gateway > Edit. Die Abschnitte sind links aufgelistet; der Button Save unter der Liste speichert die gesamte Seite. Oberhalb der Einstellungen zeigt die Seite Square Gateway ist derzeit im SANDBOX-Modus. Es werden keine echten Belastungen vorgenommen., solange der Sandbox-Modus eingeschaltet ist. Sie warnt, wenn Square aktiviert ist, aber die Application ID, der Access Token oder die Location ID des gewählten Modus fehlt (die Zahlungsart wird dann an der Kasse ausgeblendet), wenn Square die Standardwährung Ihres Shops nicht verarbeiten kann und wenn die Währung Ihres Square-Standorts davon abweicht. Ohne das Recht, die Erweiterung zu ändern, zeigt die Seite die Einstellungen an, kann sie aber nicht speichern.

Beim Speichern darf Title nicht leer sein (bis zu 128 Zeichen), Sort Order muss eine ganze Zahl sein (negative Werte sind erlaubt), Total muss eine Zahl von 0 oder größer sein, und die Geozone sowie die Bestellstatus müssen existieren; andernfalls wird nichts gespeichert. Danach prüft die Erweiterung die Zugangsdaten des gewählten Modus bei Square. Die Einstellungen werden in jedem Fall gespeichert, und die Warnungen erscheinen in einem roten Block oberhalb der Einstellungen: Square hat den Access Token abgelehnt, die Location ID wurde für dieses Token nicht gefunden, die Zugangsdaten konnten nicht geprüft werden oder die Währung des Standorts unterscheidet sich von der Shop-Währung. Square kann nur in der Währung des Standorts abbuchen: Die Erweiterung merkt sich die Währung des geprüften Standorts und blendet die Zahlungsart für Bestellungen in einer anderen Währung aus. Sie warnt auch, wenn eine Sandbox-Application-ID im Live-Modus oder umgekehrt verwendet wird.

Square

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

Title: der Name der Zahlungsart, den Kunden an der Kasse sehen. Er wird auch als Zahlungsart in der Bestellung gespeichert. Standard: Credit / debit card. Pflichtfeld.

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

Sort Order: die Position der Kartenzahlung unter den Zahlungsarten an der Kasse. Lassen Sie das Feld leer oder geben Sie eine ganze Zahl ein (negative Werte sind erlaubt).

Geo Zone: Das Kartenformular wird nur für Zahlungsadressen in der gewählten Geozone angeboten. Standard: All zones. Geozonen richten Sie unter System > Localisation > Geo Zones ein.

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

Square-Konto

Öffnen Sie das Square Developer Dashboard (der Abschnitt enthält einen Link), wählen Sie Ihre Anwendung und kopieren Sie die Application ID und den Access token von der Seite Credentials (Sandbox und Production haben getrennte Werte) sowie die Location ID von der Seite Locations. Die Währung des Standorts muss mit der Währung Ihres Shops übereinstimmen. Die Seite zeigt nur die Zugangsdatenfelder des gewählten Modus: Sandbox-Felder, solange Sandbox Mode eingeschaltet ist, Live-Felder, wenn er ausgeschaltet ist. Beide Sätze bleiben gespeichert.

Sandbox Mode: Zahlungen gehen an die Square-Sandbox, und es wird kein echtes Geld abgebucht. Verwenden Sie Square-Testkarten. Standard: eingeschaltet. Erstattungen einer Bestellung verwenden immer die Umgebung und den Standort, mit denen die Bestellung bezahlt wurde.

Sandbox Application ID: Ihre Square-Application-ID der Sandbox (beginnt mit sandbox-sq0idb-).

Sandbox Access Token: Ihr Square-Access-Token der Sandbox.

Sandbox Location ID: Ihre Square-Location-ID der Sandbox.

Live Application ID: Ihre Square-Application-ID für den Live-Betrieb (beginnt mit sq0idp-).

Live Access Token: Ihr Square-Access-Token für den Live-Betrieb.

Live Location ID: Ihre Square-Location-ID für den Live-Betrieb.

Gespeicherte Access Tokens werden nie erneut angezeigt. Das Feld bleibt leer und zeigt Gespeichert — zum Beibehalten leer lassen. Geben Sie nur dann einen neuen Wert ein, wenn Sie ihn ändern möchten. Um einen gespeicherten Access Token zu entfernen, setzen Sie unter dem Feld den Haken bei Clear the saved value on save und klicken Sie auf Save.

Bestellungen

OpenCart legt die Bestellung im Schritt Confirm Order ohne Status an (eine unvollständige Bestellung). Die Bestellung erhält erst dann einen Status, wenn Square auf die Zahlung geantwortet hat. Jedes Feld unten listet Ihre OpenCart-Bestellstatus auf.

Order Status After Payment: Square hat die Zahlung für genau den Bestellbetrag und die Bestellwährung abgeschlossen. Standard: Processing.

On Hold (Review) Status: Die Zahlung muss von Ihnen geprüft werden (siehe Bestellstatus). Standard: Pending, da OpenCart keinen Status On hold hat. Sie können unter System > Localisation > Order Statuses einen eigenen Status anlegen und hier auswählen.

Refunded Status: wird gesetzt, nachdem die Zahlung über die Registerkarte der Bestellung vollständig erstattet wurde. Standard: Refunded.

Erweitert

Debug log: Fehler und Warnungen werden immer protokolliert. Schalten Sie es ein, um auch jede Anfrage und Antwort ohne Kartendaten und Schlüssel in wc_sqg_debug.log.php im Logs-Ordner von OpenCart (storage/logs) zu protokollieren. Die Datei lässt sich nicht über das Web öffnen; bei 5 MB wird sie nach wc_sqg_debug.old.log.php verschoben. Standard: aus.

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

Delete data on uninstall: Wenn eingeschaltet, entfernt die Deinstallation der Erweiterung die Gateway-Einstellungen und die Protokolldateien. Die Square-Zahlungen und -Erstattungen der Bestellungen bleiben immer erhalten. Standard: aus.

Import / Export

Exportieren: Download JSON speichert die Einstellungen als JSON-Datei. Access Tokens werden nicht exportiert.

Importieren: Fügen Sie zuvor exportiertes JSON ein und klicken Sie auf Import, um die Einstellungen wiederherzustellen. Gespeicherte Access Tokens 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 Credit / debit card (Square), Ihre Beschreibung, SANDBOX-MODUS — es werden keine echten Belastungen vorgenommen., solange der Sandbox-Modus eingeschaltet ist, und das Square-Kartenformular. OpenCart legt die Bestellung in diesem Schritt an, weiterhin ohne Status. Wenn der Kunde auf Confirm Order klickt, wird die Karte im Browser mit Käuferverifizierung (3-D Secure / SCA) tokenisiert: Der Bestellbetrag, die Währung und die Zahlungsadresse werden an Square übermittelt, und die Bank des Kunden kann eine Bestätigung verlangen. Ihr Shop erhält nur ein Einmal-Token. In OpenCart 4 wählt der Kunde die Zahlungsart mit dem Button Choose im Block der Zahlungsart, im Fenster Payment method options. Das Square-Kartenformular erscheint dann im Bestätigungsblock unten auf der Kassenseite, oberhalb von Confirm Order.

Die Erweiterung belastet anschließend das Token über die Square Payments API für den Bestellbetrag in der Bestellwährung, mit der Bestellnummer als Referenz, einem Hinweis Order # mit der Bestellnummer und dem Namen Ihres Shops sowie der E-Mail-Adresse des Kunden. Die Zahlung wird sofort erfasst. Die Bestellung wird erst als bezahlt markiert, nachdem Square sie bestätigt hat: Die Antwort von Square muss eine COMPLETED-Zahlung für genau den Bestellbetrag, die Währung, die Bestellnummer und den Standort zeigen. Die Bestellung erhält dann Order Status After Payment auf die übliche OpenCart-Weise mit den üblichen Bestell-E-Mails und der Bestandsaktualisierung, und der Kunde sieht die Erfolgsseite der OpenCart-Bestellung mit Ihre Kartenzahlung ist eingegangen. und einem Link View the receipt zum Square-Beleg. Ist die Zahlung nicht COMPLETED oder weicht ein Wert ab, erhält die Bestellung On Hold (Review) Status, und die Seite zeigt Ihre Kartenzahlung ist eingegangen und wird geprüft. Wir aktualisieren Ihre Bestellung, sobald die Prüfung abgeschlossen ist.

Pro Warenkorb läuft immer nur ein Zahlungsversuch gleichzeitig. Klickt der Kunde zweimal oder zahlt in zwei Tabs, sieht der zweite Versuch Diese Bestellung wird bereits bezahlt. Bitte warten Sie einen Moment und prüfen Sie Ihre E-Mails, bevor Sie es erneut versuchen. Anfragen sind idempotent, und OpenCart 3 legt jedes Mal eine neue Bestellung an, wenn der Schritt Confirm Order angezeigt wird. Daher verfolgt die Erweiterung den Warenkorb: Ein bereits bezahlter Warenkorb wird nie erneut belastet, und der Kunde gelangt direkt zur Erfolgsseite.

Antwortet Square nicht (Netzwerkproblem, Zeitüberschreitung, Serverfehler), wird die Anfrage einmal mit demselben Idempotenzschlüssel wiederholt. Gibt es weiterhin keine Antwort, sucht die Erweiterung sofort nach der Zahlung dieser Bestellung bei Square. Wird sie gefunden, erhält die Bestellung ihren Status daraus. Wird keine Zahlung gefunden, bleibt der Kunde im Schritt Confirm Order mit Vom Zahlungsanbieter konnte keine Bestätigung eingeholt werden. Bitte warten Sie eine Minute und versuchen Sie es erneut — wurde Ihre Karte bereits belastet, wird die Zahlung erkannt und Sie werden nicht doppelt belastet. Der nächste Versuch desselben Warenkorbs sucht zuerst erneut nach der früheren Zahlung. Kann Square auch für die Suche nicht erreicht werden, erhält die Bestellung On Hold (Review) Status ohne Zahlung, mit einer Notiz, dass die Karte möglicherweise belastet wurde, und die Erfolgsseite zeigt Wir konnten Ihre Kartenzahlung bei Square nicht bestätigen. Bitte prüfen Sie Ihre E-Mails und Ihren Kartenauszug, bevor Sie erneut zahlen, oder kontaktieren Sie uns.

Lehnt die Bank die Karte ab, bleibt die Bestellung ohne Status, und der Kunde bleibt im Schritt Confirm Order mit einer kurzen Meldung zum Fehlercode von Square, zum Beispiel Ihre Karte wurde abgelehnt. Bitte verwenden Sie eine andere Karte oder Zahlungsart., Der Kartensicherheitscode (CVV) ist falsch. Bitte prüfen Sie ihn und versuchen Sie es erneut. oder Ihre Bank verlangt eine zusätzliche Überprüfung (3-D Secure). Bitte geben Sie Ihre Karte erneut ein und schließen Sie die Überprüfung ab. Der Warenkorb bleibt erhalten, und der Kunde kann es mit einer anderen Karte erneut versuchen. Der technische Grund wird im Protokoll festgehalten.

OpenCart 4 hält für die Kasse eine einzige Bestellung und aktualisiert sie. Nach einer abgelehnten Karte zahlt der Kunde daher dieselbe Bestellung erneut, und nach einer Zahlung ohne Antwort von Square sucht der nächste Versuch dieser Bestellung zuerst nach der früheren Zahlung. Hat die Bestellung dieses Kassenvorgangs bereits einen Status (der Shop hat sie bezahlt oder geschlossen) und enthält der Warenkorb neue Produkte, wird der Kunde zur Kasse zurückgeschickt, und der neue Warenkorb wird mit einer neuen Bestellung bezahlt.

Die Erweiterung nimmt nur Kartenzahlungen an, die sofort erfasst werden. Sie hat keine gespeicherten Karten oder Kundenprofile, keine Abonnements, kein Apple Pay, Google Pay, Cash App Pay, Afterpay, ACH oder Square-Geschenkkarten, keine Zahlungen nur mit Autorisierung, keine Square-Webhooks und keine Synchronisierung von Produkten oder Bestand mit Square. Chargebacks werden im Square Dashboard verwaltet.

Bestellungen und Erstattungen

Bestellstatus

Ohne Status (unvollständige Bestellung): Der Kunde hat noch nicht bezahlt, die Karte wurde abgelehnt, oder Squares Antwort ging verloren und es wurde keine Zahlung gefunden. Unter Sales > Orders werden solche Bestellungen nur mit dem Filter Order Status auf Missing Orders angezeigt.

Order Status After Payment (Standard Processing): Square hat eine COMPLETED-Zahlung des Bestellbetrags bestätigt. Eine Notiz zeigt die Square-Zahlungs-ID, die Kartenmarke mit den letzten 4 Ziffern und den Modus (Sandbox oder Live).

On Hold (Review) Status (Standard Pending): Square hat mit einer Zahlung geantwortet, die nicht COMPLETED ist (zum Beispiel APPROVED oder PENDING), oder mit einem anderen Betrag, einer anderen Währung, Referenz oder einem anderen Standort. Die Notiz Square-Zahlung muss geprüft werden zeigt die Zahlungs-ID, den Status und die Beträge. Dieser Status wird auch verwendet, wenn sich die Bestellung während der Zahlung geändert hat und wenn Squares Antwort verloren ging und nicht geprüft werden konnte (dann ist keine Zahlung erfasst, und die Notiz bittet Sie, die Zahlungen des Standorts im Square Dashboard mit der Bestellnummer als Referenz zu prüfen). Prüfen Sie die Zahlung im Square Dashboard, bevor Sie die Bestellung versenden.

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

Wird eine zweite Zahlung für einen Warenkorb getätigt, der bereits eine bezahlte Bestellung hat, bleibt die bezahlte Bestellung unverändert. Eine Notiz bittet Sie, sie zu prüfen und das Duplikat im Square Dashboard zu erstatten.

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

Registerkarte VibeFox Square Gateway

Öffnen Sie unter Sales > Orders eine mit Square bezahlte Bestellung. Am unteren Rand der Bestellseite, neben History und Additional, zeigt die Registerkarte VibeFox Square Gateway die Square-Payment ID (mit Link zur Zahlung im Square Dashboard) mit einem Hinweis Sandbox bei Sandbox-Zahlungen, den Square-Status, die Card-Marke und die letzten 4 Ziffern, die Beträge Paid / order / refunded, die Environment / location, den Link zum Square receipt, das Erstattungsformular, den Erstattungsverlauf und die Square notes der Bestellung. Kartennummern werden nie gespeichert. Die Registerkarte wird Benutzern angezeigt, die Zugriff auf die Erweiterung haben.

Erstattungen

Geben Sie in der Registerkarte VibeFox Square Gateway den Amount ein (der noch nicht erstattete Betrag wird eingetragen), optional einen Reason (optional), und klicken Sie auf Refund via Square. Bestätigen Sie die Frage Diesen Betrag über Square erstatten? Dies kann nicht rückgängig gemacht werden. Vollständige und Teilerstattungen werden unterstützt. Sie benötigen das Recht, die Erweiterung zu ändern (einzustellen unter System > Users > User Groups). Erstattungen erfolgen in dem Betrag und der Währung, die Square belastet hat. Nach einer Betragsabweichung können Sie daher bis zu dem Betrag erstatten, den der Kunde tatsächlich bezahlt hat, nicht den Bestellbetrag. Die Erstattung wird an die Umgebung (Sandbox oder Live) und den Standort gesendet, an dem die Zahlung erfolgte, daher muss der Access Token dieses Modus gesetzt sein. Erstattungsanfragen sind idempotent und werden einmal wiederholt, falls Square nicht antwortet. Eine Erstattung, die Square annimmt (Status PENDING oder COMPLETED), wird mit der Square-Erstattungs-ID dem Erstattungsverlauf und den Notizen hinzugefügt. Lehnt Square sie ab, zeigt die Registerkarte den Fehler, und es wird keine Erstattung erfasst. 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.

Produktretouren unter Sales > Returns zahlen über Square kein Geld zurück. Square führt Erstattungen auf eigener Seite aus: Eine Erstattung, die Square später ablehnt, wird nicht zurückgemeldet, und im Square Dashboard vorgenommene Erstattungen erscheinen nicht in OpenCart.

Lizenzschlüssel

Die Erweiterung arbeitet mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock License — VibeFox Square Gateway ist der erste Block unter Extensions > Extensions > Payments > VibeFox Square 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 gültig ist, und Ihre Domain) sowie die Buttons Check now zur erneuten Prüfung des Status, 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-square und der Link Manage licenses and domains in your account, der Ihr vibefox.net-Konto ö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 Schlüssel nicht gefunden, Dieser Schlüssel gehört zu einem anderen Produkt, Domain-Limit erreicht oder Lizenz abgelaufen am mit einem Datum. Nachdem sich die Shop-Adresse geändert hat 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 Square Kunden an der Kasse nicht angezeigt. Wird trotzdem eine Zahlung gestartet, sieht der Kunde Diese Zahlungsart ist nicht verfügbar. Bitte wählen Sie eine andere. Ein Admin-Benutzer, der im Admin im selben Browser angemeldet ist, sieht die Zahlungsart im Shop weiterhin, markiert mit (unlicensed — visible to admins only), damit Sie die Erweiterung vor dem Kauf eines Schlüssels einrichten und testen können. In OpenCart 4 ist diese Vorschau nicht verfügbar: Der Shop sieht die Anmeldung im Admin 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 Admins eine Erinnerung. Schließen Sie sie mit ×, um sie 7 Tage lang auszublenden. Bestehende Bestellungen sind nicht betroffen: Bezahlte Bestellungen bleiben bezahlt, und Erstattungen funktionieren.

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 öffnen: einmal täglich in den ersten 14 Tagen nach Eingabe des Schlüssels, danach einmal wöchentlich. Ein Cron-Job ist nicht nötig. Beim Deinstallieren der Erweiterung werden immer Lizenzschlüssel und Lizenzstatus entfernt.

Fehlerbehebung

Square erscheint nicht an der Kasse: Prüfen Sie, ob die Lizenz aktiv ist, Enable/Disable eingeschaltet ist und die Application ID, der Access Token und die Location ID des aktuellen Modus ausgefüllt sind. Prüfen Sie, ob die Währung des Kunden USD, CAD, AUD, JPY, GBP oder EUR ist und mit der Währung Ihres Square-Standorts übereinstimmt. Die Einstellungsseite zeigt für jedes dieser Probleme eine Warnung. 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.

Das Kartenformular lädt nicht: Der Kunde sieht Das Kartenformular konnte nicht geladen werden. Bitte laden Sie die Seite neu oder wählen Sie eine andere Zahlungsart. Prüfen Sie, ob Application ID und Location ID zum gewählten Modus gehören (Sandbox-IDs beginnen mit sandbox-). Klickt der Kunde zu früh, wird Das Kartenformular wird noch geladen. Bitte warten Sie einen Moment und versuchen Sie es erneut. angezeigt.

Die Zahlungsart ist nach dem Speichern verschwunden: Die Währung des Square-Standorts unterscheidet sich von der Bestellwährung. Geben Sie die Location ID eines Square-Standorts in der Währung Ihres Shops ein und speichern Sie erneut: Die Zahlungsart wird nach einer erfolgreichen Prüfung wieder angezeigt.

Square hat den Access Token des gewählten Modus abgelehnt: Das Token gehört zum anderen Modus oder ist falsch. Kopieren Sie es erneut von der Seite Credentials Ihrer Anwendung und prüfen Sie Sandbox Mode.

Die Location ID wurde für diesen Access Token nicht gefunden: Kopieren Sie die Location ID von der Seite Locations derselben Anwendung und desselben Modus.

Der Kunde sah die Meldung „Vom Zahlungsanbieter konnte keine Bestätigung eingeholt werden“: Square hat nicht geantwortet, und es wurde noch keine Zahlung gefunden. Prüfen Sie die Zahlungen dieses Standorts im Square Dashboard (Referenz = Bestellnummer). Versucht der Kunde es erneut, sucht die Erweiterung zuerst nach der früheren Zahlung und verwendet sie, statt erneut zu belasten.

Der Kunde sah die Meldung „Ihre Zahlung ist eingegangen, die Bestellung konnte aber nicht automatisch abgeschlossen werden“: Die Karte wurde belastet, aber OpenCart konnte den Bestellstatus nicht setzen. Lesen Sie das Protokoll und schließen Sie die Bestellung dann manuell ab oder erstatten Sie die Zahlung im Square Dashboard.

Der Kunde sieht die Meldung „Diese Zahlungsart ist für Ihre Bestellung nicht verfügbar“: Die Kasse passt nicht mehr zur Bestellung, die Zahlungsart wurde inzwischen ausgeschaltet oder die Bestellwährung kann nicht belastet werden. Der Kunde lädt die Kasse neu oder wählt eine andere Zahlungsart.

Die Bestellung ist nach der Zahlung im Prüfstatus: Lesen Sie die Notizen in der Registerkarte VibeFox Square Gateway (siehe Bestellstatus). Prüfen Sie die Zahlung im Square Dashboard und schließen Sie dann die Bestellung ab oder erstatten Sie die Zahlung.

Kein Erstattungsformular in der Registerkarte: Die Registerkarte nennt den Grund: Keine Square-Zahlung hat für diese Bestellung Geld eingezogen, es ist keine Square-Zahlungs-ID erfasst (die Registerkarte nennt dann Standort und Bestellnummer, nach denen Sie im Square Dashboard suchen müssen), die Zahlung ist vollständig erstattet, oder Ihre Benutzergruppe hat kein Recht, die Erweiterung zu ändern.

Erstattung schlägt mit einer Meldung zum Modus fehl: Die Zahlung wurde im Sandbox- oder Live-Modus getätigt, und der Access Token dieses Modus ist nicht gesetzt. Tragen Sie ihn ein und versuchen Sie es erneut.

Andere Fehler: Schalten Sie Debug log ein und sehen Sie sich das Feld Log auf der Erweiterungsseite an.

Deinstallation

Gehen Sie zu Extensions > Extensions, wählen Sie den Typ Payments und klicken Sie neben VibeFox Square Gateway auf Uninstall (der rote −-Button). Lizenzschlüssel und 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 Neuinstallation auf ihre Standardwerte zurückgesetzt werden. Das OpenCart-Event der Erweiterung wird ebenfalls entfernt. Ist Delete data on uninstall eingeschaltet, werden die übrigen Gateway-Einstellungen (Titel, Beschreibung, Sandbox-Modus, Zugangsdaten, Protokollierung) und die Protokolldateien entfernt. Ist es ausgeschaltet, bleiben sie für eine spätere Neuinstallation erhalten. Die Square-Zahlungen und -Erstattungen der Bestellungen bleiben immer erhalten, sodass früher bezahlte Bestellungen nach einer Neuinstallation weiterhin erstattet werden können. Bestehende Bestellungen behalten ihre Zahlungsnotizen.

In OpenCart 4 entfernen Sie auch die Dateien der Erweiterung: Gehen Sie nach der Deinstallation zu Extensions > Installer, klicken Sie neben VibeFox Square Gateway in der Liste der installierten Erweiterungen auf Uninstall (der orangefarbene −-Button) und danach auf Delete (der rote Papierkorb-Button), um das hochgeladene Paket zu entfernen.

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