Descrição

Sync inventory and product data between WooCommerce and Square POS. Securely accept payments via the Square payment gateway.

Accept credit card payments easily and directly on your store

The Square plugin extends WooCommerce to allow you to accept payments via Square. Benefit from a PCI compliant payment processing option that meets SAQ A levels of compliance.

You can also use these advanced features:

Support for WooCommerce Subscriptions
Support for WooCommerce Pre-Orders
Allow customers to save payment methods and use them at checkout
Use an enhanced payment form with automatic formatting, mobile-friendly inputs, and retina card icons

Sync your product catalog with Square

You can sync your product data automatically between WooCommerce and Square.

If you sell mainly online, you can choose WooCommerce as your system of record. This will push the WooCommerce product name, inventory, prices, categories, and images to Square. Note that inventory will still be fetched periodically from Square and you must refresh inventory in WooCommerce before editing.
If you sell in multiple locations and online, you can choose Square as your system of record. This will pull product name, inventory, and prices from Square into your WooCommerce catalog. Product images will also be synced if not already set in WooCommerce.

Imagens de tela

The main plugin settings.
The payment gateway settings.

Instalação

You can download an older version of this gateway for older versions of WooCommerce from here.

Automatic installation

Automatic installation is the easiest option as WordPress handles the file transfers itself and you don’t need to leave your web browser. To
automatically install WooCommerce Square, log in to your WordPress dashboard, navigate to the Plugins menu, and click Add New.

In the search field type “WooCommerce Square” and click Search Plugins. Once you’ve found our plugin you can install it by clicking Install Now, as well as view details about it such as the point release, rating, and description.

Manual installation

The manual installation method involves downloading our plugin and uploading it to your web server via your favorite FTP application. The WordPress codex contains instructions on how to do this here.

Updating

Automatic updates should work like a charm; as always though, ensure you backup your site just in case.

FAQ

Does this require an SSL certificate?: Yes! An SSL certificate must be installed on your site to use Square.
Where can I find documentation?: For help setting up and configuring the plugin, please refer to our user guide.
Where can I get support or talk to other users?: If you get stuck, you can ask for help in the Plugin Forum.

Avaliações

amador360 23 de setembro de 2021

Though the documentation needs a good rewrite, if you follow the instructions closely, it will work well. Not saying it will work for every scenario. I have about 100 products, both a brick and mortar and online store, and the products all have only one category. Here's what I did and what it does for me: First I set it up as a payment gateway only, without syncing. That worked beautifully. Then I set up syncing. With Square as my system of record, and product syncing turned on in both the plugin settings AND the individual product settings, it now syncs inventory from Square to Woocommerce, and transactions from Woocommerce back to Square. Be sure Woocommerce is set to manage inventory [Woocommerce Setting/Products/Inventory/Enable Stock Management]. At first, after all the settings were correct, it didn't sync. I had to manually sync once (Settings/Square/Update/Sync now). After that it has been syncing as expected. If you have further problems, be sure to read the FAQs and Troubleshooting carefully.

mshallop 10 de setembro de 2021

First, the installation went smoothly but that's it. It's the configuration and internal requirements that are untenable. There's no way to push a product sync. I've checked the 'sync with square' boxes in the product listings, checked my Square dashboard and there's nothing. Support tells me to contact Woo "for more insight". That's fair, Woo wrote the plugin/extension. There's nothing in the Woo Payments tab under Integrations, and the Square tab doesn't offer the sync option. For some reason, Square requires you to manage YOUR inventory on THEIR site. Even if you have selected the option to not track inventory, you must still list something (I recommend 1,000,000 so you can fill it out and forget about it) as long as it's blank or non-zero. Secondly, even if you pick Woo as the inventory authority, according to support, you still have to maintain inventory counts in square. (Hence the recommendation for 1,000,000 of everything.) Stripe was a breeze to install, configure and use for woo. Square could take a few lessons here. Actually, all the lessons. Deleted plugin and closed square account. Whoever commented that this plugin should be deleted wasn't joking.

David 1 de setembro de 2021

