v0.1.0
First public release of Square Terminal for WooCommerce — collect WooCommerce order payments on Square Terminal devices. Staff request a card-present payment from a WooCommerce order and complete it on paired Square hardware, with the result written back to the order.
Features
- Send a WooCommerce order to a paired Square Terminal and collect a card-present payment.
- Pair Terminal devices from WooCommerce using a short-lived Square Device Code.
- Settings-based Square Account Connection — merchant-entered Access Token, Location ID, and Webhook Signature Key (no OAuth in v0.1).
- Sandbox and Production support.
- Verified Square webhooks are the authoritative payment-completion signal; polling keeps the UI responsive.
- A per-order Payment Log and order notes record each meaningful Square step and outcome.
- The Square SDK is namespace-scoped with PHP-Scoper so it cannot clash with other plugins.
Requirements
- WordPress 6.5+
- WooCommerce 8.0+
- PHP 8.1+
Install
- Download
square-terminal-for-woocommerce.zipbelow. - In WordPress: Plugins → Add New → Upload Plugin, upload the zip, and activate.
- Configure under WooCommerce → Settings → Payments → Square Terminal (Access Token, Location ID, Webhook Signature Key), then pair a Terminal with Create Device Code.
See the README for full setup and configuration.
Scope & known limitations
- This is an early v0.1 focused on POS / order-pay flows; availability on the customer-facing storefront checkout is off by default and must be explicitly enabled.
- Payment collection only — refunds are not yet supported. Square identifiers are stored on the order so refund support can be added later.
Full Changelog: https://github.com/wcpos/square-terminal-for-woocommerce/commits/v0.1.0