VibeFox Square for OpenCart

Présentation

VibeFox Square Gateway ajoute à OpenCart 3 et OpenCart 4 les paiements par carte de crédit et de débit via Square. À l'étape Confirm Order, le client saisit sa carte dans un formulaire de carte sécurisé de Square (Square Web Payments SDK). Votre serveur ne reçoit qu'un jeton à usage unique et le débite via l'API de paiement de Square. Les données de carte n'atteignent jamais votre boutique. OpenCart crée la commande avant le paiement, mais la commande ne reçoit un statut qu'après la réponse de Square ; les tentatives refusées restent donc des commandes manquantes.

L'extension convient aux vendeurs Square qui souhaitent accepter les paiements par carte sur leur propre page de paiement, dans la devise de leur site Square : USD, CAD, AUD, JPY, GBP ou EUR. Elle prend des paiements par carte uniques, débités immédiatement. Elle ne gère pas les cartes enregistrées, les abonnements, Apple Pay, Google Pay, Cash App Pay, Afterpay ni les cartes cadeaux Square, ni les paiements en autorisation seule, ni les webhooks Square.

Principales fonctionnalités

3-D Secure / SCA : la vérification de l'acheteur s'exécute lors de la tokenisation de la carte, avec le montant total de la commande, la devise et l'adresse de paiement transmis à Square.

Payée seulement après confirmation de Square : la commande n'obtient le statut payé que pour un paiement COMPLETED d'exactement le montant total, la devise, la référence de commande et le site. Tout élément inattendu place la commande dans un statut de vérification avec une note.

Aucun double débit : une seule tentative de paiement par panier à la fois, des requêtes idempotentes, et une tentative dont la réponse s'est perdue est recherchée chez Square au lieu de débiter à nouveau la carte.

Identifiants et contrôle de la devise : le jeton d'accès et le site sont vérifiés auprès de Square à l'enregistrement. Le mode de paiement est masqué pour les commandes dans une devise que le site Square ne peut pas débiter.

Remboursements depuis la page de commande : remboursements totaux et partiels dans l'onglet VibeFox Square Gateway de la commande, toujours dans l'environnement, le site, le montant et la devise du paiement réel. Un remboursement total place la commande au statut Refunded.

Onglet Square sur la page de commande : identifiant du paiement avec un lien vers le Square Dashboard, carte, reçu, historique des remboursements et notes.

Messages clairs : les clients voient de courts messages (carte refusée, code CVV incorrect, 3-D Secure requis). Les erreurs sont toujours journalisées, sans clés ni données de carte.

Conditions OpenCart : vos propres statuts de commande, zone géographique, montant minimum de commande et ordre d'affichage.

Prérequis

OpenCart 3.0.x (testé avec la version 3.0.5.0) ou OpenCart 4.0.2 et ultérieur (testé avec la version 4.1.0.3), PHP 8.0 ou ultérieur. Le téléchargement contient les paquets des deux versions. Un compte Square avec une application dans le Square Developer Dashboard (Application ID, Access Token, Location ID). La devise de la commande doit être celle de votre site Square : USD, CAD, AUD, JPY, GBP ou EUR. Une clé de licence VibeFox obtenue sur vibefox.net (une clé par domaine).