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)

YS Helcim via FluentCart 1.1.0

A production-hardening release for both payment methods. Every payment and refund path was rebuilt around a durable operation journal, verified end-to-end with real test-account transactions, and independently reviewed.

Highlights

Closing the payment window no longer breaks the checkout process. The pay button re-enables immediately, and pressing it again resumes the same secure payment session. The same order can never be charged twice, even across browser tabs, crashes, or page reloads.
Google Pay can now be controlled from the payment settings (follow the Helcim account, force on, or off), and the checkout button wording follows suit.
Remote-first refundsA refund is recorded locally only after Helcim confirms it, using persistent idempotency keys. Unsettled (open-batch) full refunds automatically use reverse.
Fail-closed reconciliationUncertain payment outcomes are quarantined and re-verified against Helcim. A real charge can never be silently lost, and an unproven charge is never assumed.
Webhook and scheduled recovery with provider/local state integrity checks.
English-first admin UI with a complete Traditional Chinese (zh_TW) translation.

Upgrading from 1.0.0

No settings changes are required. Existing credentials, orders, and refunds are untouched; the operation journal tables are created automatically.

Verification

Translate to English (US)
Artifact SHA-256: `f67b1a4c7ca8970badd494c1584ac0dfc506377d940ffa39e7cf3ece3f69182f`
Package: 100 files, clean source, manifest schema v2
PHP: 1270 tests, 7202 assertions, 0 failures
JavaScript: 54 tests, 0 failures
Translation catalogs: 392/392 preserved, fallback 0
Runtime parity, PHP lint, mtime, and symlink deployment gates all passed

The payment runtime is byte-identical to the independently reviewed 1.1.0-rc.17 anchor; the final tag changes only release metadata and generated translation catalog headers.

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.