← 全部接入指南
商城插件 · 站内支付 + HPP

使用 thirty bees 1.6 接受加密货币付款

适用于 thirty bees 1.6 的原生支付模块与订单历史。

新增适配器为初始接入版本。正式启用前,请在自己的测试商城完成安装和真实付款验收。

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

商城平台本安装包的 PHP 环境
thirty bees >=1.6.0 <1.7.0PHP 7.4.x / 8.0.x / 8.1.x / 8.2.x / 8.3.x;请使用对应的 thirty bees 发行包

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

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

01 · 准备 MochiPay 账户

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

02 · 安装并启用原生网关

  1. 在 Modules > Add a new module 上传 ZIP,或将 mochipay 解压到 modules/mochipay,再安装 MochiPay。
  2. 安装程序会创建未付款的等待状态。打开 Configure,填写凭据、启用网关、选择金额调整方向并保存。
  3. 在原生支付限制中允许所需国家、客户组和法币。确保 Payment accepted 状态配置正确。
  4. 使用与 PHP 版本对应的 thirty bees 1.6 发行包。清除缓存并使用单个原生订单;拆分购物车订单会被拒绝并要求检查。

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

03 · 检查预设默认值

设置默认值
MochiPay URLhttps://mochi.bz
Payment modeON_SITE
唯一金额调整方向(Unique amount direction)UP
已选币种与网络USDT/TRC20 · USDC/ERC20 · BTC/Bitcoin · ETH/Ethereum · SOL/Solana
启用网关填写凭据并准备好收款钱包后再启用。

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

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

ON_SITE

商城内支付弹窗

默认 ON_SITE 弹窗在商城域名下展示准确金额、收款地址、网络、二维码和支付状态。

HPP

MochiPay 托管支付页

HPP 打开 MochiPay 的 payment_url,结账后返回商城。可在同一网关设置中选择 HPP。

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

体验公开 ON_SITE/HPP 模拟演示 →

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

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

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

了解服务端付款验证 →

排查问题与下载

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