VibeFox Square for PrestaShop

Présentation

VibeFox Square Gateway ajoute à PrestaShop les paiements par carte de crédit et de débit via Square. À l'étape de paiement, le client saisit sa carte dans un formulaire sécurisé de Square affiché sous le mode de paiement (Square Web Payments SDK). Votre serveur ne reçoit qu'un jeton à usage unique et le débite via l'API Square Payments. Les données de carte n'atteignent jamais votre boutique, et la commande n'est créée qu'après confirmation du paiement par Square.

L'extension convient aux vendeurs Square aux États-Unis, au Canada, en Australie, au Japon, au Royaume-Uni, en Irlande, en France et en Espagne qui souhaitent accepter les paiements par carte sur leur propre page de paiement. Le module prend en charge les paiements par carte uniques, capturés immédiatement. Il ne gère ni cartes enregistrées, ni abonnements, ni Apple Pay, Google Pay, Cash App Pay, Afterpay ou cartes cadeaux Square, ni paiements en autorisation seule, et n'utilise pas de webhooks Square.

Principales fonctionnalités

3-D Secure / SCA : la vérification de l'acheteur a lieu lors de la tokenisation de la carte ; le total du panier, la devise et l'adresse de facturation sont transmis à Square.

Payée uniquement après confirmation de Square : la commande reçoit Payment accepted uniquement pour un paiement COMPLETED d'un montant exactement égal au total du panier, dans la même devise, avec la même référence de panier et le même site. Tout élément inattendu place la commande en Square payment on hold 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 a été perdue est recherchée chez Square au lieu de débiter à nouveau la carte.

Vérification des identifiants et 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 paniers dans une devise que le site Square ne peut pas débiter.

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

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

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

Prérequis

PrestaShop 8.0 à 9.x, PHP 8.0 ou ultérieur. Un compte Square avec une application dans le Square Developer Dashboard (Application ID, Access Token, Location ID). La devise du panier 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).