WooCommerce Square

WooCommerce Square provides seamless integration between your Square account and WooCommerce store, allowing you to synchronize inventory on both, and offer Square as a payment option.

WooCommerce Square requires Square accounts that are based in the U.S., Canada, Australia, Japan or the UK.

Requirements ↑ Back to top

  • WooCommerce 2.6.0+
  • PHP version 5.3+
  • WordPress 4.4+
  • Square account
  • An SSL Certificate
  • A location needs to be setup in your Square account

Syncing products with WooCommerce Square requires that you have SKUs assigned to all products, including each product variation (if applicable).

Please note that there are currently compatibility issues between this plugin and sites hosted on 1&1 hosting. While not all 1&1 sites are impacted, most users will be unable to use this plugin due to the configurations of their hosting environment. 1&1 Hosting has acknowledge the issue on their end, however we have no updates if this will be fixed or not.

Installation ↑ Back to top

  1. Download the .zip file from your WooCommerce account.
  2. Go to: WordPress Admin > Plugins > Add New to upload the file you downloaded with Choose File.
  3. Activate the extension.

Setup and Configuration ↑ Back to top

WooCommerce Square Sync Settings ↑ Back to top

square settings

  1. Go toWooCommerce > Settings > Integration > Square.

  2. Connect/Disconnect: First Connect your Square account with our application to initiate sync.

  1. Select Business Location: Set the location of your store to match the location on Square.

  2. Enter your Notification Email(s): Use one or several email addresses to be notified when a sync is complete.

  3. Tick the Log Debug Messages checkbox: Useful for troubleshooting issues with the sync process. View logs at: WooCommerce > System Status > Logs and select the log that starts with woocommerce_square_sync.

woo-square-sync-setting
6. Select Enabled: This is the master switch for product syncing. If disabled, no items will sync.

  1. Include Categories: Enabling will sync your product categories.

  2. Include Inventory: Enabling will sync your product inventory.

  3. Include Images: Enabling will sync your product images.

  4. Square Inventory Sync: Enabling will auto-sync Square to WooCommerce.

  5. Save changes.

    For syncing to function correctly, you must do a one-time initial bulk sync — from WooCommerce to Square or Square to WooCommerce. This will provide the initial “link up” between the two platforms.

Per Product Sync Settings

You can choose to disable syncing for any particular product by checking the “disable sync” checkbox. This will disable all syncing functionalities both ways.
woosquare-product-syncing

Square Payment Gateway Settings ↑ Back to top

Should you wish to use and offer Square as a payment option, it needs to be set up.

woosquare-payment-settings

  1. Go to: WooCommerce > Settings > Checkout > Square.

  2. Enable/Disable: Tick the checkbox if you wish to use Square as a payment option.

  3. Enter a Title: Displayed to customers during checkout.

  4. Enter a Description

  5. Delay Capture: Allows you to pre-authorize a charge and not capture it until later. This is useful if you wish to take payment only when shipping goods. On WooCommerce, choose to: a) Capture an authorization by marking the order Processing or Completed; or b) void the authorization by canceling the order. Captures must be completed within six days.

  6. Create Customer (optional): Create a customer profile on Square when a customer checks out on your WooCommerce store.

7. Tick the Log Debug Messages checkbox: Useful for troubleshooting issues with the sync process. View logs at: WooCommerce > System Status > Logs and select the log that starts with woocommerce_square_sync.

  1. Save changes.

Here’s what the payment option looks like for customers:

woosquare-payment-form

WooCommerce Square does not currently have a sandbox mode for testing purposes.

Troubleshooting ↑ Back to top

Why is it taking so long to sync? ↑ Back to top

If you have many products on Square, it needs to loop through all of them and process each one separately. This takes time. If you set up the notification email, you can step away and come back when it’s done.

Why are some/all products not syncing? ↑ Back to top

Be sure you have SKUs set on both your products on WooCommerce site and your Square POS and that you have done an initial bulk sync.