I've tried to use this to sync with Square as the system of record and it does not "sync" by any stretch of the imagination. This is a completely untrustworthy plugin. Common errors/problems include Failed and partial syncs Changing the inventory to 0 in Woocommerce when there is inventory in Square Unfortunately, if you operate a bricks and mortar + online retail business, and need to have accurate data in your online store, I'd recommend you do manual updates. I'd also add that I worked with Woocommerce support from early Feb 2021 until late July 2021 to try to resolve the issues, but most of the time their support staff seemed to fail to read the support threads, and asked me to repeat the same problem solving steps over and over. So, support for this was atrocious.

richardu 19 de agosto de 2021

I really like the Square website, but I can't use it because this plugin is completely unreliable. Take a hint, Square, and find someone to create a new plugin from scratch.

chirase 13 de agosto de 2021

Ive worked over a year with this plugin and I regret it. Not working correctly, half the plugin is made in Javascript, so it cant be overwritted in PHP.

nierc001 21 de julho de 2021

For months this plugin never worked 100%. Manual sync would work maybe 1 out of 10 tries and would take several hours to complete or finally fail. I Couldn't get any straight answers except to deactivate other plugins and use a different theme because there may be a conflict. Seems to be the go to method to fix anything woocommerce. I have a large inventory 7000ish items. Not all are always in stock but for SEO reasons don't want to delete items. Finally after reading help for other plugins the sync inventory not related to square I figured they all have to work somewhat the same and the customer service said the item count may be the issue. So today I unchecked the sync items to square in about 4000 items ran manual sync again and BOOM! it worked. No errors no failures no nothing. Added a few more items BOOM! it worked again no errors not nothing added a few more and still working. So how many items is to much for this plugin to handle is the question? Im sure the answer will be something to do with the server memory or specs of my host but I am running pretty decent specs on a unshared server and even had my hosting company temporary upgrade me to a max server to test and still never worked correctly. So my suggestion if you use this plugin stay SMALL. But now I am on the hunt for a better system to integrate with woocommerce and my brick and mortar store.

Leia todas as 76 avaliações

Colaboradores e desenvolvedores

“WooCommerce Square” é um software com código aberto. As seguintes pessoas contribuíram para este plugin.

“WooCommerce Square” foi traduzido para 2 localizações. Agradecemos aos tradutores por suas contribuições.

Traduzir “WooCommerce Square” para o seu idioma.

Interessado no desenvolvimento?

Navegue pelo código, dê uma olhada no repositório SVN ou assine o registro de desenvolvimento via RSS.

Registro de alterações

2.6.0 – 2021.09.29

New – Add support for Square stores located in France. PR#650
Fix – PHP warning when trying to load the Square digital wallet (Apple/Google Pay buttons) on a product page that isn’t available for purchase. PR#640

2.5.3 – 2021.07.23

Fix – Failed orders with error “Square Payment Failed (Status code VALUE_TOO_LOW)” caused by incorrect line item calculations on orders with discounts/coupons (introduced in 2.5.2). PR#635

2.5.2 – 2021.07.21

Fix – Product and inventory data not being synced due to duplicate/orphaned product metadata in database. PR#625
Fix – Bypass SSL verification when checking background job processing eligibility. PR#624
Fix – Correctly apply taxes in the Order API request and report accurate percentages. PR#559

2.5.1 – 2021.05.18

Fix – Pay for Order and Add Payment Method forms sometimes not working when choosing another payment method other than Square. PR#618

2.5.0 – 2021.05.13

New – Add support for WooCommerce Checkout blocks. PR#604
New – Add support for Square stores located in Ireland. PR#609
Fix – Improve manual sync performance and reduce stream timeout responses from Square on stores with large catalogs. PR#612

2.4.1 – 2021.03.30

Fix – Variable products are now properly importing from Square on newer versions of WooCommerce. PR#605

2.4.0 – 2021.03.23

Fix – Update jQuery 3 deprecated functions. PR#560
Fix – Don’t display digital wallet buttons when the cart contains a subscription product as Square does not yet support tokenization through digital wallets. PR#597
Dev – Replace CoffeeScript with plain JS. PR#560

2.3.4 – 2021.02.11

Fix – Handle exceptions when loading digital wallet buttons on product pages with no stock or other serviceable issues. PR#591

2.3.3 – 2021.02.09

