=== FunnelKit Payment Gateway for Square WooCommerce ===
Contributors: amans2k, xlplugins, teamwoofunnels
Tags: woocommerce, funnelkit, square, payment, sync
Requires at least: 5.0
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.4.5
License: GPL v2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

FunnelKit Payment Gateway for Square WooCommerce is a powerful and reliable payment solution that enables you to accept payments both online and in person with ease.

== Description ==

FunnelKit Payment Gateway for Square WooCommerce is a powerful and reliable payment solution that enables you to accept payments both online and in person with ease.

It’s ideal for store owners looking for a secure, synchronized, and fully integrated way to handle payments, products, and inventory, all without switching platforms.

With Square Payment Gateway for WooCommerce, you can accept major credit and debit card payments, as well as popular digital wallets like Apple Pay and Google Pay, and alternative payment methods like Cash App Pay, Afterpay, ACH bank transfers, and gift cards directly on your WooCommerce store.

Whether you’re selling products online or at a physical store, Square ensures all your inventory, product data, and order history remain perfectly synced in real-time.

It goes beyond just accepting payments. With Square, you can:

*   Automatically sync inventory between Square and WooCommerce
*   Keep your product catalog consistent across platforms
*   Track orders and customer data in real time
*   Manage refunds and variable products with no hassle

Plus, with its sandbox testing mode, you can simulate transactions and test everything before going live, making Square a safe and developer-friendly option for any WooCommerce merchant.

https://www.youtube.com/watch?v=b_207FpOvr8

== Why Square? ==

Square is one of the most trusted and widely used payment platforms in the world, serving millions of businesses across the globe.

*  No monthly fees. Pay only per transaction.
*  Accepts multiple currencies and supports both online and offline transactions.
*  Built-in fraud prevention, PCI compliance, and detailed analytics.

With Square, you’re not just getting a payment processor, you’re getting a complete commerce solution that scales with your WooCommerce store.

== Features of Square Payment Gateway for WooCommerce ==

Here are the key features that make Square a standout payment solution for WooCommerce:

=== 1. Quick Onboarding Process

Get started in just a few minutes. Connect your Square account with WooCommerce and start accepting payments instantly, eliminating the need for complex setup and manual API key addition.

=== 2. Multiple Payment Methods

Accept all major credit and debit cards, including Visa, Mastercard, American Express, and more, plus Apple Pay, Google Pay, Cash App Pay, Afterpay, ACH bank transfers, and gift cards for flexible, customer-friendly checkout experiences.

=== 3. Real-Time Inventory Sync

Square keeps your product inventory in sync across both platforms. Whether you make a sale online or in person, your stock levels update automatically in WooCommerce and Square. This ensures accurate stock management at all times.

=== 4. One-Click Product Catalog Sync

Easily sync your entire product catalog, including product names, categories, prices, images, and stock, between Square and WooCommerce in just one click.

=== 5. Variable Product Support

Sell products with multiple variations (like size, color, etc.)? Square handles variable products with ease, ensuring your catalog stays consistent across platforms.

=== 6. Real-Time Order & Customer Sync

Automatically sync order and customer data between WooCommerce and Square. Keep track of every transaction and customer record in one unified system.

=== 7. Seamless Refund Management

Initiate refunds from WooCommerce and have them instantly reflect in Square and vice versa. This ensures your customers have a smooth experience, and your records stay accurate.

=== 8. Sandbox Testing Mode

Square offers a Sandbox API so you can test your entire checkout flow, sync settings, and transactions before going live without affecting real data or payments.

=== 9. Detailed Transaction Tracking

Track payments, refunds, disputes, and adjustments directly from your WooCommerce dashboard with Square’s detailed reporting.

== Compatible Payment Methods ==

Here’s what your customers can use to pay when you integrate Square with WooCommerce:

=== 1. Credit and Debit Cards

Accept payments from major credit and debit cards, such as Visa, Mastercard, American Express, Discover, Diners Club, JCB, and more.

=== 2. Apple Pay

Offer your Apple users a secure, one-click checkout experience using Face ID or Touch ID without entering card details manually.

=== 3. Google Pay

Let Android users complete their purchases in just a few taps with Google Pay, offering convenience and top-notch security.

=== 4. ACH Bank Transfer

Allow customers to pay directly from their bank account using ACH transfers, offering lower processing fees and a familiar payment flow for US-based customers.

=== 5. Cash App Pay

Give your customers the option to pay using Cash App, one of the most popular peer-to-peer payment apps. It provides a quick, seamless checkout experience that millions of users already know and trust.

=== 6. Gift Cards

Customers can redeem gift card balances at checkout, making it easy to support gifting, store credit, and loyalty programs.

=== 7. Afterpay

Offer your customers the flexibility to buy now and pay later with Afterpay. They can split their purchase into interest-free installments, helping increase average order value and reduce cart abandonment.

