Xboard / V2Board 对接易支付配置教程

Xboard 和 V2Board 都自带易支付(EPay)支付接口,不用改代码。在后台添加一个支付方式,填好泡泡支付的网关地址、商户 ID 和密钥即可收款。

  • Xboard
  • V2Board
  • 易支付 V1
  • 更新于

准备工作

开始前先联系官方客服开通接入应用,拿到下面三样。三个系统用的都是这同一组参数。

参数说明
网关域名客服提供的支付网关,如 https://网关域名
商户 ID(pid)接入应用的商户 ID
商户密钥(key)接入应用的密钥,用于 MD5 签名,不要外泄

Xboard

  1. 在后台的插件管理里确认 EPay 插件已启用,它是 Xboard 自带的插件。
  2. 打开支付配置,添加一个支付方式,支付接口选 EPay,按下表填写并保存。
字段填什么
支付网关地址https://网关域名,带上 https://,结尾不要加 /,程序会自动拼上 /submit.php
商户IDpid
通信密钥key
支付类型alipay 或 wxpay;留空则跳到收银台由买家自己选

想让买家在面板里直接选支付宝或微信,就添加两个支付方式,「支付类型」分别填 alipay 和 wxpay,其余相同。只添加一个并把「支付类型」留空也可以。

V2Board

打开后台的支付配置,添加一个支付方式,接口文件选 EPay,按下表填写并保存。

字段填什么
URLhttps://网关域名,结尾不要加 /,程序会自动拼上 /submit.php
PIDpid
KEYkey

V2Board 的 EPay 接口下单时不带支付方式,买家会先到泡泡支付的收银台,再自己选择支付宝或微信,所以只需要添加一个支付方式。

通知地址

两个面板的异步通知地址都由程序自动生成,形如 https://你的面板域名/api/v1/guest/payment/notify/EPay/一串标识,不需要手填,只要保证它能被公网访问。

「自定义通知域名」一般留空。只有当面板对外的域名收不到回调、需要用另一个域名接收通知时才填写。

两个面板走的都是页面跳转下单(/submit.php),不需要配置接口 IP 白名单。

下单测试

  1. 用一个普通用户登录,选一个最便宜的套餐下单。
  2. 选择刚添加的支付方式,页面应跳到收银台。
  3. 完成支付后回到面板,订单变为已完成、套餐生效,说明配置成功。

常见问题

现象原因与处理
跳转后提示「验签失败」密钥填错或带了空格,重新复制 key 保存。详见 验签失败排查
跳转后 404,地址里出现 //submit.php网关地址结尾多了 /,去掉后保存
接入应用未配置支付方式 xxx 对应的产品这个支付方式还没开通,或支付方式编码写错了(微信是 wxpay,不是 wechat)。编码无误就联系官方客服配置
支付成功但订单没有开通异步通知没到。确认面板域名能被公网访问、通知路径没有被防火墙或 CDN 拦截。详见 收不到通知排查

其他报错见 排错指引;协议细节见 签名算法 与 异步通知。

其他对接文档

获取商户 ID 与密钥

联系官方客服开通接入应用,网关地址、pid 与 key 由客服直接提供,专人协助联调。

联系官方客服