← 全部接入指南
商城外掛 · 站內支付 + HPP

使用 thirty bees 1.6 接受加密貨幣付款

適用於 thirty bees 1.6 的原生支付模組與訂單歷史。

新增介面卡為初始接入版本。正式啟用前,請在自己的測試商城完成安裝和真實付款驗收。

選擇正確的安裝包與 PHP 環境

購物系統本安裝包的 PHP 環境
thirty bees >=1.6.0 <1.7.0PHP 7.4.x / 8.0.x / 8.1.x / 8.2.x / 8.3.x;請使用對應的 thirty bees 發行包

使用安裝包與確切商城核心均允許的 PHP 版本,外掛不能使舊商城核心相容新版 PHP。

新包使用可選 request_id 去重功能,需要 MochiPay Web65 或更高版本。已有客戶可繼續使用當前外掛和 API 接入。

01 · 準備 MochiPay 賬戶

  1. 建立賬戶 · 啟用訂閱.
  2. 錢包 · 為準備提供的每種幣種和網路啟用收款錢包,並在結賬前備份恢復資料。
  3. API 憑證 · 商戶 API Key 和 Secret 僅儲存在服務端,不能放入結賬 HTML 或瀏覽器指令碼。

02 · 安裝並啟用原生閘道器

  1. 在 Modules > Add a new module 上傳 ZIP,或將 mochipay 解壓到 modules/mochipay,再安裝 MochiPay。
  2. 安裝程式會建立未付款的等待狀態。開啟 Configure,填寫憑據、啟用閘道器、選擇金額調整方向並儲存。
  3. 在原生支付限制中允許所需國家、客戶組和法幣。確保 Payment accepted 狀態配置正確。
  4. 使用與 PHP 版本對應的 thirty bees 1.6 發行包。清除快取並使用單個原生訂單;拆分購物車訂單會被拒絕並要求檢查。

每個 ZIP 內的英文 README 包含準確路徑、原生配置、依賴和升級說明,請按對應平臺的檔案操作。

03 · 檢查預設預設值

設定預設值
MochiPay URLhttps://mochi.bz
支付模式ON_SITE
唯一金額調整方向(Unique amount direction)UP
已選幣種與網路USDT/TRC20 · USDC/ERC20 · BTC/Bitcoin · ETH/Ethereum · SOL/Solana
啟用閘道器填寫憑據並準備好收款錢包後再啟用。

填寫 API 憑據,選擇 Unique amount direction 的 UP 或 DOWN,啟用 MochiPay 並儲存。ON_SITE 和六種支付方式已預選;僅向客戶提供已啟用收款錢包的方式,仍需完成原生支付方式與渠道設定。

04 · ON_SITE 和 HPP 使用同一筆支付

ON_SITE

商城內支付彈窗

預設 ON_SITE 彈窗在商城域名下展示準確金額、收款地址、網路、二維碼和支付狀態。

HPP

MochiPay 託管支付頁

HPP 開啟 MochiPay 的 payment_url,結賬後返回商城。可在同一閘道器設定中選擇 HPP。

重新開啟結賬或切換展示模式會複用已儲存的支付訂單。MochiPay API 無需新增 payment_mode 引數。

體驗公開 ON_SITE/HPP 模擬演示 →

05 · 正式使用前驗證測試訂單

  1. 建立小額測試訂單。付款前確認法幣總額、所選幣種、網路及準確加密貨幣金額。
  2. 確認服務端查詢 MochiPay,只有匹配的 PAID 結果才更新原生已付款狀態。返回 URL 或回撥內容本身不能證明付款。
  3. 測試 HPP、ON_SITE、重新開啟結賬及重複通知,確認複用同一訂單且只處理一次支付完成。

這些下載包已完成原始碼與介面檢查及模擬結賬驗證。完整原生商城安裝和真實付款結賬仍需測試環境驗收。

瞭解服務端付款驗證 →

排查問題與下載

若閘道器未顯示,請檢查準確商城分支、PHP、快取、原生支付方式啟用狀態及渠道限制。若訂單一直等待付款,請檢查憑據、有效訂閱、錢包和公開回撥可達性。升級時保留已有支付嘗試記錄。