Fahad HSBC Payments for WooCommerce – PayMe & Hosted Card Gateway
| 开发者 |
fahadmahmood
invoicepress |
|---|---|
| 更新时间 | 2026年10月26日 03:58 |
| PHP版本: | 7.4 及以上 |
| WordPress版本: | 7.1 |
| 版权: | GPLv2 or later |
| 版权网址: | 版权信息 |
详情介绍:
HSBC Payments for WooCommerce adds two payment methods to your store, each configured under WooCommerce > Settings > Payments.
PayMe from HSBC (uses the PayMe for Business API)
- HKD only, as required by PayMe.
- A clean pay page with a PayCode (QR), an "Open PayMe app" button on phones, a live countdown and status.
- Orders are confirmed by HSBC's signed webhook, with a rate-limited status check as a safety net.
- Full and partial refunds from the order screen, and a manual "re-check status" button.
- Separate sandbox and live credentials, plus a "Test connection" button.
- Customers enter card details on the gateway's hosted page, so card data never reaches your server.
- Orders are confirmed by reading the order back from the gateway, never by trusting the browser redirect.
- Charge immediately, or authorize now and capture when the order is completed (cancelling voids the hold).
- Optional webhook safety net and refunds from the order screen.
- Needs the gateway host, merchant ID and API password issued to you by HSBC.
- HSBC payment panel on every order showing references, with capture and re-check actions.
- Translation ready, with Traditional Chinese (Hong Kong) included for customer-facing text.
- Works with the block-based Cart and Checkout and the classic shortcode checkout.
- Declares compatibility with High-Performance Order Storage (HPOS).
- Secrets are masked in logs; webhook signatures and digests are verified before anything is changed.
- No third-party logos are bundled. Add your own licensed icon URL in settings.
安装:
- Upload the plugin in Plugins > Add New > Upload Plugin, then activate. WooCommerce must be active.
- Go to WooCommerce > Settings > Payments and open PayMe from HSBC or HSBC card payments.
- Enter your sandbox credentials, save, then press "Test connection".
- Place a test order. Switch to live only after HSBC approves your sandbox testing.
常见问题:
Which currencies work?
PayMe: HKD only. Cards: the currencies enabled on your HSBC account (set them in "Allowed currencies").
Where do I get credentials?
PayMe: open a PayMe for Business account and register at the HSBC developer portal (develop.hsbc.com). Cards: ask your HSBC relationship manager for your gateway host, merchant ID and API password.
Does it work with the block checkout?
Yes, and with the classic checkout.
The sandbox says it cannot verify the signature.
Switch "Signing key format" between Base64 and Plain in the PayMe settings, then try again.
Customers paid but the order did not complete.
Your site must be reachable over HTTPS so HSBC can call the notification URL. Check security plugins and firewalls are not blocking it, and turn on the debug log under the method's Advanced settings.
Can I refund from WooCommerce?
Yes, use the normal Refund button on the order. PayMe refunds must be made against a completed payment.
更新日志:
2.2.0 – 2026-10-26
- New: order screen panel with PayMe request and transaction IDs, card gateway references, and re-check / capture buttons.
- New: card authorize-then-capture. Completing the order captures; cancelling an authorized order voids the hold.
- New: translation template (.pot) and Traditional Chinese (zh_HK) for customer-facing text.
- New: automated test suite for request signing, webhook verification and state mapping (
php tests/run.php). - New: coding-standards config, setup guide with go-live checklist, store icon and banner.
- Improved: block checkout hints are now translatable.
- Improved: clearer notes on orders when amounts or currencies do not match.
- New: complete rewrite for the current PayMe for Business API (v0.12) with signed requests and signed webhook verification.
- New: hosted card payments through a gateway hosted checkout, confirmed by server-side order lookup.
- New: block checkout and classic checkout support; HPOS compatibility declared.
- New: modern pay page with QR code, mobile deep link, countdown, live status, dark mode and reduced-motion support.
- New: full and partial refunds from the WooCommerce order screen.
- New: separate sandbox and live credentials, "Test connection" button, masked debug logging.
- New: clean uninstall of settings and cached tokens.
- Requires WooCommerce 8.0 or newer and PHP 7.4 or newer. Tested up to WordPress 7.1 and WooCommerce 11.2.
- Internal pre-release.