电商插件
Magento 模块
安装并配置官方 Magento 和 Adobe Commerce 支付模块，支持原生 OAuth、DPoP 绑定令牌、托管 MakePay 结账和签名 Webhook。
概述
MakePay Magento/Adobe Commerce 模块为商店提供托管加密结账，支持原生 OAuth、DPoP 绑定令牌、托管 MakePay 结账和签名 Webhook。
开始之前
- Magento 或 Adobe Commerce 商店使用 HTTPS。
- 管理员可安装模块并运行必要的 Magento CLI 命令。
- 服务器可向
https://www.makecrypto.io发起出站 HTTPS 请求。 - MakeCrypto 公司已完成 MakePay 结算设置。
安装模块
下载官方模块包：
https://plugins.makecrypto.io/downloads/magento/latest.zip
将模块安装到 Magento 代码库后，运行模块启用、setup upgrade、依赖注入编译和缓存清理命令。生产环境应按现有部署流程发布静态资源。
使用 OAuth 连接
在 Magento 后台 MakePay 设置中点击 Connect MakePay。登录 MakeCrypto，选择收款公司并批准权限。返回 Magento 后确认连接、Webhook secret 和结算设置。
配置 MakePay
配置支付方式标题、启用状态、结账模式、结算 symbol、链接过期时间、订单状态映射和回调 URL。普通安装使用连接模式，手动 API key 只作为回退。
结账流程
客户在 Magento 结账中选择 MakePay 后，模块创建 MakePay 支付链接并跳转到托管结账。Webhook 返回后，模块更新订单、发票或订单备注。
订单状态
成功付款会把订单推进到已付款或处理中状态。失败、取消或过期付款会按配置标记为取消/失败。中间状态保留订单以等待最终 Webhook。
安全说明
OAuth 令牌、API secret 和 Webhook secret 应只保存在服务器端配置中。限制 Magento 后台权限，并在 MakeCrypto 中撤销不再使用的连接。
故障排查
如果模块无法连接，请检查 HTTPS、后台 base URL、出站请求和 Magento 日志。如果订单未更新，请检查 MakeCrypto Webhook 日志、Magento cron/队列和回调 URL 是否可公网访问。