宝付收银台支付接入指引-商户版-v1.0

版本号 ：v1.0 更新时间：2024-04-29

支付渠道：宝付

宝付小程序收银台支付产品能力介绍和行业场景方案

产品能力介绍

商户小程序接入宝付小程序收银台，宝付小程序收银台拉起支付，支付完成后，收银台页面返回商户页面，宝付后台通知商户支付成功

行业场景方案

需要小程序支付的场景

案例介绍

电商小程序

商户小程序点击支付

)

拉起收银台支付页

支付完成返回商户小程序

方案特点

对于商家侧

提高商户对接小程序支付的效率

资金流

宝付结算给商户

适用支付产品

微信小程序支付

产品限额

微信官方标准限额

商户对接流程

开通宝付商户号

销售联系商户收集材料，开通宝付商户号

开通微信商户号

开通宝付商户号，会自动开能微信商户号

微信商户号二次认证

开通微信商户号后，按微信官方的标准要求，宝付提供认证二维码，商家进行认证，以下认证方式二选一

技术对接

交互流程

注意事项（重要）：

拉起支付的 appid 和 path 均以实际提供为准。

宝付宝财通

调用下单接口，获取 token，

预下单接口：用户登录 - Powered by MinDoc

重要下单字段：reqType = APP_PAY

返回字段：token， 例值：dEn4iGcH1PRaCthvZ1%2BhqroJy6wLHRYwOoTkL8PrlnM%3D&member_id=1278683

各客户端拉起小程序收银台方式

微信小程序可以使用以下两种方式拉起宝付小程序收银台，将 token 传递给 tradeNo

方式一：跳转打开宝付小程序收银台，跳转方式：wx.navigateToMiniProgram(Object object) | 微信开放文档

