5.2 B2b门店助手对接方案


微信小程序B2b门店助手

开通流程说明

开通云商通二代产品

请线下联系通联对应分公司客户经理,由客户经理协助收集材料,通过云商通二代产品开通流程,开通对应的产品。

账户产品客户,如需在产品开通流程完成前先联调,需先通过综合支付产品开通应用并配置B2b产品权限,后续再从支付产品升级账户产品。

大B小程序申请B2b类目

登陆小程序管理后台(https://mp.weixin.qq.com/),找到「设置-基本信息-服务类目」,添加【商家自营-B2b(商品批发/门店管理)】类目

descript

大B小程序向通联进行授权

云商通二代运营平台生产小程序授权码,有效期30分钟,过期重新获取。

小程序管理员进行扫码授权,将“小程序B2b门店助手”项授权给服务商,授权码线下对接群提供。

descript

descriptdescript

扫码后选择“小程序B2b门店助手”,点击“确定”完成授权

descriptdescript

大B小程序开通门店助手

右侧导航栏【行业能力】下找到【B2b门店助手】,在页面点击【开通】后,填写小程序基本信息,点击【提交】即可完成开通

descript

descript

大B小程序引用门店助手插件

申请添加插件

方式1:小程序后台页面申请

登录小程序后台(mp.weixin.qq.com),点击左下方头像,“账号设置-第三方设置-插件管理-添加插件”,搜索“小程序门店助手”并申请添加。

descript

 方式2:开发者工具引用

使用开发者工具运行小程序,并引入插件,在调试器中会提示“添加插件”,点击添加插件,前往小程序管理后台确认即可.

 

配置插件

一、简介与准入开通 | 微信开放文档

大B小程序申请B2b支付商户号

申请B2b支付商户号

通联侧提供商户号进件功能,由通联分公司人员在运营后台提交B2b支付商户号申请。

进行账户验证(若支付管理员为公司法人,无该步骤)

若支付管理员不是法人,则需进行账户验证,通联提供法人验证二维码(非必须环节);商户法人微信扫码完成验证。

资料审核与账户状态查询(微信侧)

完成商户资料提交及账户验证后,将进入平台审核环节,审核一般需要1-7个工作日,商户可以随时进入页面或通过通联运营平台查看最新审核状态。

签约

微信侧平台审核通过之后,即可进入商户号开通环节,此时由通联提供签约二维码,由商户法人微信进行扫码签约即可。

完成签约后,将进入"商户号开通中"状态,微信将为商户开通商户号,稍后片刻即可完成最终开通。当状态变成"已开通"后,即可通过该商户号使用支付服务。

完成商户号与小程序的关联

商户号完成开通后,需根据指引进行相关操作,确保"与小程序关联状态"为"已关联",商户号方可在小程序中成功发起支付!

(1)当"与小程序关联状态"为"待商户号超管同意"时

请商户号超管前往"微信支付商家助手"公众号按照收到的"创建经营场景申请进展通知",或者pc 登录商户平台pay.weixin.qq.com按照站内信通知,进行相关操作:

descript

descript

(2)当"与小程序关联状态"为"待小程序超管同意"时

请小程序超管pc 登录小程序后台 mp.weixin.qq.com,前往【功能-微信支付】,针对以下两个待确认流程进行确认操作。

descript

descript

报名技术服务费优惠活动

由通联分公司运营人员登录云商通二代运营后台,按商户维度进行操作费率报名,申请多个商户需多次优惠费率。

微信侧产品指导报价千四,可申请优惠费率,支付中门店已认证未认证均支持支付,但费率不同

  • 门店已认证:微信按优惠费率记手续费
  • 门店未认证:按千6记收手续费

配置商户提现规则

提现规则配置

方式1:微信页面端方式:

可前往"基本配置--自动提现"页面,开启自动提现功能。开启后,平台将每天定时发起提现申请。

descript

方式2:由通联分公司运营人员登录云商通二代运营后台,按商户维度进行配置。

提现时效:

产品配置自动提现,D日交易,D+1日早上 8:30发起提现,立即到账

提现金额:

D日【日终账户余额】,前一日的日终可提现账户余额;当系统自动发起提现时,会判断当时的可提现金额账户余额,是否大于"前一日的日终可提现账户余额",≥时发起提现,<时不发起。

商户发票获取

通过微信运营平台,菜单-B2b门店助手-【支付管理】查看详情-【资金管理】发票管理。

descript

小b门店进行门店认证

1.7.1 小程序前端改造

在小程序的流程设计中,需引导用户进入”小程序门店助手“插件页面,完成门店认证授权流程。只有完成门店认证授权的用户,方可获取用户的门店信息、使用模板消息功能以及享受优惠费率。

标杆示例:

descript

小程序C端拉起小b门店授权,参考微信官方前端配置门店助手插件,配置成功后用户访问小程序会唤起授权弹窗。

申请添加插件

方式1:小程序后台页面申请

登录小程序后台(mp.weixin.qq.com),选择菜单“设置-第三方设置-插件管理-添加插件”,搜索“小程序门店助手”并申请添加。

方式2:开发者工具引用

使用开发者工具运行小程序,并引入插件,在调试器中会提示“添加插件”,点击添加插件,前往小程序管理后台确认即可.

配置插件

在小程序app.json中配置

重要提醒:version可以填写具体版本号,建议直接填写latest以自动获取最新版插件

注意:“自定义插件名”代表之后使用时需要配置的,文档中使用了"bb-plugin"作为演示。 还需要添加 permission 字段来允许使用定位信息,才可以选择门店地址。

{

"pages": [

"pages/index/index"

],

"plugins": {

"自定义插件名": {

"version": "latest",

"provider": "wx69b7451feb427f0e"

}

},

"sitemapLocation": "sitemap.json",

"permission": {

"scope.userLocation": {

"desc": "你的位置信息将用于小程序定位"

}

}

}

代码中添加插件入口

页面中会出现“打开插件”的导航,点击可跳转门店认证插件。

示例中的“bb-plugin”就是在app.json里面配置的自定义的插件名。

<!--index.wxml-->

<navigator url="plugin://bb-plugin/info-regist">

打开插件

</navigator>

获取插件授权信息

备注:若用户未向该小程序授权门店认证信息,则会返回错误信息“门店未对品牌授权”。

const plugin = requirePlugin("bb-plugin"); // 引入插件

Page({

data: {

},

onShow(){

plugin.getRetailInfo({

success: (value) => {

console.log(value)

}

})

}

});

// value 结构如下

{

"status": true,

"errorMsg": "成功",

"data": {

"isEnableUsePlugin": true,

"isGrantRetailInfo": true,

"phone": "18888888888",

"storeType": "超市",

"storeAddress": "广东省广州市海珠区创意大道",

"businessName": "测试店名 A",

"businessId": "223345jjj123445C",

"managerName": "路人甲",

"openid": "ooo999=ssssdxdf",

"managerAuditStatus": 4

}

}

插件返回的授权信息

返回结构体字段:

参数意义

返回参数

备注

调用状态

status

若未授权则为 false

返回数据

data

 

错误信息

errorMsg

 

返回数据字段:

参数意义

参数名称

类型

该小程序是否允许使用此插件

isEnableUsePlugin

boolean

该小程序是否已被授权

isGrantRetailInfo

boolean

门店登记手机号

phone

string

门店类型

storeType

string

门店地址

storeAddress

string

门店名称

businessName

string

营业执照注册号

businessId

string

经营者姓名

managerName

string

用于发送消息的id

openid

string

1.7.2 预录入门店信息

可通过云商通【预录入门店信息】接口,将门店信息录入。对于已提前预录入门店信息的用户,在登录小程序进行门店认证授权流程时,会默认拉起展示预录入的门店信息,用户一键确认即可完成认证授权,减少用户操作成本,提示认证授权成功率:

descript

1.7.3 引导用户完成门店认证

小程序完成门店助手开通后,需引导线下小b门店访问小程序时完成门店认证。共有以下几种情形:

(1)如小b门店已在平台门店库,则需用户一键确认授权

descript

(2)如小b门店信息已录入信息且命中算法,则需用户核对已录入信息并点击确认

descript

(3)如小b门店信息未录入信息且命中算法,则需用户手动填写门店名称、类型、定位并点击确认

descript

(4)如小b门店信息已录入信息且未命中算法,则需用户手动填写营业执照注册号、企业名称、经营者姓名

descript

(5)如小b门店信息未录入信息且未命中算法,则需要用户手动填写门店名称、类型、定位、营业执照注册号、企业名称、经营者姓名

descript

完整图示如下:

descript

 

 

订单支付及退款

 

支付

1、  【消费申请】、【担保消费申请】接口:上送“小程序B2b门店助手”支付模式,完成下单,接口响应“渠道参数信息(前端支付参数)-B2bChnlFrontParamInfo”,商户获取此信息,在小程序内下单拉起支付( wx.requestCommonPayment(Object object))的流程与正常小程序支付一致,默认微信支付限额为5万;

2、  前端调起微信后未支付,微信默认20分钟关闭订单;

*针对同一笔业务订单,前端已调起微信支付,未终态的订单,如再唤起支付,请更换支付订单号。(目前微信针对此产品暂不支持主动关闭)

退款

1、  【退款申请接口】:当原交易时间超过160天的订单不受理退款,微信支付退款支持单笔交易分多次退款,需等待前一次退款完成后再发起调用。

2、  退款间隔:支付成功和退款发起建议间隔10分钟时间,间隔过小会导致渠道退款报错。

*退款订单为异步处理逻辑,针对respMsg\":\"操作频繁,请稍后再试\",\"respCode\":\"20002;建议1分钟后再请求。

订单管理

支付和退款订单通过【订单结果通知】接口,获取订单结果,也可通过【订单状态查询】、【订单详情查询】接口查询具体订单信息。

订单对账

结算周期:D+1 11:45分后,可通过【对账文件下载】接口获取对账文件

对账单获取:云商通门户支持选择日期下载商户对账文件(excel)

商户结算

支持设置商户自定义提现规则(云商通运营平台配置)或客户登陆小程序后台配置。

手动提现

对于已结算部分的资金,可在微信小程序后台"资金管理"页面中申请提现

自动提现

D日交易,D+1日早上 8:30发起提现,立即到账。

页面方式:可前往"基本配置--自动提现"页面,开启自动提现功能。开启后,平台将每天定时发起提现申请。

商户发票获取

通过微信运营平台,菜单-B2b门店助手-【支付管理】查看详情-【资金管理】发票管理。

 


chenlin6 2024年12月24日 14:18 收藏文档