准备工作
开始前先联系官方客服开通接入应用,拿到下面三样。三个系统用的都是这同一组参数。
| 参数 | 说明 |
|---|---|
| 网关域名 | 客服提供的支付网关,如 https://网关域名 |
商户 ID(pid) | 接入应用的商户 ID |
商户密钥(key) | 接入应用的密钥,用于 MD5 签名,不要外泄 |
新建支付网关
用管理员账号进入后台的「支付」→「网关设置」,点「新建支付」,按下表填写并保存。
| 字段 | 填什么 |
|---|---|
| 类型 | 易支付 |
| 名称 | 展示给用户的名字,如「支付宝」 |
| 回调域名 | 留空,除非你专门配置过用另一个域名接收回调 |
| 网关货币类型 | 人民币 |
| 支付域名 | https://网关域名,程序会自动拼上 /submit.php |
| 商户号 | pid |
| 密钥 | key |
| 支付类型 | 选「支付宝」或「微信」;选「收银台」则由用户到收银台自己选 |
支付宝和微信各建一个网关,除了「名称」和「支付类型」,其余相同。只建一个并选「收银台」也可以。
One-Hub 走的是页面跳转下单(/submit.php),不需要配置接口 IP 白名单。
通知地址
异步通知地址由程序自动生成,形如 https://你的域名/api/payment/notify/一串标识,不需要手填。请确认这个地址能被公网访问,反向代理没有拦截 /api/payment/notify/。
充值测试
- 用一个普通用户登录,进入充值页面。
- 输入金额,选择刚建好的支付方式,页面应跳到收银台。
- 完成支付后回到站点,余额增加,后台「支付」→「订单列表」里能看到这笔订单,说明配置成功。
常见问题
其他对接文档
获取商户 ID 与密钥
联系官方客服开通接入应用,网关地址、pid 与 key 由客服直接提供,专人协助联调。
联系官方客服