电商插件
PrestaShop 模块
安装并配置官方 PrestaShop 支付模块，支持原生 OAuth、DPoP 绑定令牌和 MakePay Webhook。
概述
MakePay PrestaShop 模块为 PrestaShop 商店加入托管加密支付，支持原生 OAuth、DPoP 绑定令牌和签名 MakePay Webhook。
开始之前
- PrestaShop 商店使用 HTTPS。
- PHP 启用 OpenSSL，并允许出站 HTTPS 请求。
- 拥有可安装模块和管理支付方式的后台账号。
- MakeCrypto 公司已完成 MakePay 结算设置。
设置 MakeCrypto
在连接商店前，先在 MakeCrypto 中选择收款公司，完成 Wallet > Balances > Set up settlement，并检查商户支付费用、重定向和少付容差设置。
安装模块
下载官方模块包：
https://plugins.makecrypto.io/downloads/prestashop/latest.zip
在 PrestaShop 后台打开模块管理，上传 ZIP，安装并启用 MakePay 模块。
连接店铺
在模块配置页保持默认连接模式，点击 Connect MakePay，登录 MakeCrypto，选择公司并批准请求权限。返回 PrestaShop 后确认连接状态和 Webhook secret，然后启用支付方式。
OAuth 安全模型
模块使用 OAuth 授权码流程和 DPoP 绑定令牌连接 MakeCrypto。连接权限仅覆盖公司读取、支付链接、客户和 MakePay 设置，不允许移动钱包资金。
网关设置
检查网关标题、描述、结账体验、结算币种、支付链接过期时间和 Webhook URL。生产环境 MakePay 门户 URL 应保持 https://www.makecrypto.io，除非支持团队要求变更。
订单状态
已支付、已确认或已完成的 MakePay 状态会把 PrestaShop 订单标记为已付款。失败、过期或取消状态会按模块配置标记为失败/取消。进行中状态保持待付款。
手动 API 密钥回退
仅用于 OAuth 连接不可用或支持团队指导的恢复场景。创建 MakePay API 密钥后，把公司 ID、key ID、secret 和 Webhook secret 填入模块设置。
故障排查
如果连接失败，请确认店铺 HTTPS、后台 URL、出站请求和模块权限。如果订单未更新，请检查 MakeCrypto Webhook 日志，以及 PrestaShop 防火墙、缓存或安全模块是否阻止回调。