文档地址:「微信支付分停车服务」
Q1:商户调用“支付分停车扣款受理API”返回:{"code":"PARAM_ERROR","message":"参数错误"}
A1:请按下列几点进行排查:
- 请确认参数是否按照文档的参数格式进行填写
- 请确认appid与mchid、sub_appid与sub_mchid有关联
- start_time与end_time时间不能相同
- end_time时间是否小于当前发起扣款时的时间
Q2:支付分停车扣费受理接口code返回:INVALID_REQUEST;message返回:场景信息和停车入场id不匹配
A2:请按下列几点进行排查:
- 停车入场id(parking_id)已经进行过受理
- parking_info传入的信息,与入场时信息不一致
- 服务商模式请检查创建停车入场接口使用的sub_mchid,是否与扣费受理接口使用的sub_mchid一致
Q3:支付分停车扣费受理接口code返回:INVALID_REQUEST;message返回:停车入场id不存在
A3:请按下列几点进行排查:
- 停车入场id传入错误,需使用创建停车入场API返回的停车入场id
- 停车入场id不是当前车牌最新有效的停车入场id,同一车牌同时只存在一个有效的停车入场id
- 停车入场id已经扣过款,不能重复使用
Q4:支付分停车扣款接口返回:"code": "NO_AUTH","message": "当前商户无法扣款"
A4:请按下列几点进行排查:
- 请检查appid和调用接口的商户号是否关联成功
- 服务商模式请检查sub_appid和sub_mchid是否关联成功
- 此商家的收款功能已被限制,暂无法支付,商家可以登录微信商户平台/微信支付商家助手小程序查看原因和解决方案
Q5:商户调用“调起微信支付分停车服务开通页API”返回:商户无权限发起该流程,请联系商户处理
A5:请按下列几点进行排查:
- 请确认是否已经完成了相关的支付分停车权限申请
- 请确认唤起的模式是否符合申请权限的模式,如服务商模式下不能使用直连模式唤起
Q:调用支付分停车“创建停车入场API”返回“商户入场id非法,请检查商户入场id”是什么原因?
A:每次入场都需使用不同的商户入场id,商户入场id不能重复使用。
Q:调用支付分停车“扣费受理API”返回“系统繁忙,请稍后重试”
A:请按下列几点进行排查:
- 停车入场id不正确(长度小于12个字符时报系统繁忙,大于等于12个字符时,如果不正确会报错停车入场id不存在),停车入场id不是自定义的参数,是由“创建停车入场API”返回。
- appid或sub_appid填写错误。
- 当前系统繁忙,可用原参数重试扣款。
Q6:微信车主2.0/3.0模式请求接口返回PARAM_ERROR错误
A6:请按下列几点进行排查:
- 核实对应参数的格式是否有严格按照文档上面说明的进行
- 请求参数是否是真实有效的,如发起扣款时,车牌已经绑定且授权的情况
- 车主服务接口权限升级导致需要新增参数,详情查看最新车主接口文档
Q7:小程序或者app应用如何跳转到支付分停车车牌管理页
A7:
- path路径填入/pages/creditparking/creditparking,小程序可以参考此处https://developers.weixin.qq.com/miniprogram/dev/api/navigate/wx.navigateToMiniProgram.html
- path路径填入/pages/creditparking/creditparking,APP可以参考此处https://developers.weixin.qq.com/doc/oplatform/Mobile_App/Launching_a_Mini_Program/Launching_a_Mini_Program.html
Q8:小程序或者app应用如何跳转到微信车主服务首页
A8:
- path路径填入/pages/index/index,小程序可以参考此处https://developers.weixin.qq.com/miniprogram/dev/api/navigate/wx.navigateToMiniProgram.html
- path路径填入/pages/index/index,APP可以参考此处https://developers.weixin.qq.com/doc/oplatform/Mobile_App/Launching_a_Mini_Program/Launching_a_Mini_Program.html
Q9:微信车主用户状态接口查询返回normal,微信车主申请扣款接口err_code返回VEHICLE_NOT_EXIST;err_code_des返回No valid Plate Number at trade_time
A9:请按下列几点进行排查:
- 扣款发起的时候,车牌是否没绑定到车主平台
- 参数end_time的时间必须要在车牌绑定之后的时间
Q10:微信车主用户状态接口查询返回normal,微信车主申请扣款接口err_code返回VEHICLE_NOT_EXIST;err_code_des返回Plate Number Query EMPTY
A10:由于车牌进行过无感降级成免密的操作,导致了该车牌无法在2.0模式的停车场下使用,需要车场进行升级成3.0的模式后才能对该车牌进行扣款
Q11:调用微信乘车码签约接口返回:此商户暂未开通此业务/暂时无法开通
A11:请按下列几点进行排查:
- 确认代扣权限是否开通成功,登陆商户平台——产品中心核实
- 商户号与APPID是否有绑定的关系
- 模板id是否与商户号对应,直连的不能使用服务商的,服务商的不能使用直连的
- 公众号唤起签约中notify_url参数是否有按照文档的填写,参与sign生成是notify_url不需要转义,跳转url需要转义
- 请求接口是否有误,如直连商户请求成服务商模式的接口
- 代扣模板id(plan_id)是否审批通过
Q12:调用微信乘车码签约接口返回:网络异常签约失败
A12:请按下列几点进行排查:
- 确认plan_id已审核通过
- 确认plan_id是否与当前商户号匹配
- 确认参数是否按照文档的填写
- 确认签约使用的网络环境,如使用了代理的情况,请将payapp.weixin.qq.com地址移除到例外配置列表
- 确认当前签约用户是否已微信实名
- 确认当前商户号与appid有绑定关系
Q13:车主服务和乘车码接口,用户签约、解约是如何通知商户
A13:
- 微信车主
- 签约与解约不会通知到商户,由于用户是与微信进行签约而不是与商户进行签约
- 微信乘车码
- 签约通知是通过签约接口上传的notify_url参数所填写的地址回调通知的(签约失败不通知)。解约信息是通过创建模版ID时填写的解约通知URL来回调通知的
Q14:调用微信车主服务“授权/开通接口”返回:参数错误,请联系商户处理
A14:请按下列几点进行排查:
- 确认extraData的所需参数是否有传入
- 确认extraData的格式是否为object
Q15:调用微信车主服务“授权/开通接口”返回:当前请求人数较多,请稍后再试
A15:请按下列几点进行排查:
- 使用签名校验工具"https://pay.weixin.qq.com/wiki/doc/api/micropay.php?chapter=20_1"中的自定义参数进行检测
- 签名校验工具通过,但实际请求失败,检查生成SIGN用的KEY是否正确,服务商模式需要使用服务商的,参数是否有按照文档内的填写
- 核实请求参数格式是否按照文档的填写
- openid/sub_openid是否是属于当前这台签约手机的微信号
- openid/sub_openid的值是否对应当前的appid/sub_appid(可以通过接口核实:https://pay.weixin.qq.com/wiki/doc/api/micropay_sl.php?chapter=9_12&index=8)
- 确认参数appid与mch_id是否有绑定关系
- 确认参数sub_appid与sub_mch_id是否有绑定关系
- H5授权跳转URL排查格式是否正确,如是否多了空格、车牌参数中文是否已url编码转义等
- H5授权跳转URL中车牌参数需要转义,参与Sign生成时不需要
- 确认授权对象的appid(服务商为sub_appid,直连为appid)已申请车主服务接入流程
- 需要用户确认是否完成微信的实名认证,打开微信钱包,查看“身份信息”,可查看实名认证状态
- 可能用户本地小程序还是旧版的,需要用户在“微信车主服务”公众号点击进去,访问车主服务小程序之后,再退出重试签约
- 检查是否有同号不同色车牌在绑定中
Q17:调用乘车码扣款接口返回:CONTRACT_OVER_LIMIT
A17:检查支付金额、当天支付笔数是否超过限额,如已配置,咨询相关配置人员确认开通无误;注:默认次数:每天5笔,每笔最大500元
Q18:车主服务调用入场通知接口用户状态查询返回:VEHICLE_NOT_EXIST
A18:请按下列几点进行排查:
- 车牌号是否在车主平台进行过绑定,可通过用户状态查询接口核实
- 车牌格式是否正确
Q19:车主服务、乘车码申请扣款的时候,如何使用代金券
A19:申请扣款接口里面的goods_tag参数,具体的在申请代金券规则里面有说明
Q20:小程序调用授权/开通接口”返回:开发小程序已过期,请在开发者工具中重新扫码
A20:请按下列几点进行排查:
- 查看一下参数是否有添加envVersion,该参数会不正确会导致无法正常跳转
- 开发者工具目前已经不支持模拟小程序跳转,如需测试,请使用手机进行测试
Q21:车主服务发起扣款受理成功,但支付回调返回扣款失败
A21:请按下列几点进行排查:
- 商户需要确认是否开通了垫资功能
- 如果已开通微信垫资功能,商户侧可更换商户订单号重新发起申请扣款
- 如果重试扣款多次还是失败,可以联系微信技术支持人员反馈
Q22:微信车主服务,当用户余额不足抵扣的时候,垫资是由谁来帮用户垫
A22:商户在垫资功能已经配置成功的情况下,当申请扣款接口受理成功,但是用户余额不足抵扣的时候,这边会由微信来帮用户垫资这笔费用,并由微信负责催缴,商户侧也可通过“微信垫资还款api”引导用户跳转微信侧还款
Q23:已关闭的扣款订单,更换商户订单号后重新发起扣款,是否会对用户扣款多次
A23:对于用户来说,只有支付成功的订单,用户才会产生费用。已关闭的订单并不会对用户产生扣费
Q24:微信车主服务,用户如何添加多个车牌
A24:通过授权开通接口可对同一个用户进行多个车牌的绑定
Q25:用户在欠费状态下,商户是否需要通过“微信垫资还款api”引导用户还款
A25:建议引导。如果用户是欠费状态,商户侧应限制用户的服务,应尽快引导用户还款后恢复服务
Q26:调用“调起签约接口”返回:签名构造参数错误
A26: 请按下列几点进行排查:
- 查看参数名是否正确填写,是否参杂多余参数进行签名,是否有多余的空格
- 商户号是否填写错误
- notify_url不能有特殊字符,像“!”;也不能使用localhost,notify_urlcontract_display_account都不需要ENCODE
- SIGN生成有误,请通过签名校验工具中自定义参数进行校验(https://pay.weixin.qq.com/wiki/doc/api/micropay.php?chapter=20_1),如校验通过但实际请求错误,请确认秘钥是否有误
- request_serial第一位最好不要为0
- extraData类型为object,不是字符串
- 签约链接是否有换行
- contract_display_account参数值不支持UTF8非3字节编码的字符,如+
Q27:微信车主服务请求服务商模式的接口返回:受理关系不存在
A27:请确认接口中sub_mch_id与mch_id是否有绑定关系,商户可以登陆服务商后台查看对应的子商户列表核实
Q28:微信车主申请开通服务返回:你暂时无法开通微信车主服务,请留意后续的通知
A28:请按下列几点进行排查:
- 开通车主服务用户必须已实名
- 用户活跃度不高,微信注册时间不超过3个月
- 用户不满足开通车主的条件,该账号可能涉及风控
Q29:调用微信车主接口返回:商户号代扣产品权限校验失败
A29:请按下列几点进行排查:
- 确认mch_id和appid有绑定关系
- 确认sub_mch_id与sub_appid有绑定关系
- 请求接口是否有混淆,服务商模式需要走服务商接口,不能走直连模式接口
- 请求参数是否有混淆,子商户号不能填写到服务商号参数中
- 服务商模式下请确认子商户是否已经对服务商授权代扣权限(服务商可登录商户平台代扣管理中核实)
- 请确认当前商户号的微信车主平台代扣权限是否已开通(可联系对接微信运营同事确认)
- 服务商模式下请确认子商户是否已经对服务商授权微信车主平台代扣权限(可联系对接微信运营同事确认)
Q30:用户要如何关闭车主服务和移除车牌
A30:
- 如需关闭服务:我-服务-钱包-支付设置-免密支付-车主服务-关闭扣费服务,关闭服务的同时会解绑所有车牌
- 如需移除车牌:关注公众号“微信车主服务”-菜单栏“车主服务”-“我的车牌”-点垃圾桶图标删除,只移除车牌不会关闭服务
Q31:调用微信乘车码“申请扣款接口”返回:CONTRACT_OVER_LIMIT这类情况隔天是否会进行自动发起扣款的操作
A31:不会
Q32:微信车主服务是否可以根据异步通知的支付结果作为放行车辆的依据
A32:可以
Q33:微信车主H5跳转授权出现空白页面
A33:请按下列几点进行排查:
- 核实车牌参数是否有UTF8格式转义
- 核实请求参数是否是按照文档的填写
Q34:微信车主接口返回:商户号与APPID不匹配(appid not match mch_id)
A34:
- 请求接口类型错误
- 确认APPID与MCH_ID有绑定关系
Q36:调用微信车主服务入场通知接口返回:UNAUTHORIZED
A36:请按下列几点进行排查:
- 确认请求参数格式、参数值无误,如车牌的格式
- 可进行“用户状态查询接口”核实对应的车牌列表信息,如返回正常,则确认“入场通知接口”中的对应的商户号、子商户、appid、sub_appid等参数是否是与“用户状态查询接口”一致
Q37:调用微信车主接口返回:sub_appid not match sub_mch_id
A37:请按下列几点进行排查:
- 检查请求参数是否正确,是否是按照文档上的填写
- 检查子商户绑定的appid是否是此sub_appid,具体可以在(商户平台-服务商功能-特约商户管理-配置-特约商户APPID管理)中查看
Q38:微信车主接口返回:Permission denied
A38:请按下列几点进行排查:
- 检查请求参数是否正确,是否是按照文档上的填写
- 请确认车主权限是否有申请开通,如无申请可通过《车主服务接入流程文档》进行申请
Q39:调用乘车码申请扣款返回:签约号无效
A39:请按下列几点进行排查:
- 签约协议号需要使用签约成功时微信返回的协议号
- 多个商户共同使用需要申请共享协议号,如共享配置已完成,但仍然返回该错误,请确认主共享与被共享的商户号是否混淆
Q40:车主服务的H5授权完成页面点击完成按钮跳转异常
A40:请按下列几点进行排查:
- 确认是否已经配置该回跳地址,可以通过《车主服务接入流程文档》进行申请
- 确认配置的地址中没有携带问号、特殊字符参数
- 确认配置的地址可以正常访问
Q41:调用微信车主服务“用户状态查询接口”接口返回:OVERDUE
A41:请按下列几点进行排查:
- 确认用户是否已经通过“缴费通知”进行还款
- 商户侧可以请求“微信垫资还款API”接口引导用户进行还款
Q42:调用微信车主“用户状态接口”什么情况下会返回path路径
A42:
- 调用”用户状态查询接口“,用户状态为非normal的情况会返回path路径
- 调用”用户状态查询接口“,用户状态为normal且plate_number _info车牌列表为空的情况下会返回path路径
Q43:垫资的订单可以发起退款吗
A43:微信侧垫资的订单可以发起全额退款,也可以发起部分退款
Q44:微信乘车码是否支持用户在小程序签约后在同一商户的公众号或APP上解约
A44:当签约与解约接口的appid、mch_id、sub_mch_id、plan_id参数值一致时是支持的
Q45:微信车主服务服务商模式下,调用”用户状态查询接口“需要注意哪些事项
A45:
- 服务商模式下,如其下的子商户绑定的sub_appid一致时,可以使用任意一个子商户进行查询
- 服务商模式下,如其下的子商户绑定的sub_appid不一致时,需要使用对应”授权开通接口“时使用的sub_appid进行查询
- 服务商模式下,其下的子商户都需要进行开通车主接口权限,具体开通流程可以查看《车主服务接入流程文档》
Q46:车主的免密单笔限额是多少呢
A46:目前不同场景不同的情况的限额都不一样
Q47:代扣模板审批通过后,是否支持修改,修改完之后是否需要审批
A47:
- 对于已审批通过的模板,目前这边只支持修改解约通知地址,修改完后立马生效
- 如果是需要修改模板的内容,这边需要重新创建代扣模板
Q48:调用“授权开通接口”没有出现对应的授权页面
A48:请按下列几点进行排查:
- 使用“用户状态查询接口”返回的参数path的值
- 不同类型需要使用对应的授权方式进行跳转
- app使用的跳转path值与小程序的一致
Q49:欠费用户后续要如何还款垫资的费用
A49:
- 通过微信发送的还款通知消息入口
- 通过商户侧请求微信垫资还款api的入口
Q50:车主授权关注功能已配置,商户号已绑定关注appid,返回的授权成功页面没有出现关注按钮选项
A50:核实是否该用户已经关注了公众号,已关注的情况下是不会出现关注按钮
Q51:微信垫资支付的订单在商户平台是如何展示
A51:垫资的订单在商户的后台上正常的展示,与其他的非垫资订单一样
Q52:用户没有自行的删除车牌,但却收到了来自微信发送的车牌移除通知
A52:非高速ETC场景下,同一个车牌可以被不同的用户进行绑定的操作,当其他用户完成了绑定操作后,原用户会收到来自微信发送的车牌移除通知
Q53:服务商名下有多个特约商户,是不是每个特约商户都需要跟用户签约么
A53:用户只需要跟微信签约即可,跟商户之间的关系只有授权的关系,如在直连模式下,则用户在不同的appid下都需要重新授权,如在服务商模式下,在不同的sub_appid下都需要重新授权。如特约商户的sub_appid都是一样的,车主在一家商户下授权过,那么在其他家sub appid相同的商户都不需要二次授权了
Q54:小程序跳转车主平台返回:体验版小程序无体验权限,请联系小程序管理员
A54:请排查一下跳转组件、跳转方法中的参数中是否添加了version字段,如存在该参数,请修改成release或将该字段参数去掉
Q55:第三方APP跳转微信签约完成之后无法跳转回第三方APP
A55:请按下列几点进行排查:
- 检测是否是包名、包签名的问题,可以通过微信分享接口进行测试,如分享后不能返回到APP,则是包名、包签名的问题
- 签约完成页面点击返回没有弹窗提示也可能会导致跳转失败的情况,自行核实return_app的值是否与文档一致
- 确认所使用的APP安装包是最新版本
- 核实完上述情况后,如还存在跳转异常,在WXEntryActivity重写onCreate和onNewInten方法
- 如IOS正常,Android异常,在manifest文件中添加exported属性、taskAffinity属性、launchMode属性
- 注:有关上述的manifest属性请到开放平台的文档上进行查看:https://open.weixin.qq.com/cgi-bin/showdocument?action=dir_list&t=resource/res_list&verify=1&id=1417751808&token=&lang=zh_CN
Q56:车主接口发起扣款请求,接口返回:No such contract_id, or no contract sign by the user
A56:请确认下在请求车主申请扣款时该用户已开通车主服务
Q57:车主服务商模式下,开通授权页面中的商户可以改成对应的车场的名称么
A57:目前该模式下,名称是固定的,只能展示服务商的商户名称/简称,这边无法修改成对应车场的名称/简称
Q58:车主接口使用测试账号该如何获取openid或者是sub_openid
A58:目前该测试账号需要使用接口的形式来获取对应的openid、sub_openid,该账号无法使用正常的形式(如网页授权等)来获取用户的openid或者sub_openid,具体的接口地址:https://pay.weixin.qq.com/wiki/doc/api/micropay_sl.php?chapter=9_12&index=8(授权码就是微信付款码)
Q59:车主用户在已开通了服务的情况下,是否还需要授权给商户
A59:用户在开通了车主服务后,还需要授权给商户,商户侧可以进行对应的“用户状态查询”,或者通过“入场通知接口”返回的状态判断,如非normal的情况下,根据不同的状态去引导用户进行操作
Q60:微信小程序进行签约的时候返回:参数构造错误
A60:请按下列几点进行排查:
- 核对文档示例检查参数正确性
- 检查appid和商户号是否绑定了关系
- 确认当前商户号的代扣权限是否正常(商户后台-产品中心-委托代扣)
Q62:微信车主服务停车3.0模式的授权模式与2.0的是否一致
A62:一致
Q63:微信车主服务停车3.0模式的新用户默认标签都是为PROACTIVE吗
A63:是的
Q64:微信车主服务停车3.0模式下的用户升级后新添加的车牌都为PROACTIVE吗
A64:是的
Q65:微信车主服务停车3.0接口模式的扣款请求中,是否可以由商户选择传入的deduct_mode字段的值
A65:商户需要根据用户当前的标签值来传入。PROACTIVE标签只能传入PROACTIVE,AUTOPAY可以传入PROACTIVE或AUTOPAY
Q66:PROACTIVE(免密)标签的用户如何升级成AUTOPAY(无感)标签
A66:
- 微信侧会推送升级消息提示用户可以升级成无感标签
- 商户侧请求“免密支付升级无感接口”引导用户升级
Q67:商户是否可以通过“免密支付升级无感支付接口”引导新用户升级标签
A67:可以,只需要“用户状态查询接口”有返回COMMON_USE即可引导用户升级对应的车牌
Q68:商户使用“免密支付升级无感支付接口”的前提条件
A68:需要用户授权后才能通过接口引导,具体可以通过“用户状态查询接口”核实用户的当前授权状态
Q69:停车3.0场景中的常用车牌的触发规则是否区分停车场(商户)
A69:不区分。在30天内,一个用户为同个车牌在任意停车场使用了3次免密支付模式,则该车牌被标记为常用车牌,用户可为该车牌升级无感支付。升级后,车辆可在支持无感支付的停车场里授权后使用
Q70:常用车牌的触发规则是否有金额限制
A70:没有
Q71:停车场景3.0接口模式的扣款返回“用户的扣费模式受限,请确认后重试”
A71:调用”用户状态查询接口“核实当前对应扣款标识,PROACTIVE无法发起无感模式支付
Q72:无感标识的车牌,是否会由于长时间没有使用而导致标签变更
A72:无感标识的标签不会因为频次改变
Q73:存量用户的车牌是否有标签
A73:有,存量用户的车牌标签微信侧已统一201912进行处理(处理规则:如用户使用过无感支付,则为无感标签,否则就是免密标签,仅针对存量用户,新用户、存量用户新车牌不计入)
Q74:存量用户添加的新车牌是否默认为无感标签
A74:新车牌默认为免密标签
Q75:存量用户移除无感车牌后重新添加是否仍然为无感标签
A75:移除后重新添加的车牌都为免密标识
Q76:如何判断车牌是否是常用车牌标识
A76:通过“用户状态查询接口”返回的车牌列表信息中的common_use_flag字段,如有则为常用车牌
Q77:常用车牌是否可以被强绑定
A77:常用车牌不能被其他用户强绑
Q80:微信车主停车场景3.0的无感升级推送策略
A80:
- 车牌已经是无感标识的情况下,不会推送
- 使用免密支付且触发了常用车牌策略后,微信侧在支付凭证发送后跟推一条升级邀请的消息,该消息只会推送一次
Q81:调用“授权开通接口”跳转开通车主服务时显示车主服务首页,无法开通
A81:由于车主服务策略调整,需要增加车牌参数进行授权开通
Q82:调用“授权开通接口”引导用户授权时返回“当前车牌已经被其他微信号绑定,暂时无法添加”
A82:当前用户绑定的车牌为其他微信号的常用/无感标识车牌,常用/无感车牌无法被强绑定
Q83:商户调用“免密支付升级无感支付接口”返回“商户请求错误,请联系商户处理”
A83:请按下列几点进行排查:
- 请按照文档的参数进行填写
- 加密方式是否为HMAC-SHA256
- 用户标识有误,请确认是否与appid或sub_appid对应
- 当前升级的车牌与用户不匹配,请确认车牌是否对应该用户
Q84:商户调用“免密支付升级无感支付接口返回“商户请求用户和操作用户不一致,请联系商户处理”
A84:请确认传入的用户标识(openid)与当前操作用户是否匹配
Q85:商户调用“免密支付升级无感支付接口返回“车主平台查询不到指定车牌信息”
A85:确认传入的openid是否对应当前绑定车牌的用户
Q86:车主2.0/3.0扣款接口err_code返回:INVALID_REQUEST;err_code_des返回:Plate Number Err
A86:同一车牌号的不同颜色车牌,被同一个用户、或分别被不同用户绑定,因支付分停车可以区分车牌颜色,车主2.0/3.0无法区分车牌颜色,所以车主2.0/3.0接口返回该报错,解决方案:
- 停车场景的商户可以升级接口,接入支付分停车接口
- 同一用户绑定重复车牌号的,移除重复的车牌号
Q87:车主服务申请扣款接口报错:参数/字段设置失败,请修改或稍后再试。
A87:请求参数内容涉及敏感词,请调整后再试