Skip to content

v0.1.0

Choose a tag to compare

@github-actions github-actions released this 05 Jun 19:51
b89ab22

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

  1. Download square-terminal-for-woocommerce.zip below.
  2. In WordPress: Plugins → Add New → Upload Plugin, upload the zip, and activate.
  3. 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