查询车牌服务开通信息

更新时间：2024.10.22

该接口仅支持停车场景，商户首先请求查询车牌服务开通信息接口，确认该车牌，是否被该用户开通车主服务，以及车牌具体服务开通状态，包括正常服务，和暂停服务，以及未开通三个状态。

接口说明

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

请求方式：【GET】/v3/vehicle/parking/services/find

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

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

请求参数

Header HTTP头参数

Authorization 　必填　string

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

Accept 　必填　string

请设置为application/json

query 查询参数

appid 　必填 string(32)

【公众账号id】appid是商户在微信申请公众号或移动应用成功后分配的帐号ID，登录平台为mp.weixin.qq.com或open.weixin.qq.com

sub_mchid 　必填 string(32)

【子商户号】微信支付分配的子商户号，服务商模式下必传

plate_number 　必填 string(32)

【车牌号】车牌号，仅包括省份+车牌，不包括特殊字符。

openid 　必填 string(32)

【用户标识】用户在商户对应appid下的唯一标识

plate_color 　必填 string

【车牌颜色】车牌颜色

可选取值：

BLUE: 蓝色

GREEN: 绿色

YELLOW: 黄色

BLACK: 黑色

WHITE: 白色

LIMEGREEN: 黄绿色

请求示例

1curl -X GET \
2  https://api.mch.weixin.qq.com/v3/vehicle/parking/services/find?appid=wxcbda96de0b165486&sub_mchid=1900000109&plate_number=粤B888888&openid=oUpF8uMuAJOM2pxb1Q&plate_color=BLUE \
3  -H "Authorization: WECHATPAY2-SHA256-RSA2048 mchid=\"1900000001\",..." \
4  -H "Accept: application/json" 
5

应答参数

200 OK

plate_number 　必填 string(32)

【车牌号】车牌号，仅包括省份+车牌，不包括特殊字符。

plate_color 　必填 string

【车牌颜色】车牌颜色

可选取值：

BLUE: 蓝色

GREEN: 绿色

YELLOW: 黄色

BLACK: 黑色

WHITE: 白色

LIMEGREEN: 黄绿色

service_open_time 　选填 string(32)

【车牌服务开通时间】车牌服务开通时间，遵循rfc3339标准格式，格式为yyyy-MM-DDTHH:mm:ss+TIMEZONE，yyyy-MM-DD表示年月日，T出现在字符串中，表示time元素的开头，HH:mm:ss表示时分秒，TIMEZONE表示时区（+08:00表示东八区时间，领先UTC 8小时，即北京时间）。例如：2015-05-20T13:29:35+08:00表示，北京时间2015年5月20日 13点29分35秒。

openid 　必填 string(32)

【用户标识】用户在商户对应appid下的唯一标识，此处返回商户请求中的openid

service_state 　必填 string(32)

【车牌服务开通状态】车牌服务开通状态，
NORMAL 正常服务
PAUSE 暂停服务
OUT_SERVICE 未开通
商户根据状态带用户跳转至对应的微信支付分停车服务小程序页面。其中NORMAL 和 PAUSE状态，可跳转至车牌管理页，进行车牌服务状态管理。OUT_SERVICE状态，可跳转至服务开通页面。

应答示例

200 OK

1{
2  "plate_number" : "粤B888888",
3  "plate_color" : "BLUE",
4  "service_open_time" : "2017-08-26T10:43:39+08:00",
5  "openid" : "oUpF8uMuAJOM2pxb1Q",
6  "service_state" : "PAUSE"
7}
8

错误码

公共错误码

状态码	错误码	描述	解决方案
400	PARAM_ERROR	参数错误	请根据错误提示正确传入参数
400	INVALID_REQUEST	HTTP 请求不符合微信支付 APIv3 接口规则	请参阅接口规则
401	SIGN_ERROR	验证不通过	请参阅签名常见问题
500	SYSTEM_ERROR	系统异常，请稍后重试	请稍后重试

业务错误码

状态码	错误码	描述	解决方案
400	INVALID_REQUEST	子商户号不存在，请检查后再试	商户所传子商户号不存在，请使用正确的子商户号进行接口请求
400	INVALID_REQUEST	用户信息有误，请检查OpenID	使用正确的微信OpenID重试
403	NO_AUTH	商户未入驻	当前扣款商户无权限扣款，请确认当前扣款商户已开通微信支付分停车产品权限。修复商户权限后可原参数重试
429	RATELIMIT_EXCEEDED	达到调用速率限制	接口调用频率过快，请降低请求频率
500	SYSTEM_ERROR	出现内部服务器错误	5开头的错误码均为系统错误，请使用相同的参数稍后重试

文档是否有帮助

更多支持

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