通过用户标识、用户子标识、签约计划号、车牌号查询ETC绑定信息

更新时间:2024.11.18

通过用户标识、用户子标识、签约计划号、车牌号查询ETC绑定信息

接口说明

支持商户:【普通服务商】

请求方式:【GET】/v3/vehicle/etc/users/{openid}/contracts

请求域名:【主域名】https://api.mch.weixin.qq.com 使用该域名将访问就近的接入点

     【备域名】https://api2.mch.weixin.qq.com 使用该域名将访问异地的接入点 ,指引点击查看

请求参数

Header HTTP头参数

Authorization  必填 string

请参考签名认证生成认证信息


Accept  必填 string

请设置为application/json


path 路径参数

openid  必填 string(32)

【用户标识】 此参数为微信用户在商户对应AppID或sub_appid下的唯一标识


query 查询参数

sub_mchid  选填 string(32)

【特约商户号】 特约商户的商户号,由微信支付生成并下发。


plan_id  必填 string(32)

【签约计划号】 ETC授权扣费模板ID,商户申请后由微信侧提供


plate_number  必填 string(32)

【车牌号】 车牌号

请求示例

GET

1curl -X GET \
2  https://api.mch.weixin.qq.com/v3/vehicle/etc/users/onqOjjmM1tad-3ROpncN-yUfa6ua/contracts?sub_mchid=1900000109&plan_id=123&plate_number=浙ASB945 \
3  -H "Authorization: WECHATPAY2-SHA256-RSA2048 mchid=\"1900000001\",..." \
4  -H "Accept: application/json" 
5

应答参数

200 OK

appid  必填 string(32)

【发起签约的appid】 发起签约绑定的appid


sp_mchid  必填 string(32)

【服务商商户号】 服务商商户号,由微信支付生成并下发。


sp_openid  必填 string(32)

【用户在发起签约app的标识】 用户在发起签约app下用户唯一标识


sub_appid  选填 string(32)

【子商户AppID】 微信支付分配的公众账号ID


sub_mchid  选填 string(32)

【特约商户号】 特约商户号,由微信支付生成并下发。


contract_id  必填 string(32)

【商户etc绑定号】 商户etc绑定号


bind_state  必填 string(32)

【etc绑定状态】 etc绑定状态,枚举值:

OPENED : 已开通

PAUSE :已暂停

DELETED: 已关闭


plate_number  必填 string(32)

【绑定的车牌号】 绑定的车牌号


sub_openid  选填 string(32)

【用户在发起签约子app的标识】 用户在发起签约子app下用户唯一标识

应答示例

200 OK

1{
2  "appid" : "wxcbda96de0b165486",
3  "sp_mchid" : "10000098",
4  "sp_openid" : "onqOjjmM1tad-3ROpncN-yUfa6ua",
5  "sub_appid" : "wxcbda96de0b165489",
6  "sub_mchid" : "1900000109",
7  "contract_id" : "aAfixCs13LsdKPpfZfDkk2189ssXjfx",
8  "bind_state" : "DELETED",
9  "plate_number" : "浙ASB945",
10  "sub_openid" : "onqOjjmM1tbd-3Rxise1-yUfa6ua"
11}
12

 

错误码

公共错误码

状态码

错误码

描述

解决方案

400

PARAM_ERROR

参数错误

请根据错误提示正确传入参数

400

INVALID_REQUEST

HTTP 请求不符合微信支付 APIv3 接口规则

请参阅 接口规则

401

SIGN_ERROR

验证不通过

请参阅 签名常见问题

500

SYSTEM_ERROR

系统异常,请稍后重试

请稍后重试

业务错误码

状态码

错误码

描述

解决方案

500

SYSTEM_ERROR

系统错误

请稍后原付款单号重试

404

RESOURCE_NOT_EXISTS

签约模板不存在或已停用

请修改后再试

400

CONTRACT_NOT_EXIST

ETC绑定信息不存在

请引导用户进行绑定

400

RESOURCE_ALREADY_EXISTS

用户已绑定该ETC设备,不可重复绑定

-

 

 

反馈
咨询
目录
置顶