准备工作
开始前先联系官方客服开通接入应用,拿到下面三样。三个系统用的都是这同一组参数。
| 参数 | 说明 |
|---|---|
| 网关域名 | 客服提供的支付网关,如 https://网关域名 |
商户 ID(pid) | 接入应用的商户 ID |
商户密钥(key) | 接入应用的密钥,用于 MD5 签名,不要外泄 |
填写支付设置
用管理员账号进入系统设置,找到支付与充值相关设置里的易支付区块(新版界面叫「Epay 网关」),按下表填写并保存。旧版界面的名称可能略有不同,按含义对应即可。
| 配置项 | 填什么 |
|---|---|
| Epay 端点 | https://网关域名,只填到域名,程序会自动拼上 /submit.php |
| 易支付商户 ID | pid |
| Epay 密钥 | key |
| 回调地址 | 你站点的根地址,如 https://api.example.com,不要带任何路径;留空则使用「服务器地址」 |
| 充值价格 | 用户每充值 1 美元余额要付多少钱,如 7.3 |
| 最低充值 | 单次最少充值的美元数量 |
「回调地址」和「服务器地址」至少有一个要填成用户实际访问的公网地址。New-API 用它拼出异步通知地址 https://你的域名/api/user/epay/notify,填错的话支付成功后余额不会到账。
设置充值方式
充值方式保存为一段 PayMethods JSON。其中 type 会原样作为易支付的支付方式编码提交,所以支付宝要写 alipay,微信要写 wxpay:
[
{ "name": "支付宝", "type": "alipay" },
{ "name": "微信", "type": "wxpay" }
]New-API 走的是页面跳转下单(/submit.php),不需要配置接口 IP 白名单。
充值测试
- 用一个普通用户登录,进入充值页面。
- 输入充值数量,选择支付宝或微信,页面应跳到收银台。
- 完成支付后回到站点,余额增加,说明配置成功。
常见问题
| 现象 | 原因与处理 |
|---|---|
| 充值页没有在线充值入口 | Epay 端点、商户 ID、密钥三项只要有一项为空,在线充值就不会启用,补全后保存 |
| 支付成功但余额没到账 | 异步通知没到。检查「回调地址」或「服务器地址」是否是公网可访问的站点根地址,反向代理是否放行 /api/user/epay/notify |
| 跳转后提示「验签失败」 | Epay 密钥填错或带了空格,重新复制 key 保存 |
| 接入应用未配置支付方式 xxx 对应的产品 | 这个支付方式还没开通,或支付方式编码写错了(微信是 wxpay,不是 wechat)。编码无误就联系官方客服配置 |
其他对接文档
获取商户 ID 与密钥
联系官方客服开通接入应用,网关地址、pid 与 key 由客服直接提供,专人协助联调。
联系官方客服