← 全部接入指南选择正确的安装包与 PHP 环境
Zen Cart 1.5.3-1.5.7
| 商城平台 | 本安装包的 PHP 环境 |
|---|
| 1.5.3-1.5.4 | 5.6 |
|---|
| 1.5.5 | 5.6-7.1 |
|---|
| 1.5.6 | 5.6-7.3 |
|---|
| 1.5.7 | 5.6-8.0 |
|---|
使用安装包与确切商城核心均允许的 PHP 版本，插件不能使旧商城核心兼容新版 PHP。
01 · 准备 MochiPay 账户
- 创建账户 及 启用订阅.
- 打开 钱包，选择添加 HD 钱包 → 生成新钱包，私下备份助记词并保存，启用测试使用的资产 / 网络。
- 在此处设置客户能识别的显示名称 账户资料.
- 打开 API 凭证 并复制 API Key 和已保存的 API Secret。首次设置若未保存密钥，请重新生成并妥善保存。重新生成现有密钥会使使用旧密钥的接入失效。
完成标准： 你的订阅与收款钱包均有效，并已取得下方所需凭证。
查看图文账户设置 →03 · 站内支付或 HPP
站内支付（默认）： 顾客在商城域名内查看支付地址、准确金额、网络和二维码。采用跳转式网关的平台会打开商城本地支付页并显示弹窗。
HPP: 将支付界面切换为 HPP，付款人将跳转至 MochiPay 托管付款页。
04 · 支付并验证小额订单
- 下一个小额订单，并在结账时选择已启用的资产 / 网络。
- 站内支付打开商城对话框，HPP 打开 MochiPay；核对订单金额 / 币种、精确加密货币数量、网络与地址。
- 发送准确显示的数量，地址二维码不含金额，不能取整或复用其他订单地址。
- 等待链上确认，在 MochiPay 检查 PAID，并核对商城已付款状态。
浏览器返回、扫码或截图不能证明付款。插件重新查询 API 并验证订单后才更新。少付、多付、取消及到期不会自动完成商城订单。
05 · 收款与升级
将收款地址与交易匹配到订单和钱包，资金进入你的钱包，不存在平台资金池。
原位更新文件，保留已保存设置和历史订单关联，然后清除平台缓存。升级时不要卸载模块。创建超时后再次付款前，先检查或查询已有尝试。
了解付款与钱包 →测试未完成时
无法创建支付选项或订单
检查订阅状态、已启用收款钱包、支付方式代码、凭据及订单币种汇率对。插件还需确认测试使用的商城范围及顾客已启用该支付方式。
付款仍在等待中或金额不足
核对交易的资产、网络、地址和准确应付金额，并等待所需确认数。请勿仅凭截图或浏览器返回将商城订单标记为已付款。
MochiPay 已付款，但商城 / 应用状态未更新
确认通知/回调端点能通过 HTTPS 公开访问，且未被身份验证或防火墙拦截。确认接入能查询 MochiPay 并检查错误日志。仅收款链接更新 MochiPay，不会更新外部商城。