//参考代码
wx.navigateToMiniProgram({
appId: 'wx9f0******73c9',//已提供为准
path: 'pages/pay-plugin/pay-plugin?tradeNo=****&member_id=*****&type=BF',  success(res) {    // 打开成功  }})

方式二：打开宝付小程序收银台半屏小程序，打开方式：wx.openEmbeddedMiniProgram(Object object) | 微信开放文档

//参考代码
wx.openEmbeddedMiniProgram({
appId: 'wx9f0******73c9',
path: 'pages/pay-plugin/pay-plugin?tradeNo=****&member_id=*****&type=BF',
success(res) {
// 打开成功  
}
})

APP 拉起宝付小程序收银台，将 token 传递给 tradeNo

// 安卓示例
// 跳转
String appId = "wxd930ea***********"; // 填移动应用(App)的 AppId，非小程序的 AppID
IWXAPI api = WXAPIFactory.createWXAPI(context, appId);

WXLaunchMiniProgram.Req req = new WXLaunchMiniProgram.Req();req.userName = "gh_d3****074f"; // 小程序原始 ID，以实际提供为准

req.path = 'pages/pay-plugin/pay-plugin?tradeNo=****&member_id=*****&type=BF';                  //拉起小程序页面的可带参路径，以提供为准

req.miniprogramType = WXLaunchMiniProgram.Req.MINIPTOGRAM_TYPE_RELEASE;// 可选打开 开发版，体验版和正式版
api.sendReq(req);

//回调说明 WXEntryActivity中
public void onResp(BaseResp resp) { 
        if (resp.getType() == 
        ConstantsAPI.COMMAND_LAUNCH_WX_MINIPROGRAM) {
        WXLaunchMiniProgram.Resp launchMiniProResp = 
        (WXLaunchMiniProgram.Resp) resp;
        String extraData =launchMiniProResp.extMsg; //对应小程序组件 
        <button open-type="launchApp"> 中的 app-parameter 属性    
            }
        }

//IOS示例
//跳转
WXLaunchMiniProgramReq *launchMiniProgramReq = 
[WXLaunchMiniProgramReq object];
launchMiniProgramReq.userName = userName;  //拉起的小程序的username
launchMiniProgramReq.path = 'pages/pay-plugin/pay-plugin?tradeNo=****&member_id=*****&type=BF'；launchMiniProgramReq.miniProgramType = miniProgramType; //拉起小程序的类型return  [WXApi sendReq:launchMiniProgramReq];

//回调说明

-(void)onResp:(BaseResp *)resp
{     
        if ([resp isKindOfClass:[WXLaunchMiniProgramResp class]])    
        { 
            NSString *string = resp.extMsg;          // 对应小程序组件 <button open-type="launchApp"> 中的 app-parameter 属性     
                    }
            }

备注：APP 拉起小程序指引功能介绍 | 微信开放文档

H5/非原生APP通过链接拉起宝付小程序收银台，将token传递给tradeNo

//IOS示例
weixin://dl/business/?appid=wx9f0******73c9&path=pages/pay-plugin/pay-plugin&query=tradeNo=token&type=BF


//Android系统开发者需要使用 H5 页面中转，再跳转到 Scheme 实现打开小程序，跳转代码示例如下：
location.href = 
'weixin://dl/business/?appid=wx9f0******73c9&path=pages/pay-plugin/pay-plugin&query=tradeNo%3D{token}&type=BF'//该跳转方法可以在用户打开 H5 时立即调用，也可以在用户触发事件后调用。



/**其中，各个参数的定义如下：
* 【必填】APPID：宝付收银台小程序的 appid ；
* 【必填】PATH：打开小程序的页面 path ，必须是已经发布的小程序存在的页面，不可携带 query；
* 【选填】QUERY：打开小程序的 query（如tradeNo=token&type=BF），最大512个字符，只支持数字，大小写英文以及部分特殊字符：!#$&'()*+,/:;=?@-._~%`，需要url_encode；*/

宝付聚合

调用下单接口，获取 token，

预下单接口：统一下单交易预创建

重要字段：reqType = APP_PAY

返回字段：token， 例值：dEn4iGcH1PRaCthvZ1%2BhqroJy6wLHRYwOoTkL8PrlnM%3D&member_id=1278683

各客户端拉起小程序收银台方式

微信小程序可以使用以下两种方式拉起宝付小程序收银台，将 token 传递给 tradeNo

方式一：跳转打开宝付小程序收银台，跳转方式：wx.navigateToMiniProgram(Object object) | 微信开放文档

//参考代码
wx.navigateToMiniProgram({
    appId: 'wx9f0******73c9',//已提供为准
      path: 'pages/pay-plugin/pay-plugin?tradeNo=****&member_id=*****&type=BF',
  success(res) {
    // 打开成功
  }
})

方式二：打开宝付小程序收银台半屏小程序，打开方式：wx.openEmbeddedMiniProgram(Object object) | 微信开放文档

//参考代码

wx.openEmbeddedMiniProgram({
appId: 'wx9f0******73c9',
path: 'pages/pay-plugin/pay-plugin?tradeNo=****&member_id=*****&type=BF', 
    success(res) {
// 打开成功  }})

APP 拉起宝付小程序收银台，将 token 传递给 tradeNo

// 安卓示例

// 跳转
String appId = "wxd930ea5d5a*******"; // 填移动应用(App)的 AppId，非小程序的 AppID
IWXAPI api = WXAPIFactory.createWXAPI(context, appId);

WXLaunchMiniProgram.Req req = new WXLaunchMiniProgram.Req();
req.userName = "gh_d3*****4f"; // 小程序原始 ID，不用改
req.path = 'pages/pay-plugin/pay-plugin?tradeNo=****&member_id=*****&type=BF';                  //拉起小程序页面的可带参路径
req.miniprogramType = WXLaunchMiniProgram.Req.MINIPTOGRAM_TYPE_RELEASE;// 可选打开 开发版，体验版和正式版api.sendReq(req);

//回调说明 WXEntryActivity中

public void onResp(BaseResp resp) { 
        if (resp.getType() == 
        ConstantsAPI.COMMAND_LAUNCH_WX_MINIPROGRAM) {
        WXLaunchMiniProgram.Resp launchMiniProResp = 
        (WXLaunchMiniProgram.Resp) resp; 
                String extraData =launchMiniProResp.extMsg; //对应小程序组件 <button open-type="launchApp"> 中的 app-parameter 属性    }}

//IOS示例
//跳转

WXLaunchMiniProgramReq *launchMiniProgramReq = 
[WXLaunchMiniProgramReq object];
launchMiniProgramReq.userName = userName;  //拉起的小程序的username
launchMiniProgramReq.path = 'pages/pay-plugin/pay-plugin?tradeNo=****&member_id=*****&type=BF'；launchMiniProgramReq.miniProgramType = miniProgramType; //拉起小程序的类型

return  [WXApi sendReq:launchMiniProgramReq];

//回调说明
-(void)onResp:(BaseResp *)resp
{
if ([resp isKindOfClass:[WXLaunchMiniProgramResp class]])     
{          NSString *string = resp.extMsg;          
// 对应小程序组件 <button open-type="launchApp"> 中的 app-parameter 属性     
        }
    }

备注：APP 拉起小程序指引功能介绍 | 微信开放文档

H5/非原生APP通过链接拉起宝付小程序收银台，将token传递给tradeNo

//IOS示例
weixin://dl/business/?appid=wx9f0******73c9&path=pages/pay-plugin/pay-plugin&query=tradeNo=token&type=BF


//Android系统开发者需要使用 H5 页面中转，再跳转到 Scheme 实现打开小程序，跳转代码示例如下：
location.href = 'weixin://dl/business/?appid=wx9f0******73c9&path=pages/pay-plugin/pay-plugin&query=tradeNo%3D{token}&type=BF'
//该跳转方法可以在用户打开 H5 时立即调用，也可以在用户触发事件后调用。

/*
*其中，各个参数的定义如下：

* 【必填】APPID：宝付收银台小程序的 appid ；
* 【必填】PATH：打开小程序的页面 path ，必须是已经发布的小程序存在的页面，不可携带 query；
* 【选填】QUERY：打开小程序的 query（如tradeNo=token&type=BF），最大512个字符，只支持数字，大小写英文以及部分特殊字符：!#$&'()*+,/:;=?@-._~%`，需要url_encode；*/

备注：APP 拉起小程序指引功能介绍 | 微信开放文档

商户侧上线

商户侧测试无误后上线