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