{"id":1445,"date":"2020-11-27T14:47:52","date_gmt":"2020-11-27T21:47:52","guid":{"rendered":"https:\/\/help.foosales.com\/docs\/topics\/payments\/square-integration\/"},"modified":"2025-06-03T16:36:45","modified_gmt":"2025-06-03T22:36:45","slug":"integracion-de-pago-square","status":"publish","type":"docs","link":"https:\/\/help.foosales.com\/es\/docs\/topics\/payments\/square-payment-integration\/","title":{"rendered":"Square Integraci\u00f3n de pagos"},"content":{"rendered":"<div class=\"ast-oembed-container \" style=\"height: 100%;\"><iframe title=\"Square Payments with FooSales\" width=\"500\" height=\"375\" src=\"https:\/\/www.youtube.com\/embed\/PcZV0CiGB-Q?feature=oembed\" frameborder=\"0\" allow=\"accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share\" referrerpolicy=\"strict-origin-when-cross-origin\" allowfullscreen><\/iframe><\/div>\n<p>&nbsp;<\/p>\n<p>FooSales integrates with Square hardware to capture card payments directly within the FooSales apps for a seamless checkout experience. There is no need to synchronize product catalogs between your WooCommerce store and your Square account. Order totals are sent to Square at checkout and after the payment completes successfully, FooSales automatically completes the WooCommerce order.<\/p>\n<p><strong>Note: A <a href=\"https:\/\/www.foosales.com\/pricing\/\" target=\"_blank\" rel=\"noopener\">FooSales Plus<\/a> plan is required for the Square integration.<\/strong><\/p>\n<h2>Quick Links<\/h2>\n<ul>\n<li><a href=\"#requirements\">Requirements<\/a><\/li>\n<li><a href=\"#setup\">Setup<\/a>\n<ul>\n<li><a href=\"#create-new-square-application\">Create New Square Application<\/a><\/li>\n<li><a href=\"#square-sandbox\">Square Sandbox<\/a><\/li>\n<li><a href=\"#ios-integration\">iOS Integration<\/a><\/li>\n<li><a href=\"#android-integration\">Android Integration<\/a><\/li>\n<li><a href=\"#square-terminal-integration\">Square Terminal Integration<\/a><\/li>\n<li><a href=\"#foosales-wordpress-plugin-settings\">FooSales WordPress Plugin Settings<\/a><\/li>\n<\/ul>\n<\/li>\n<li><a href=\"#pairing-square-terminal\">Pairing Square Terminal<\/a><\/li>\n<li><a href=\"#unpairing-square-terminal\">Unpairing Square Terminal<\/a><\/li>\n<li><a href=\"#processing-payments-at-checkout-using-square-terminal\">Processing Payments at Checkout Using Square Terminal<\/a><\/li>\n<li><a href=\"#processing-payments-at-checkout-using-square-reader\">Processing Payments at Checkout Using Square Reader<\/a><\/li>\n<li><a href=\"#manual-card-processing-at-checkout\">Manual Card Processing at Checkout<\/a><\/li>\n<li><a href=\"#refunding-an-order\">Refunding an Order<\/a><\/li>\n<li><a href=\"#capturing-processing-fees\">Capturing Processing Fees<\/a><\/li>\n<\/ul>\n<h2>Requirements<\/h2>\n<p>The following are required for the Square payment integration:<\/p>\n<ul>\n<li style=\"list-style-type: none;\">\n<ul>\n<li>An active <a href=\"https:\/\/www.foosales.com\/pricing\/\" target=\"_blank\" rel=\"noopener\">FooSales Plus<\/a> plan\u00a0OR <a href=\"https:\/\/www.foosales.com\/signup\" target=\"_blank\" rel=\"noopener\">7-day free trial<\/a><\/li>\n<li><a href=\"https:\/\/www.foosales.com\/downloads\/ipad-app\/\" target=\"_blank\" rel=\"noopener\">FooSales iPad<\/a> or <a href=\"https:\/\/www.foosales.com\/downloads\/android-app\/\" target=\"_blank\" rel=\"noopener\">Android tablet<\/a> app installed (version <em>2.2.0+<\/em>) or the <a href=\"https:\/\/web.foosales.com\/\" target=\"_blank\" rel=\"noopener nofollow\">FooSales web app<\/a><\/li>\n<li><a href=\"https:\/\/www.foosales.com\/downloads\/wordpress-plugin\" target=\"_blank\" rel=\"noopener\">FooSales WordPress plugin<\/a> installed (<em>1.17.0+<\/em>)<\/li>\n<li>Apple iPad or Android tablet (Note: Square Stand only works with iPads)<\/li>\n<li><a href=\"https:\/\/squareup.com\/\" target=\"_blank\" rel=\"noopener\">Square account<\/a> where the currency matches the currency of your WooCommerce store<\/li>\n<li>Square Point of Sale app available on the <a href=\"https:\/\/apps.apple.com\/app\/square-point-of-sale-pos\/id335393788\" target=\"_blank\" rel=\"noopener noreferrer nofollow\">App Store<\/a> and <a href=\"https:\/\/play.google.com\/store\/apps\/details?id=com.squareup\" target=\"_blank\" rel=\"noopener noreferrer nofollow\">Play Store<\/a> which must be installed on the <strong>same device<\/strong> as the FooSales app<\/li>\n<li>A supported Square device including <a href=\"https:\/\/squareup.com\/us\/en\/hardware\/stand\" target=\"_blank\" rel=\"noopener\">Square Stand<\/a>, <a href=\"https:\/\/amzn.to\/39oMj8w\" target=\"_blank\" rel=\"noopener nofollow\">Square Terminal<\/a>, <a href=\"https:\/\/squareup.com\/us\/en\/hardware\/reader\" target=\"_blank\" rel=\"noopener noreferrer\">Reader for magstripe<\/a> and <a href=\"https:\/\/squareup.com\/us\/en\/hardware\/contactless-chip-reader\" target=\"_blank\" rel=\"noopener noreferrer\">Reader for contactless and chip<\/a> (<strong>Note:<\/strong> The FooSales web app currently only supports Square Terminal and Square manual card entries.\u00a0Square Register is not compatible with any of the FooSales apps.)<\/li>\n<li><b>Note:<\/b><span style=\"font-weight: 400;\"> Square hardware is currently available to customers in the <strong>US<\/strong>, <strong>Canada<\/strong>, <strong>Australia<\/strong>, <strong>Japan<\/strong>, the <strong>United Kingdom<\/strong>, <strong>Republic of Ireland<\/strong>, <strong>France<\/strong> and <strong>Spain<\/strong>, however, you do not need a reader for <\/span><a href=\"https:\/\/help.foosales.com\/docs\/topics\/payments\/square-payment-integration\/#manual-card-processing-at-checkout\"><span style=\"font-weight: 400;\">manual card entries<\/span><\/a><span style=\"font-weight: 400;\">.<\/span><\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<h2>Setup<\/h2>\n<p>If you plan on integrating FooSales with a <a href=\"https:\/\/squareup.com\/us\/en\/hardware\/stand\" target=\"_blank\" rel=\"noopener\">Square Stand<\/a>, <a href=\"https:\/\/squareup.com\/us\/en\/hardware\/reader\" target=\"_blank\" rel=\"noopener\">Reader for magstripe<\/a> or <a href=\"https:\/\/squareup.com\/us\/en\/hardware\/contactless-chip-reader\" target=\"_blank\" rel=\"noopener\">Reader for contactless and chip<\/a>, please ensure that you have the <strong>Square Point of Sale &amp; Payment<\/strong> app installed on the iPad or Android tablet that you will be using for FooSales.<\/p>\n<ul>\n<li>Download the <a href=\"https:\/\/apps.apple.com\/app\/square-point-of-sale-pos\/id335393788\" target=\"_blank\" rel=\"noopener nofollow\">iOS app for your iPad<\/a><\/li>\n<li>Download the <a href=\"https:\/\/play.google.com\/store\/apps\/details?id=com.squareup\" target=\"_blank\" rel=\"noopener nofollow\">Android app for your tablet<\/a><\/li>\n<\/ul>\n<p>Once you have downloaded and installed the <strong>Square Point of Sale &amp; Payment<\/strong> app on your tablet, log in to the app using your <strong>Square account&#8217;s<\/strong>\u00a0username and password.<\/p>\n<p>In order for FooSales and the Square Point of Sale app to be able to communicate with each other, you will need to <strong>create a new<\/strong> or <strong>update an existing<\/strong> Square application in your <strong>Square Developer Dashboard<\/strong>.<\/p>\n<ul>\n<li><a href=\"#create-new-square-application\">Create New Square Application<\/a><\/li>\n<li><a href=\"#ios-integration\">iOS Integration<\/a><\/li>\n<li><a href=\"#android-integration\">Android Integration<\/a><\/li>\n<li><a href=\"#square-terminal-integration\">Square Terminal Integration<\/a><\/li>\n<li><a href=\"#foosales-wordpress-plugin-settings\">FooSales WordPress Plugin Settings<\/a><\/li>\n<\/ul>\n<h2>Create New Square Application<\/h2>\n<p>Open your <a href=\"https:\/\/developer.squareup.com\/apps\" target=\"_blank\" rel=\"noopener noreferrer nofollow\">Square Developer Dashboard<\/a> and choose <strong>New Application<\/strong>, <strong>Create Your First Application<\/strong> if it is a new account OR <strong>Open<\/strong> a previously created application if one already exists in your account.<\/p>\n<p><img fetchpriority=\"high\" decoding=\"async\" class=\"alignnone wp-image-1452 size-full\" src=\"https:\/\/help.foosales.com\/wp-content\/uploads\/2020\/11\/square_developer_dashboard_create_application.png\" alt=\"\" width=\"1586\" height=\"934\" title=\"\" srcset=\"https:\/\/help.foosales.com\/wp-content\/uploads\/2020\/11\/square_developer_dashboard_create_application.png 1586w, https:\/\/help.foosales.com\/wp-content\/uploads\/2020\/11\/square_developer_dashboard_create_application-300x177.png 300w, https:\/\/help.foosales.com\/wp-content\/uploads\/2020\/11\/square_developer_dashboard_create_application-1024x603.png 1024w, https:\/\/help.foosales.com\/wp-content\/uploads\/2020\/11\/square_developer_dashboard_create_application-768x452.png 768w, https:\/\/help.foosales.com\/wp-content\/uploads\/2020\/11\/square_developer_dashboard_create_application-1536x905.png 1536w\" sizes=\"(max-width: 1586px) 100vw, 1586px\" \/><\/p>\n<p>When creating a <strong>new application<\/strong>, you will need to enter a <strong>name for your application<\/strong> and agree to the <a href=\"https:\/\/squareup.com\/us\/en\/legal\/general\/developers\" target=\"_blank\" rel=\"noopener\">Square Developer terms of service<\/a>.<\/p>\n<p>Next, open your newly created application or existing application. If you created a new application, it will automatically be set to use the latest version of the Square production API. If you are using an existing application, it is recommended that it be set to use the latest version of the Square production API for security and functionality purposes. You can make sure that your application&#8217;s production API version is set to the latest version by scrolling to the bottom of the <strong>Credentials<\/strong> page.<\/p>\n<p><img decoding=\"async\" class=\"alignnone wp-image-54867 size-large\" src=\"https:\/\/help.foosales.com\/wp-content\/uploads\/2020\/11\/square_api_version_2022-06-27-1024x413.png\" alt=\"\" width=\"1024\" height=\"413\" title=\"\" srcset=\"https:\/\/help.foosales.com\/wp-content\/uploads\/2020\/11\/square_api_version_2022-06-27-1024x413.png 1024w, https:\/\/help.foosales.com\/wp-content\/uploads\/2020\/11\/square_api_version_2022-06-27-300x121.png 300w, https:\/\/help.foosales.com\/wp-content\/uploads\/2020\/11\/square_api_version_2022-06-27-768x310.png 768w, https:\/\/help.foosales.com\/wp-content\/uploads\/2020\/11\/square_api_version_2022-06-27-1536x620.png 1536w, https:\/\/help.foosales.com\/wp-content\/uploads\/2020\/11\/square_api_version_2022-06-27.png 1596w\" sizes=\"(max-width: 1024px) 100vw, 1024px\" \/><\/p>\n<p>If you are using an <strong>existing application<\/strong>, already have an integration setup using an older version of the Square production API, and you are worried about breaking your current implementation by changing the API version, then to be safe, we suggest you rather create a new application for your FooSales integration.<\/p>\n<p>By clicking on the <strong>Production<\/strong> tab, you will see your unique <strong>Application ID<\/strong> and <strong>Access Token<\/strong>. You will need to enter these two keys in your <strong>FooSales WordPress plugin settings<\/strong>.<\/p>\n<p><img decoding=\"async\" class=\"alignnone wp-image-1471 size-full\" src=\"https:\/\/help.foosales.com\/wp-content\/uploads\/2020\/11\/square_application_production_credentials.png\" alt=\"\" width=\"1916\" height=\"1258\" title=\"\" srcset=\"https:\/\/help.foosales.com\/wp-content\/uploads\/2020\/11\/square_application_production_credentials.png 1916w, https:\/\/help.foosales.com\/wp-content\/uploads\/2020\/11\/square_application_production_credentials-300x197.png 300w, https:\/\/help.foosales.com\/wp-content\/uploads\/2020\/11\/square_application_production_credentials-1024x672.png 1024w, https:\/\/help.foosales.com\/wp-content\/uploads\/2020\/11\/square_application_production_credentials-768x504.png 768w, https:\/\/help.foosales.com\/wp-content\/uploads\/2020\/11\/square_application_production_credentials-1536x1009.png 1536w\" sizes=\"(max-width: 1916px) 100vw, 1916px\" \/><\/p>\n<p>Next, select the <strong>Point of Sale API<\/strong> menu option and ensure that you still have the <strong>Production<\/strong> tab selected.<\/p>\n<h2>Square Sandbox<\/h2>\n<p>FooSales makes use of the <strong>Square Point of Sale API<\/strong> in order to send payment requests to your Square account.<\/p>\n<p><span style=\"text-decoration: underline;\"><strong>Please note:<\/strong><\/span> The Point of Sale API is not currently supported by the Square Sandbox environment. You can view the current status by selecting the <strong>Sandbox<\/strong> tab on the\u00a0<strong>Point of Sale API<\/strong> page.<\/p>\n<p><img loading=\"lazy\" decoding=\"async\" class=\"alignnone size-large wp-image-54860\" src=\"https:\/\/help.foosales.com\/wp-content\/uploads\/2020\/11\/square_sandbox_not_supported-1024x380.png\" alt=\"\" width=\"1024\" height=\"380\" title=\"\" srcset=\"https:\/\/help.foosales.com\/wp-content\/uploads\/2020\/11\/square_sandbox_not_supported-1024x380.png 1024w, https:\/\/help.foosales.com\/wp-content\/uploads\/2020\/11\/square_sandbox_not_supported-300x111.png 300w, https:\/\/help.foosales.com\/wp-content\/uploads\/2020\/11\/square_sandbox_not_supported-768x285.png 768w, https:\/\/help.foosales.com\/wp-content\/uploads\/2020\/11\/square_sandbox_not_supported-1536x569.png 1536w, https:\/\/help.foosales.com\/wp-content\/uploads\/2020\/11\/square_sandbox_not_supported.png 1716w\" sizes=\"(max-width: 1024px) 100vw, 1024px\" \/><\/p>\n<h2>iOS Integration<\/h2>\n<p>To setup the integration with the<strong> FooSales iPad app<\/strong>, scroll down to the <strong>iOS section<\/strong> on the <strong>Point of Sale API <\/strong>page and enter the following in the <strong>iOS App Bundle IDs<\/strong> input:<\/p>\n<pre>com.foosales.FooSales<\/pre>\n<p>Then enter the following in the\u00a0<strong>iOS App URL Schemes<\/strong> input:<\/p>\n<pre>foosales<\/pre>\n<p><img loading=\"lazy\" decoding=\"async\" class=\"alignnone size-full wp-image-1464\" src=\"https:\/\/help.foosales.com\/wp-content\/uploads\/2020\/11\/square_application_production_ios.png\" alt=\"\" width=\"1284\" height=\"690\" title=\"\" srcset=\"https:\/\/help.foosales.com\/wp-content\/uploads\/2020\/11\/square_application_production_ios.png 1284w, https:\/\/help.foosales.com\/wp-content\/uploads\/2020\/11\/square_application_production_ios-300x161.png 300w, https:\/\/help.foosales.com\/wp-content\/uploads\/2020\/11\/square_application_production_ios-1024x550.png 1024w, https:\/\/help.foosales.com\/wp-content\/uploads\/2020\/11\/square_application_production_ios-768x413.png 768w\" sizes=\"(max-width: 1284px) 100vw, 1284px\" \/><\/p>\n<h2>Android Integration<\/h2>\n<p>To setup the integration with the <strong>FooSales Android tablet app<\/strong>, scroll down to the <strong>Android section <\/strong>on the <strong>Point of Sale API<\/strong> page, click on\u00a0<strong>Add New Android Package<\/strong> and enter the following\u00a0 in the\u00a0<strong>Package Name<\/strong> input:<\/p>\n<pre>com.foosales.FooSales<\/pre>\n<p>Then enter the following in the\u00a0<strong>Fingerprint<\/strong> input:<\/p>\n<pre>A5:54:9F:97:61:4E:D0:FE:7F:AD:12:53:3D:A9:31:D2:2A:E7:53:E6<\/pre>\n<p><img loading=\"lazy\" decoding=\"async\" class=\"alignnone wp-image-54346 size-large\" src=\"https:\/\/help.foosales.com\/wp-content\/uploads\/2020\/11\/foosales_square_android_fingerprint-1024x343.png\" alt=\"\" width=\"1024\" height=\"343\" title=\"\" srcset=\"https:\/\/help.foosales.com\/wp-content\/uploads\/2020\/11\/foosales_square_android_fingerprint-1024x343.png 1024w, https:\/\/help.foosales.com\/wp-content\/uploads\/2020\/11\/foosales_square_android_fingerprint-300x101.png 300w, https:\/\/help.foosales.com\/wp-content\/uploads\/2020\/11\/foosales_square_android_fingerprint-768x257.png 768w, https:\/\/help.foosales.com\/wp-content\/uploads\/2020\/11\/foosales_square_android_fingerprint.png 1468w\" sizes=\"(max-width: 1024px) 100vw, 1024px\" \/><\/p>\n<h2>Square Terminal Integration<\/h2>\n<p>If you plan on integrating FooSales with a <a href=\"https:\/\/amzn.to\/39oMj8w\" target=\"_blank\" rel=\"noopener nofollow\">Square Terminal<\/a>, you will need to add the FooSales webhook to your Square application. From the <strong>Production<\/strong> tab, click on the &#8220;Webhooks&#8221; menu item to expand its submenu. Select the &#8220;Subscriptions&#8221; submenu item to view the <strong>Webhook subscriptions <\/strong>section.<\/p>\n<p><img loading=\"lazy\" decoding=\"async\" class=\"alignnone wp-image-54868 size-large\" src=\"https:\/\/help.foosales.com\/wp-content\/uploads\/2020\/11\/square_webhooks_empty_2022-06-27-1024x455.png\" alt=\"\" width=\"1024\" height=\"455\" title=\"\" srcset=\"https:\/\/help.foosales.com\/wp-content\/uploads\/2020\/11\/square_webhooks_empty_2022-06-27-1024x455.png 1024w, https:\/\/help.foosales.com\/wp-content\/uploads\/2020\/11\/square_webhooks_empty_2022-06-27-300x133.png 300w, https:\/\/help.foosales.com\/wp-content\/uploads\/2020\/11\/square_webhooks_empty_2022-06-27-768x341.png 768w, https:\/\/help.foosales.com\/wp-content\/uploads\/2020\/11\/square_webhooks_empty_2022-06-27.png 1516w\" sizes=\"(max-width: 1024px) 100vw, 1024px\" \/><\/p>\n<p>Click on the &#8220;<strong>Add subscription<\/strong>&#8221; button and enter a name for the webhook such as &#8220;<strong>FooSales Terminal API<\/strong>&#8220;. Enter the webhook URL for <strong>your website<\/strong>\u00a0e.g.:<\/p>\n<pre>[YOUR SITE]\/wp-json\/foosales\/v4\/webhook_square<\/pre>\n<p><img loading=\"lazy\" decoding=\"async\" class=\"alignnone wp-image-54869 size-large\" src=\"https:\/\/help.foosales.com\/wp-content\/uploads\/2020\/11\/square_webhook_name_url_2022-06-27-844x1024.png\" alt=\"\" width=\"844\" height=\"1024\" title=\"\" srcset=\"https:\/\/help.foosales.com\/wp-content\/uploads\/2020\/11\/square_webhook_name_url_2022-06-27-844x1024.png 844w, https:\/\/help.foosales.com\/wp-content\/uploads\/2020\/11\/square_webhook_name_url_2022-06-27-247x300.png 247w, https:\/\/help.foosales.com\/wp-content\/uploads\/2020\/11\/square_webhook_name_url_2022-06-27-768x932.png 768w, https:\/\/help.foosales.com\/wp-content\/uploads\/2020\/11\/square_webhook_name_url_2022-06-27.png 1258w\" sizes=\"(max-width: 844px) 100vw, 844px\" \/><\/p>\n<p>Next, you will need to let Square know which events it needs to send to FooSales by checking each relevant event.<\/p>\n<p>FooSales needs to be notified about the following events:<\/p>\n<ul>\n<li><em>device.code.paired<\/em><\/li>\n<li><em>terminal.checkout.updated<\/em><\/li>\n<li><em>terminal.refund.updated<\/em><\/li>\n<\/ul>\n<p>Once you click the &#8220;<strong>Save<\/strong>&#8221; button, you will see your newly added webhook subscription.<\/p>\n<p><img loading=\"lazy\" decoding=\"async\" class=\"alignnone wp-image-54870 size-large\" src=\"https:\/\/help.foosales.com\/wp-content\/uploads\/2020\/11\/square_webhooks_added_2022-06-27-1024x509.png\" alt=\"\" width=\"1024\" height=\"509\" title=\"\" srcset=\"https:\/\/help.foosales.com\/wp-content\/uploads\/2020\/11\/square_webhooks_added_2022-06-27-1024x509.png 1024w, https:\/\/help.foosales.com\/wp-content\/uploads\/2020\/11\/square_webhooks_added_2022-06-27-300x149.png 300w, https:\/\/help.foosales.com\/wp-content\/uploads\/2020\/11\/square_webhooks_added_2022-06-27-768x381.png 768w, https:\/\/help.foosales.com\/wp-content\/uploads\/2020\/11\/square_webhooks_added_2022-06-27.png 1526w\" sizes=\"(max-width: 1024px) 100vw, 1024px\" \/><\/p>\n<h2>FooSales WordPress Plugin Settings<\/h2>\n<p>After copying your production <strong>Application ID<\/strong> and\u00a0<strong>Access Token<\/strong>, navigate to your <strong>WordPress admin area<\/strong>\u00a0and open the <strong>FooSales plugin settings<\/strong>. Under <strong>Square Integration<\/strong>, paste your\u00a0<strong>Application ID<\/strong> and\u00a0<strong>Access Token<\/strong>, then <strong>save your settings<\/strong> and you&#8217;re good to go!<\/p>\n<p><img loading=\"lazy\" decoding=\"async\" class=\"alignnone wp-image-1518 size-full\" src=\"https:\/\/help.foosales.com\/wp-content\/uploads\/2020\/11\/square_integration_foosales_plugin_settings.png\" alt=\"\" width=\"1404\" height=\"644\" title=\"\" srcset=\"https:\/\/help.foosales.com\/wp-content\/uploads\/2020\/11\/square_integration_foosales_plugin_settings.png 1404w, https:\/\/help.foosales.com\/wp-content\/uploads\/2020\/11\/square_integration_foosales_plugin_settings-300x138.png 300w, https:\/\/help.foosales.com\/wp-content\/uploads\/2020\/11\/square_integration_foosales_plugin_settings-1024x470.png 1024w, https:\/\/help.foosales.com\/wp-content\/uploads\/2020\/11\/square_integration_foosales_plugin_settings-768x352.png 768w\" sizes=\"(max-width: 1404px) 100vw, 1404px\" \/><\/p>\n<h2>Pairing Square Terminal<\/h2>\n<p>In order to process a payment at checkout using a <a href=\"https:\/\/amzn.to\/39oMj8w\" target=\"_blank\" rel=\"noopener nofollow\">Square Terminal<\/a>, you will need to pair a Terminal device with FooSales.<\/p>\n<p><strong>Please note<\/strong> that this is not necessary when using FooSales with a <a href=\"https:\/\/squareup.com\/us\/en\/hardware\/stand\" target=\"_blank\" rel=\"noopener\">Square Stand<\/a>, <a href=\"https:\/\/squareup.com\/us\/en\/hardware\/reader\" target=\"_blank\" rel=\"noopener\">Reader for magstripe<\/a> or <a href=\"https:\/\/squareup.com\/us\/en\/hardware\/contactless-chip-reader\" target=\"_blank\" rel=\"noopener\">Reader for contactless and chip<\/a>, as FooSales will simply send a payment request to the Square Point of Sale &amp; Payment app installed on the same tablet when using these devices.<\/p>\n<p>In order to pair a Terminal device with FooSales, open the <strong>FooSales Settings<\/strong> screen and scroll down to <strong>Square Settings<\/strong>. Here you can select which Square location should be associated with the device that the FooSales app is running on. For instructions on how to setup more than one Square location, please read the <a href=\"https:\/\/squareup.com\/help\/us\/en\/article\/5580-manage-multiple-locations-with-square\" target=\"_blank\" rel=\"noopener\">Manage Multiple Locations with Square<\/a> help documentation.<\/p>\n<p><img loading=\"lazy\" decoding=\"async\" class=\"alignnone size-large wp-image-53822\" src=\"https:\/\/help.foosales.com\/wp-content\/uploads\/2021\/03\/fs_settings_square_location-1024x416.png\" alt=\"\" width=\"1024\" height=\"416\" title=\"\" srcset=\"https:\/\/help.foosales.com\/wp-content\/uploads\/2021\/03\/fs_settings_square_location-1024x416.png 1024w, https:\/\/help.foosales.com\/wp-content\/uploads\/2021\/03\/fs_settings_square_location-300x122.png 300w, https:\/\/help.foosales.com\/wp-content\/uploads\/2021\/03\/fs_settings_square_location-768x312.png 768w, https:\/\/help.foosales.com\/wp-content\/uploads\/2021\/03\/fs_settings_square_location.png 1250w\" sizes=\"(max-width: 1024px) 100vw, 1024px\" \/><\/p>\n<p>Next, you will first need to sign into the Terminal using a <strong>device code<\/strong> that will be generated in <strong>FooSales<\/strong>. Click on the &#8220;<strong>Generate Code<\/strong>&#8221; button to generate a new device code. Once the code has been generated, you will only have <strong>5 minutes<\/strong> to sign into the Terminal before the device code expires, in which case, you will need to generate a new code and re-attempt the pairing process.<\/p>\n<p><img loading=\"lazy\" decoding=\"async\" class=\"alignnone size-large wp-image-53828\" src=\"https:\/\/help.foosales.com\/wp-content\/uploads\/2021\/03\/fs_settings_square_device_code-1024x432.png\" alt=\"\" width=\"1024\" height=\"432\" title=\"\" srcset=\"https:\/\/help.foosales.com\/wp-content\/uploads\/2021\/03\/fs_settings_square_device_code-1024x432.png 1024w, https:\/\/help.foosales.com\/wp-content\/uploads\/2021\/03\/fs_settings_square_device_code-300x127.png 300w, https:\/\/help.foosales.com\/wp-content\/uploads\/2021\/03\/fs_settings_square_device_code-768x324.png 768w, https:\/\/help.foosales.com\/wp-content\/uploads\/2021\/03\/fs_settings_square_device_code-1536x649.png 1536w, https:\/\/help.foosales.com\/wp-content\/uploads\/2021\/03\/fs_settings_square_device_code-2048x865.png 2048w\" sizes=\"(max-width: 1024px) 100vw, 1024px\" \/><\/p>\n<p>Once you enter the device code and the Terminal has loaded, the <strong>Square Settings<\/strong> in the FooSales app will update to show that it has paired with the device successfully.<\/p>\n<p><img loading=\"lazy\" decoding=\"async\" class=\"alignnone size-large wp-image-53826\" src=\"https:\/\/help.foosales.com\/wp-content\/uploads\/2021\/03\/fs_settings_square_device_paired-1024x437.png\" alt=\"\" width=\"1024\" height=\"437\" title=\"\" srcset=\"https:\/\/help.foosales.com\/wp-content\/uploads\/2021\/03\/fs_settings_square_device_paired-1024x437.png 1024w, https:\/\/help.foosales.com\/wp-content\/uploads\/2021\/03\/fs_settings_square_device_paired-300x128.png 300w, https:\/\/help.foosales.com\/wp-content\/uploads\/2021\/03\/fs_settings_square_device_paired-768x328.png 768w, https:\/\/help.foosales.com\/wp-content\/uploads\/2021\/03\/fs_settings_square_device_paired.png 1208w\" sizes=\"(max-width: 1024px) 100vw, 1024px\" \/><\/p>\n<p>After successfully pairing a device, FooSales will remember the unique device identifier when capturing payments until the device is specifically <strong>unpaired<\/strong>. This means that you can pair the same device to multiple FooSales apps by following the instructions above.<\/p>\n<p>In order to enter a new device code on the Square Terminal which was generated by a different FooSales app, you must sign-out of the paired device while leaving the FooSales app in its <strong>paired<\/strong> state. To <strong>sign-out<\/strong> of the paired <strong>Square Terminal<\/strong>, swipe on the device from the far left side of the screen to display the slide-out menu, tap <strong>Settings<\/strong> and then tap the <strong>Sign Out<\/strong> button which will return the device to the login screen. You can then choose to sign-in again using the new device code.<\/p>\n<h2>Unpairing Square Terminal<\/h2>\n<p>If FooSales is paired with a specific Square Terminal and you would like to pair it with a different device or change the Square location that FooSales is associating with the paired device, you will first need to tap the <strong>Unpair<\/strong> button to unpair the device in order to choose a different location and generate a new device code. To <strong>sign-out<\/strong> of the paired <strong>Square Terminal<\/strong>, swipe on the device from the far left side of the screen to show the slide-out menu, tap <strong>Settings<\/strong> and then tap the <strong>Sign Out<\/strong> button which will return the device to the login screen. You can then sign-in again using a newly generated device code.<\/p>\n<h2>Processing Payments at Checkout Using Square Terminal<\/h2>\n<p>When you&#8217;re ready to complete an order on the <strong>Checkout <\/strong>screen in FooSales using a paired <strong>Square Terminal<\/strong>, select <strong>Square Terminal Payment<\/strong> as the payment method.<\/p>\n<p><img loading=\"lazy\" decoding=\"async\" class=\"alignnone wp-image-55106 size-large\" src=\"https:\/\/help.foosales.com\/wp-content\/uploads\/2020\/11\/IMG_1184-1024x690.jpg\" alt=\"Screenshot of FooSales checkout using the Square Terminal card reader payment method\" width=\"1024\" height=\"690\" title=\"\" srcset=\"https:\/\/help.foosales.com\/wp-content\/uploads\/2020\/11\/IMG_1184-1024x690.jpg 1024w, https:\/\/help.foosales.com\/wp-content\/uploads\/2020\/11\/IMG_1184-300x202.jpg 300w, https:\/\/help.foosales.com\/wp-content\/uploads\/2020\/11\/IMG_1184-768x518.jpg 768w, https:\/\/help.foosales.com\/wp-content\/uploads\/2020\/11\/IMG_1184.jpg 1528w\" sizes=\"(max-width: 1024px) 100vw, 1024px\" \/><\/p>\n<p>When you click the <strong>Pay button<\/strong>, a checkout request will be sent to your paired <strong>Square Terminal<\/strong>. Follow the prompts on the Square Terminal in order to process the payment. The FooSales app will wait until the checkout is successfully completed.<\/p>\n<p><img loading=\"lazy\" decoding=\"async\" class=\"alignnone size-large wp-image-53833\" src=\"https:\/\/help.foosales.com\/wp-content\/uploads\/2021\/03\/square_terminal_checkout_wait-1024x379.png\" alt=\"\" width=\"1024\" height=\"379\" title=\"\" srcset=\"https:\/\/help.foosales.com\/wp-content\/uploads\/2021\/03\/square_terminal_checkout_wait-1024x379.png 1024w, https:\/\/help.foosales.com\/wp-content\/uploads\/2021\/03\/square_terminal_checkout_wait-300x111.png 300w, https:\/\/help.foosales.com\/wp-content\/uploads\/2021\/03\/square_terminal_checkout_wait-768x284.png 768w, https:\/\/help.foosales.com\/wp-content\/uploads\/2021\/03\/square_terminal_checkout_wait-1536x569.png 1536w, https:\/\/help.foosales.com\/wp-content\/uploads\/2021\/03\/square_terminal_checkout_wait-2048x758.png 2048w\" sizes=\"(max-width: 1024px) 100vw, 1024px\" \/><\/p>\n<p>Once the payment has been successfully completed, FooSales will submit the order to your WooCommerce database.<\/p>\n<h2>Processing Payments at Checkout Using Square Reader<\/h2>\n<p>When you&#8217;re ready to complete an order on the <strong>Checkout <\/strong>screen in the FooSales app using a <strong>Square Reader<\/strong>, select <strong>Square Reader Payment<\/strong> as the payment method. The FooSales web app only supports manual credit card entries and Square Terminal payments at present so you would need to select <strong>Square Manual Payment<\/strong> or <strong>Square Terminal Payment<\/strong> as the payment method.<\/p>\n<p><img loading=\"lazy\" decoding=\"async\" class=\"alignnone wp-image-55107 size-full\" src=\"https:\/\/help.foosales.com\/wp-content\/uploads\/2020\/11\/square-reader.png\" alt=\"Square reader payment method\" width=\"1000\" height=\"674\" title=\"\" srcset=\"https:\/\/help.foosales.com\/wp-content\/uploads\/2020\/11\/square-reader.png 1000w, https:\/\/help.foosales.com\/wp-content\/uploads\/2020\/11\/square-reader-300x202.png 300w, https:\/\/help.foosales.com\/wp-content\/uploads\/2020\/11\/square-reader-768x518.png 768w\" sizes=\"(max-width: 1000px) 100vw, 1000px\" \/><\/p>\n<p>Tapping the <strong>Pay button<\/strong> will open a <strong>Square payment screen<\/strong> which includes the order total from the checkout screen. You can now process the card payment using your Square hardware as you normally would or manually enter the card details in the case of the web app.<\/p>\n<p><img loading=\"lazy\" decoding=\"async\" class=\"alignnone size-full wp-image-1478\" src=\"https:\/\/help.foosales.com\/wp-content\/uploads\/2020\/11\/square_integration_process_card.png\" alt=\"\" width=\"1280\" height=\"960\" title=\"\" srcset=\"https:\/\/help.foosales.com\/wp-content\/uploads\/2020\/11\/square_integration_process_card.png 1280w, https:\/\/help.foosales.com\/wp-content\/uploads\/2020\/11\/square_integration_process_card-300x225.png 300w, https:\/\/help.foosales.com\/wp-content\/uploads\/2020\/11\/square_integration_process_card-1024x768.png 1024w, https:\/\/help.foosales.com\/wp-content\/uploads\/2020\/11\/square_integration_process_card-768x576.png 768w\" sizes=\"(max-width: 1280px) 100vw, 1280px\" \/><\/p>\n<p>Once the payment is successfully completed, you will be returned to the FooSales app and the order will get submitted and marked as <strong>Completed<\/strong> in your WooCommerce store. The Square transaction will be linked to your WooCommerce order. If you open the completed order on the\u00a0<strong>Orders<\/strong> screen, you will see the payment method highlighted if Square was used to process the payment. Tapping on this text will open the linked Square transaction in a browser window for your convenience.<\/p>\n<p>If you navigate to the <strong>WooCommerce Order<\/strong> in your <strong>WordPress admin area<\/strong>, you will see the payment method marked as <strong>Square<\/strong> along with a link to <strong>View the transaction<\/strong> in a new browser tab.<\/p>\n<p><img loading=\"lazy\" decoding=\"async\" class=\"alignnone size-full wp-image-1480\" src=\"https:\/\/help.foosales.com\/wp-content\/uploads\/2020\/11\/square_integration_woocommerce_order.png\" alt=\"\" width=\"1280\" height=\"1012\" title=\"\" srcset=\"https:\/\/help.foosales.com\/wp-content\/uploads\/2020\/11\/square_integration_woocommerce_order.png 1280w, https:\/\/help.foosales.com\/wp-content\/uploads\/2020\/11\/square_integration_woocommerce_order-300x237.png 300w, https:\/\/help.foosales.com\/wp-content\/uploads\/2020\/11\/square_integration_woocommerce_order-1024x810.png 1024w, https:\/\/help.foosales.com\/wp-content\/uploads\/2020\/11\/square_integration_woocommerce_order-768x607.png 768w\" sizes=\"(max-width: 1280px) 100vw, 1280px\" \/><\/p>\n<h2>Manual Card Processing at Checkout<\/h2>\n<p>If you do not have a Square Reader device or in an emergency, you can still enter the customer&#8217;s card details manually at checkout in order to process an order payment. Select <strong>Square Manual Payment<\/strong> as the payment method.<\/p>\n<p>When you click the <strong>Pay button<\/strong>, a form will appear that allows you to enter the card number, expiry date and CVC in order to process the payment. Once the payment has been successfully submitted, FooSales will complete the order and submit it to your WooCommerce store.<\/p>\n<p><img loading=\"lazy\" decoding=\"async\" class=\"alignnone size-large wp-image-54177\" src=\"https:\/\/help.foosales.com\/wp-content\/uploads\/2020\/11\/square_manual_card_form-1024x682.png\" alt=\"\" width=\"1024\" height=\"682\" title=\"\" srcset=\"https:\/\/help.foosales.com\/wp-content\/uploads\/2020\/11\/square_manual_card_form-1024x682.png 1024w, https:\/\/help.foosales.com\/wp-content\/uploads\/2020\/11\/square_manual_card_form-300x200.png 300w, https:\/\/help.foosales.com\/wp-content\/uploads\/2020\/11\/square_manual_card_form-768x512.png 768w, https:\/\/help.foosales.com\/wp-content\/uploads\/2020\/11\/square_manual_card_form.png 1378w\" sizes=\"(max-width: 1024px) 100vw, 1024px\" \/><\/p>\n<h2>Refunding an Order<\/h2>\n<p>If you entered your <strong>Square Access Token<\/strong> in your <strong>FooSales WordPress plugin<\/strong> settings and you refund an order in FooSales, the Square transaction will be automatically refunded to the card that originally made the payment. If the transaction contained <strong>split tenders<\/strong> or the <strong>refund failed<\/strong> for some unknown reason, the order status is changed to <strong>Refunded<\/strong> in WooCommerce and an <strong>error message<\/strong> is displayed that allows you to view the transaction and refund the payment manually through your Square account.<\/p>\n<p><span style=\"text-decoration: underline;\"><strong>Please note:<\/strong><\/span> Refunding an order that was originally placed online (ie. not through FooSales) or manually through the <strong>WooCommerce<\/strong> back-end <span style=\"text-decoration: underline;\">will not<\/span> automatically refund the <strong>Square payment<\/strong>. If you would like to refund an order from your <strong>WordPress admin area <\/strong>instead of <strong>FooSales<\/strong> or if you would like to refund an order in FooSales that was originally placed online, you will need to click on the <strong>View transaction<\/strong> link in the <strong>order view<\/strong> to open and manually refund the payment through your <strong>Square Dashboard<\/strong> and then set the <strong>WooCommerce order status<\/strong> to <strong>Refunded<\/strong>.<\/p>\n<p>If you originally processed the payment on a paired <strong>Square Terminal<\/strong> and the original card needs to be presented such as with an Interac debit card, a refund request will be sent to the paired <strong>Square Terminal<\/strong> and the <strong>FooSales app<\/strong> will wait until the refund is successfully completed.<\/p>\n<p><img loading=\"lazy\" decoding=\"async\" class=\"alignnone size-large wp-image-53835\" src=\"https:\/\/help.foosales.com\/wp-content\/uploads\/2021\/03\/square_terminal_refund-1024x379.png\" alt=\"\" width=\"1024\" height=\"379\" title=\"\" srcset=\"https:\/\/help.foosales.com\/wp-content\/uploads\/2021\/03\/square_terminal_refund-1024x379.png 1024w, https:\/\/help.foosales.com\/wp-content\/uploads\/2021\/03\/square_terminal_refund-300x111.png 300w, https:\/\/help.foosales.com\/wp-content\/uploads\/2021\/03\/square_terminal_refund-768x284.png 768w, https:\/\/help.foosales.com\/wp-content\/uploads\/2021\/03\/square_terminal_refund-1536x569.png 1536w, https:\/\/help.foosales.com\/wp-content\/uploads\/2021\/03\/square_terminal_refund-2048x758.png 2048w\" sizes=\"(max-width: 1024px) 100vw, 1024px\" \/><\/p>\n<p>If you originally processed the payment using a\u00a0<strong>Square Reader<\/strong> in the iOS or Android app and the original card needs to be presented such as with an Interac debit card, the refund will need to be done directly in the <strong>Square Point of Sale<\/strong> app on the tablet, not within the FooSales app.<\/p>\n<h2>Capturing Processing Fees<\/h2>\n<p>If you&#8217;re using a third-party export plugin to export your orders and you&#8217;re processing payments with Square, you might want to include the fees that Square deducts from the payment in your sales export. FooSales automatically adds these fees as hidden meta data with the key <em>_foosales_square_fee_amount <\/em>to the order as well as individual POS Payments when using the split payment functionality. When charging multiple split payments within an order using Square as the payment method, each split payment will receive as hidden meta data the corresponding processing fee using the same <em>_foosales_square_fee_amount<\/em> meta data key. The order&#8217;s meta data value for <em>_foosales_square_fee_amount<\/em><em>\u00a0<\/em>will be the sum of all the individual split payments&#8217; Square processing fees to give you the total amount Square deducted from the order as processing fee.<\/p>\n","protected":false},"featured_media":0,"parent":31,"menu_order":1,"comment_status":"closed","ping_status":"closed","template":"","meta":{"site-sidebar-layout":"default","site-content-layout":"default","ast-site-content-layout":"default","site-content-style":"default","site-sidebar-style":"default","ast-global-header-display":"","ast-banner-title-visibility":"","ast-main-header-display":"","ast-hfb-above-header-display":"","ast-hfb-below-header-display":"","ast-hfb-mobile-header-display":"","site-post-title":"","ast-breadcrumbs-content":"","ast-featured-img":"","footer-sml-layout":"","ast-disable-related-posts":"","theme-transparent-header-meta":"default","adv-header-id-meta":"","stick-header-meta":"default","header-above-stick-meta":"","header-main-stick-meta":"","header-below-stick-meta":"","astra-migrate-meta-layouts":"set","ast-page-background-enabled":"default","ast-page-background-meta":{"desktop":{"background-color":"","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"tablet":{"background-color":"","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"mobile":{"background-color":"","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""}},"ast-content-background-meta":{"desktop":{"background-color":"var(--ast-global-color-5)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"tablet":{"background-color":"var(--ast-global-color-5)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"mobile":{"background-color":"var(--ast-global-color-5)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""}},"footnotes":""},"doc_tag":[154,26,98,250,153,69,220,251,10,12,25,218,212,217,71,65,151,301,150,152,203,219,16],"class_list":["post-1445","docs","type-docs","status-publish","hentry","doc_tag-access-token","doc_tag-android-app","doc_tag-api","doc_tag-apple-pay","doc_tag-application-id","doc_tag-checkout","doc_tag-device-code","doc_tag-google-pay","doc_tag-hardware","doc_tag-integration","doc_tag-ipad-app","doc_tag-location","doc_tag-manual","doc_tag-pair","doc_tag-payment-processing","doc_tag-payments","doc_tag-reader","doc_tag-sandbox","doc_tag-square","doc_tag-stand","doc_tag-terminal","doc_tag-unpair","doc_tag-web-app"],"comment_count":0,"_links":{"self":[{"href":"https:\/\/help.foosales.com\/es\/wp-json\/wp\/v2\/docs\/1445","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/help.foosales.com\/es\/wp-json\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/help.foosales.com\/es\/wp-json\/wp\/v2\/types\/docs"}],"replies":[{"embeddable":true,"href":"https:\/\/help.foosales.com\/es\/wp-json\/wp\/v2\/comments?post=1445"}],"version-history":[{"count":0,"href":"https:\/\/help.foosales.com\/es\/wp-json\/wp\/v2\/docs\/1445\/revisions"}],"up":[{"embeddable":true,"href":"https:\/\/help.foosales.com\/es\/wp-json\/wp\/v2\/docs\/31"}],"next":[{"title":"Stripe Integraci\u00f3n de pagos","link":"https:\/\/help.foosales.com\/es\/docs\/topics\/payments\/stripe-payment-integration\/","href":"https:\/\/help.foosales.com\/es\/wp-json\/wp\/v2\/docs\/54115"}],"prev":[{"title":"Pagos fraccionados","link":"https:\/\/help.foosales.com\/es\/docs\/topics\/payments\/split-payments\/","href":"https:\/\/help.foosales.com\/es\/wp-json\/wp\/v2\/docs\/55251"}],"wp:attachment":[{"href":"https:\/\/help.foosales.com\/es\/wp-json\/wp\/v2\/media?parent=1445"}],"wp:term":[{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/help.foosales.com\/es\/wp-json\/wp\/v2\/doc_tag?post=1445"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}