Fix – Uncaught PHP error when attempting to setup Apple Pay and Square is not properly connected (i.e. no valid access token found). PR#587
Fix – Improve error logging when the request to verify the store’s domain with Square/Apple Pay fails. PR#587
Fix – Allow variable products to be previewed when Square is active. PR#554

2.3.2 – 2021.02.04

Fix – PHP error on the My Account > Payment Methods page when saving a new card. PR#585

2.3.1 – 2021.02.03

Fix – Add the correct variation to the cart when purchasing with Apple Pay and Google Pay from the product page. PR#581

2.3.0 – 2021.02.02

Feature – Apple Pay and Google Pay support (US, UK and CA stores only). PR#547
Fix – Duplicate idempotency_key issues caused by order IDs being re-used on the same store URL (i.e. after restoring from a backup). PR#563
Fix – Don’t import item variations from Square that are not available at your store’s business location. PR#562
Fix – Restore stock in Square when processing partial refunds (previously was only restoring stock for full refunds). PR#565
Fix – Only restore stock if the “Restock refunded items” option is checked when refunding an order. PR#565
Fix – Fatal errors during the sync and import process caused by unexpected/invalid Square API responses. PR#500
Fix – Sends only one sync complete email per update to products that are synced with Square. PR#552
Fix – Allow products with large numbers of categories (600+) to sync to Square when WooCommerce is SOR. PR#568
Fix – Database related errors with creating the Square customer’s table when first installing Square. PR#558
Fix – Allow variable products with valid variations to import when variations with missing skus are present. PR#573
Tweak – Update the Customer Profile setting description to make it clear that this setting enables tokenization. PR#576

2.2.5 – 2020.11.24

Fix – Correctly saves inventory sync time when sync fails so items are re-synced on next attempt. PR#448
Fix – Fixes warnings introduced with PHP 8. PR#533
Fix – Corrects the plugin support URL. PR#539
Fix – Allows imports containing products with variable pricing to complete successfully. PR#540
Tweak – Updates assets to reflect WooCommerce color change. PR#544

2.2.4 – 2020.10.30

Fix – Prevents logging anything if logging is disabled. PR#493
Fix – Fixes a bug where products are imported even when it is not available at the store’s location. PR#537

2.2.3 – 2020.10.23

Fix – Display the correct stock quantity amount on all variations when product data is sent to Square. PR#503
Fix – Avoid IDEMPOTENCY_KEY_REUSED API errors when syncing product data from WooCommerce to Square by using a more unique API request key. PR#528
Fix – Added customer_id to Orders API to link Customers & Transactions on Square Dashboard and Transactions CSV Export. PR#527
Fix – Issues with the postal code not matching WooCommerce data while saving cards. PR#501
Fix – Prevents the “Send product data to Square” checkbox from being enabled when products and variations contain empty or duplicate SKUs. PR#525
Fix – Issues that caused the Square Payment Form to be unclickable on the checkout page. PR#530
Fix – Compatibility issues with the Square Payment form and conditional payment gateway extensions. PR#530

2.2.2 – 2020.09.15

Fix – Don’t import a new copy of each product image from Square when updating products during the import process. PR#513

2.2.1 – 2020.09.11

New – Make the “Update existing products” part of the new import process optional by adding a new checkbox on Import Products modal. PR#508
Fix – Stop the import process from getting stuck in a loop when reaching the time limit. PR#511
Fix – Don’t import/update categories from Square that are attached to products that cannot be found in WooCommerce. PR#511
Fix – “idempotency_key must not be greater than 45 length” errors returned by some payment requests on stores using custom order number plugins. PR#507

2.2.0 – 2020.08.31

