电商插件
OpenCart 扩展
安装并配置官方 OpenCart 支付扩展,支持原生 OAuth、DPoP 绑定令牌、托管 MakePay 结账和签名 Webhook。
概述
MakePay OpenCart 扩展为 OpenCart 商店提供托管加密支付,支持原生 OAuth、DPoP 绑定令牌、托管 MakePay 结账和签名 Webhook。
开始之前
- OpenCart 商店和管理后台使用 HTTPS。
- PHP 启用 OpenSSL。
- 拥有安装扩展和管理支付方式的管理员权限。
- MakeCrypto 公司已配置 MakePay 结算资产。
设置 MakeCrypto
选择收款公司,完成结算资产、费用承担、重定向和少付容差设置。商店连接会使用该公司创建支付链接和接收 Webhook。
安装扩展
下载官方 OCMOD 包:
https://plugins.makecrypto.io/downloads/opencart/latest.ocmod.zip
在 OpenCart 后台上传扩展,刷新 modifications,然后启用 MakePay 支付方式。
使用 OAuth 连接
在 MakePay 扩展设置中点击 Connect MakePay。登录 MakeCrypto、选择公司、批准访问后返回 OpenCart,确认连接状态和 Webhook secret。
配置 MakePay
设置支付方式标题、排序、结账模式、结算 symbol、链接过期时间和成功/失败订单状态。普通安装保持连接模式,不需要手动 API secret。
配置 Webhook
扩展会注册 OpenCart 回调 URL。确保公网可访问,且防火墙允许 MakePay 发起 POST 请求。Webhook secret 应只保存在服务器端。
结账流程
客户在 OpenCart 结账选择 MakePay 后,扩展创建支付链接并跳转到托管结账。MakePay Webhook 会把支付结果同步回订单。
订单状态
成功付款映射到已支付/已处理状态;失败、取消和过期映射到失败或取消状态;其他状态保持待付款或处理中。
安全说明
OAuth 令牌和 Webhook secret 不应暴露给浏览器或模板。若管理员账号或服务器备份泄露,请在 MakeCrypto 中撤销连接并重新连接。
故障排查
如果按钮缺失,请确认扩展已启用并刷新 modifications。如果付款后订单不变,请比对 Webhook URL、检查 MakeCrypto Webhook 日志,并确认 OpenCart 路由没有被 SEO、缓存或安全扩展阻止。