使用 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。1.7.6 之前及 9.0.x 之后的版本不在此包支持范围内。

设置	新安装默认值 / 操作
MochiPay URL	https://mochi.bz — 默认填写；不添加 /api 后缀
API Key / API Secret	首次填写自己的商户凭证
支付界面	站内支付 — 默认；也支持 HPP
客户支付选项	默认勾选全部五项：USDT/TRON、USDC/Ethereum、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 · 收款与升级

将收款地址与交易匹配到订单和钱包，资金进入你的钱包，不存在平台资金池。

原位更新文件，保留已保存设置和历史订单关联，然后清除平台缓存。升级时不要卸载模块。创建超时后再次付款前，先检查或查询已有尝试。

测试未完成时