收银宝间联微信订单B2B小程序FAQ

一、接口类

1.调用api接口一直报错48001[api unauthorized rid]，怎么解决？

• 首先确认access_token 是否获取正确：Token生成说明 | 微信开放文档
• 确认小程序是否开通门店助手：小程序后台能看到这个界面
• 确认第三方（服务商）是否被授权 158 权限集
  • 首先服务商需要在微信开放平台开发配置里添加小程序权限集
  • 让小程序授权 158 权限集
  • 最后第三方平台页面看到的：
• 或参考排错指南排查问题：https://developers.weixin.qq.com/doc/oplatform/Third-party_Platforms/2.0/troubleshooting/third_party_authority_instructions_troubleshooting.html

2.api 接口里的 access_token怎么获取？

Token生成说明 | 微信开放文档

3.交易结果回调地址是不是可以用服务商的地址，如何配置

消息推送 | 微信开放文档

4.目前支付发起的交互链路是什么样子的

5.上传商户图片 API 接口返回-1

• 检查[file_name]字段后缀是否正确，接受"jpg/jpeg/png/bmp"后缀，注意小写
• 检查[file]字段是否为图片的二进制转base64 字符串

6.调用wx.requestCommonPayment 签名无效：invalid pay signature 702003（报错702002）

• 注意！！！：目前文档提供的支付签名计算是以getorder查询订单api为例，调用wx.requestCommonPayment，uri固定为requestCommonPayment，一定要把uri替换成requestCommonPayment（uri = 'requestCommonPayment'）；

post_body内容也需要替换成signData的内容，必须和实际发起请求的post_body完全一致。

• 确定加密算法是否正确：to_hex(hmac_sha256(sessionKey,signData))
• 确认加密的 key 是否正确，是否弄混现网/沙箱环境的key信息，获取AppKey（/retail/B2b/getappkey）接口可以获取现网/沙箱密钥
• 检查用户登录态 session_key 是否过期，session_key需要为当前用户有效session_key
• 确认加密的数据是否正确：uri&post_body。一个例子：
  • uri: "requestCommonPayment"
  • post_body: "{\\"mchid\\":\\"123456\\",\\"out_trade_no\\":\\"123456\\",\\"description\\":\\"-订单号DD123456\\",\\"amount\\":{\\"order_amount\\":200,\\"currency\\":\\"CNY\\"},\\"attach\\":\\"aaa,1234\\",\\"env\\":0}"
• 确认加密的数据空格是否被正确处理：有些 json 库不会去掉json 结构里逗号后面的空格，需要处理掉
• 确认数据的格式是否正确，如order_amount是整数不是浮点数
• 确认小程序端参数名大小写，参考文档参数对比（注意：需要和文档名称一致例如：开发者自定义paysig、pay_sig、paysign、paySign、PsySig 等这些都不行，必须是paySig ）

7.调用微信退款接口成功，但是查询微信退款单返回退款失败。

• 退款涉及平台分账等行为，如果这些流程还没完成，申请退款的金额大于剩余没有分账的金额，可能就会出现退款失败。此时查询退款单的状态是[REFUND_FAIL]，描述是[系统原因导致失败，请稍后重试发起]。这种情况下需要开发者稍晚点发起退款重试。

8.IP白名单限制在哪里配置（请求接口返回{"errcode":61004,"errmsg":"access clientip is not registered ..."})

• 微信开放平台-第三方平台-开发配置-开发资料-白名单 ip 地址列表，https://developers.weixin.qq.com/doc/oplatform/Third-party_Platforms/2.0/troubleshooting/TroubleShooting.html

9.报错【获取商户号信息失败，请确认商户号是否开通成功】如何处理

• 是商户id没有传到微信后台
  • 检查一下前端请求mchid字段是否为空；
  • 非空情况下，检查下http-post请求头的 'Content-Type'是否为 'application/json'
  • 如果是支付接口，检查一下signdata这个字段的字符串是否是直接由请求体反序列化得到的，不要再多一层"signdata":xxx

10.session_key是否会过期？会的。怎么获取session_key？

• wx.checkSession(Object object) | 微信开放文档注意：如调用此接口出现报错87009，请开发者仔细核查session_key 值是否完整且是否在有效期内！前后端参数是否对应

/sns/jscode2session接口返回的session_key 值里面有字符（不要把"+"、"/"等干掉变成空格），注意编码格式。

• https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/login.html

11、调用wx.requestCommonPayment 错误码1003-999-35006/1003-100006-35506

• 小程序与商户号未完成绑定，或者手动解绑过
  • 商户检查商户号状态是否已经绑定

