YS Helcim via FluentCart

FluentCart × Helcim: Payment Window + Embedded Card Form Dual Modes, Including Digital Wallets and Refunds.

v1.1.4 Fluent Cart FluentCart Free Download

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.4

The refund dialog on a FluentCart order page now checks the payment with Helcim as soon as it opens, and reloads the order after a successful refund. Checkout explains a HelcimPay.js security-check failure and lets the shopper reopen the same payment window. No settings changes are required.

1.1.4 (2026-10-12)

#### Changed

  • The refund dialog on a FluentCart order page now checks the payment with Helcim as soon as it opens. It automatically selects the order's only Helcim payment (choose one when there are several) and shows Helcim's status for it, the original amount, whether its settlement batch is still open, and the order's refund limit from the refunds FluentCart has recorded. Checking only reads: it never syncs refunds or sends a refund. When the check fails, the dialog says why and offers: Check again.
  • The form is shorter: the amount, an optional reason and Refund payment — or Cancel the full payment While the batch is still open, because Helcim only allows the full amount to be cancelled before settlement. Item and stock options and Advanced recovery and details Keep it folded away until needed.
  • Once Helcim confirms the refund or void and FluentCart has recorded it, the dialog shows the result, folds the form away and reloads the order after two seconds, so the payment status is current without closing the dialog. A refused or unknown outcome stays in the dialog, and an unknown one stays locked against a second refund.

#### Fixed

  • When Helcim's hosted payment window cannot validate its ReCaptcha check, checkout explains the problem and offers Reopen payment window, which resumes the same payment session through the existing server checks, instead of waiting indefinitely for a payment result. Other unconfirmed outcomes stay locked until they are verified, and no payment is marked failed on the browser's word alone.
  • The hosted payment button and its error messages are exposed to screen readers. FluentCart marks the payment container as hidden from assistive technology even while it is visible.

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.

0