FluentCart経由のYS Helcim
FluentCart × Helcim:決済ウィンドウ+インラインカードフォームのデュアルモード、デジタルウォレットと返金機能付き。
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 憑證加密儲存,除錯記錄自動遮罩敏感資料。
スクリーンショット
更新日誌 (最新)
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; masked debug logging
- 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 has no sandbox environment. To test, request a "developer test account" from Helcim and use the official test card numbers.
よくある質問
アカウントは必要ですか?
需要 Helcim 商家帳號與 API Token;Helcim 沒有獨立沙盒,測試請申請開發者測試帳號並使用官方測試卡號。
支援哪些幣別?
USD 與 CAD。商店幣別不符時,本付款方式不會顯示於結帳頁。
兩種模式差在哪?
HelcimPay.js 是託管付款視窗(含數位錢包);helcim.js 是內嵌在結帳頁的卡片表單(純信用卡、體驗不跳窗)。可依喜好擇一或並開。
支援訂閱嗎?
v1 專注一次性付款(含退款與對帳);訂閱/預授權在後續版本規劃中。