Why are my product categories not syncing correctly? ↑ Back to top

Because WooCommerce and Square handle product categories very differently.

  • WooCommerce allows multiple categories to be assigned to one product while Square only allows one.

So if you’re syncing from Square to WooCommerce, that product will be updated to just one that is set in Square. If you have multiple categories and you’re syncing from WooCommerce to Square, it will pick the parent/and or the top most category to use. Because of this limitation on Square, our plugin has to follow suit.

My product description is not syncing to my WooCommerce store. ↑ Back to top

This is by design.

  • Because WooCommerce accepts/allows rich HTML content and Square does not.

So if you sync’d from Square to WooCommerce and your WooCommerce product had HTML content, all HTML would be stripped away leaving only plain text. This is not the result you would want. However, you can sync from WooCommerce to Square and any HTML content will be stripped before saving to Square as they don’t allow HTML content. But if you are only using plain text product description and you would still like to sync both ways, there is a filter you can use. Place the following code into your child theme’s functions.php file. Please take care when editing code. Always make a backup of your site first.

add_filter( 'woocommerce_square_sync_from_square_description', '__return_true' );

My variations are not syncing properly. ↑ Back to top

Because WooCommerce and Square handles product variations very differently.

  • Square has single level variations where WooCommerce can have multilevel variations.

So if you only have single level variations on the WooCommerce side (only one attribute) everything will sync to Square just fine. However, if you need to use multiple attributes you need to use a workaround. For example, if you have Color and Size (two attributes). Then you need to combine them into one attribute, for example, Black Small, Black Medium and Black Large as the three variations. This way when syncing over to Square, it will generate the variations correctly.

Nothing is Syncing and I am seeing this error “PHP Deprecated: Automatically populating $HTTP_RAW_POST_DATA is deprecated and will be removed in a future version.” in my PHP error log. ↑ Back to top

Add the following into your PHP.ini file. “always_populate_raw_post_data = -1” ( no quotes ). You can ask your host to do this for you.

Why do I not see the Square payment on the checkout page? ↑ Back to top

Make sure you have SSL installed on your site and is active on the checkout page.

I am testing a purchase with Square Payment but it failed! Why? ↑ Back to top

Make sure you’re testing with a dollar amount that is greater than $1.00.

Why do my Square reports not show order information? ↑ Back to top

Currently, Square’s API does not support sending detailed transaction information. At this time, they are only able to capture the order number and the order total on transactions sent to them. Because of this, transactions will show up in your Square account as an uncategorized “Custom Amount.”

Why are my product images in WooCommerce not updating after I change them in Square? ↑ Back to top

This is intentional and due to the way Square handles product images. Once a product image has been imported from Square, any changes to that image in Square will need to be manually recreated in WooCommerce. You can do this by editing the item within WooCommerce and uploading your new product image. Please note that if you update your product images from within WooCommerce, instead of Square, you don’t have to worry about this – as WooCommerce will automatically update the new product image to your Square account.

The reason for this is because Square saves all product images with the same filename. This means even though you may have updated the product image in Square, that image file will have the same name as it did before. Because of this, there is no way for your WooCommerce site to know if the product image is different when a sync is performed. If we were to import the image with every sync, it would cause file duplications in your media library.

Why do my products not have SKUs after importing from Square? ↑ Back to top

If your products do not have SKU’s or are not showing as for sale on your site, check the product in Square to ensure it does not have extra blank variations. Log into your Square dashboard and click on the item that is causing the problem. Make sure that the only blank variation line is the very last line. If there are any other blank variation lines, you will need to delete them using the “X” symbol to the right. Once you are done removing any blank variations, save your changes. Now go back to your WooCommerce site and manually edit the product to remove any blank variations that were brought in with your sync. The next time that your Square account syncs to WooCommerce, the issue will be corrected.

The hourly “Square Inventory Sync” isn’t updating my products or adding new ones? ↑ Back to top

