使用 PrestaShop 1.7 / 8 / 9 接受加密貨幣付款

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

PrestaShop 1.7.6-1.7.8 / 8.x / 9.0.x

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

01 · 準備 MochiPay 賬戶

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

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

02 · 安裝並儲存配置

上傳 ZIP 的位置 模組管理器 > 上傳模組，安裝 MochiPay 並開啟配置，或手動合併 mochipay/ 放入 modules/mochipay/。填寫憑據，將啟用設為是並儲存，允許原生訂單幣種、國家及顧客組使用此模組。此包採用 paymentOptions 並將貨幣/網路選擇綁定到本機支付形式。自動建立等待狀態；已驗證的付款使用所接受的付款。 PHP 8 適用於 PrestaShop 8/9，不適用於 PrestaShop 1.7。 1.7.6 之前和 9.0.x 之後的版本超出了此套件的聲明範圍。

設定	新安裝預設值 / 操作
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 · 收款與升級

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

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

測試未完成時