OpenCart 插件
为 OpenCart 接入加密支付。
将商店连接到你自己的 Wholly Crypto 收银台。顾客选择网络和代币，订单通过经过验证的通知更新。
获取插件
v1.0.1首个版本适用于 OpenCart 4.1.x 和 PHP 8.1+，已在 OpenCart 4.1.0.4 上测试。请先在测试环境检查你的主题和结账流程。
MIT 许可 · 包含 PHP SDK · 无需配置 Composer
结账简单，订单可靠验证。
- 托管收银台，展示商店接受的资产
- 签名 IPN 与经过身份验证的 API 检查
- 保存账单重试记录，防止重复入账
钱包密钥保留在 Wholly Crypto 中。插件不收取额外百分比费用，处理额度的计费规则仍然适用。
安装
下载安装包并核对 SHA256SUMS，不要使用 GitHub 自动生成的源码 ZIP。
whollycrypto.ocmod.zip
保留此文件名，通过以下菜单上传并安装：
Extensions → Installer
然后安装并编辑支付方式：
Extensions → Extensions → Payments → Wholly Crypto
连接商店
填写 API 和收银台源地址、项目和商店的 API UUID、仅限该项目的读写 API 凭据，以及商店的 IPN 签名密钥。在 Wholly 中启用 IPN，回调地址由插件提供。
使用 HTTPS，确保防火墙允许回调通过，且不需要 CAPTCHA 或浏览器登录。保存并检查连接后，再完成一次测试支付。
选择待支付、已付款、待审核和已过期的订单状态。只有已付款状态可以触发 OpenCart 履约。首个版本每个安装共用一个连接。
连接检查仅验证 API 访问，不代表完整支付流程已经通过测试。
检查支付流程
未确认或部分付款会保持待处理状态。匹配的已结算付款只更新订单一次。多付、迟付、无效付款或修改过的订单需要检查。浏览器跳转回来并不代表付款成功。
OpenCart 会将验证结果记录到订单历史，并保留其原生反欺诈检查。可通过 Wholly 的 IPN 历史查看并重发失败通知。
限制与发送问题
此版本支持金额为正的法币订单和完整页面收银台，不支持自动退款或定期扣款，也不支持 OpenCart 3.x 和 4.0.x。
额度不足可能暂停 IPN，但顾客仍可付款。恢复额度后，可从 Wholly 的投递历史中重发失败通知。