使用 Magento 1 / OpenMage 接受加密货币付款

选择正确的安装包与 PHP 环境

Magento CE 1.9.3.0–1.9.4.5；OpenMage 19/20 原生 M1 API

使用安装包与确切商城核心均允许的 PHP 版本，插件不能使旧商城核心兼容新版 PHP。

01 · 准备 MochiPay 账户

1. 创建账户 及 启用订阅.
2. 打开 钱包，选择添加 HD 钱包 → 生成新钱包，私下备份助记词并保存，启用测试使用的资产 / 网络。
3. 在此处设置客户能识别的显示名称 账户资料.
4. 打开 API 凭证 并复制 API Key 和已保存的 API Secret。首次设置若未保存密钥，请重新生成并妥善保存。重新生成现有密钥会使使用旧密钥的接入失效。

完成标准： 你的订阅与收款钱包均有效，并已取得下方所需凭证。

02 · 安装并保存配置

合并 app/ 合并至商店根目录。安装前禁用 Magento 1 编译；如有使用，安装后重新编译。清除配置和区块缓存，退出管理后台后重新登录。打开 系统 > 配置 > 销售 > 支付方式 > MochiPay。填写凭据、启用，并在正确的网站或商店范围内保存。模块启用文件为 app/etc/modules/MochiPay_Payment.xml。自定义主题需包含附带支付表单模板，或保留原生 base/default 回退。此模块适用于 Magento 1。Magento 1.0–1.8 和 CE 1.9.0–1.9.2 不在支持范围内。原版 Magento CE 1.x 不声明兼容 PHP 8；PHP 8 仅适用于兼容的 OpenMage 核心。

设置	新安装默认值 / 操作
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 · 收款与升级

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

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

测试未完成时