One-Hub 对接易支付配置教程

One-Hub 自带支付网关功能,支持易支付。在后台新建一个支付网关,填好泡泡支付的网关地址、商户号和密钥,用户就能在线充值。

  • One-Hub
  • 在线充值
  • 易支付 V1
  • 更新于

准备工作

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

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

新建支付网关

用管理员账号进入后台的「支付」→「网关设置」,点「新建支付」,按下表填写并保存。

字段填什么
类型易支付
名称展示给用户的名字,如「支付宝」
回调域名留空,除非你专门配置过用另一个域名接收回调
网关货币类型人民币
支付域名https://网关域名,程序会自动拼上 /submit.php
商户号pid
密钥key
支付类型选「支付宝」或「微信」;选「收银台」则由用户到收银台自己选

支付宝和微信各建一个网关,除了「名称」和「支付类型」,其余相同。只建一个并选「收银台」也可以。

One-Hub 走的是页面跳转下单(/submit.php),不需要配置接口 IP 白名单。

通知地址

异步通知地址由程序自动生成,形如 https://你的域名/api/payment/notify/一串标识,不需要手填。请确认这个地址能被公网访问,反向代理没有拦截 /api/payment/notify/。

充值测试

  1. 用一个普通用户登录,进入充值页面。
  2. 输入金额,选择刚建好的支付方式,页面应跳到收银台。
  3. 完成支付后回到站点,余额增加,后台「支付」→「订单列表」里能看到这笔订单,说明配置成功。

常见问题

现象原因与处理
跳转后提示「验签失败」密钥填错或带了空格,重新复制 key 保存。详见 验签失败排查
接入应用未配置支付方式 xxx 对应的产品这个支付方式还没开通,或支付方式编码写错了(微信是 wxpay,不是 wechat)。编码无误就联系官方客服配置
支付成功但余额没到账异步通知没到。确认站点能被公网访问;「回调域名」如果填过,确认它填的是能访问到本站的地址。详见 收不到通知排查

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

其他对接文档

获取商户 ID 与密钥

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

联系官方客服