免密支付升级无感支付

更新时间：2024.11.14

应用场景

当用户不是无感扣费方式且该车牌是该用户的常用车牌时，商户可引导用户进行免密支付升级到无感支付，从而提高用户的出场体验。

仅支持停车场景

流程介绍

调用用户状态查询api获取用户的车辆状态，如果返回的plate_number_info指定车牌的common_use_flag字段为COMMON_USE，则可引导用户升级该车牌的扣费方式到无感支付
--小程序,APP跳转，通过跳转路径(pages/no-sense-payment/index)调用 ‘免密支付升级无感支付sapi’ 进入车主小程序的对应页面，用户进行升级车牌无感支付操作
返回商户小程序，APP后再次调用用户状态查询api确认用户最新车主状态及车牌信息

1.小程序调用请求说明

接口	wx.navigateToMiniProgram(OBJECT)接口
说明	iOS 微信客户端 6.5.9 版本开始支持，Android 客户端即将在 6.5.10 版本开始支持

OBJECT参数说明：

字段名	变量名	必填	类型	示例值	描述
微信车主小程序appid	appId	是	String	wxbcad394b3d99dac9	固定值 wxbcad394b3d99dac9
场景信息传递给小程序的数据	extraData	是	object	{ "appid": "wx426a3015555a46be", "mch_id": "10000098", s "nonce_str": "FF1A406564EE70106445", "sign_type": "HMAC-SHA256", "sign":"EE088059BBC9141264F8D14293AD6C4BB94CEA8C08AA98FBF93E262D445F8FF5", "plate_number": "藏ZZZZZZ", "openid": "oUpF8uMEb4qRXf22hE3X68TekukE" }	签约的请求参数，详情见extraData字段详细说明

extraData参数说明：

字段名	变量名	必填	类型	示例值	描述
公众账号id	appid	是	String（32）	wxcbda96de0b165486	微信支付分配的公众账号id
商户号	mch_id	是	String（32）	1900009231	微信支付分配的商户号
车牌号	plate_number	是	String（32）	粤B888888	车牌号。仅包括省份+车牌，不包括特殊字符。
随机字符串	nonce_str	是	String（32）	5K8264ILTKCH16CQ2502SI8ZNMTM67VS	随机字符串，不长于32位。
用户标识	openid	是	String（32）	oUpF8uMEb4qRXf22hE3X68TekukE	此参数必传，用户在商户appid下的唯一标识。
签名类型	sign_type	是	String（32）	HMAC-SHA256	签名类型，仅支持HMAC-SHA256
签名	sign	是	String（64）	EE088059BBC9141264F8D14293AD6C4BB94CEA8C08AA98FBF93E262D445F8FF5	签名，详见签名生成算法

示例：

1wx.navigateToMiniProgram({
2    appId: 'wxbcad394b3d99dac9',
3    path: 'pages/no-sense-payment/index',
4    extraData: {
5        appid: 'wx426a3015555a46be',
6        mch_id: '10000098',
7        openid: 'oUpF8uMEb4qRXf22hE3X68TekukE'
8        plate_number: '藏ZZZZZZ',
9        nonce_str: 'FF1A406564EE70106445',
10        sign_type: 'HMAC-SHA256',
11        sign:'EE088059BBC9141264F8D14293AD6C4BB94CEA8C08AA98FBF93E262D445F8FF5',
12    },
13      success(res) {
14      },
15      fail(res) {
16      // 未成功跳转到车主小程序
17      }
18})

用户升级完成之后，会跳转回商户小程序。暂时不返回参数，商户小程序可再次调用用户状态查询接口获取用户的最新车主状态。

2.APP调用请求说明

参数说明：

字段含义	变量名	必填	类型	示例值	描述
公众账号id	appid	是	String（32）	wxcbda96de0b165486	微信支付分配的公众账号id
车牌号	plate_number	是	String（32）	粤B888888	车牌号。仅包括省份+车牌，不包括特殊字符。
商户号	mch_id	是	String（32）	1900009231	微信支付分配的商户号
随机字符串	nonce_str	是	String（32）	5K8264ILTKCH16CQ2502SI8ZNMTM67VS	随机字符串，不长于32位。
用户标识	openid	是	String（32）	oUpF8uMEb4qRXf22hE3X68TekukE	此参数必传，用户在商户appid下的唯一标识。
签名类型	sign_type	是	String（32）	HMAC-SHA256	签名类型，仅支持HMAC-SHA256
签名	sign	是	String（64）	EE088059BBC9141264F8D14293AD6C4BB94CEA8C08AA98FBF93E262D445F8FF5	签名，详见签名生成算法

