MakePay XenForo 支付提供方

概述

官方 MakePay XenForo 插件为 XenForo payment profiles 添加托管加密结账。XenForo 创建购买请求，MakePay 创建托管支付链接，签名 MakePay Webhook 到达后，XenForo 的支付回调处理器完成购买。

普通设置请使用 Connect MakePay。手动 API key 凭据作为回退保留。

开始之前

• XenForo 2.3 或更新版本。
• PHP 8.1 或更新版本，并启用 OpenSSL。
• HTTPS forum/community URL。
• 可管理 payment profiles 的管理员权限。
• 可管理支付设置的 MakePay 公司。

安装插件包

下载最新 ZIP：

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

通过 XenForo 插件归档安装器安装，或把 upload/ 目录内容上传到 XenForo 根目录。插件 ID 为 MakePay/Payment，源码安装在：

src/addons/MakePay/Payment

使用 OAuth 连接

进入 Options > Service providers > Payment profiles > Add payment profile 并选择 MakePay。先保存一次 profile，再重新打开并选择 Connect MakePay。插件会打开 MakeCrypto、要求登录并选择公司、展示权限、批准后返回 XenForo、保存连接并配置 callback URL 和 Webhook secret。

配置 MakePay

连接完成后，将 Connection Method 保持为默认连接模式。检查 MakePay company ID、结算币种、支付链接过期时间、Webhook callback URL，以及手动 API key 回退凭据。

结账流程

把 MakePay payment profile 添加到用户升级、付费资源或其他支持 payment profiles 的可购买流程。会员选择 MakePay 时，插件会创建带 XenForo metadata 的 MakePay 支付链接。

字段	用途
source=xenforo	标识集成来源。
orderId=xenforo_purchase_<requestKey>	将 MakePay 活动映射回 XenForo。
requestKey	XenForo 购买请求 key。
purchasableTypeId	XenForo purchasable 类型。
moduleVersion	已安装 MakePay 插件版本。
xenforoVersion	XenForo 运行时版本。

买家会被重定向到托管 MakePay 结账，并在付款或取消后返回 XenForo。

支付状态

MakePay 向以下地址发送签名回调：

https://your-forum.example/payment_callback.php?_xfProvider=makepay

MakePay 状态	XenForo 回调结果
paid、completed、confirmed、succeeded	Payment received
failed、expired	Payment reversed
cancelled、canceled	Payment reversed
refunded	Payment reversed
其他状态	Pending

安全说明

插件把连接详情保存在 payment profile options 中。请限制 XenForo 管理后台访问；如果管理员账号或服务器备份泄露，请在 MakeCrypto 中断开社区连接。

故障排查

如果 Connect MakePay 无法启动，请确认 XenForo board URL 使用 HTTPS 且公网可访问。如果按钮缺失，请保存 payment profile 后重新打开。如果购买没有完成，请比对 MakePay Webhook callback URL 和 XenForo payment_callback.php?_xfProvider=makepay URL，并轮换 Webhook secret。