VibeFox Square for OpenCart

Übersicht

VibeFox Square Gateway ergänzt OpenCart 3 und OpenCart 4 um Kredit- und Debitkartenzahlungen über Square. Im Schritt Confirm Order gibt der Kunde seine Karte in einem sicheren Kartenformular von Square ein (Square Web Payments SDK). Ihr Server erhält nur ein Einmal-Token und belastet es über die Square Payments API. Kartendaten erreichen Ihren Shop nie. OpenCart legt die Bestellung vor der Zahlung an, aber die Bestellung erhält erst einen Status, wenn Square geantwortet hat, daher bleiben abgelehnte Versuche fehlende Bestellungen.

Die Erweiterung eignet sich für Square-Händler, die Kartenzahlungen auf ihrer eigenen Kasse anbieten möchten, in der Währung ihres Square-Standorts: USD, CAD, AUD, JPY, GBP oder EUR. Die Erweiterung nimmt einmalige Kartenzahlungen an, die sofort erfasst werden. Gespeicherte Karten, Abonnements, Apple Pay, Google Pay, Cash App Pay, Afterpay und Square-Geschenkkarten werden nicht unterstützt, ebenso wenig Zahlungen mit reiner Autorisierung und Square-Webhooks.

Hauptfunktionen

3-D Secure / SCA: Die Käuferverifizierung läuft bei der Tokenisierung der Karte, dabei werden Bestellsumme, Währung und Zahlungsadresse an Square übergeben.

Nur bezahlt, wenn Square bestätigt: Die Bestellung erhält den Status „bezahlt“ nur bei einer COMPLETED-Zahlung über genau die Bestellsumme, die Währung, die Bestellreferenz und den Standort. Alles Unerwartete setzt die Bestellung in einen Prüfstatus mit einer Notiz.

Keine doppelten Belastungen: pro Warenkorb läuft jeweils nur ein Zahlungsversuch, die Anfragen sind idempotent, und ein Versuch, dessen Antwort verloren ging, wird bei Square nachgeschlagen, statt die Karte erneut zu belasten.

Zugangsdaten und Währungsprüfung: das Zugriffstoken und der Standort werden beim Speichern bei Square geprüft. Die Zahlungsart wird für Bestellungen in einer Währung ausgeblendet, die der Square-Standort nicht belasten kann.

Erstattungen auf der Bestellseite: vollständige und teilweise Erstattungen im Reiter VibeFox Square Gateway der Bestellung, immer mit Umgebung, Standort, Betrag und Währung der tatsächlichen Zahlung. Eine vollständige Erstattung setzt den Status Refunded.

Square-Reiter auf der Bestellseite: Zahlungs-ID mit Link zum Square Dashboard, Karte, Beleg, Erstattungsverlauf und Notizen.

Klare Meldungen: Kunden sehen kurze Meldungen (abgelehnt, falscher CVV, 3-D Secure erforderlich). Fehler werden immer protokolliert, ohne Schlüssel oder Kartendaten.

OpenCart-Bedingungen: Ihre eigenen Bestellstatus, Geozone, Mindestbestellsumme und Sortierreihenfolge.

Anforderungen

OpenCart 3.0.x (getestet mit 3.0.5.0) oder OpenCart 4.0.2 oder neuer (getestet mit 4.1.0.3), PHP 8.0 oder neuer. Der Download enthält die Pakete für beide Versionen. Ein Square-Konto mit einer Anwendung im Square Developer Dashboard (Application ID, Access Token, Location ID). Die Bestellwährung muss die Währung Ihres Square-Standorts sein: USD, CAD, AUD, JPY, GBP oder EUR. Ein VibeFox-Lizenzschlüssel von vibefox.net (ein Schlüssel pro Domain).