电商插件

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、缓存或安全扩展阻止。

需要合作伙伴设置帮助?

在 MakeCrypto 中打开支付链接详情,复制真实支付 UID 的生成代码片段;也可以返回门户管理商户设置。

打开门户