{"id":300237,"date":"2026-06-14T11:03:18","date_gmt":"2026-06-14T11:03:18","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/wppayments-square-hosted-checkout-for-woocommerce\/"},"modified":"2026-06-14T15:12:04","modified_gmt":"2026-06-14T15:12:04","slug":"payments-connect-square","status":"publish","type":"plugin","link":"https:\/\/wordpress.org\/plugins\/payments-connect-square\/","author":23480523,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"1.0.6","stable_tag":"1.0.6","tested":"7.0","requires":"6.0","requires_php":"7.4","requires_plugins":null,"header_name":"Payments Square Connect","header_author":"WPPayments","header_description":"Accept payments through Square Hosted Checkout from WooCommerce with OAuth, webhooks, and optional OAuth Worker relay.","assets_banners_color":"448587","last_updated":"2026-06-14 15:12:04","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"","header_author_uri":"","rating":0,"author_block_rating":0,"active_installs":0,"downloads":85,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","changelog"],"tags":{"1.0.3":{"tag":"1.0.3","author":"wppayments","date":"2026-06-14 11:02:56"},"1.0.4":{"tag":"1.0.4","author":"wppayments","date":"2026-06-14 13:25:00"},"1.0.5":{"tag":"1.0.5","author":"wppayments","date":"2026-06-14 14:27:49"},"1.0.6":{"tag":"1.0.6","author":"wppayments","date":"2026-06-14 15:12:04"}},"upgrade_notice":[],"ratings":[],"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3571833,"resolution":"128x128","location":"assets","locale":"","width":128,"height":128},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3571833,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256}},"assets_banners":{"banner-772x250.png":{"filename":"banner-772x250.png","revision":3571833,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.0.3","1.0.4","1.0.5","1.0.6"],"block_files":[],"assets_screenshots":[],"screenshots":[]},"plugin_section":[],"plugin_tags":[3148,1152,1887,2672,286],"plugin_category":[45],"plugin_contributors":[267068],"plugin_business_model":[],"class_list":["post-300237","plugin","type-plugin","status-publish","hentry","plugin_tags-checkout","plugin_tags-contact-form-7","plugin_tags-payments","plugin_tags-square","plugin_tags-woocommerce","plugin_category-ecommerce","plugin_contributors-wppayments","plugin_committers-wppayments"],"banners":{"banner":"https:\/\/ps.w.org\/payments-connect-square\/assets\/banner-772x250.png?rev=3571833","banner_2x":false,"banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/payments-connect-square\/assets\/icon-128x128.png?rev=3571833","icon_2x":"https:\/\/ps.w.org\/payments-connect-square\/assets\/icon-256x256.png?rev=3571833","generated":false},"screenshots":[],"raw_content":"<!--section=description-->\n<p>This plugin redirects customers to Square Hosted Checkout. Connect Square once under <strong>Settings \u2192 Payments Square Connect<\/strong>; WooCommerce checkout and Contact Form 7 forms share the same connection.<\/p>\n\n<p>When you enable Payments Square Connect, the site exchanges data with <strong>Square<\/strong> for payments, OAuth, and webhooks.<\/p>\n\n<p><strong>WooCommerce:<\/strong> enable the gateway under WooCommerce \u2192 Settings \u2192 Payments and customize the checkout title and description.<\/p>\n\n<p><strong>Contact Form 7:<\/strong> add the <code>[square_pay]<\/code> form tag to accept fixed or field-based amounts. Example: <code>[square_pay amount:25.00]<\/code> or <code>[square_pay amount-field:your-amount]<\/code> with a matching number field.<\/p>\n\n<h3>External services<\/h3>\n\n<p>This plugin is a client for third-party services. By using it you direct WordPress to contact those services.<\/p>\n\n<ul>\n<li><p><strong>Square (required for payments and connection)<\/strong><\/p>\n\n<ul>\n<li><strong>What:<\/strong> OAuth, REST API calls (e.g. locations, payment links), and hosted checkout pages.  <\/li>\n<li><strong>When:<\/strong> When a store admin uses \"Connect with Square\", when checkout or a Contact Form 7 payment creates a payment link, and when Square sends webhooks to your site.  <\/li>\n<li><strong>Endpoints (summary):<\/strong> <code>https:\/\/connect.squareup.com<\/code> or <code>https:\/\/connect.squareupsandbox.com<\/code> (OAuth and API), plus Square's hosted checkout URLs returned in API responses.  <\/li>\n<li><strong>Data sent:<\/strong> API requests include OAuth tokens after connection, order or form-derived totals and references needed to create checkout, and webhook payloads as defined by Square.  <\/li>\n<li><strong>Terms:<\/strong> https:\/\/squareup.com\/legal - review Square's developer and seller terms for your region.<\/li>\n<\/ul><\/li>\n<li><p><strong>WPPayments OAuth relay (required for Connect with Square)<\/strong><\/p>\n\n<ul>\n<li><strong>What:<\/strong> Registers your site and completes Square OAuth so application secrets are not stored in WordPress.  <\/li>\n<li><strong>When:<\/strong> When a store admin clicks <strong>Connect with Square<\/strong>.  <\/li>\n<li><strong>Endpoint:<\/strong> <code>https:\/\/shc4wc-square-oauth.wordpress-ingenious.workers.dev<\/code>  <\/li>\n<li><strong>Data sent:<\/strong> Your site URL, sandbox\/live environment, and signed session identifiers needed to finish OAuth.  <\/li>\n<li><strong>Terms:<\/strong> https:\/\/squareup.com\/legal (Square OAuth); contact the plugin author for questions about the relay service.<\/li>\n<\/ul><\/li>\n<\/ul>\n\n<p>Store admins explicitly start OAuth by clicking <strong>Connect with Square<\/strong>; customers are sent to Square's hosted pages only during checkout or after submitting a Contact Form 7 payment form.<\/p>\n\n<h3>Privacy<\/h3>\n\n<ul>\n<li><strong>Site owners:<\/strong> OAuth and API usage are initiated by an administrator with <code>manage_options<\/code>. Tokens are stored in the WordPress database (options) like other payment settings.  <\/li>\n<li><strong>Customers:<\/strong> Personal and payment data on hosted checkout is processed by <strong>Square<\/strong> under Square's policies, not by form fields added by this plugin on your site for card entry.  <\/li>\n<li><strong>Logging:<\/strong> Optional WooCommerce logs may record technical details when debug logging is enabled; disable debug in normal production.  <\/li>\n<li>For compliance questions, consult Square's documentation and your legal advisor; this readme is not legal advice.<\/li>\n<\/ul>\n\n<!--section=installation-->\n<ol>\n<li>Activate the plugin (WooCommerce is required; Contact Form 7 is optional).<\/li>\n<li>Go to <strong>Settings \u2192 Payments Square Connect<\/strong>.<\/li>\n<li>Choose environment (Sandbox\/Live).<\/li>\n<li>Connect your Square account and select a location.<\/li>\n<li>Save settings.<\/li>\n<li>For WooCommerce: go to <strong>WooCommerce \u2192 Settings \u2192 Payments \u2192 Payments Square Connect<\/strong>, enable the gateway, and set the checkout title and description.<\/li>\n<li>For Contact Form 7: add <code>[square_pay]<\/code> to a form (see Description above).<\/li>\n<\/ol>\n\n<!--section=changelog-->\n<h4>1.0.6<\/h4>\n\n<ul>\n<li>Ship default OAuth relay URL so Connect with Square works on fresh installs without manual Worker configuration.<\/li>\n<li>Simplified connection settings (merchant Connect UI only).<\/li>\n<\/ul>\n\n<h4>1.0.5<\/h4>\n\n<ul>\n<li>Shared Square connection hub under Settings \u2192 Payments Square Connect (one Connect for WooCommerce and Contact Form 7).<\/li>\n<li>WooCommerce gateway settings limited to checkout display options; connection moved to the shared settings page.<\/li>\n<li>Contact Form 7 support via <code>[square_pay]<\/code> form tag (fixed or field-based amounts).<\/li>\n<li>Generic Square payment link API used by both WooCommerce orders and CF7 submissions.<\/li>\n<\/ul>\n\n<h4>1.0.4<\/h4>\n\n<ul>\n<li>Freemius SDK integrated for licensing, updates, and analytics.<\/li>\n<li>Prevent duplicate plugin bootstrap when multiple copies are present.<\/li>\n<li>Show a short test-mode notice at checkout when environment is Sandbox.<\/li>\n<\/ul>\n\n<h4>1.0.3<\/h4>\n\n<ul>\n<li>Plugin display name adjusted for WordPress.org naming checks (removed restricted wording).<\/li>\n<li>Main bootstrap file and folder slug aligned with <code>payments-connect-square<\/code> for Plugin Check text-domain validation.<\/li>\n<\/ul>\n\n<h4>1.0.2<\/h4>\n\n<ul>\n<li>Plugin display name updated for trademark guidelines.<\/li>\n<li>Text domain aligned with plugin slug <code>payments-connect-square<\/code>.<\/li>\n<\/ul>\n\n<h4>1.0.0<\/h4>\n\n<ul>\n<li>Initial release.<\/li>\n<\/ul>","raw_excerpt":"WooCommerce and Contact Form 7 payments via Square Hosted Checkout, OAuth, and webhooks.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/300237","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=300237"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/wppayments"}],"wp:attachment":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=300237"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=300237"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=300237"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=300237"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=300237"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=300237"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}