VibeFox Square for PrestaShop

Overview

VibeFox Square Gateway adds credit and debit card payments through Square to PrestaShop. At the payment step the customer enters the card in a secure Square card form shown under the payment method (Square Web Payments SDK). Your server receives only a single-use token and charges it through the Square Payments API. Card data never reaches your shop, and the order is created only after Square confirms the payment.

It suits Square sellers in the US, Canada, Australia, Japan, the UK, Ireland, France and Spain who want to take card payments on their own checkout page. The module takes one-time card payments, captured immediately. It has no saved cards, subscriptions, Apple Pay, Google Pay, Cash App Pay, Afterpay or Square gift cards, no authorize-only payments and no Square webhooks.

Key features

3-D Secure / SCA: buyer verification runs when the card is tokenized, with the cart total, the currency and the billing address passed to Square.

Paid only when Square confirms: the order gets Payment accepted only for a COMPLETED payment of exactly the cart total, currency, cart reference and location. Anything unexpected puts the order in Square payment on hold with a note.

No double charges: one payment attempt per cart at a time, idempotent requests, and an attempt whose answer was lost is looked up at Square instead of charging the card again.

Credentials and currency check: the access token and location are checked with Square on save. The method is hidden for carts in a currency the Square location cannot charge.

Refunds from the order page: full and partial refunds in the Square block of the order, always in the environment, location, amount and currency of the actual payment. A full refund sets the order to Refunded.

Square block on the order page: payment ID with a Square Dashboard link, card, receipt, refund history and notes.

Clear messages: customers see short messages (declined, wrong CVV, 3-D Secure required). Errors are always logged, without keys or card data.

Requirements

PrestaShop 8.0 to 9.x, PHP 8.0 or later. A Square account with an application in the Square Developer Dashboard (Application ID, Access Token, Location ID). The cart currency must be the currency of your Square location: USD, CAD, AUD, JPY, GBP or EUR. A VibeFox license key from vibefox.net (one key per domain).