{"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-20T19:04:09","modified_gmt":"2026-06-20T19:04:09","slug":"payments-connect-square","status":"publish","type":"plugin","link":"https:\/\/cn.wordpress.org\/plugins\/payments-connect-square\/","author":23480523,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"1.1.9","stable_tag":"1.1.9","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-20 19:04:09","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"","header_author_uri":"","rating":0,"author_block_rating":0,"active_installs":0,"downloads":589,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","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"},"1.0.7":{"tag":"1.0.7","author":"wppayments","date":"2026-06-15 13:27:20"},"1.0.8":{"tag":"1.0.8","author":"wppayments","date":"2026-06-15 13:34:30"},"1.0.9":{"tag":"1.0.9","author":"wppayments","date":"2026-06-15 13:55:53"},"1.1.0":{"tag":"1.1.0","author":"wppayments","date":"2026-06-15 19:15:29"},"1.1.1":{"tag":"1.1.1","author":"wppayments","date":"2026-06-15 20:20:30"},"1.1.2":{"tag":"1.1.2","author":"wppayments","date":"2026-06-16 11:47:58"},"1.1.3":{"tag":"1.1.3","author":"wppayments","date":"2026-06-16 11:53:45"},"1.1.4":{"tag":"1.1.4","author":"wppayments","date":"2026-06-16 12:35:25"},"1.1.5":{"tag":"1.1.5","author":"wppayments","date":"2026-06-19 19:00:29"},"1.1.6":{"tag":"1.1.6","author":"wppayments","date":"2026-06-20 00:02:41"},"1.1.7":{"tag":"1.1.7","author":"wppayments","date":"2026-06-20 18:53:00"},"1.1.8":{"tag":"1.1.8","author":"wppayments","date":"2026-06-20 18:57:05"},"1.1.9":{"tag":"1.1.9","author":"wppayments","date":"2026-06-20 19:04:09"}},"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","1.0.7","1.0.8","1.0.9","1.1.0","1.1.1","1.1.2","1.1.3","1.1.4","1.1.5","1.1.6","1.1.7","1.1.8","1.1.9"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":3573573,"resolution":"1","location":"assets","locale":"","width":1400,"height":935},"screenshot-2.png":{"filename":"screenshot-2.png","revision":3573573,"resolution":"2","location":"assets","locale":"","width":1400,"height":935},"screenshot-3.png":{"filename":"screenshot-3.png","revision":3573573,"resolution":"3","location":"assets","locale":"","width":1400,"height":935},"screenshot-4.png":{"filename":"screenshot-4.png","revision":3573573,"resolution":"4","location":"assets","locale":"","width":1400,"height":1057},"screenshot-5.png":{"filename":"screenshot-5.png","revision":3580098,"resolution":"5","location":"assets","locale":"","width":431,"height":615},"screenshot-6.png":{"filename":"screenshot-6.png","revision":3580098,"resolution":"6","location":"assets","locale":"","width":639,"height":1941}},"screenshots":{"1":"Connect your Square account, choose Sandbox or Live, and pick a location.","2":"Checkout Settings: wallets, tipping, branding, and policies (Live mode only).","3":"Subscription Plans: view Square plans and copy plan IDs.","4":"WooCommerce: enable the gateway and set checkout title and description.","5":"Contact Form 7: add Square payment tags to a form.","6":"Square Hosted Checkout: product names and totals shown on Square's payment page."}},"plugin_section":[],"plugin_tags":[1152,1887,2672,4079,286],"plugin_category":[45],"plugin_contributors":[267068],"plugin_business_model":[],"class_list":["post-300237","plugin","type-plugin","status-publish","hentry","plugin_tags-contact-form-7","plugin_tags-payments","plugin_tags-square","plugin_tags-subscriptions","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":[{"src":"https:\/\/ps.w.org\/payments-connect-square\/assets\/screenshot-1.png?rev=3573573","caption":"Connect your Square account, choose Sandbox or Live, and pick a location."},{"src":"https:\/\/ps.w.org\/payments-connect-square\/assets\/screenshot-2.png?rev=3573573","caption":"Checkout Settings: wallets, tipping, branding, and policies (Live mode only)."},{"src":"https:\/\/ps.w.org\/payments-connect-square\/assets\/screenshot-3.png?rev=3573573","caption":"Subscription Plans: view Square plans and copy plan IDs."},{"src":"https:\/\/ps.w.org\/payments-connect-square\/assets\/screenshot-4.png?rev=3573573","caption":"WooCommerce: enable the gateway and set checkout title and description."},{"src":"https:\/\/ps.w.org\/payments-connect-square\/assets\/screenshot-5.png?rev=3580098","caption":"Contact Form 7: add Square payment tags to a form."},{"src":"https:\/\/ps.w.org\/payments-connect-square\/assets\/screenshot-6.png?rev=3580098","caption":"Square Hosted Checkout: product names and totals shown on Square's payment page."}],"raw_content":"<!--section=description-->\n<h4>A smarter way to accept Square payments on WordPress<\/h4>\n\n<p>Most Square payment plugins show the payment form on your own checkout page. That can break when a theme, plugin, or cache gets in the way.<\/p>\n\n<p><strong>Payments Square Connect<\/strong> sends customers to <strong>Square Hosted Checkout<\/strong> \u2014 Square's own payment page. After they pay, they come back to your store or form automatically.<\/p>\n\n<p><strong>Why merchants like it:<\/strong><\/p>\n\n<ul>\n<li><strong>Fewer checkout problems<\/strong> \u2014 payment does not depend on your theme or other plugins<\/li>\n<li><strong>Better security<\/strong> \u2014 card details are entered on Square, not on your WordPress site<\/li>\n<li><strong>One connection<\/strong> \u2014 use the same Square account for <strong>WooCommerce<\/strong>, <strong>Contact Form 7<\/strong>, and <strong>subscriptions<\/strong><\/li>\n<\/ul>\n\n<h4>Quick start<\/h4>\n\n<ol>\n<li>Install and activate <strong>Payments Square Connect<\/strong>.<\/li>\n<li>Open <strong>Payments Square Connect<\/strong> in the WordPress admin sidebar.<\/li>\n<li>Choose <strong>Sandbox<\/strong> for testing or <strong>Live<\/strong> for real payments.<\/li>\n<li>Click <strong>Payments Square Connect<\/strong>, sign in with Square, and pick your <strong>Square Location<\/strong>.<\/li>\n<li>Click <strong>Save connection settings<\/strong>.<\/li>\n<li>Turn on WooCommerce and\/or Contact Form 7 (see below).<\/li>\n<\/ol>\n\n<h4>Where to find settings<\/h4>\n\n<p>Everything is under <strong>Payments Square Connect<\/strong> in the admin sidebar:<\/p>\n\n<ul>\n<li><strong>Payments Square Connect<\/strong> \u2014 connect Square, choose Sandbox or Live, pick a location<\/li>\n<li><strong>Checkout Settings (Beta)<\/strong> \u2014 wallets, tipping, branding, and policies on Square checkout (<strong>Live mode only<\/strong>)<\/li>\n<li><strong>Subscription Plans<\/strong> \u2014 view your Square plans and copy plan IDs<\/li>\n<li><strong>Support<\/strong> \u2014 email, WhatsApp, or the WordPress.org forum<\/li>\n<\/ul>\n\n<h4>Connect Square<\/h4>\n\n<p>Every payment uses this screen first.<\/p>\n\n<ol>\n<li>Go to <strong>Payments Square Connect \u2192 Payments Square Connect<\/strong>.<\/li>\n<li>Pick <strong>Sandbox<\/strong> while testing, or <strong>Live<\/strong> when you are ready to take real payments.<\/li>\n<li>Click <strong>Payments Square Connect<\/strong> and sign in with your Square account.<\/li>\n<li>Choose your <strong>Square Location<\/strong> from the list.<\/li>\n<li>Click <strong>Save connection settings<\/strong>.<\/li>\n<\/ol>\n\n<p><strong>Tips<\/strong><\/p>\n\n<ul>\n<li>Start in <strong>Sandbox<\/strong> so you can test without charging real cards.<\/li>\n<li>If you move your site to a new address, connect Square again from this page.<\/li>\n<li>Use <strong>Disconnect Square<\/strong> if you need to switch accounts.<\/li>\n<\/ul>\n\n<h4>WooCommerce<\/h4>\n\n<p>WooCommerce is <strong>optional<\/strong>. Install it only if you sell through a WooCommerce store.<\/p>\n\n<ol>\n<li>Complete <strong>Connect Square<\/strong> above.<\/li>\n<li>Go to <strong>WooCommerce \u2192 Settings \u2192 Payments \u2192 Payments Square Connect<\/strong>.<\/li>\n<li>Turn the gateway <strong>on<\/strong>.<\/li>\n<li>Set <strong>Title<\/strong> and <strong>Description<\/strong> (what shoppers see at checkout). Example: \"Pay with Square\".<\/li>\n<li>Save and place a test order.<\/li>\n<\/ol>\n\n<p><strong>At checkout:<\/strong> the customer chooses your Square gateway, is sent to Square to pay, then returns to your <strong>Order received<\/strong> page.<\/p>\n\n<p><strong>Subscriptions (optional):<\/strong> create plans in Square, refresh <strong>Subscription Plans<\/strong> in this plugin, then pick a plan on each WooCommerce subscription product.<\/p>\n\n<h4>Contact Form 7<\/h4>\n\n<p>Contact Form 7 is <strong>optional<\/strong>. Use it for donations, fees, registrations, and similar forms.<\/p>\n\n<p><strong>One-time payment<\/strong><\/p>\n\n<ol>\n<li>Connect Square first.<\/li>\n<li>Add a tag to your form:\n\n<ul>\n<li>Fixed amount: <code>[square_pay amount:25.00]<\/code><\/li>\n<li>Amount from a form field: <code>[square_pay amount-field:your-amount]<\/code><\/li>\n<\/ul><\/li>\n<li>Publish the form. After submit, the visitor pays on Square and returns with a success message.<\/li>\n<\/ol>\n\n<p><strong>Subscription signup<\/strong><\/p>\n\n<ol>\n<li>Create plans in Square and copy a plan ID from <strong>Subscription Plans<\/strong>.<\/li>\n<li>Add a tag like: <code>[square_subscribe variation:YOUR_PLAN_ID name:\"Silver Membership\" amount:15.00]<\/code><\/li>\n<\/ol>\n\n<h4>Subscription Plans<\/h4>\n\n<p>Open <strong>Payments Square Connect \u2192 Subscription Plans<\/strong> to:<\/p>\n\n<ul>\n<li>See plans from your Square account<\/li>\n<li>Click <strong>Refresh from Square<\/strong> after you add or change plans<\/li>\n<li>Copy plan IDs for Contact Form 7 tags or WooCommerce products<\/li>\n<\/ul>\n\n<p><strong>Good to know:<\/strong> some payment methods (such as Cash App Pay and Afterpay) are not available for subscription sign-up.<\/p>\n\n<h4>Checkout Settings (Beta)<\/h4>\n\n<p>Customize Square checkout for payments created by this plugin.<\/p>\n\n<p><strong>Live mode only<\/strong> \u2014 switch to Live on the Connect screen first.<\/p>\n\n<ul>\n<li><strong>Merchant settings<\/strong> \u2014 Apple Pay, Google Pay, Cash App Pay (Afterpay is managed in Square Dashboard)<\/li>\n<li><strong>Location settings<\/strong> \u2014 customer notes, tipping, button style, store policy text<\/li>\n<\/ul>\n\n<h4>Requirements<\/h4>\n\n<ul>\n<li>WordPress 6.0+<\/li>\n<li>PHP 7.4+<\/li>\n<li>A Square seller account<\/li>\n<li>WooCommerce \u2014 optional (for store checkout)<\/li>\n<li>Contact Form 7 \u2014 optional (for form payments)<\/li>\n<li>WooCommerce Subscriptions \u2014 optional (for recurring products)<\/li>\n<\/ul>\n\n<!--section=installation-->\n<ol>\n<li>Activate <strong>Payments Square Connect<\/strong>.<\/li>\n<li>Open <strong>Payments Square Connect<\/strong> in the admin sidebar.<\/li>\n<li>Choose <strong>Sandbox<\/strong> or <strong>Live<\/strong>, sign in with Square, and save a location.<\/li>\n<li>Enable WooCommerce and\/or add Contact Form 7 tags if you need them.<\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt id=\"do%20i%20need%20woocommerce%3F\"><h3>Do I need WooCommerce?<\/h3><\/dt>\n<dd><p>No. You can take payments through Contact Form 7 without WooCommerce.<\/p><\/dd>\n<dt id=\"do%20i%20need%20contact%20form%207%3F\"><h3>Do I need Contact Form 7?<\/h3><\/dt>\n<dd><p>No. If you only sell through WooCommerce, you do not need Contact Form 7.<\/p><\/dd>\n<dt id=\"where%20are%20the%20settings%3F\"><h3>Where are the settings?<\/h3><\/dt>\n<dd><p><strong>Payments Square Connect<\/strong> in the WordPress admin sidebar.<\/p><\/dd>\n<dt id=\"what%20is%20sandbox%20vs%20live%3F\"><h3>What is Sandbox vs Live?<\/h3><\/dt>\n<dd><p><strong>Sandbox<\/strong> is for testing \u2014 no real money. <strong>Live<\/strong> is for real payments. Start in Sandbox, then switch to Live when you are ready.<\/p><\/dd>\n<dt id=\"how%20does%20the%20customer%20get%20back%20to%20my%20site%3F\"><h3>How does the customer get back to my site?<\/h3><\/dt>\n<dd><p>Square sends them back automatically after payment. WooCommerce shoppers see the order confirmation page. Form visitors return to the same form with a success message.<\/p><\/dd>\n<dt id=\"can%20i%20sell%20subscriptions%3F\"><h3>Can I sell subscriptions?<\/h3><\/dt>\n<dd><p>Yes. Create plans in Square, then use <strong>Subscription Plans<\/strong> in this plugin to connect them to WooCommerce products or Contact Form 7 forms.<\/p><\/dd>\n<dt id=\"why%20are%20checkout%20settings%20greyed%20out%3F\"><h3>Why are Checkout Settings greyed out?<\/h3><\/dt>\n<dd><p>Checkout Settings work in <strong>Live mode only<\/strong>. Connect in Live to change wallets, tipping, and branding.<\/p><\/dd>\n<dt id=\"is%20card%20data%20stored%20on%20my%20site%3F\"><h3>Is card data stored on my site?<\/h3><\/dt>\n<dd><p>No. Customers enter payment details on <strong>Square Hosted Checkout<\/strong>. Your WordPress site does not store card numbers.<\/p><\/dd>\n<dt id=\"how%20do%20i%20get%20help%3F\"><h3>How do I get help?<\/h3><\/dt>\n<dd><p>Open <strong>Payments Square Connect \u2192 Support<\/strong> for email, WhatsApp, or the <a href=\"https:\/\/wordpress.org\/support\/plugin\/payments-connect-square\/\">WordPress.org support forum<\/a>.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>1.1.9<\/h4>\n\n<ul>\n<li>Support page: remove visible WhatsApp phone number; Open WhatsApp button still works.<\/li>\n<\/ul>\n\n<h4>1.1.8<\/h4>\n\n<ul>\n<li>README: simplified, user-friendly documentation.<\/li>\n<\/ul>\n\n<h4>1.1.7<\/h4>\n\n<ul>\n<li>WooCommerce checkout on Square now shows each product name (plus shipping and fees) instead of one generic order line.<\/li>\n<\/ul>\n\n<h4>1.1.6<\/h4>\n\n<ul>\n<li>README: added overview of Square Hosted Checkout benefits.<\/li>\n<\/ul>\n\n<h4>1.1.5<\/h4>\n\n<ul>\n<li>Fixed Cash App Pay setting not saving in Checkout Settings.<\/li>\n<\/ul>\n\n<h4>1.1.4<\/h4>\n\n<ul>\n<li>Improved Square connection permissions for Checkout Settings.<\/li>\n<\/ul>\n\n<h4>1.1.3<\/h4>\n\n<ul>\n<li>Fixed error after connecting Square in some setups.<\/li>\n<\/ul>\n\n<h4>1.1.2<\/h4>\n\n<ul>\n<li>Square Connect works without WooCommerce installed.<\/li>\n<li>Clearer connection error messages when debug logging is on.<\/li>\n<\/ul>\n\n<h4>1.1.1<\/h4>\n\n<ul>\n<li>New Support page with email, WhatsApp, and forum link.<\/li>\n<\/ul>\n\n<h4>1.1.0<\/h4>\n\n<ul>\n<li>New admin menu with Connect, Checkout Settings, and Subscription Plans.<\/li>\n<li>Subscriptions for WooCommerce and Contact Form 7.<\/li>\n<li>Checkout customization for Square hosted pages.<\/li>\n<\/ul>\n\n<h4>1.0.9<\/h4>\n\n<ul>\n<li>More reliable return to your site after Square sign-in.<\/li>\n<\/ul>\n\n<h4>1.0.8<\/h4>\n\n<ul>\n<li>Fixed connection errors after redirect from Square.<\/li>\n<\/ul>\n\n<h4>1.0.7<\/h4>\n\n<ul>\n<li>Fixed connect failures when the site URL changes.<\/li>\n<\/ul>\n\n<h4>1.0.6<\/h4>\n\n<ul>\n<li>Easier first-time Square connection setup.<\/li>\n<\/ul>\n\n<h4>1.0.5<\/h4>\n\n<ul>\n<li>One Square connection for WooCommerce and Contact Form 7.<\/li>\n<li>Contact Form 7 payment tag support.<\/li>\n<\/ul>\n\n<h4>1.0.4<\/h4>\n\n<ul>\n<li>Plugin updates and licensing improvements.<\/li>\n<\/ul>\n\n<h4>1.0.3<\/h4>\n\n<ul>\n<li>WordPress.org naming and compatibility updates.<\/li>\n<\/ul>\n\n<h4>1.0.2<\/h4>\n\n<ul>\n<li>Display name and text domain updates.<\/li>\n<\/ul>\n\n<h4>1.0.0<\/h4>\n\n<ul>\n<li>Initial release.<\/li>\n<\/ul>","raw_excerpt":"Square Hosted Checkout for WooCommerce and Contact Form 7. Connect once for one-time and subscription payments.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/cn.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/300237","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/cn.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/cn.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/cn.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=300237"}],"author":[{"embeddable":true,"href":"https:\/\/cn.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/wppayments"}],"wp:attachment":[{"href":"https:\/\/cn.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=300237"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/cn.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=300237"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/cn.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=300237"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/cn.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=300237"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/cn.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=300237"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/cn.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=300237"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}