YS Helcim via FluentCart

FluentCart × Helcim:付款視窗+內嵌卡表雙模式,含數位錢包與退款。

v1.1.0 Fluent Cart FluentCart 免費下載

FluentCart 想收北美市場的錢,Helcim 是手續費友善的選擇。這支外掛把 Helcim 完整接進 FluentCart,提供兩種收款模式,涵蓋信用卡與 Google Pay/Apple Pay 數位錢包,支援 USD 與 CAD。

兩種收款模式任選

HelcimPay.js 付款視窗:安全的託管付款視窗,Google Pay 與 Apple Pay 在支援的裝置上自動出現;helcim.js 內嵌卡表:卡號於瀏覽器端直接權杖化(tokenize),卡片資料完全不經過你的伺服器,PCI 負擔最小化。兩種模式都可獨立啟用。

退款與 Webhook 對帳

退款直接在 FluentCart 訂單頁操作;Webhook 以 HMAC 簽章驗證並在入帳前回查 Helcim 交易核對金額——通知內容不可信任是原則,查證後才入帳。API 憑證加密儲存、除錯日誌自動遮罩敏感資料。

功能特色

HelcimPay.js 付款視窗

安全託管視窗,Google Pay/Apple Pay 自動出現。

helcim.js 內嵌卡表

瀏覽器端權杖化,卡片資料不觸及你的伺服器。

訂單頁退款

FluentCart 訂單畫面直接發動退款。

Webhook HMAC 對帳

簽章驗證+回查交易核對金額後才入帳。

USD/CAD 支援

幣別不符時付款方式自動隱藏,避免錯收。

憑證加密與遮罩日誌

API 憑證加密儲存,除錯記錄自動遮罩敏感資料。

螢幕截圖

更新日誌(最新版)

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 strands the checkout. 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 refunds: a refund is recorded locally only after Helcim confirms it, with persistent idempotency keys. Unsettled (open-batch) full refunds automatically use reverse.
  • Fail-closed reconciliation: uncertain 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

  • Source commit: `10847a86f6d476e15667a823d8bd240e49255c3d`
  • 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.

常見問題

需要什麼帳號?

需要 Helcim 商家帳號與 API Token;Helcim 沒有獨立沙盒,測試請申請開發者測試帳號並使用官方測試卡號。

支援哪些幣別?

USD 與 CAD。商店幣別不符時,本付款方式不會顯示於結帳頁。

兩種模式差在哪?

HelcimPay.js 是託管付款視窗(含數位錢包);helcim.js 是內嵌在結帳頁的卡片表單(純信用卡、體驗不跳窗)。可依喜好擇一或並開。

支援訂閱嗎?

v1 專注一次性付款(含退款與對帳);訂閱/預授權在後續版本規劃中。

0