New-API 对接易支付配置教程

New-API 内置易支付充值,不用装插件。在系统设置里填好泡泡支付的网关地址、商户 ID 和密钥,用户就能用支付宝、微信给余额充值。

  • New-API
  • 在线充值
  • 易支付 V1
  • 更新于

准备工作

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

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

填写支付设置

用管理员账号进入系统设置,找到支付与充值相关设置里的易支付区块(新版界面叫「Epay 网关」),按下表填写并保存。旧版界面的名称可能略有不同,按含义对应即可。

配置项填什么
Epay 端点https://网关域名,只填到域名,程序会自动拼上 /submit.php
易支付商户 IDpid
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 白名单。

充值测试

  1. 用一个普通用户登录,进入充值页面。
  2. 输入充值数量,选择支付宝或微信,页面应跳到收银台。
  3. 完成支付后回到站点,余额增加,说明配置成功。

常见问题

现象原因与处理
充值页没有在线充值入口Epay 端点、商户 ID、密钥三项只要有一项为空,在线充值就不会启用,补全后保存
支付成功但余额没到账异步通知没到。检查「回调地址」或「服务器地址」是否是公网可访问的站点根地址,反向代理是否放行 /api/user/epay/notify
跳转后提示「验签失败」Epay 密钥填错或带了空格,重新复制 key 保存
接入应用未配置支付方式 xxx 对应的产品这个支付方式还没开通,或支付方式编码写错了(微信是 wxpay,不是 wechat)。编码无误就联系官方客服配置

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

其他对接文档

获取商户 ID 与密钥

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

联系官方客服