That’s not all! FunnelKit Team is committed to bringing you many more payment gateways to enhance your WooCommerce store experience.

== ABOUT FUNNELKIT ==

The Square Payment Gateway for WooCommerce is proudly developed by FunnelKit’s expert team: the same people behind some of the most powerful sales and marketing tools for WooCommerce.

With over a decade of experience and a thriving ecosystem, FunnelKit helps thousands of businesses worldwide boost conversions, streamline checkout, and maximize revenue.

Here’s a look at other game-changing plugins from FunnelKit’s suite:

=== Here are some of our plugins:

**[FunnelKit's Funnel Builder](https://wordpress.org/plugins/funnel-builder/)** - The most flexible funnel builder for WordPress. Build profitable funnels using conversion-friendly templates, analyze performance and improve with built-in A/B testing.

**[FunnelKit Checkout](https://funnelkit.com/woocommerce-checkout-pages-aero/)** - Increase your conversions with FunnelKit’s optimized WooCommerce checkout pages. Choose from ready-to-use checkout page templates, embed forms, create one-page checkouts, and more. Offer order bumps to boost your business revenue.

**[FunnelKit One-Click Upsells](https://funnelkit.com/woocommerce-one-click-upsells-upstroke/)** - Boost your average order value (AOV) by pitching hyper-relevant post-purchase upsell offers after the checkout.

**[FunnelKit Automations](https://wordpress.org/plugins/wp-marketing-automations/)** - Engage with your customers with automated WooCommerce email marketing and SMS campaigns. Automate your abandoned cart recovery sequence, post-purchase follow-up emails, winback campaigns, and more.

**[FunnelKit Cart](https://wordpress.org/plugins/cart-for-woocommerce/)** - Adds a beautiful sliding cart to your WooCommerce store. Let the buyers add items, edit quantity and add upsells (Pro) on the side cart. Skip traditional cart page and reach checkout faster.

**[FunnelKit Payment Gateway for Stripe WooCommerce](https://wordpress.org/plugins/funnelkit-stripe-woo-payment-gateway/)** - Accept payments with Stripe-powered gateways such as Apple Pay, Google Pay, BNPL, and more while supporting upsells and advanced checkout flows.

== Frequently Asked Questions ==

= How do I add a Square payment gateway to WooCommerce? =
To add a Square gateway to WooCommerce, install this plugin for free. Its seamless onboarding process lets you connect your Square account with WooCommerce and enable your preferred payment methods in a matter of minutes.

= Does it work with recurring subscription payments? =
Yes! Square Gateway supports official [WooCommerce Subscriptions](https://woocommerce.com/products/woocommerce-subscriptions/).

= What happens if you switch from the existing Square gateway to this Square Payment Gateway for WooCommerce plugin? =
Switching from your existing Square gateway plugin to the FunnelKit Payment Gateway for Square WooCommerce will make it your primary payment gateway plugin to collect payments on your WooCommerce website via Square. Ensure you’ve deactivated your existing plugin after the switch.

= Will my older subscriptions continue to work if I switch to this plugin? =
Yes, your subscriptions will continue to work fine. This Square Gateway plugin will take complete responsibility for your subscription charging even if you make the switch.

= Is there a charge or pricing fee for Square? =
Square offers pricing tailored to your business needs. If your needs are limited, you can get their free plan. There is no setup cost, but only 3.3% + 30¢ for online transactional costs and 2.6% + 15¢ for tap, dip, or swipe.

= Can I deactivate the existing Square plugin after switching to this plugin? =
Yes! Once you've successfully moved on to this plugin, you can deactivate and uninstall your existing Square plugin.

= Can I test Square payments before going live? =
Absolutely! Use the Sandbox mode to test payments, product sync, and inventory updates before accepting real payments.

= Can I add multiple Express Checkout buttons on a single page? =
Yes, Square Payment Gateway for WooCommerce lets you add multiple express checkout buttons, such as both Apple Pay and Google Pay, on a single product, cart, and checkout page.

= Can I sync variable products from WooCommerce to Square? =
Yes, Square fully supports syncing WooCommerce variable products with attributes like size, color, and more.

= Do I need to manually manage my inventory? =
No, the gateway plugin offers smart data sync settings that automatically synchronize inventory between WooCommerce and Square in real-time.

= Is there any documentation to help me get started? =
Yes, visit our [complete documentation](https://funnelkit.com/docs/square-gateway-for-woocommerce/) on the FunnelKit Square Payment Gateway for WooCommerce here.

= I have some questions. How do I contact your support team? =
Whatever questions you have, our support team will be happy to help you.
Either fill up this [support form](https://funnelkit.com/support/) or drop your query at [support@funnelkit.com](support@funnelkit.com)

= My express buttons are not showing. What should I do? =
If the express payment buttons are not showing up on your checkout page, please make sure to meet the guidelines of respective payment providers. Follow this [Troubleshooting document](https://funnelkit.com/docs/square-gateway-for-woocommerce/troubleshooting/express-payment-buttons-not-showing/) to set up your payment providers.


== External Services ==

This plugin integrates with the following external services:

### 1. **Google Pay API**
- **Purpose**: Google Pay is used to process payments securely during checkout.
- **Data Sent**: Transaction details such as the total amount and the customer’s Google Pay account information are sent when the user selects Google Pay as a payment method.
- **Terms and Privacy**: This service is provided by **Google LLC**. You can view the terms of service and privacy policy at [Google Pay Terms of Service](https://pay.google.com/about/terms/) and [Google Privacy Policy](https://policies.google.com/privacy).

### 2. **FunnelKit AUTH API (Square Connect OAuth)**
- **Purpose**: The FunnelKit AUTH API is used to authenticate and securely connect to Square's payment gateway for OAuth purposes.
- **Data Sent**: Authentication tokens and user details are sent to ensure a secure connection during the payment process.
- **Terms and Privacy**: This service is provided by **FunnelKit**. The terms of service and privacy policy are available upon request.

### 3. **Square Direct APIs (JavaScript & PHP)**
- **Purpose**: Square Direct APIs handle payment processing and transaction syncing between the plugin and Square.
- **Data Sent**: Customer information (name, email, payment method) and order details are transmitted during payment processing. The plugin also syncs transaction status and updates after each purchase.
- **Terms and Privacy**: This service is provided by **Square, Inc.** You can view the terms of service and privacy policy at [Square Terms of Service](https://squareup.com/legal/terms) and [Square Privacy Policy](https://squareup.com/legal/privacy).

== Installation ==

1.  Upload the `funnelkit-payment-gateway-square-for-woocommerce` folder to the `/wp-content/plugins/` directory.
2.  Activate the plugin through the 'Plugins' menu in WordPress.
3.  Go to WooCommerce > Settings > Payments and enable the "FunnelKit Square" gateway.
4.  Configure the gateway settings with your Square API keys, sync preferences, and advanced options.



== Screenshots ==

1.  Admin settings and sync tools (TBD)
2.  Payment gateway at checkout (TBD)

== Changelog ==

= 1.4.5 =
* Improved: Hardened authentication and request validation across checkout and payment flows. Recommended update.

= 1.4.4 =
* Improved: Compatibility with upsells to handle a few edge cases related to sessions. (#128)

= 1.4.3 =
* Improved: Compatibility with WooCommerce version 10.8.0.
* Improved: Webhooks reliability, accuracy & security. (#126)

= 1.4.2 =
* Improved: Google Pay button styling improved across different positions . (#121)
* Improved: Webhooks handling for dispute and refunds cases improved for edge cases. (#119)
* Improved: Google Pay and Apple Pay buttons compatibility improved with FunnelKit checkout. (#119)

= 1.4.1 =
* Fixed: Handled edge case of Google Pay button showing twice in checkout place order area. (#111)

= 1.4.0 =
* Critical Fixed: Payment nonce error resolved.

= 1.3.0 =
* Added: Square Gift Card payment gateway.
* Added: Cash App Pay payment gateway.
* Added: ACH Bank Transfer payment gateway.
* Added: Afterpay payment gateway.
* Added: WooCommerce Blocks (block checkout) support for all Square payment gateways.
* Added: Smart button compatibility with FunnelKit Cart.
* Added: New setting to disable order creation on payment.updated webhook arrival.
* Added: Browser support checks for Google Pay before rendering the button.
* Improved: Google Pay and Apple Pay styling improved.
* Improved: Order Noted improved for all payment methods.
* Improved: Credit Card fields loading behaviour with FunnelKit multi-step checkout.

= 1.2.0 =
* Added: Admin tool under connection settings to simulate webhooks. (#29)
* Added: Test mode for administrators to enable testing without affecting live transactions. (#40)
* Added: Customer saved cards management metabox in WordPress user profile for administrators. (#41)
* Improved: Google Pay and Apple Pay integration restricted to one-time payments only, excluding upsells and subscriptions. (#20)
* Improved: Payment dispute handling through webhook integration. (#31)
* Improved: Customer onboarding flow and user experience. (#28)
* Improved: Express payment button script loading performance and optimization. (#38)
* Improved: Credit card element loading performance on checkout pages. (#43)

= 1.1.0 =
* Improved: Square connect success and failed states.
* Improved: Google Pay & Apple Pay express button visibility with FunnelKit Checkout.
* Improved: Admin settings assets loading optimized.
* Improved: Product Sync Improved for customer switching from other WooCommerce square plugin.
* Improved: Card tokenization improved as per square latest API flow.
* Improved: Order processing behavior when customer OR card API fails.

= 1.0.0 =
* Initial release with full payment, sync, webhook, and FunnelKit integration.