The automated hourly “Square Inventory Sync” will only update the inventory of items that have already been synced between Square and your WooCommerce site. It is not able to add new items to WooCommerce, nor is it able to update the price or description of existing items. If you have new items in Square that are not in WooCommerce, or if you want the price, item name, or image in WooCommerce to be updated using Square; you will need to perform a manual Square to WooCommerce sync. This can be done by using the “Square > WC” button on the WooCommerce > Settings > Integration tab.

Because of this, we recommend using WooCommerce to manage all of your product changes or additions, as changes made in WooCommerce are automatically sent to Square and do not require a manual sync.

FAQ ↑ Back to top

Do I need to set SKUs for all products? ↑ Back to top

Yes, you must set SKUs for syncing to work properly. The SKU is a unique value in both WooCommerce and Square, so it is used to ‘match’ items between the two platforms.

How does Square automatically sync inventory to my WooCommerce store? ↑ Back to top

From the time you activate the plugin, a scheduled event automatically polls the inventory from Square and updates your WooCommerce on an hourly basis.

I have multiple Square locations. Why am I only able to use one location per WooCommerce store? ↑ Back to top

This is typical with integrations. However, in discussion with Square, this may be added in the future.

Why is auto-sync only available for inventory from Square to WooCommerce? ↑ Back to top

This is a Square limitation, not because WooCommerce is unable to offer this feature and functionality.

Does Square payments work in countries other than the U.S., Canada, Australia, Japan and the UK? ↑ Back to top

Not at this time. Options for other countries can be found at: WooCommerce Payment Gateways.

Does this support Subscriptions? ↑ Back to top

Not at this time. These gateways do: Subscription Payment Methods and Gateways.

How are Sale prices handled? ↑ Back to top

Square does not support having a regular and sale price for items. When you set a sale price for an item in WooCommerce, the price will also be updated in your Square account. Once the sale price is removed from the item in WooCommerce, your Square item will be updated with the regular price again.

Sync process passes the current product prices. Therefore, when syncing products, make sure there are no active discounts (via WooCommerce Memberships or any other discount plugin) for the logged-in user otherwise discounted prices will be synced and used for all users. To avoid this, login using a normal admin user which has no discount rules applied to it.

Is there a maximum length for my product descriptions? ↑ Back to top

Square has an undocumented 4095 character limit on item descriptions. If someone is having trouble with items syncing and the descriptions are very long, double-check this.

Why is my sync frozen/stuck? ↑ Back to top

If you are trying to perform a manual sync and finding that the sync is stuck or frozen, it may be caused by caching from a plugin or your web host.

Try disabling any caching plugins that you have installed. As well, check to ensure your host hasn’t forced the installation of any cache plugins. These would show up under the “Drop-ins” or “Must-Use” tabs on your Plugins screen.

Does syncing include Square modifiers? ↑ Back to top

WooCommerce does not have such modifiers so therefore Square modifiers are not sync’d.

Can I connect the same Square account to multiple WooCommerce sites?

As long as each WooCommerce site is using a different Square Location, you can connect the same Square account to multiple WooCommerce sites.

How does Square handle syncing products with tax inclusive pricing? ↑ Back to top

Currently Square does not support pricing inclusive of taxes. Their suggestion is to create Tax Rules in Square to mark items that should not have taxes applied to them. Because of this, we are not able to send your product price and the appropriate percent of inclusive tax as Square would add it on top of the product price. As a result, when using product prices inclusive of tax, we will send the base product price and the tax as one combined value to Square. This means that if your customers see the item as $10 on your WooCommerce store, we will send the price to Square as $10.

Questions and Feedback ↑ Back to top

Have a question before you buy? Please fill out this pre-sales form.

Already purchased and need some assistance? Get in touch with a Ninja via the Help Desk.

WooCommerce - the most customizable eCommerce platform for building your online business.

Back to the top