使用 Magento 2 接受加密货币付款

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

Magento Open Source 2.3.7–2.4.8，使用原生结账

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

01 · 准备 MochiPay 账户

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

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

02 · 安装并保存配置

复制 MochiPay/Payment/ to app/code/MochiPay/Payment/。使用 Magento 文件所有者账号运行：

php bin/magento module:enable MochiPay_Payment
php bin/magento setup:upgrade
php bin/magento cache:flush

生产模式下还需运行 php bin/magento setup:di:compile 以及商店通常使用的 setup:static-content:deploy 命令。打开 商店 > 配置 > 销售 > 支付方式 > MochiPay，填写凭据、启用并保存。附带 Knockout 支付渲染器适配 Magento 原生结账。Hyva、无头或自定义结账需要单独的前端适配器。PHP 8.5 和 Magento 2.4.9+ 不在声明范围内。

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

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

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

测试未完成时