准备工作
开始前先联系官方客服开通接入应用,拿到下面三样。三个系统用的都是这同一组参数。
| 参数 | 说明 |
|---|---|
| 网关域名 | 客服提供的支付网关,如 https://网关域名 |
商户 ID(pid) | 接入应用的商户 ID |
商户密钥(key) | 接入应用的密钥,用于 MD5 签名,不要外泄 |
Xboard
- 在后台的插件管理里确认 EPay 插件已启用,它是 Xboard 自带的插件。
- 打开支付配置,添加一个支付方式,支付接口选
EPay,按下表填写并保存。
| 字段 | 填什么 |
|---|---|
| 支付网关地址 | https://网关域名,带上 https://,结尾不要加 /,程序会自动拼上 /submit.php |
| 商户ID | pid |
| 通信密钥 | key |
| 支付类型 | alipay 或 wxpay;留空则跳到收银台由买家自己选 |
想让买家在面板里直接选支付宝或微信,就添加两个支付方式,「支付类型」分别填 alipay 和 wxpay,其余相同。只添加一个并把「支付类型」留空也可以。
V2Board
打开后台的支付配置,添加一个支付方式,接口文件选 EPay,按下表填写并保存。
| 字段 | 填什么 |
|---|---|
| URL | https://网关域名,结尾不要加 /,程序会自动拼上 /submit.php |
| PID | pid |
| KEY | key |
V2Board 的 EPay 接口下单时不带支付方式,买家会先到泡泡支付的收银台,再自己选择支付宝或微信,所以只需要添加一个支付方式。
通知地址
两个面板的异步通知地址都由程序自动生成,形如 https://你的面板域名/api/v1/guest/payment/notify/EPay/一串标识,不需要手填,只要保证它能被公网访问。
「自定义通知域名」一般留空。只有当面板对外的域名收不到回调、需要用另一个域名接收通知时才填写。
两个面板走的都是页面跳转下单(/submit.php),不需要配置接口 IP 白名单。
下单测试
- 用一个普通用户登录,选一个最便宜的套餐下单。
- 选择刚添加的支付方式,页面应跳到收银台。
- 完成支付后回到面板,订单变为已完成、套餐生效,说明配置成功。
常见问题
其他对接文档
获取商户 ID 与密钥
联系官方客服开通接入应用,网关地址、pid 与 key 由客服直接提供,专人协助联调。
联系官方客服