ClientExec 网关

概述

MakePay ClientExec 网关为一次性和周期性发票提供托管加密结账。客户从发票进入 MakePay，付款结果通过回调同步回 ClientExec。

开始之前

• ClientExec 使用 HTTPS。
• PHP 启用 OpenSSL，并可向 MakeCrypto 发起出站请求。
• 管理员可安装支付网关并管理发票。
• MakeCrypto 公司已配置 MakePay 结算。

安装网关

下载官方 ZIP：

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

上传到 ClientExec 安装目录对应网关位置，启用 MakePay 网关并打开配置页。

连接 MakePay

使用 Connect MakePay 连接 MakeCrypto 公司，或在支持团队指导下使用手动 API key。连接后保存网关设置。

配置 MakePay

检查公司 ID、结算币种、支付链接过期时间、回调 URL、手动凭据和网关显示名称。

结账流程

客户支付发票时，网关创建 MakePay 支付链接，并把发票 ID、客户邮箱和金额写入 payload/metadata。付款完成后回调更新发票。

周期性发票

周期性发票按每张发票创建独立支付链接。MakePay 不替代 ClientExec 的订阅调度；它处理每次发票收款和状态回写。

发票状态

成功付款会标记发票 paid。失败、取消或过期会记录失败状态或保留 unpaid，便于重新发送付款链接。

安全说明

API secret 和 Webhook secret 必须只保存在服务器端配置中。限制 ClientExec 管理员权限。

故障排查

如果发票未更新，请检查 MakeCrypto Webhook 日志、ClientExec 网关日志、回调 URL 和防火墙规则。结算错误通常表示 MakeCrypto 公司还未设置默认结算资产。