{"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-16T12:35:25","modified_gmt":"2026-06-16T12:35:25","slug":"payments-connect-square","status":"publish","type":"plugin","link":"https:\/\/it.wordpress.org\/plugins\/payments-connect-square\/","author":23480523,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"1.1.4","stable_tag":"1.1.4","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-16 12:35:25","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"","header_author_uri":"","rating":0,"author_block_rating":0,"active_installs":0,"downloads":446,"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"}},"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"],"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":3574502,"resolution":"5","location":"assets","locale":"","width":1024,"height":880},"screenshot-6.png":{"filename":"screenshot-6.png","revision":3574502,"resolution":"6","location":"assets","locale":"","width":423,"height":1024}},"screenshots":{"1":"Payments Square Connect: connect your Square account, choose Sandbox or Live, pick a location, and copy the webhook URL.","2":"Checkout Settings (Beta): manage Apple Pay, Google Pay, Cash App Pay, and other hosted checkout options (Live mode only).","3":"Subscription Plans: view Square catalog variations and copy IDs for CF7 square_subscribe tag or WooCommerce Subscriptions.","4":"WooCommerce: enable the gateway and set checkout title and description under WooCommerce settings.","5":"Contact Form 7: edit a form and add Square payment tags for one-time or subscription checkout.","6":"Square hosted checkout (mobile): buyer payment page on Square after redirect from your store or form."}},"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":"Payments Square Connect: connect your Square account, choose Sandbox or Live, pick a location, and copy the webhook URL."},{"src":"https:\/\/ps.w.org\/payments-connect-square\/assets\/screenshot-2.png?rev=3573573","caption":"Checkout Settings (Beta): manage Apple Pay, Google Pay, Cash App Pay, and other hosted checkout options (Live mode only)."},{"src":"https:\/\/ps.w.org\/payments-connect-square\/assets\/screenshot-3.png?rev=3573573","caption":"Subscription Plans: view Square catalog variations and copy IDs for CF7 square_subscribe tag or WooCommerce Subscriptions."},{"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 under WooCommerce settings."},{"src":"https:\/\/ps.w.org\/payments-connect-square\/assets\/screenshot-5.png?rev=3574502","caption":"Contact Form 7: edit a form and add Square payment tags for one-time or subscription checkout."},{"src":"https:\/\/ps.w.org\/payments-connect-square\/assets\/screenshot-6.png?rev=3574502","caption":"Square hosted checkout (mobile): buyer payment page on Square after redirect from your store or form."}],"raw_content":"<!--section=description-->\n<p><strong>Payments Square Connect<\/strong> lets you accept card and wallet payments through <strong>Square Hosted Checkout<\/strong>. Customers pay on Square's pages (not on your site), then return to your store or form automatically.<\/p>\n\n<p>Connect your Square account <strong>once<\/strong>. After that, WooCommerce checkout, Contact Form 7 forms, and subscription sign-ups all use the same connection \u2014 no duplicate setup.<\/p>\n\n<h4>Getting started in 2 minutes<\/h4>\n\n<p>This short walkthrough covers install \u2192 connect Square \u2192 first payment:<\/p>\n\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>, click <strong>Payments Square Connect<\/strong>, sign in, and save a <strong>Square Location<\/strong>.<\/li>\n<li><strong>Contact Form 7:<\/strong> add <code>[square_pay amount:25.00]<\/code> to a form and submit a test payment.<\/li>\n<li><strong>WooCommerce (optional):<\/strong> enable the gateway under <strong>WooCommerce \u2192 Settings \u2192 Payments<\/strong>.<\/li>\n<\/ol>\n\n<p>See the <strong>Screenshots<\/strong> section below for each admin screen. A video tutorial will be embedded here once published on YouTube.<\/p>\n\n<h4>Quick start<\/h4>\n\n<ol>\n<li>Install and activate the plugin.<\/li>\n<li>Open <strong>Payments Square Connect<\/strong> in the WordPress admin sidebar.<\/li>\n<li>Choose <strong>Sandbox<\/strong> (testing) or <strong>Live<\/strong> (real payments).<\/li>\n<li>Click <strong>Payments Square Connect<\/strong>, sign in with Square, and pick a <strong>Square Location<\/strong>.<\/li>\n<li>Click <strong>Save connection settings<\/strong>.<\/li>\n<li>Turn on the payment method you need (WooCommerce gateway and\/or Contact Form 7 tags \u2014 see below).<\/li>\n<\/ol>\n\n<h4>Where to find settings<\/h4>\n\n<p>Everything is under the top-level menu <strong>Payments Square Connect<\/strong> in the WordPress sidebar:<\/p>\n\n<ul>\n<li><strong>Payments Square Connect<\/strong> \u2014 connect your account, choose Sandbox\/Live, pick a location, copy the webhook URL, and enable debug logging.<\/li>\n<li><strong>Checkout Settings (Beta)<\/strong> \u2014 customize how Square hosted checkout looks and behaves (payment methods, tipping, branding, policies). <strong>Live mode only<\/strong> \u2014 Square does not support this API in Sandbox.<\/li>\n<li><strong>Subscription Plans<\/strong> \u2014 view subscription plan variations from your Square Catalog and copy IDs for forms or WooCommerce products.<\/li>\n<li><strong>Support<\/strong> - report a technical issue (email form), open WhatsApp chat, or visit the WordPress.org support forum.<\/li>\n<\/ul>\n\n<h4>Connect Square (required for all payments)<\/h4>\n\n<p>This is the main setup screen. Every payment flow depends on it.<\/p>\n\n<p><strong>Step-by-step<\/strong><\/p>\n\n<ol>\n<li>Go to <strong>Payments Square Connect \u2192 Payments Square Connect<\/strong>.<\/li>\n<li><strong>Environment<\/strong> \u2014 select <strong>Sandbox<\/strong> while testing, or <strong>Live<\/strong> when you are ready to charge real cards.<\/li>\n<li>Click the <strong>Payments Square Connect<\/strong> button and sign in with your Square seller account.<\/li>\n<li>After a successful login, choose your <strong>Square Location<\/strong> from the dropdown. This location receives payments for WooCommerce orders and Contact Form 7 submissions.<\/li>\n<li><strong>Webhook URL<\/strong> \u2014 copy the URL shown on this page and paste it into your <a href=\"https:\/\/developer.squareup.com\/apps\">Square Developer Dashboard<\/a> webhook settings if you use webhooks for order updates.<\/li>\n<li><strong>Debug Log<\/strong> \u2014 turn on only while troubleshooting; leave off in production.<\/li>\n<li>Click <strong>Save connection settings<\/strong>.<\/li>\n<\/ol>\n\n<p><strong>Tips<\/strong><\/p>\n\n<ul>\n<li>Use <strong>Sandbox<\/strong> first to run test checkouts without moving money.<\/li>\n<li>If you change your site URL, open this page and connect again so OAuth stays valid.<\/li>\n<li><strong>Disconnect Square<\/strong> appears after you are connected if you need to switch accounts.<\/li>\n<\/ul>\n\n<h4>WooCommerce store checkout<\/h4>\n\n<p>WooCommerce is <strong>optional<\/strong>. Install it only if you sell products through a WooCommerce store.<\/p>\n\n<p><strong>Setup<\/strong><\/p>\n\n<ol>\n<li>Complete <strong>Connect Square<\/strong> above (Sandbox or Live + location saved).<\/li>\n<li>Go to <strong>WooCommerce \u2192 Settings \u2192 Payments \u2192 Payments Square Connect<\/strong>.<\/li>\n<li>Check <strong>Enable\/Disable<\/strong> to turn the gateway on.<\/li>\n<li>Set <strong>Title<\/strong> and <strong>Description<\/strong> \u2014 these are what shoppers see on the checkout payment methods list. Example title: \"Pay with Square\".<\/li>\n<li>Save changes.<\/li>\n<\/ol>\n\n<p><strong>How checkout works<\/strong><\/p>\n\n<ul>\n<li>The customer chooses <strong>Payments Square Connect<\/strong> at checkout and places the order.<\/li>\n<li>They are redirected to <strong>Square Hosted Checkout<\/strong> to enter payment details.<\/li>\n<li>After payment, Square sends them back to your <strong>Order received<\/strong> page.<\/li>\n<li>In <strong>Sandbox<\/strong>, a test-mode note is added to the gateway description automatically.<\/li>\n<\/ul>\n\n<p><strong>WooCommerce Subscriptions (optional)<\/strong><\/p>\n\n<p>If you use <strong>WooCommerce Subscriptions<\/strong>:<\/p>\n\n<ol>\n<li>Create subscription plans in your <strong>Square Catalog<\/strong> (Square Dashboard or API).<\/li>\n<li>Open <strong>Payments Square Connect \u2192 Subscription Plans<\/strong> and click <strong>Refresh from Square<\/strong>.<\/li>\n<li>Edit your WooCommerce subscription product \u2192 <strong>General<\/strong> tab.<\/li>\n<li>Choose a <strong>Square subscription plan variation<\/strong> from the dropdown (leave empty for one-time payment).<\/li>\n<li>At checkout, the buyer is sent to Square's <strong>Subscription Plan Checkout<\/strong> instead of a one-time payment link.<\/li>\n<\/ol>\n\n<h4>Contact Form 7 payments<\/h4>\n\n<p>Contact Form 7 is <strong>optional<\/strong>. Install it only if you want to collect payments through forms (donations, fees, registrations, etc.).<\/p>\n\n<p><strong>One-time payment<\/strong><\/p>\n\n<ol>\n<li>Complete <strong>Connect Square<\/strong> above.<\/li>\n<li>Edit your CF7 form and add one of these tags:\n\n<ul>\n<li>Fixed amount: <code>[square_pay amount:25.00]<\/code><\/li>\n<li>Amount from a field: <code>[square_pay amount-field:your-amount]<\/code> (add a number field named <code>your-amount<\/code> in the same form)<\/li>\n<\/ul><\/li>\n<li>Publish the form. When a visitor submits, they are redirected to Square to pay, then returned to the form page with a <strong>success message<\/strong>.<\/li>\n<\/ol>\n\n<p><strong>Subscription signup<\/strong>\n1. Create plan variations in Square Catalog.\n2. Copy a variation ID from <strong>Payments Square Connect \u2192 Subscription Plans<\/strong>.\n3. Add a tag like this to your form: <code>[square_subscribe variation:YOUR_VARIATION_ID name:\"Silver Membership\" amount:15.00]<\/code>\n   * <strong>variation<\/strong> (required) \u2014 Square subscription plan <strong>variation<\/strong> ID, not the parent plan ID.\n   * <strong>name<\/strong> (optional) \u2014 label on the Square checkout page.\n   * <strong>amount<\/strong> (optional) \u2014 should match the price in Square for that variation.\n4. After signup, the visitor returns to the form with a thank-you message.<\/p>\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 all subscription plan variations synced from your Square Catalog.<\/li>\n<li>Click <strong>Refresh from Square<\/strong> after you add or change plans in Square.<\/li>\n<li>Copy <strong>Variation ID<\/strong> values for CF7 <code>[square_subscribe]<\/code> tags or WooCommerce product mapping.<\/li>\n<\/ul>\n\n<p><strong>Square limits to know<\/strong><\/p>\n\n<ul>\n<li>Only variations with one paid phase (or one free trial + one paid phase) work with hosted checkout.<\/li>\n<li>Cash App Pay and Afterpay are not available for subscription checkout.<\/li>\n<\/ul>\n\n<h4>Checkout Settings (Beta)<\/h4>\n\n<p>Open <strong>Payments Square Connect \u2192 Checkout Settings<\/strong> to control Square hosted checkout for payment links created by this plugin.<\/p>\n\n<p><strong>Important:<\/strong> This screen works in <strong>Live mode only<\/strong>. Switch to Live on the Connect screen first; Sandbox shows a notice and fields stay read-only.<\/p>\n\n<p><strong>Merchant settings tab<\/strong><\/p>\n\n<ul>\n<li><strong>Apple Pay<\/strong>, <strong>Google Pay<\/strong>, <strong>Cash App Pay<\/strong> \u2014 enable or disable wallets on hosted checkout.<\/li>\n<li><strong>Afterpay \/ Clearpay<\/strong> \u2014 read-only; enable or disable in the Square Dashboard.<\/li>\n<\/ul>\n\n<p><strong>Location settings tab<\/strong><\/p>\n\n<ul>\n<li><strong>Customer notes<\/strong> \u2014 let buyers leave a note during checkout.<\/li>\n<li><strong>Tipping<\/strong> \u2014 tip percentages, default tip, smart tipping.<\/li>\n<li><strong>Branding<\/strong> \u2014 button color and shape on the Square checkout page.<\/li>\n<li><strong>Policy<\/strong> \u2014 title and description for a policy block on checkout.<\/li>\n<\/ul>\n\n<p>Changes are stored in Square and apply to checkout pages this plugin creates.<\/p>\n\n<h4>Requirements<\/h4>\n\n<ul>\n<li><strong>WordPress<\/strong> 6.0 or later<\/li>\n<li><strong>PHP<\/strong> 7.4 or later<\/li>\n<li><strong>Square seller account<\/strong> (Sandbox for testing, Live for production)<\/li>\n<li><strong>WooCommerce<\/strong> \u2014 optional; required only for store checkout<\/li>\n<li><strong>Contact Form 7<\/strong> \u2014 optional; required only for form-based payments<\/li>\n<li><strong>WooCommerce Subscriptions<\/strong> \u2014 optional; required only to map subscription products to Square plans<\/li>\n<\/ul>\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 (locations, payment links, catalog search, checkout merchant\/location settings), hosted checkout pages, and webhooks.  <\/li>\n<li><strong>When:<\/strong> When an admin uses <strong>Payments Square Connect<\/strong>, when checkout or a CF7 form creates a payment or subscription link, when checkout settings are saved, when subscription plans are refreshed from catalog, and when Square sends webhooks.  <\/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 hosted checkout URLs returned in API responses.  <\/li>\n<li><strong>Data sent:<\/strong> OAuth tokens after connection, order\/form totals and references, subscription plan variation IDs, checkout setting payloads, and webhook payloads as defined by Square.  <\/li>\n<li><strong>Terms:<\/strong> https:\/\/squareup.com\/legal \u2014 review Square's developer and seller terms for your region.<\/li>\n<\/ul><\/li>\n<li><p><strong>WPPayments OAuth relay (required for Payments Square Connect)<\/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>Payments Square Connect<\/strong>.  <\/li>\n<li><strong>Endpoint:<\/strong> <code>https:\/\/shc4wc-square-oauth.wordpress-ingenious.workers.dev<\/code> (override with <code>SHC4WC_OAUTH_WORKER_BASE<\/code> in <code>wp-config.php<\/code> if needed).  <\/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>Payments Square Connect<\/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 card fields on your WordPress site.  <\/li>\n<li><strong>Logging:<\/strong> Optional debug logs may record technical details when debug logging is enabled on <strong>Payments Square Connect<\/strong>; 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<h4>Minimum setup (all sites)<\/h4>\n\n<ol>\n<li>Activate <strong>Payments Square Connect<\/strong>.<\/li>\n<li>In the admin sidebar, open <strong>Payments Square Connect<\/strong>.<\/li>\n<li>Select <strong>Sandbox<\/strong> or <strong>Live<\/strong>.<\/li>\n<li>Click <strong>Payments Square Connect<\/strong>, complete Square sign-in, and select a <strong>Square Location<\/strong>.<\/li>\n<li>Click <strong>Save connection settings<\/strong>.<\/li>\n<\/ol>\n\n<h4>WooCommerce store<\/h4>\n\n<ol>\n<li>Finish minimum setup above.<\/li>\n<li>Go to <strong>WooCommerce \u2192 Settings \u2192 Payments \u2192 Payments Square Connect<\/strong>.<\/li>\n<li>Enable the gateway and set the checkout <strong>Title<\/strong> and <strong>Description<\/strong>.<\/li>\n<li>Save and test a checkout in Sandbox first.<\/li>\n<\/ol>\n\n<h4>Contact Form 7<\/h4>\n\n<ol>\n<li>Finish minimum setup above.<\/li>\n<li>Edit a form and add <code>[square_pay amount:25.00]<\/code> or <code>[square_subscribe variation:ID name:\"Plan\" amount:15.00]<\/code>.<\/li>\n<li>Publish and submit the form to test the redirect to Square.<\/li>\n<\/ol>\n\n<h4>Subscriptions<\/h4>\n\n<ol>\n<li>Create subscription plans in Square Catalog.<\/li>\n<li>Open <strong>Payments Square Connect \u2192 Subscription Plans<\/strong> \u2192 <strong>Refresh from Square<\/strong>.<\/li>\n<li>Use variation IDs in CF7 tags or map them on WooCommerce subscription products.<\/li>\n<\/ol>\n\n<h4>Checkout appearance (Live only)<\/h4>\n\n<ol>\n<li>Switch to <strong>Live<\/strong> on the Connect screen.<\/li>\n<li>Open <strong>Payments Square Connect \u2192 Checkout Settings<\/strong>.<\/li>\n<li>Adjust merchant and location options, then save.<\/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 use Contact Form 7 payments without WooCommerce. WooCommerce is only required if you want to sell through a WooCommerce store checkout.<\/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 CF7. Install CF7 only when you want form-based payments.<\/p><\/dd>\n<dt id=\"where%20is%20the%20main%20settings%20page%3F\"><h3>Where is the main settings page?<\/h3><\/dt>\n<dd><p><strong>Payments Square Connect<\/strong> in the WordPress admin sidebar. Connection, checkout customization, and subscription plan IDs are all under that menu.<\/p><\/dd>\n<dt id=\"what%20is%20the%20difference%20between%20sandbox%20and%20live%3F\"><h3>What is the difference between Sandbox and Live?<\/h3><\/dt>\n<dd><p><strong>Sandbox<\/strong> uses Square's test environment \u2014 no real money moves. <strong>Live<\/strong> charges real cards. Start in Sandbox, then switch to Live when you are ready for production. Checkout Settings only work in Live.<\/p><\/dd>\n<dt id=\"how%20does%20the%20customer%20return%20to%20my%20site%20after%20paying%3F\"><h3>How does the customer return to my site after paying?<\/h3><\/dt>\n<dd><p>Square redirects the buyer back automatically. WooCommerce customers land on the <strong>Order received<\/strong> page. Contact Form 7 visitors return to the same form page with a success message.<\/p><\/dd>\n<dt id=\"can%20i%20accept%20recurring%20subscriptions%3F\"><h3>Can I accept recurring subscriptions?<\/h3><\/dt>\n<dd><p>Yes. Create plans in Square Catalog, then either:<\/p>\n\n<ul>\n<li>Add <code>[square_subscribe]<\/code> to a Contact Form 7 form, or<\/li>\n<li>Map a Square plan variation on a WooCommerce Subscriptions product.<\/li>\n<\/ul>\n\n<p>See <strong>Payments Square Connect \u2192 Subscription Plans<\/strong> for variation IDs and setup notes.<\/p><\/dd>\n<dt id=\"why%20is%20checkout%20settings%20greyed%20out%20or%20showing%20a%20sandbox%20notice%3F\"><h3>Why is Checkout Settings greyed out or showing a Sandbox notice?<\/h3><\/dt>\n<dd><p>Square's Checkout Settings API is not available in Sandbox. Connect in <strong>Live<\/strong> mode to edit payment methods, tipping, branding, and policies.<\/p><\/dd>\n<dt id=\"how%20do%20i%20contact%20support%3F\"><h3>How do I contact support?<\/h3><\/dt>\n<dd><p>Open <strong>Payments Square Connect \u2192 Support<\/strong>. You can send a technical issue by email, start a WhatsApp chat, or post on the <a href=\"https:\/\/wordpress.org\/support\/plugin\/payments-connect-square\/\">WordPress.org support forum<\/a> for the plugin.<\/p><\/dd>\n<dt id=\"where%20do%20i%20get%20the%20webhook%20url%3F\"><h3>Where do I get the webhook URL?<\/h3><\/dt>\n<dd><p>On <strong>Payments Square Connect \u2192 Payments Square Connect<\/strong>. Copy the <strong>Webhook URL<\/strong> and add it in your Square Developer Dashboard if you use webhooks.<\/p><\/dd>\n<dt id=\"is%20card%20data%20stored%20on%20my%20wordpress%20site%3F\"><h3>Is card data stored on my WordPress site?<\/h3><\/dt>\n<dd><p>No. Payment details are entered on <strong>Square Hosted Checkout<\/strong>. Your site never stores card numbers.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>1.1.4<\/h4>\n\n<ul>\n<li>OAuth: request <code>MERCHANT_PROFILE_WRITE<\/code> and <code>PAYMENT_METHODS_READ<\/code> scopes during Square Connect so Checkout Settings (Beta) save calls have required permissions.<\/li>\n<\/ul>\n\n<h4>1.1.3<\/h4>\n\n<ul>\n<li>Fix fatal error after Square OAuth return when saving the connection (undefined settings variable).<\/li>\n<\/ul>\n\n<h4>1.1.2<\/h4>\n\n<ul>\n<li>OAuth: store Worker connection key in a dedicated option so Square Connect works on sites without WooCommerce.<\/li>\n<li>Connect errors: show technical details on the settings screen when <strong>Debug Log<\/strong> is enabled.<\/li>\n<li>Clearer messages when OAuth Worker registration or connection key save fails.<\/li>\n<\/ul>\n\n<h4>1.1.1<\/h4>\n\n<ul>\n<li><strong>Support<\/strong> admin page: technical issue form (email), WhatsApp link, and link to the WordPress.org support forum.<\/li>\n<li>Freemius: hide duplicate <strong>Support Forum<\/strong> submenu entry so support is only under <strong>Payments Square Connect<\/strong>.<\/li>\n<\/ul>\n\n<h4>1.1.0<\/h4>\n\n<ul>\n<li>Top-level admin menu <strong>Payments Square Connect<\/strong> with separate screens: connection settings, Checkout Settings (Beta), and Subscription Plans.<\/li>\n<li><strong>Checkout Settings (Beta):<\/strong> retrieve\/update Square Checkout merchant settings (Apple Pay, Google Pay, Cash App Pay) and location settings (tipping, branding, policies, customer notes) via the Checkout API.<\/li>\n<li><strong>Subscription Plan Checkout:<\/strong> create hosted checkout links for Square subscription plan variations.<\/li>\n<li>Contact Form 7 <code>[square_subscribe]<\/code> form tag for subscription signup flows.<\/li>\n<li>WooCommerce Subscriptions support: map subscription products to Square plan variations; gateway uses subscription checkout when configured.<\/li>\n<li><strong>Subscription Plans<\/strong> admin page lists catalog variations and integration docs.<\/li>\n<li>CF7 payment return: visible success banner on the form page after Square redirect.<\/li>\n<li>WooCommerce and Contact Form 7 are optional; plugin core loads without requiring WooCommerce.<\/li>\n<li>Freemius: auto-resolve clone\/safe-mode for Cloudflare tunnel and local dev hosts when the public URL changes.<\/li>\n<\/ul>\n\n<h4>1.0.9<\/h4>\n\n<ul>\n<li>Permanent OAuth return fix: HMAC-signed return state (no transients) and session-based fallback when Worker drops query parameters after Square redirect.<\/li>\n<\/ul>\n\n<h4>1.0.8<\/h4>\n\n<ul>\n<li>Fix OAuth state validation failed after Square redirect by using a transient return state instead of WP nonces (works across external redirects and tunnel URL changes).<\/li>\n<\/ul>\n\n<h4>1.0.7<\/h4>\n\n<ul>\n<li>Fix Connect failures (invalid_return_url): force HTTPS return URLs and re-register the site with the OAuth Worker when the public site URL changes.<\/li>\n<\/ul>\n\n<h4>1.0.6<\/h4>\n\n<ul>\n<li>Ship default OAuth relay URL so Payments Square Connect 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 (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":"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:\/\/it.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/300237","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/it.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/it.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/it.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=300237"}],"author":[{"embeddable":true,"href":"https:\/\/it.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/wppayments"}],"wp:attachment":[{"href":"https:\/\/it.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=300237"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/it.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=300237"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/it.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=300237"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/it.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=300237"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/it.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=300237"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/it.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=300237"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}