示例：Android示例如下：（APP调起小程序详细说明）

1String appId = "wxcdbdf056ad5fc1fb"; // 填应用AppId
2IWXAPI api = WXAPIFactory.createWXAPI(context, appId);
3WXLaunchMiniProgram.Req req = new WXLaunchMiniProgram.Req();
4req.userName = "gh_518c42c65952"; // 填车主小程序原始id，取固定值gh_518c42c65952
5req.path = "/pages/no-sense-payment/index?extraData={\"appid\":\"wxcbda96de0b165486\",\"mch_id\":\"10000098\",\"nonce_str\":\"5K8264ILTKCH16CQ2502SI8ZNMTM67VS\",\"sign_type\":\"HMAC-SHA256\",\"openid\":\"oUpF8uMEb4qRXf22hE3X68TekukE\",\"plate_number\":\"藏ZZZZZZ\",\"sign\":\"C99D665499D169E97D6278868C06FB91E5DD87BCDA758FA4869669F12C27FEFC\"}";//拉起小程序页面的可带参路径，不填默认拉起小程序首页
6req.miniprogramType = WXLaunchMiniProgram.Req.MINIPTOGRAM_TYPE_RELEASE;
7api.sendReq(req);

用户升级完成之后，会跳转回商户小程序。暂时不返回参数，商户侧APP接收到客户端回调后再次调用用户状态查询接口获取用户的最新车主状态。

3.H5跳转调用请求说明 (注意：参数之后需要拼接#wechat_redirect)

接口	https://payapp.weixin.qq.com/vehicle/plat/indextemplate
请求方式	GET

参数说明：

字段含义	变量名	必填	类型	示例值	描述
商户号	mch_id	是	String（32）	100000980	微信支付分配的商户号
公众账号 id	appid	是	String（32）	wxcbda96de0b165486	微信支付分配的公众账号 id
页面跳转标识	subcribeapp	是	String（32）	upgradedeductmode	固定值： upgradedeductmode （注：该参数不参与签名）
用户标识	openid	是	String（32）	oUpF8uMuAJO_M2pxb1Q9zNjWeS6o	用户在商户 appid或子商户sub_appid 下的唯一标识
车牌号	plate_number	是	String （32）	粤B888888	车牌号。仅包括省份+车牌，不包括特殊字符。
随机字符串	nonce_str	是	String（32）	5K8264ILTKCH16CQ2502SI8ZNMTM67VS	随机字符串，不长于32位。
签名类型	sign_type	是	String（32）	HMAC-SHA256	签名类型，仅支持HMAC-SHA256
签名	sign	是	String（64）	EE088059BBC9141264F8D14293AD6C4BB94CEA8C08AA98FBF93E262D445F8FF5	签名，详见签名生成算法

跳转 url 示例：(注意：生成跳转链接的时候，对所有参数 urlconde 再生成跳转链接)

1https://payapp.weixin.qq.com/vehicle/plat/indextemplate?subcribeapp=upgradedeductmode&nonce_str=5K8264ILTKCH16CQ2502SI8ZNMTM67VS&openid=oUpF8uMuAJO_M2pxb1Q9zNjWeS6o&appid=wxc bda96de0b165486&sign=EE088059BBC9141264F8D14293AD6C4BB94CEA8C08AA98FBF93E262D445F8FF5&plate_number=%E7%B2%A4B888888&mch_id=100000980&sign_type=HMAC-SHA256#wechat_redirect

用户升级完成之后，会跳转回点击跳转前的页面。暂时不返回参数，商户侧需要自行调用用户状态查询接口获取用户的最新车主状态。

文档是否有帮助

更多支持

开发文档(服务商)开发文档(V2版)开发者社区微信开放平台微信公众平台腾讯客服