HandyPay for WooCommerce
| 开发者 | kylekonstnar |
|---|---|
| 更新时间 | 2026年9月2日 22:32 |
| PHP版本: | 7.4 及以上 |
| WordPress版本: | 7.0 |
| 版权: | GPLv2 or later |
| 版权网址: | 版权信息 |
详情介绍:
安装:
- Install and activate WooCommerce and HandyPay Payments 1.2.0 or newer from WordPress.org, then connect HandyPay.
- Install and activate HandyPay for WooCommerce.
- Go to WooCommerce → Settings → Payments, enable HandyPay, and save.
常见问题:
Do I need the HandyPay Payments plugin?
Yes. This gateway uses the connection and API key from HandyPay Payments 1.2.0 or newer. If it is missing, the gateway stays inactive and an admin notice links to the WordPress.org download.
How do I create a subscription?
Edit a simple or variable WooCommerce product, enable HandyPay subscription under Product data, choose the billing interval (and optionally a free trial, a sign-up fee, and shipping once or every cycle), and save. The product must be purchased by itself. Customers complete signup on HandyPay's hosted checkout page, and renewals run automatically.
What happens on each renewal?
HandyPay charges the card and sends a signed webhook. The plugin creates a new WooCommerce order for the renewal (linked to the signup order, marked paid, stock and reports updated) so your order history matches what was billed. If a renewal fails, the signup order is noted, the subscription shows as past due, and HandyPay retries the card; if the retries fail, the subscription is cancelled.
How do customers cancel or update their card?
From My Account → Subscriptions. "Update card" opens HandyPay's secure manage page; "Cancel" stops the subscription at the end of the paid period. You can also cancel, resume, or open the manage page for any subscription from WooCommerce → Subscriptions.
How do I unlock content for subscribers?
On the subscription product, choose a role under Grant role while active. Then wrap content in [handypay_members product="123"]...[/handypay_members] or use the Members only (HandyPay) block. Access is removed when the subscription ends, after the grace period you set in the gateway settings for failed payments.
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.
Which currency is sent to HandyPay?
The gateway uses the currency saved on each WooCommerce order. Amounts, checkout sessions, order notes, and refunds therefore stay in the order currency instead of assuming US or Jamaican dollars.
更新日志:
- Subscriptions, complete: renewals become linked WooCommerce orders, failed renewals mark the subscription past due with the retry date, and cancellations from HandyPay or the customer sync to the order.
- New WooCommerce → Subscriptions screen and an order-screen box: status, next renewal, cancel at period end, cancel now, resume, sync, and the customer's manage page.
- New My Account → Subscriptions tab: customers update their card on HandyPay's secure page, cancel, or keep a cancelled subscription.
- Unlock content: grant a role while a subscription is active, gate content with the [handypay_members] shortcode or the Members only (HandyPay) block, and a past-due grace period setting.
- Subscription products gain a free trial, a sign-up fee, "charge shipping once", and support for variable products. The recurring amount, one-time items, and the WooCommerce order total always agree to the cent.
- Fixed: test-mode webhooks could act on live orders (the mode is now checked on every event). Expired checkouts cancel the order; failed payments mark it failed with the processor's reason.
- Refunds from the WooCommerce order screen now work on renewal orders too, and dashboard refunds of renewals sync back.
- Requires HandyPay Payments 1.2.0 or newer for subscription management (checkout works on 1.1.0).
- Added HandyPay subscriptions for simple WooCommerce products with daily, weekly, monthly, or yearly billing through hosted Stripe Checkout.
- Subscription checkout uses the WooCommerce order currency, including GYD for Guyana merchants, and keeps recurring billing on HandyPay's managed payment rails.
- Added a clear update prompt when HandyPay Payments is older than the required 1.1.0 release.
- Orders record whether they were paid in live or test mode, and test webhook events can never change live orders.
- Refund fixes: a failed HandyPay refund no longer marks the order refunded (previously WooCommerce would restock and adjust reports anyway), pending refunds are noted as processing, and the refund id is stored so the webhook cannot double-record it.
- Restored the delayed-payment guard on the thank-you page: complete-but-unpaid sessions (bank debits and similar) stay pending until the payment actually settles.
- Quick links to HandyPay system status, product updates, and support from the gateway settings.
- Fixed partial-refund sync so every refund amount is recorded correctly in WooCommerce.
- Added reliable handling for delayed payment methods and failed asynchronous payments.
- Refreshed settings links and HandyPay branding.
- Removed handypay-payments from the Requires Plugins header. That plugin is distributed from handypay.me rather than the WordPress.org directory, so the header cannot resolve it. The dependency is handled by a runtime check whose admin notice links to the download.
- 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.