12、调用wx.requestCommonPayment 错误码 1003-30000-30000

• 商品名称中有特殊字符
  • 让商家去掉特殊字符，目前暂时不支持特殊字符。

13、调用/retail/B2b/...等 api 返回 9403200 参数为空或非法 detail:[支付签名[pay_sig]校验失败]rid: ...

• paySig校验失败
  • 让商户检查 uri 是否填写了正确的 /retail/B2b/...
  • 让商户检查 AppKey 是否使用的现网环境的key，目前服务器api只能用现网AppKey
  • 让商户检查加密的 postdata 和发起请求的 postdata 是否一致
  • 对照文档 一、简介与准入开通 | 微信开放文档 检查签名算法是否正确
  • 检查实际使用的appKey是否为对应B2b商户号下的信息，不同商户号不能混用，可登录mp后台查看B2b商户号中查看对应信息/或者调用获取AppKey的/retail/B2b/getappkey接口获取现网环境AppKey

14、报错：requestCommonPayment:fail webapi_wxa_createmidasorder:fail server system error", errno: 1000, errCode: undefined 内部系统错误

• 商户号绑定状态有问题，可以去B2b门店助手-支付管理-商户号管理 及 支付与交易-微信支付下查看下绑定情况，是否为对应小程序下的商户号；若在支付与交易-微信支付-已关联商户号(服务商模式)下解绑了父商户号为1800010305 的B2b商户号，请重新申请新B2b商户号，使用新B2b商户重新调用B2b支付接口。
• 参数名错误，mchid，里面的i小写
• 此商家的收款功能已被限制，暂无法支付。商家可登录微信商户平台/微信支付商家助手小程序/经营账户页面查看原因和解决方案。
• 若字段内容，比如商品描述里需要使用斜杠，把\换成/
• 字段值长度超过限制，具体查看接口文档参数类型[长度限制]（注意：目前 商品描述字段 暂时需控制在100个字节内，已恢复127字节长度限制）

15、报错：requestCommonPayment:fail webapi_wxa_createmidasorder:fail mch is not registered 702006

• 去B2b门店助手-支付管理-商户号管理 及 支付与交易-微信支付下查看下绑定情况，商户号是否已绑定成功且已关联，是否为对应小程序下的商户号(通过B2b申请商户号流程，在这个B2b小程序下注册成功的B2b商户号)
• 传值问题，开发者仔细检查请求包参数信息（包括参数名称是否与文档一致）、参数类型，int64 类型不是 string不要使用双引号。

