new-api、sub2api 接入支付宝:填三个值就能收款
new-api、sub2api、独角数卡这些系统的充值模块都内置了「易支付」接口。BBpay 兼容易支付接口格式, 你只要在原来的支付设置里填上 BBpay 给的网关地址、商户 ID、密钥,用户充值就走支付宝, 钱直接进你自己的支付宝。不用改代码,也不用装插件。
- 1拿三个值BBpay 后台「易支付兼容」页开通,复制网关地址、商户 ID、密钥
- 2填进你的系统new-api 的支付设置、sub2api 的易支付服务商,原来填易支付的地方
- 3付一笔试试先用沙箱的值看能不能出收银台,再换正式的值付一笔小额
开始之前
正式收款要先准备好这三件事。只想先试试配置对不对,用沙箱就行,三件事都可以以后再办。
- 开通 BBpay,进入后台。
- 你的支付宝签约了一种收款产品:订单码支付(不需要 ICP 备案),或者电脑网站支付 / 手机网站支付。 不确定能签哪个,看 开通指南,一分钟自查。
- 在后台 收款账户 用收款的支付宝扫码,授权 BBpay 代你下单。
和原来的易支付一样
- 同一套接口和 MD5 签名,原来的充值模块直接能用
- 付款成功后回调你的站点,自动给用户加余额
- 电脑上显示二维码,手机上直接跳支付宝
不一样的地方
- 钱由支付宝直接结算到你自己的账户,BBpay 不经手、不代收
- 不用等平台结算、提现
- BBpay 只收月费,不抽交易手续费(支付宝按费率收)
第 1 步:拿到三个值
登录 BBpay 后台,左侧点 易支付兼容,在「正式收款」点「开通,生成商户 ID 和密钥」 (想先试试,就在「沙箱测试」里开通)。页面上会显示:
| 值 | 长什么样 | 说明 |
|---|---|---|
| 网关地址 | https://bbpay.uk/epay | 所有商户都一样 |
| 商户 ID | 10234567 | 8 位数字,沙箱和正式各一个 |
| 商户密钥 | Kx7…(32 位) | 签名用,别发给别人;泄露了在后台点「重置密钥」 |
同一页还要选收款方式,选你在支付宝签约了的那一种:签了订单码支付就选「订单码支付」(默认), 签了电脑网站支付和手机网站支付就选「电脑网站支付 + 手机网站支付」。选错了,买家付款时支付宝会提示没有权限。
第 2 步:new-api 怎么填
用管理员账号登录 new-api,打开「系统设置」,找到「支付设置」(不同版本的菜单名可能略有差别, 找填「易支付」的那一组)。按下表填,保存。
支付地址https://bbpay.uk/epay不要带 submit.php,new-api 会自己补
易支付商户 ID后台显示的 8 位商户 ID
易支付商户密钥后台显示的 32 位密钥
回调地址留空留空就用「服务器地址」拼回调地址
- 「系统设置」里的「服务器地址」要是 https 的公网地址,比如
https://api.你的域名.com。 付款通知会发到这个地址,填 localhost 或 http 收不到。 - 充值方式只留支付宝。new-api 默认还有微信,BBpay 只支持支付宝, 在「充值方式」里把
wxpay那一项删掉,不然用户点微信会提示下单失败。
第 2 步:sub2api 怎么填
用管理员账号登录 sub2api,进入「设置」里的支付配置,添加一个服务商,类型选「易支付(EasyPay)」:
商户 ID(PID)后台显示的 8 位商户 ID
商户密钥(PKey)后台显示的 32 位密钥
API 基础地址https://bbpay.uk/epay
支付宝渠道 ID留空
微信渠道 ID留空
- 保存后,把前台的「支付宝」按钮指向这个易支付服务商(易支付支付宝)。
- 不要把「微信支付」指向它:BBpay 只支持支付宝。
- 「回调基础地址」填你站点的 https 公网地址,付款通知会发到这里。
独角数卡、V2Board 等其他系统
凡是支持「易支付」的系统都可以,填法相同:
| 对方系统里的叫法 | 填什么 |
|---|---|
| 支付网关 / 接口地址 / API 地址 | 一般填 https://bbpay.uk/epay/(带结尾的 /); 要求填完整下单地址的,填 https://bbpay.uk/epay/submit.php |
| 商户 ID / PID / 商户号 | 后台的 8 位商户 ID |
| 商户密钥 / KEY | 后台的 32 位密钥 |
| 支付方式 / 通道 | 只开支付宝(alipay) |
BBpay 支持 submit.php(页面跳转)、mapi.php(接口下单)、api.php(查单)。 自己写代码对接的,参数和签名见 接口说明。
第 3 步:测试和上线
- 先用沙箱的三个值。在你的站点点充值,能跳到支付宝收银台(或出现付款二维码),就说明地址、商户 ID、密钥都填对了。 沙箱收银台只能用支付宝沙箱买家账号付款,普通支付宝扫码会提示无效,这是正常的。
- 换成正式的三个值,自己付一笔小额。付完看站点余额有没有加上; BBpay 后台 Webhook 页的推送记录里,这笔通知应该显示「已送达」。
- 测试的钱在支付宝商家平台 b.alipay.com 的交易记录里退回给自己即可。
回调没到账?先看 Webhook 页推送记录里的错误。最常见的原因是站点的「服务器地址」或「回调基础地址」不是 https 公网地址。 改好后在推送记录里点「重发」。另外,BBpay 每天会自动向支付宝补查还没有结果的订单,付了款的会补发通知。
常见问题
- 能收微信吗?
- 不能。BBpay 是支付宝服务商,只支持支付宝。在你的系统里把微信那一项关掉或删掉。
- 钱什么时候到?
- 钱由支付宝直接结算到你自己的支付宝账户,到账时间按你和支付宝的签约规则,BBpay 不经手。 原来用的易支付平台大多是平台先代收、再给你结算提现,换成 BBpay 后不再有这一步。
- 提示「签名错误」?
- 商户密钥填错了,或者在后台重置过密钥没有同步更新。注意沙箱和正式是两套商户 ID 和密钥,不能混用。
- 付款时支付宝提示没有权限或「用户权限不足」?
- 你的支付宝没签约后台选的那种收款方式。到「易支付兼容」页换成你签了的那一种,或者去支付宝签约。 还没在「收款账户」扫码授权的,正式下单会提示「站长还没有在 BBpay 后台绑定支付宝收款账户」。
- 能退款吗?
- 易支付的
api.php退款接口暂不支持。可以在支付宝商家平台直接退, 或者调 BBpay 的 退款接口。 - 没有营业执照、没有 ICP 备案能用吗?
- 能不能收款由支付宝决定,BBpay 不能替你签约。订单码支付不需要 ICP 备案,但需要真实门店资料; 详细条件和额度见 开通指南。
new-api、sub2api 的菜单名称按 2026 年 11 月的版本整理,不同版本可能略有不同。 BBpay 只兼容易支付的接口格式,和任何易支付平台没有关系。