接入教程
立即开通

new-api、sub2api 接入支付宝:填三个值就能收款

new-api、sub2api、独角数卡这些系统的充值模块都内置了「易支付」接口。BBpay 兼容易支付接口格式, 你只要在原来的支付设置里填上 BBpay 给的网关地址、商户 ID、密钥,用户充值就走支付宝, 钱直接进你自己的支付宝。不用改代码,也不用装插件。

  1. 1拿三个值BBpay 后台「易支付兼容」页开通,复制网关地址、商户 ID、密钥
  2. 2填进你的系统new-api 的支付设置、sub2api 的易支付服务商,原来填易支付的地方
  3. 3付一笔试试先用沙箱的值看能不能出收银台,再换正式的值付一笔小额

开始之前

正式收款要先准备好这三件事。只想先试试配置对不对,用沙箱就行,三件事都可以以后再办。

  1. 开通 BBpay,进入后台。
  2. 你的支付宝签约了一种收款产品:订单码支付(不需要 ICP 备案),或者电脑网站支付 / 手机网站支付。 不确定能签哪个,看 开通指南,一分钟自查。
  3. 在后台 收款账户 用收款的支付宝扫码,授权 BBpay 代你下单。

和原来的易支付一样

  • 同一套接口和 MD5 签名,原来的充值模块直接能用
  • 付款成功后回调你的站点,自动给用户加余额
  • 电脑上显示二维码,手机上直接跳支付宝

不一样的地方

  • 钱由支付宝直接结算到你自己的账户,BBpay 不经手、不代收
  • 不用等平台结算、提现
  • BBpay 只收月费,不抽交易手续费(支付宝按费率收)

第 1 步:拿到三个值

登录 BBpay 后台,左侧点 易支付兼容,在「正式收款」点「开通,生成商户 ID 和密钥」 (想先试试,就在「沙箱测试」里开通)。页面上会显示:

值长什么样说明
网关地址https://bbpay.uk/epay所有商户都一样
商户 ID102345678 位数字,沙箱和正式各一个
商户密钥Kx7…(32 位)签名用,别发给别人;泄露了在后台点「重置密钥」

同一页还要选收款方式,选你在支付宝签约了的那一种:签了订单码支付就选「订单码支付」(默认), 签了电脑网站支付和手机网站支付就选「电脑网站支付 + 手机网站支付」。选错了,买家付款时支付宝会提示没有权限。

第 2 步:new-api 怎么填

用管理员账号登录 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)」:

sub2api · 添加支付服务商:易支付(示意)
商户 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 步:测试和上线

  1. 先用沙箱的三个值。在你的站点点充值,能跳到支付宝收银台(或出现付款二维码),就说明地址、商户 ID、密钥都填对了。 沙箱收银台只能用支付宝沙箱买家账号付款,普通支付宝扫码会提示无效,这是正常的。
  2. 换成正式的三个值,自己付一笔小额。付完看站点余额有没有加上; BBpay 后台 Webhook 页的推送记录里,这笔通知应该显示「已送达」。
  3. 测试的钱在支付宝商家平台 b.alipay.com 的交易记录里退回给自己即可。
回调没到账?先看 Webhook 页推送记录里的错误。最常见的原因是站点的「服务器地址」或「回调基础地址」不是 https 公网地址。 改好后在推送记录里点「重发」。另外,BBpay 每天会自动向支付宝补查还没有结果的订单,付了款的会补发通知。

常见问题

能收微信吗?
不能。BBpay 是支付宝服务商,只支持支付宝。在你的系统里把微信那一项关掉或删掉。
钱什么时候到?
钱由支付宝直接结算到你自己的支付宝账户,到账时间按你和支付宝的签约规则,BBpay 不经手。 原来用的易支付平台大多是平台先代收、再给你结算提现,换成 BBpay 后不再有这一步。
提示「签名错误」?
商户密钥填错了,或者在后台重置过密钥没有同步更新。注意沙箱和正式是两套商户 ID 和密钥,不能混用。
付款时支付宝提示没有权限或「用户权限不足」?
你的支付宝没签约后台选的那种收款方式。到「易支付兼容」页换成你签了的那一种,或者去支付宝签约。 还没在「收款账户」扫码授权的,正式下单会提示「站长还没有在 BBpay 后台绑定支付宝收款账户」。
能退款吗?
易支付的 api.php 退款接口暂不支持。可以在支付宝商家平台直接退, 或者调 BBpay 的 退款接口。
没有营业执照、没有 ICP 备案能用吗?
能不能收款由支付宝决定,BBpay 不能替你签约。订单码支付不需要 ICP 备案,但需要真实门店资料; 详细条件和额度见 开通指南。

new-api、sub2api 的菜单名称按 2026 年 11 月的版本整理,不同版本可能略有不同。 BBpay 只兼容易支付的接口格式,和任何易支付平台没有关系。