Blesta 网关

概述

MakePay Blesta 网关为客户发票提供托管加密结账。客户从 Blesta 发票进入 MakePay，付款完成后网关通过回调更新发票。

开始之前

• Blesta 使用 HTTPS。
• PHP 启用 OpenSSL。
• 可安装网关并管理支付方式的管理员账号。
• MakeCrypto 公司已完成 MakePay 结算设置。

安装网关

下载官方 ZIP：

https://plugins.makecrypto.io/downloads/blesta/latest.zip

上传到 Blesta 网关目录并在后台启用 MakePay。

连接 MakePay

使用连接流程选择 MakeCrypto 公司并批准访问。若连接不可用，可在支持团队指导下使用手动 API key 回退。

手动 API 密钥回退

在 MakeCrypto 创建 MakePay API 密钥，复制公司 ID、key ID、secret 和 Webhook secret 到 Blesta 设置。不要把 secret 放入模板或公开工单。

结账流程

客户支付 Blesta 发票时，网关创建 MakePay 支付链接，并把发票、客户和金额信息写入 metadata。客户完成付款后返回 Blesta。

发票状态

成功 MakePay 状态会把发票标记为已支付。失败、取消或过期会保留或标记为失败，便于商户重新请求付款。

安全说明

Webhook 回调应验证签名后再更新发票。限制 Blesta 管理后台和服务器配置访问。

故障排查

如果客户无法跳转，请检查网关是否启用、API 密钥是否有效、公司是否已完成结算设置。如果发票未更新，请检查 Webhook 投递日志和服务器访问日志。