使用 OpenCart 3 接受加密貨幣付款

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

OpenCart 3.0.x

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

01 · 準備 MochiPay 賬戶

1. 建立賬戶 與 啟用訂閱.
2. 開啟 錢包，選擇新增 HD 錢包 → 生成新錢包，私下備份助記詞並儲存，啟用測試使用的資產 / 網路。
3. 在此處設定客戶能識別的顯示名稱 賬戶資料.
4. 開啟 API 憑證 並複製 API Key 和已儲存的 API Secret。首次設定若未儲存金鑰，請重新生成並妥善儲存。重新生成現有金鑰會使使用舊金鑰的接入失效。

完成標準： 你的訂閱與收款錢包均有效，並已取得下方所需憑證。

02 · 安裝並儲存配置

上傳方式 擴充套件 > 安裝器，重新整理 擴充套件 > 修改，然後安裝 / 配置 MochiPay，位置為 擴充套件 > 擴充套件 > 支付。合併 upload/ ，必要時手動合併。採用 Twig 檢視和 payment_mochipay_* 設定。等待狀態預設 1，已付款預設 5，兩者必須不同。此外掛不會使未經修補的舊 3.x 核心相容 PHP 8。

設定	新安裝預設值 / 操作
MochiPay URL	https://mochi.bz — 預設填寫；不新增 /api 字尾
API 金鑰 / API 秘密	首次填寫自己的商戶憑證
支付介面	站內支付 — 預設；也支援 HPP
客戶支付選項	預設勾選全部五項：USDT/TRC20、USDC/ERC20、BTC/Bitcoin、ETH/Ethereum、SOL/Solana
已啟用	初始關閉，填寫憑證後啟用
唯一金額調整方向	UP — 預設；也可按偏好選擇 DOWN

填寫憑據後啟用 MochiPay 並儲存唯一金額方向偏好。預設勾選所有資產，只保留已啟用收款錢包支援的選項。原位檔案更新保留現有設定，包括 HPP。

03 · 站內支付或 HPP

站內支付（預設）： 顧客在商城域名內檢視支付地址、準確金額、網路和二維碼。採用跳轉式閘道器的平臺會開啟商城本地支付頁並顯示彈窗。

HPP: 將支付介面切換為 HPP，付款人將跳轉至 MochiPay 託管付款頁。

04 · 支付並驗證小額訂單

1. 下一個小額訂單，並在結賬時選擇已啟用的資產 / 網路。
2. 站內支付開啟商城對話方塊，HPP 開啟 MochiPay；核對訂單金額 / 幣種、精確加密貨幣數量、網路與地址。
3. 傳送準確顯示的數量，地址二維碼不含金額，不能取整或複用其他訂單地址。
4. 等待鏈上確認，在 MochiPay 檢查 PAID，並核對商城已付款狀態。

瀏覽器返回、掃碼或截圖不能證明付款。外掛重新查詢 API 並驗證訂單後才更新。少付、多付、取消及到期不會自動完成商城訂單。

05 · 收款與升級

將收款地址與交易匹配到訂單和錢包，資金進入你的錢包，不存在平臺資金池。

原位更新檔案，保留已儲存設定和歷史訂單關聯，然後清除平臺快取。升級時不要解除安裝模組。建立超時後再次付款前，先檢查或查詢已有嘗試。

測試未完成時