Feature – Import new product variations from square to existing products in WooCommerce. PR#475
Feature – Variations that are removed from Square will now be removed from products in WooCommerce during import. PR#475
Feature – Upgrade to the Square Payments and Refunds API. PR#408
Feature – New orders can be refunded up to one year after payment (up from 120 days). PR#408
Fix – Only import products from Square that have non-empty SKUs. PR#475
Fix – Empty product categories imported from Square into WooCommerce. PR#475
Fix – Assign existing products to new categories imported from Square. PR#475
Fix – Prevents loading of Square Assets on all pages except My Account -> Payment Methods & Checkout. PR#469
Fix – Square Product Import & Product Manual Sync not triggering on mobile browsers. PR#472
Fix – 3D Secure Verification Token is missing, Intent mismatch and other checkout errors related to SCA for merchants outside of the EU. PR#471
Fix – Updated some of our documentation and support links in admin notices so they no longer redirect to an old URL or a 404 page. PR#474
Fix – Use pagination to fetch inventory counts from Square. PR#478
Fix – Display WooCommerce checkout validation errors along with Square payment form errors. PR#476
Fix – Switching between sandbox and production environments will now show correct business locations. PR#462
Fix – Don’t wipe a customer’s saved cards on when we receive an API error. PR#460
Fix – Exclude draft and pending products from syncing from WooCommerce to Square. PR#484
Fix – DevTools errors caused by missing minified JS files.
Fix – PHP errors when syncing large amounts of products (get_data() on null and getCursor() on a string). PR#497

2.1.6 – 2020.07.15

Fix – Make the “Sync Now” button disabled when no business location is set in Square settings.
Fix – Enable checking/unchecking the Manage Stock setting for all variations.
Fix – Refunding an order paid with another payment gateway will no longer sync inventory with Square when “Do not sync product data” is selected.
Fix – Imported variation products that are out-of-stock will no longer show on the shop page when “Hide out of stock items from the catalog” is selected.
Fix – Product images will now sync when Square is in Sandbox mode.
Fix – Damaged stock adjustments will now sync properly to WooCommerce when multiple stock adjustments are made.
Fix – Improve performance when manually syncing large amount of stock adjustments from Square (some inventory updates were missing).
Fix – Quick editing products no longer sets incorrect stock quantities or disables syncing.
Fix – Existing customer that have been removed from the connected Square account, or can’t be found will now be able to save a new card on the checkout.
Fix – When the System of Record is set to WooCommerce, product images will now properly sync to Square.
Tweak – Use CSC consistently in all error messages when referring to the Card Security Code.
Tweak – Change to using WordPress core methods to import/sync images from Square.

2.1.5 – 2020.05.15

Fix – Fatal errors caused by incorrectly fetching locations before plugin init.
Fix – WordPress database error when creating the Square Customers table on servers using utf8mb4.

2.1.4 – 2020.05.05

Fix – Make sure that Square credit card fields are editable after checkout form refresh.

2.1.3 – 2020.04.30

Fix – Persistent caching of locations to prevent unnecessary refetching and rate limiting.

2.1.2 – 2020.04.29

Fix – INTENT_MISMATCH errors when guest customers save a card and registration is disabled.
Fix – Improve checkout compatibility with password managers such as 1Password. This also avoids payment for reload on address change.
Fix – Pass valid address values even if checkout fields are not present.
Tweak – Sandbox mode can be turned on in the settings, no more need for setting the constant.
Tweak – Change location URL to refer to our docs.

2.1.1 – 2020.03.23

Fix – Inventory/Stock updates as a result of checkout via PayPal Standard does not reflect on the Square item.
Fix – Error when trying to save an external product with the modified ‘sync with square’ value.
Fix – Move product check on a possibly invalid product out of the try block avoiding potential further errors.

2.1.0 – 2020.02.11

Feature – Add support for SCA (3D Secure 2)
Fix – Minor fixes to the Sync completed emails
Tweak – Add email notifications when connection issues are detected
Fix – Category sync when WooCommerce is the System of Record and there have been changes in Square

2.0.8 – 2019.12.09

Fix – Inventory changes through payments and refunds from other gateways not reflected on Square.
Fix – Fatal error on versions of WooCommerce before 4.3.
Fix – Sandbox API calls by passing is_sandbox flag to the Gateway API.
Fix – Quick edit view when editing a variable product without all variations SKU.
Fix – Verify if the product can be synced with Square before enabling sync when bulk/quick updating.
Fix – Disable sync for products that should not be synced after a REST API update.
Fix – Unable to create products during import.
Fix – Product inventory sync issue when WooCommerce is set as the Source of Record.
Fix – Inventory not updated when purchased through another gateway.
Fix – Category and description data not updated in a sync from Square.
Fix – Transactions on multiple stores connected to the same Square account would appear to succeed without actually charging the customer.
Fix – When making multiple partial refunds on the same order, only the first one would work.
Tweak – Include product ID on failed sync record message.
Tweak – Remove notices for refresh token when sandbox is enabled.
Tweak – Prevent refreshing a token token when sandbox is enabled.

