=== HandyPay for WooCommerce ===
Contributors: kylekonstnar
Tags: woocommerce, payments, stripe, checkout, caribbean
Requires at least: 6.2
Tested up to: 7.0
Requires PHP: 7.4
Requires Plugins: handypay-payments, woocommerce
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Accept card payments at WooCommerce checkout with HandyPay and settle to a local Caribbean bank account.

== Description ==

**HandyPay for WooCommerce** adds HandyPay as a payment method on your WooCommerce store. Customers check out as usual and you settle to a local bank account, built for the Caribbean: Jamaica, Trinidad & Tobago, St. Lucia, Antigua, Guyana, the Bahamas and major markets.

At checkout, customers are redirected to HandyPay's secure hosted page to pay, then returned to your store. Card data never touches your server (PCI SAQ-A). Works with both the classic shortcode checkout and the WooCommerce Cart/Checkout blocks.

Issue full or partial refunds right from the WooCommerce order screen - they are processed through HandyPay automatically. Disputes are managed from the HandyPay Payments plugin and the HandyPay merchant dashboard.

= Requires =

This add-on needs the free **HandyPay Payments** plugin (active and connected to your HandyPay account) and **WooCommerce**.

== Installation ==

1. Install and activate **WooCommerce** and the **HandyPay Payments** plugin, and connect HandyPay with your API key.
2. Install and activate **HandyPay for WooCommerce**.
3. Go to **WooCommerce → Settings → Payments**, enable **HandyPay**, and save.

== External services ==

This plugin connects to the **HandyPay payments API** (`https://api.handypay.me`) to create checkout sessions and process card payments through HandyPay's payment processor (**Stripe**). This is required for the plugin to accept payments.

* **When:** when a customer places an order using HandyPay, and when the store owner views or manages payments.
* **Data sent:** order amount and currency, order/line item descriptions, the customer's email (if provided at checkout), and your HandyPay API key for authentication. Raw card details are collected by HandyPay/Stripe directly and are never sent to or stored on your site.
* **HandyPay:** Terms - https://handypay.me/terms · Privacy - https://handypay.me/privacy
* **Stripe (payment processor):** Terms - https://stripe.com/legal · Privacy - https://stripe.com/privacy

== Frequently Asked Questions ==

= Do I need the HandyPay Payments plugin? =
Yes. This gateway uses the connection and API key from the HandyPay Payments plugin.

= Is card data PCI compliant? =
Yes. Customers pay on HandyPay's hosted page, so raw card data never touches your server (PCI SAQ-A).

= How do refunds work? =
Open the order in **WooCommerce → Orders**, click **Refund**, and issue a full or partial refund - it is processed through HandyPay automatically. You can also refund from the HandyPay Payments plugin or the HandyPay dashboard.

== Changelog ==

= 1.0.0 =
* First public release: HandyPay payment gateway for WooCommerce (hosted checkout), block checkout support, native full/partial refunds from the WooCommerce order screen, and Caribbean local-bank settlement.
