查询停车费用

更新时间:2026.06.29
||| 安装 Skill

对商户提供查询停车费用接口

接口说明

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

请求方式:【POST】/v3/parking/reminders/parking-fee

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

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

请求参数

Header  HTTP头参数

 Authorization  必填 string

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


 Accept  必填 string

请设置为application/json


 Content-Type  必填 string

请设置为application/json


body  包体参数

 out_serial_number  必填   string(64)

【商户停车单号】 商户系统自行生成,须在同一商户号下全局唯一。建议不超过32字符,超过64字符将被拦截。


 plate_number  选填   string(16)

【车牌号】 国内车牌,省份简称+6~7位字母或数字(新能源绿牌8位)。


 out_parking_id  选填   string(64)

【商户停车场ID】 与进件接口中的 out_parking_lot_id 同义,为本接口历史字段命名。商户侧自定义的停车场唯一标识,在「提交停车场进件申请」时传入。仅支持字母、数字、下划线、连字符,长度1~64字符,同一商户号下不可重复。

请求示例

curl
Java
Go

POST

1curl -X POST \
2  https://api.mch.weixin.qq.com/v3/parking/reminders/parking-fee \
3  -H "Authorization: WECHATPAY2-SHA256-RSA2048 mchid=\"1900000001\",..." \
4  -H "Accept: application/json" \
5  -H "Content-Type: application/json" \
6  -d '{
7    "out_serial_number" : "PARK20260423001",
8    "plate_number" : "粤B12345",
9    "out_parking_id" : "lot_sz_tencent_001"
10  }'
11

应答参数

200 OK

 code  选填   string(32)

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


 message  选填   string(256)

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


 total_amount  选填   integer

【当前总费用】 查询成功且存在停车单时返回,单位为分。


 parking_timestamp  选填   integer

【已停时长】 查询成功且存在停车单时返回,单位为秒。


 parking_state  选填   string

【停车状态】 查询成功且存在停车单时返回。

可选取值

  • PARKING_STATE_UNKNOWN:  未知

  • PARKING_STATE_ENTERED:  已入场

  • PARKING_STATE_EXIT_GATE:  到闸口

  • PARKING_STATE_EXITED:  已离场

  • PARKING_STATE_UNEXPECTED_CLOSE:  异常关单


 pay_state  选填   string

【支付状态】 查询成功且停车单已有支付记录时返回。

可选取值

  • PAY_STATUS_UNKNOWN:  未知

  • PAY_STATUS_UNPAID:  未支付

  • PAY_STATUS_PAID:  已支付


 allowed_exit_timestamp  选填   integer

【免费待出场时间】 查询成功且车场配置了免费出场时段时返回,单位为秒。


 next_raise_price  选填   integer

【下一次跳价价格】 查询成功且车场开启跳价提醒且未触达封顶时返回,单位为分。


 next_raise_timestamp  选填   integer

【下一次跳价时间】 查询成功且车场开启跳价提醒且未触达封顶时返回,秒级时间戳。


 payable_amount  选填   integer

【应付金额】 查询成功且存在应付费用时返回,单位为分。


 paid_amount  选填   integer

【已付金额】 查询成功且存在已支付记录时返回,单位为分。

应答示例

200 OK

1{
2  "code" : "PARAM_ERROR",
3  "message" : "参数错误",
4  "total_amount" : 1,
5  "parking_timestamp" : 1,
6  "parking_state" : "PARKING_STATE_UNKNOWN",
7  "pay_state" : "PAY_STATUS_UNKNOWN",
8  "allowed_exit_timestamp" : 1,
9  "next_raise_price" : 1,
10  "next_raise_timestamp" : 1,
11  "payable_amount" : 1,
12  "paid_amount" : 1
13}
14

 

错误码

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

状态码

错误码

描述

解决方案

400

PARAM_ERROR

参数错误

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

400

INVALID_REQUEST

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

请参阅 接口规则

401

SIGN_ERROR

验证不通过

请参阅 签名常见问题

500

SYSTEM_ERROR

系统异常,请稍后重试

请稍后重试

 

反馈
目录
置顶