使用 Shopware 6.6 / 6.7 接受加密货币付款

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

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

新包使用可选 request_id 去重功能，需要 MochiPay Web65 或更高版本。已有客户可继续使用当前插件和 API 接入。

01 · 准备 MochiPay 账户

1. 创建账户 · 启用订阅.
2. 钱包 · 为准备提供的每种币种和网络启用收款钱包，并在结账前备份恢复资料。
3. API 凭证 · 商户 API Key 和 Secret 仅保存在服务端，不能放入结账 HTML 或浏览器脚本。

02 · 安装并启用原生网关

1. 仅安装对应 Shopware 分支的 ZIP。可在 Extensions > My extensions 上传，或将 MochiPay 解压到 custom/plugins/MochiPay。不要同时安装两个包。
2. 在商城根目录运行 bin/console plugin:refresh，再运行 bin/console plugin:install --activate MochiPay。
3. 为使用此网关的每个销售渠道配置凭据并启用扩展。在 Settings > Payment methods 启用支付方式并分配销售渠道。
4. 将 Shopware 6.6 升级到 6.7 时，先备份设置和支付历史，再用 6.7 包替换插件文件，最后按正常流程运行 plugin:update MochiPay。

每个 ZIP 内的英文 README 包含准确路径、原生配置、依赖和升级说明，请按对应平台的文件操作。

03 · 检查预设默认值

填写 API 凭据，选择 Unique amount direction 的 UP 或 DOWN，启用 MochiPay 并保存。ON_SITE 和五种支付方式已预选；仅向客户提供已启用收款钱包的方式，仍需完成原生支付方式与渠道设置。

04 · ON_SITE 和 HPP 使用同一笔支付

重新打开结账或切换展示模式会复用已保存的支付订单。MochiPay API 无需新增 payment_mode 参数。

05 · 正式使用前验证测试订单

1. 创建小额测试订单。付款前确认法币总额、所选币种、网络及准确加密货币金额。
2. 确认服务端查询 MochiPay，只有匹配的 PAID 结果才更新原生已付款状态。返回 URL 或回调内容本身不能证明付款。
3. 测试 HPP、ON_SITE、重新打开结账及重复通知，确认复用同一订单且只处理一次支付完成。

这些下载包已完成源码与接口检查及模拟结账验证。完整原生商城安装和真实付款结账仍需测试环境验收。

排查问题与下载

若网关未显示，请检查准确商城分支、PHP、缓存、原生支付方式启用状态及渠道限制。若订单一直等待付款，请检查凭据、有效订阅、钱包和公开回调可达性。升级时保留已有支付尝试记录。