2.0.7 – 2019.11.18

Fix – No longer automatically disconnect on unexpected authorization errors
Fix – Bump compatibility for WooCommerce 3.8 and WordPress 5.3
Fix – Correct cents rounding that was causing invalid value errors
Fix – Fix encrypted token handling
Fix – No longer call revoke when disconnecting – just disconnect the site

2.0.6 – 2019.11.07

Fix – Access token renewal schedule action duplication.

2.0.5 – 2019.10.16

Fix – Access token renewal by adding support for refresh tokens as per the new Square API
Fix – Variable pricing import and adding an alert when these type of products are ignored.
Fix – Line item discounts and other adjustments being ignored.
Tweak – Add a notice when a refresh token is not present to warn users to re-connect their accounts.
Feature – Added support for Sandbox accounts.

2.0.4 – 2019.09.03

Fix – Add adjustments to Square order in the event of discrepancy with WooCommerce total

2.0.3 – 2019.08.19

Tweak – Re-introduce the “inventory sync” toggle to allow syncing product data without affecting inventory
Fix – Adjust v1 upgrades to properly toggle inventory sync when not enabled in v1
Fix – Ensure product prices are correctly converted to and from cents regardless of the decimal place setting
Fix – Don’t block the product stock management UI when product sync is disabled
Fix – Ensure products that have multiple attributes that aren’t used for variations can be synced
Misc – Add support for WooCommerce 3.7

2.0.2 – 2019.08.13

Tweak – WC 3.7 compatibility.

2.0.1 – 2019.07.23

Fix – Don’t display the “unsupported” payment processing admin notice for UK-based merchants

2.0.0 – 2019.07.22

Feature – Support Square customer profiles for saved payment methods
Feature – Customers can label their saved payment methods for easy identification when choosing how to pay
Feature – Support enhanced payment form with auto formatting and retina card icons
Feature – Show detailed decline messages when possible in place of generic errors
Feature – Add support for WooCommerce Subscriptions
Feature – Add support for WooCommerce Pre-Orders
Feature – Orders with only virtual items can force a charge instead of authorization
Feature – Void authorizations from WooCommerce
Feature – Itemize Square transactions for improved reporting in Square
Feature – Add sync records to notify admins of failed product syncs
Feature – Changed “Synced with Square” option while bulk editing products
Tweak – Introduce “System of Record” settings to control product data sync
Tweak – Remove items from Square locations when deleted in WooCommerce (if WC is the system of record)
Tweak – Allow users to hide WooCommerce products if removed from the linked Square location (if Square is the system of record)
Tweak – Import images from Square when not set in WooCommerce (if Square is the system of record)
Tweak – Remove Square postcode field when a postcode can be used from the checkout form
Fix – Ensure connection tokens are refreshed ahead of expiration
Fix – Always ensure settings are displayed in multisite
Fix – Ensure Square prices update WooCommerce regular price, not sale price
Fix – Remove usages of $HTTP_RAW_POST_DATA, which is deprecated
Fix – Do not allow multiple sync processes to run simultaneously
Fix – Avoid submitting duplicate orders with Checkout for WC plugin
Misc – Upgrade to Square Connect v2 APIs
Misc – Background process product sync for improved scalability
Misc – Refactor for other miscellaneous fixes and improved reliability

1.0.38 – 2019-07-05

Fix – Re-deploy due to erroneous inclusion of trunk folder

1.0.37 – 2019-04-16

Fix – Use correct assets loading scheme.

1.0.36 – 2019-04-15

Tweak – WC 3.6 compatibility.

1.0.35 – 2019-02-01

Fix – Idempotency key reuse issue when checking out.

1.0.34 – 2018-11-07

Update – Fieldset tag to div tag in payment box to prevent unwanted styling.
Fix – Provide unique idempotency ID to the order instead of random unique number.
Update – WP tested up to version 5.0

1.0.33 – 2018-09-27

Update – WC tested up to version 3.5

1.0.32 – 2018-08-23

Fix – UK/GB localed does not support Diners/Discover, so do not show these brands on checkout.