YS Helcim via FluentCart
FluentCart × Helcim: Payment Window + Embedded Card Form Dual Modes, Including Digital Wallets and Refunds.
FluentCart wants to collect payments from the North American market, and Helcim is a fee-friendly option. This plugin fully integrates Helcim into FluentCart, offering two payment methods that cover credit cards and digital wallets like Google Pay/Apple Pay. It supports both USD and CAD.
Choose between two payment methods
HelcimPay.js Payment WindowSecure hosted payment window; Google Pay and Apple Pay appear automatically on supported devices.Helcim.js embedded card formCard numbers are tokenized directly on the browser side, so card data never passes through your server, minimizing PCI burden. Both modes can be enabled independently.
Refunds and Webhook Reconciliation
Refunds are processed directly on the FluentCart order page; webhooks verify with HMAC signatures and check Helcim transactions before crediting to reconcile amounts. The principle is that notification content is not trusted and crediting only occurs after verification. API credentials are encrypted and stored, and debug logs automatically mask sensitive data.
Features
HelcimPay.js Payment Window
Secure checkout window, Google Pay/Apple Pay appears automatically.
Helcim.js embedded card form
Browser-side tokenization, card data does not touch your servers.
Order page refund
FluentCart order screen initiates refund directly.
Webhook HMAC Reconciliation
Signature verification, transaction recall, and amount reconciliation before crediting.
USD/CAD Support
When the currency doesn't match, the payment method is automatically hidden to prevent incorrect collection.
Certificate Encryption and Log Masking
API credentials encrypted and stored, debug logs automatically mask sensitive data.
Screenshots
Changelog (Latest)
The first public release. Adds Helcim as a payment gateway for FluentCart.
Payment methods
- HelcimPay.js modal checkout (`ys_helcim`) — a secure hosted payment window. Google Pay and Apple Pay appear automatically on supported devices/browsers.
- helcim.js inline card form (`ys_helcim_js`) — Card numbers are tokenized in the browser, so card data never touches your server.
Features
- Refunds directly from the FluentCart order screen
- Webhook reconciliation with HMAC signature verification
- USD and CAD support
- Credentials encrypted at rest; debug logging masked
- Auto-updates via the YS Plugin Hub
- English (default) with Traditional Chinese (zh_TW) translation
Requirements
WordPress 6.0+, PHP 8.1+, FluentCart 1.5.2+
Testing
Helcim does not have a sandbox environment. To test, request a "developer test account" from Helcim and use the official test card numbers.
FAQ
What account is needed?
You need a Helcim merchant account and API Token; Helcim does not have a separate sandbox. For testing, please apply for a developer test account and use the official test card numbers.
Which currencies are supported?
USD and CAD. This payment method will not be displayed on the checkout page if the store currency does not match.
What's the difference between the two modes?
HelcimPay.js is a hosted payment window (with digital wallet). helcim.js is a card form embedded in the checkout page (pure credit card, no pop-ups for the experience). You can choose one or use both, according to your preference.
Do you support subscriptions?
v1 focuses on one-time payments (including refunds and reconciliation); subscriptions/pre-authorizations are planned for future versions.