16、报错{"errcode":12,"errmsg":"不在可以设置费率的时间范围内 rid: ...

• 每 30 天只能修改一次

17、{"errcode":9403202,"errmsg":"商户单号重复 detail:[商户退款单号重复，请更换退款单号重试] rid: ...

• 开发者自查调用日志，退款单号重复使用

18、支付失败报错{errMsg："requestPayment:fail banned"}、{errno:102,errMsg: "requestPayment:fail:access denied,appId=XXX"}

• 调错支付接口了，B2b支付使用 wx.requestCommonPayment
• 若确认没用错B2b支付接口，登录mp后台检查站内信有没有封禁支付权限：关于《微信小程序订单管理》接入通知 / 点击首页是否有订单信息录入通知，按照第2点登记成功后再重试下B2b支付

19、报错{"errcode":9403203,"errmsg":"商户未完成建档 detail:[获取商户号信息失败，请确认商户号是否开通成功] rid: ...

• 检查字段名是否填写有误，是mchid ，不是mch_id
• 请求包格式需要是JSON
• 填写的商户号是否是对应小程序下的B2b商户号
• 实际请求包body没有请求参数内容，为NULL

20、B2b商户号关联小程序失败，点击重试报错 ret=110002

• 关于绑定小程序与商户号的环节，商家不能自行去微信支付商户后台操作，必须按照B2b文档步骤操作，否则就会绑定不成功。
• 不要按照以下截图的指引操作，需要按照B2b文档来
• 检查之前收到此确认通知后，是否一直没去完成确认----该情况只能重新注册新B2b商户号，注意接收消息后及时完成确认！

21.服务商代开通申请门店助手权限【查询商户号开通状态API】报错{"errcode":-1,"errmsg":"system error detail:[系统错误，请稍后重试] rid: ...

• 服务商代开通前，需要小程序先添加B2b的类目（商家自营-B2b(商品批发/门店管理)），才能代开通申请门店助手权限
• 添加类目有2种方式：

方式1：登录mp后台(https://mp.weixin.qq.com/)添加类目；

方式2：第三方平台有代小程序添加类目的接口，该接口需要小程序授权【30】小程序基本信息管理 权限集给第三方平台后才能代调用

https://developers.weixin.qq.com/doc/oplatform/openApi/OpenApiDoc/miniprogram-management/category-management/addCategory.html

22.报错{"errcode":61007,"errmsg":"api is unauthorized to component rid: ...

• B2b小程序未授权【158】小程序B2b门店助手 权限集给第三方平台，完成授权后再代调用，可通过该接口

https://developers.weixin.qq.com/doc/oplatform/openApi/OpenApiDoc/authorization-management/getAuthorizerInfo.html

查询对应小程序是否将权限授给第三方平台，后续遇到61007的问题建议可以先按照指引

https://developers.weixin.qq.com/doc/oplatform/Third-party_Platforms/2.0/troubleshooting/third_party_authority_instructions_troubleshooting.html

进行自助排查

23.调用wx.requestCommonPayment 报错:errMsg:"requestCommonPayment:fail webapi_wxa_createmidasorder:fail invalid json" errno:1022

• 检查请求参数信息：参数类型是否正确（例如：env是int类型，实际调用接口时使用""进行包装了）、是否有多余的符号，以及商品信息 product_info ，若有多个商品信息可在第1个商品信息后面添加第2个或多个商品信息

示例：//第2个商品信息

,{

spu_id: 'spu123456',

sku_id: 'sku123',

title: 'QQ长鹅',

path: 'pages/index',

head_img: 'https://mp.weixin.qq.com/123',

category: '玩偶',

sku_attr: '50cm',

org_price: 5000,

sale_price: 4000,

quantity: 5

}

注意：调用此接口需要填写的参数参考B2b文档即可，无需填写offerId 参数。https://developers.weixin.qq.com/miniprogram/dev/platform-capabilities/industry/B2b_store_assistant.html#_3-3-%E6%94%AF%E4%BB%98%E4%B8%8E%E9%80%80%E6%AC%BE

24.上传商户图片 API ，接口报错-1：{"errcode":-1,"errmsg":"system error detail:[传入的file字段为空]

• 代码里字节流base64编码（自行根据代码确认是否编码）后，用json格式传参调用此接口。
• 文件二进制内容不是图片，仔细检查后重新提交

25.报错：requestCommonPayment:fail requestPayment:fail jsapi has no permission,,,,jsapi has been banned,errno:-1

• 登录mp后台（https://mp.weixin.qq.com/）查看站内信和首页，按照指引去录入小程序商品订单详情path，一般生效时间T+1。录入成功后再重试B2b支付接口

26.支付失败,失败原因"errno":1000,"errmsg":requestCommonPayment:fail webapi_wxa_createmidasorder:fail 商户号与小程序未绑定[RID:XXXX]；支付失败,失败原因"errno":1000,"errmsg":requestCommonPayment:fail webapi_wxa_createmidasorder:fail 商户号异常解绑 [RID:XXX]; requestCommonPayment:fail webapi_wxa_createmidasorder:fail {"code":"INVALID_REQUEST","message":"sub_mch_id与sub_appid不匹配"} [RID:.....] 1000

• 检查是否通过B2b业务入口创建的B2b商户号 https://developers.weixin.qq.com/miniprogram/dev/platform-capabilities/industry/B2b_store_assistant.html#_3-1-%E7%94%B3%E8%AF%B7%E5%95%86%E6%88%B7%E5%8F%B7
• 登录mp后台分别检查下【B2b门店助手-支付管理】及【交易与支付-微信支付】的绑定状态，若确定绑定无误检查下参数值是否超过长度限制，例如：商品描述字节数实际是 135 大于最大值 127，一个中文算3个字节（注意：目前商品描述字段暂时需控制在100个字节内，已恢复127字节长度限制）。
• 若检查绑定状态：B2b门店助手-支付管理，显示已关联，但在交易与支付-微信支付看不到已关联成功的服务商信息（1800010305，主体都是：深圳市腾讯计算机系统有限公司信息），请与商户/小程序超管或贵司内部员工确认在交易与支付-微信支付的已关联商户号(服务商模式)板块手动操作解绑了，该情况只能重新申请B2b商户号。

注意：谨慎操作解绑深圳腾讯主体服务商商户号，解绑后可能无法拉起B2b支付

• 如商户号的营业执照信息（例如经营者/法人、企业名称等）出现变更，建议使用最新营业执照信息重新申请B2b商户号。
• B2b商户号注册时若与小程序同主体，已关联商户号(服务商模式)板块可能不会有此商户号绑定的深圳腾讯主体服务商商户号信息，一般情况下可以直接使用，如不能拉起B2b支付，咨询B2b业务侧同学反馈 小程序B2b门店助手 产品功能介绍

27.未接收到B2b支付通知回调事件？

• 调用B2b查询订单API查询下订单支付完成时间，根据支付完成时间点去自查服务器（小程序-消息推送配置的URL地址；第三方平台账号-一般检查现网版本配置的消息与事件接收配置URL地址）的消息推送。
• 配置的URL网络是否通顺，是否能正常接收消息，排查是否拦截微信方IP地址。获取微信服务器IP地址可调用接口：https://developers.weixin.qq.com/doc/offiaccount/Basic_Information/Get_the_WeChat_server_IP_address.html
• 代开发模式检查：

1、小程序是否将158权限集授权给第三方平台

2、排查是否将小程序原始id添加到第三方平台-测试列表中，导致支付通知推送到测试环境消息与事件接收配置URL地址。

28.{"code":19,"error_msg":"当前小程序不在插件白名单中"}

• 检查小程序是否添加类目：商家自营-B2b(商品批发/门店管理) 以及 开通B2b门店助手功能
• 检查小程序是否添加此插件（wx69b7451feb427f0e）并在app.json中配置

29.刚下单就显示订单状态为订单关闭/订单已关闭

• 检查参数信息是否正确，mch_id与appid是否匹配，是否为对应B2b小程序下的B2b商户号。
• 检查控制台具体报错信息，按照报错信息排查问题。

30.插件支付报错{errno:702009,errMsg:"operateWXData:fail wgf is not registered or pay amount is illegal [RID: 

• B2b商户号未开通银行转账功能，可前往mp后台-B2b门店助手-支付管理-找到对应B2b商户号-银行转账-【去开通】或调用开通银行转账 API开通。

31.报错{"errcode":9403201,"errmsg":"数据不存在 detail:[账单不存在] rid:...

• 未成功创建B2b订单、退款单等
• 搞错商户号
• 订单号有误
• 现网、沙箱环境弄混

32、报错{errMsg: "requestCommonPayment:fail webapi_wxa_createmidasorder:fail invalid mode [RID: 6a4cd3b-1744016945]", errno: 702004

• 检查mode参数位置是否填错，mode不在signData里
• mode值填错

33.报错{errno: 702009, errMsg: "operateWXData:fail wqf is not registered or pay amount is illegal [RID: ...；{"errMsg":"enterpriseBankTransfer:fail wqf is not registered or pay amount is illegal [RID: 9ca2914-1772178610]","errCode":1000}

• 商户号没有开通银行转账/订单金额低于5w
• 与小程序关联状态需要已关联

34、报错{"errcode":9403205,"errmsg":"该订单无法退款 detail:[该订单不支持退款] rid: ...

• 调用查询订单接口确认订单状态
• 订单超过160天，不支持退款

35、调用B2b业务api，提示报错"errcode":45009,"errmsq":"reach max api daily guota limit rid:...

• 接口一般都有每日调用限制，具体可以调用https://developers.weixin.qq.com/miniprogram/dev/OpenApiDoc/openApi-mgnt/getApiQuota.html接口自查，重置也有接口支持，具体看文档说明https://developers.weixin.qq.com/miniprogram/dev/OpenApiDoc/openApi-mgnt/clearQuota.html

36、errMsg:"requestcommonPayment:fail signData参数类型必须是string errno: 1001

• signData类型Object，实际调用B2b支付接口前将signData转成String，用jsonStr的格式做实际请求

37、小程序无法支付，提示“支付功能暂时无法使用“

• 根据平台规则，经营B2b业务的小程序，需使用小程序B2b门店助手支付服务进行交易。

38.B2b小程序无法支付，提示“由于小程序违规，支付功能暂时无法使用"

• 检查是否因为没有完成接入订单发货管理导致，可登录小程序后台查看首页或站内信，点击【前去授权】，对所有商户号都完成授权。无法授权或不需要使用的商户号需要解绑。操作完成后即自动恢复能力。
• 订单管理：所有实物电商小程序都需要授权，需提供订单详情页path。设置path路径：小程序mp后台（https://mp.weixin.qq.com/）订单管理-订单信息录入页面-->设置小程序商品订单详情path。配置path后生效时间是T+1
• B2b支付交易的订单，不需要对接发货接口进行发货。

39.用户已完成门店认证授权，B2b获取插件授权信息，返回errmsg：“营业执照未验证”

• 检查代码，可能是未传入回调。可调整为：

    plugin.getRetailInfo({

      success: (res) => {

        console.log('getRetailInfo',res)

      }

    }) 再试试。

40、拉起B2b支付报错：商品名称有特殊字符，字符集不兼容，errno:1000

• 暂时没有具体的字符集列表，utf8包含但是gbk2312不包含的建议不传递，也尽量不要使用特殊字符火星文之类。

41、B2b插件调用报错小程序未授权、营业执照未验证

• 可直接通过status去判断该用户是否完成门店认证；调用门店信息查询api做兜底判断用户是否完成门店认证授权

42.拉起B2b支付报错：商户号收款功能已被限制,商家可以登录微信商户平台/微信支付商家助手小程序查看原因和解决方案[RID...

• 到“商户平台（pay.weixin.qq.com）>账户中心>违约记录”或“商家助手小程序>风险处理”了解原因：1、电脑端申诉方式：https://kf.qq.com/faq/240129iuEZBJ240129meAR3u.html 2、移动端申诉方式：https://kf.qq.com/faq/240129aQZjiM240129QRBFRV.html
• 如确认商户号均未有任何风控通知，登录mp后台（https://mp.weixin.qq.com/）-微信支付页面查看绑定情况

正常情况下每个B2b商户号会在已关联商户号及已关联商户号(服务商模式)各一条绑定记录，若已关联商户号(服务商模式)下没有任何记录，请与商户/小程序超管或贵司内部员工确认在交易与支付-微信支付的已关联商户号(服务商模式)板块手动操作解绑了，该情况只能重新申请B2b商户号。

注意：谨慎操作解绑已关联商户号(服务商模式)板块下的深圳腾讯主体服务商商户号，解绑后可能无法拉起B2b支付

二.门店认证

2.1.营业执照上的企业名称为空或*字符，门店认证时企业名称如何填写？

• 企业名称填写“个体户+经营者姓名”，如“个体户张三” 。

2.2.用户进行门店认证需要上传营业执照信息？有些用户提示营业执照被占用

• 门店认证基于微信号，微信号命中平台算法就不需要营业执照，没命中就需要上传营业执照信息 小程序B2b门店助手 产品功能介绍
• 目前同一个营业执照只能用一次。可以先认证其中一个人，另一个人（其他人）在此B2b小程序中平时提高访问、交易频次就会通过算法验证，再次进行门店认证时就不需要提供营业执照。
• 员工管理功能：小程序B2b门店助手 产品功能介绍

2.3.企业名称不合法

• 检查填写的名称是否与国家公示系统查询一致、是否有多余空格或其他字符、需要填写整个企业名称包括"(个体工商户)"或"（个体工商户）"
• 可以去国家公示系统查询企业信息：

https://shiming.gsxt.gov.cn/index.html

2.4.门店认证授权提示：您不是指定门店法人身份，无法验证

• 检查点击同意授权的用户微信实名认证信息是否为企业法人（经营者）

三.报名技术服务费优惠活动

3.1.接口端方式报名，自研开发者/代开发服务商都能调用吗？

• 可以。如果是自研模式，在 mp端操作报名即可，没必要开发接口，是否需要调用接口取决于开发者。
• 授权158权限集给第三方平台服务商，只能由服务商代调用接口报名优惠费率。

3.2.设置费率是否有其他规则限制？比如时间、范围

• 通过api设置费率建议开发者也记录下设置费率时间，目前每30天只能修改一次且费率只能下调。

3.3.已完成门店认证，为什么订单无法享受优惠费率还是默认费率0.6%？

• 使用 B2b 支付的“查询订单”接口，确认支付用户的 openid，然后根据门店认证的“门店信息查询 api”，确认这个 openid 是否完成门店认证。以及订单的发起支付时间，是否晚于，用户 openid 的门店认证成功时间。

四.退款

4.1.退款逻辑是什么？

• 订单结算后退款，先从可提现金额账户里面扣除所需退款金额，退款成功后，后返还退款对应的手续费

4.2、分账退款逻辑是什么？

• 具体查看B2b分账退款规则说明：https://developers.weixin.qq.com/miniprogram/dev/platform-capabilities/industry/B2b_store_assistant.html#_3-6-%E5%88%86%E8%B4%A6

4.3.怎么核实退款到哪里了？退款时间是多久？到账时间是多久？mp后台查询显示的退款时间是实际到账时间吗？

• 银行卡退款需要0~7个工作日
• 分别查询订单api（确认用户实际支付方式）和查询退款api（确认退款入账账户）
• 退到银行卡（储蓄卡及信用卡）0-3个工作日；微信零钱退款即时到账
• 不是，这里是平台处理退款单-退款成功时间，实际到账时间要以实际为准。