查询停车场信息

更新时间:2026.06.29
||

对商户提供查询停车场信息接口,返回停车场基础信息、启用状态及未启用/下线原因。适用对象与普通服务商一致,支持普通商户、普通服务商、平台商户(电商模式),与既有停车提醒 API 相同。

接口说明

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

请求方式:【GET】/v3/parking/reminders/parking-lot

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

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

请求参数

Header  HTTP头参数

 Authorization  必填 string

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


 Accept  必填 string

请设置为application/json


query  查询参数

 out_parking_lot_id  选填   string(64)

【商户停车场ID】 商户侧自定义的停车场唯一标识,在「提交停车场进件申请」时传入。仅支持字母、数字、下划线、连字符,长度1~64字符,同一商户号下不可重复。与微信停车场ID二选一,至少传一个;若与微信停车场ID同时传入,以微信停车场ID为准。


 wx_parking_lot_id  选填   string(64)

【微信停车场ID】 停车场进件审核通过且运营入驻完成后,由微信支付分配。可通过「查询停车场进件申请单」或「查询停车场信息」接口获取;入场/离场/支付等接口须与入场时保持一致。与商户停车场ID二选一,至少传一个;若与商户停车场ID同时传入,优先使用本字段。

请求示例

curl
Java
Go

GET

1curl -X GET \
2  https://api.mch.weixin.qq.com/v3/parking/reminders/parking-lot?out_parking_lot_id=lot_sz_tencent_001&wx_parking_lot_id=21232735744117624001123604298240 \
3  -H "Authorization: WECHATPAY2-SHA256-RSA2048 mchid=\"1900000001\",..." \
4  -H "Accept: application/json" 
5

应答参数

200 OK

 code  选填   string(32)

【响应码】 仅接口调用失败时返回;调用成功时不返回此字段。失败时返回错误码字符串,具体见接口错误码列表。


 message  选填   string(256)

【返回信息】 仅接口调用失败时返回;调用成功时不返回此字段。失败时返回错误原因描述。


 wx_parking_lot_id  选填   string(64)

【微信停车场ID】 停车场进件审核通过且运营入驻完成后,由微信支付分配。可通过「查询停车场进件申请单」或「查询停车场信息」接口获取;入场/离场/支付等接口须与入场时保持一致。查询成功时返回。


 out_parking_lot_id  选填   string(64)

【商户停车场ID】 商户侧自定义的停车场唯一标识,在「提交停车场进件申请」时传入。仅支持字母、数字、下划线、连字符,长度1~64字符,同一商户号下不可重复。查询成功时返回。


 parking_lot_name  选填   string(128)

【停车场名称】 查询成功时返回。


 parking_lot_address  选填   string(256)

【停车场地址】 查询成功时返回停车场详细地址。


 payment_mini_prog_appid  选填   string(32)

【支付小程序appid】 查询成功且进件时配置了支付小程序时返回。


 payment_mini_prog_path  选填   string(256)

【支付小程序path】 查询成功且进件时配置了支付路径时返回。


 parking_order_mini_prog_appid  选填   string(32)

【停车订单小程序appid】 查询成功且进件时配置了停车订单小程序时返回。


 parking_order_mini_prog_path  选填   string(256)

【停车订单小程序path】 查询成功且进件时配置了停车订单路径时返回。


 enabled_state  选填   string

【启用状态】 停车场启用状态,各枚举值含义见字段枚举说明。

可选取值

  • ENABLED_STATE_UNKNOWN:  未知状态

  • ENABLED_STATE_NOT_ENABLED:  未开启状态

  • ENABLED_STATE_ENABLED:  已开启状态

  • ENABLED_STATE_OFFLINE:  已下线状态


 reason  选填   string(256)

【原因】 enabled_state 为 NOT_ENABLED 或 OFFLINE 时返回原因文案;已开启时为空。长度1~256字符。

应答示例

200 OK

1{
2  "code" : "PARAM_ERROR",
3  "message" : "参数错误",
4  "wx_parking_lot_id" : "21232735744117624001123604298240",
5  "out_parking_lot_id" : "lot_sz_tencent_001",
6  "parking_lot_name" : "腾讯大厦停车场",
7  "parking_lot_address" : "广东省深圳市南山区科技中一道10000号",
8  "payment_mini_prog_appid" : "wx1234567890abcdef",
9  "payment_mini_prog_path" : "/pages/pay/index",
10  "parking_order_mini_prog_appid" : "wx1234567890abcdef",
11  "parking_order_mini_prog_path" : "/pages/order/index",
12  "enabled_state" : "ENABLED_STATE_UNKNOWN",
13  "reason" : "进场时延过高"
14}
15

 

错误码

以下是本接口返回的错误码列表。详细错误码规则,请参考微信支付接口规则-错误码和错误提示

状态码

错误码

描述

解决方案

400

PARAM_ERROR

参数错误

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

400

INVALID_REQUEST

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

请参阅 接口规则

401

SIGN_ERROR

验证不通过

请参阅 签名常见问题

500

SYSTEM_ERROR

系统异常,请稍后重试

请稍后重试

 

反馈
目录
置顶