Square changelog
-
1.0.0
StableFirst public release of the Square payment plugin for Solidshop (
plg_solidshoppayment_square). Establishes the baseline that all future changelog entries are deltas against.Added
- Shoppers pay on Square's hosted checkout page, into the merchant's own Square account, with the methods Square offers there for that account (cards, Apple Pay, Google Pay and more). Card details are entered on Square's page and never reach the store's site.
- The order arrives at Square itemised: each product with its quantity and variant, then shipping, the payment fee and, on stores whose prices leave tax out, the tax, each on its own line, less the order's discount. The shopper is charged the order's grand total to the cent, and the Square order carries the Solidshop order reference.
- Sandbox and production credentials side by side (location ID and access token), with a per-store test-mode switch.
- The webhook registers itself: saving a store with Square switched on subscribes the store's own callback address to Square's payment updates and keeps the signature key and the address with the store's settings. Saving again after changing credentials, or after moving the site, registers again. A store saves whether or not Square can be reached; registering only adds a warning when it fails.
- The payment is confirmed when the shopper comes back from Square, from Square's own record of the order's payment, so the confirmation page shows a paid order straight away; a site Square cannot reach, such as one on localhost, still records its payments that way. The webhook confirms payments whose shopper never comes back.
- A payment that takes less than the order total records the order as Partially paid. A failed card attempt leaves the order pending, as the shopper can try again on the same checkout page.
- Configurable payment surcharge per store, the confirmation email sent once the payment is confirmed, captures on the order's Activity Timeline (deduplicated on the payment id), and a Joomla log of every payment event and rejection.
- Bundled admin translations for 23 languages, including RTL (Arabic, Hebrew, Persian).
Refunds are made in the Square Dashboard; set the order's payment status in Solidshop to match.
Security
- Webhooks are checked against the store's signature key and the address it was registered with, and matched only to that store's own Square orders. Payments that are not the store's (sales on Square's own devices, another site on the same account) are acknowledged and ignored, so Square does not keep sending them, and a repeated or late update never sets a refunded order back to Paid.
- The return address carries an HMAC order token, and a payment is recorded only in the order's currency.
Requires Joomla 6.x+, PHP 8.4+, and Solidshop 1.8.0+ (enforced at install by the plugin's installer scriptfile).