同步支付结果通知

更新时间:2026.06.29
||

对商户提供同步支付结果通知接口

接口说明

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

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

请求域名:【主域名】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字符将被拦截。与入场时同步的 out_serial_number 保持一致。


 plate_number  必填   string(16)

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


 parking_id  必填   string(64)

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


 parking_state  必填   string

【停车状态】 按照本文档提供的停车状态枚举值传入,各枚举值含义见字段枚举说明。

可选取值

  • PARKING_STATUS_UNKNOWN:  未知

  • PARKING_STATUS_PARKING:  停车中

  • PARKING_STATUS_NOT_PARKING:  非停车中


 pay_type  必填   string

【支付类型】 按照本文档提供的支付类型枚举值传入,各枚举值含义见字段枚举说明。仅支持微信支付(PAY_TYPE_WXPAY),非微信支付将拒绝同步。

可选取值

  • PAY_TYPE_UNKNOWN:  未知

  • PAY_TYPE_WXPAY:  微信支付

  • PAY_TYPE_OTHERS:  其他支付


 openid  选填   string(128)

【付款用户OpenID】 支付渠道为微信支付时必填。获取方式详见参数说明


 sub_mchid  选填   string(32)

【特约商户号】 微信支付分配的特约商户号。支付渠道为微信支付且存在特约商户时必填。


 total_amount  必填   integer

【总费用】 单位为分,必填


 paid_amount  必填   integer

【已支付费用】 单位为分,必填;当支付渠道为微信支付时,不允许为零


 out_trade_no  选填   string(64)

【商户支付订单号】 商户侧支付订单号;与 wx_trade_no 至少二选一必传,建议全填。长度1~64字符,同一商户号下建议唯一。


 pay_channel  选填   string

【支付渠道】 已支付状态下建议填写,用于标识支付来源。

可选取值

  • PAY_CHANNEL_UNKNOWN:  未知

  • PAY_CHANNEL_WECHAT_PAY_NOTIF:  微信支付通知消息

  • PAY_CHANNEL_SCAN_QRCODE:  扫码

  • PAY_CHANNEL_OFFICIAL_ACCOUNT:  公众号

  • PAY_CHANNEL_MCH_MINI_PROG:  商户小程序

  • PAY_CHANNEL_OTHERS:  其他


 pay_time  选填   integer

【支付时间】 支付完成时刻,秒级时间戳(Unix timestamp)。例如:1719128975 表示北京时间2024-06-23 13:29:35。


 token  选填   string(256)

【消息支付防伪凭证】 原样回传微信支付随缴费入口下发的凭证;用于服务端验真消息支付,缺省即未回传


 wx_trade_no  选填   string(64)

【微信支付订单号】 微信支付订单号;与 out_trade_no 至少二选一必传,建议全填。长度1~64字符。

请求示例

curl
Java
Go

POST

1curl -X POST \
2  https://api.mch.weixin.qq.com/v3/parking/reminders/payment \
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    "parking_id" : "21232735744117624001123604298240",
10    "parking_state" : "PARKING_STATUS_UNKNOWN",
11    "pay_type" : "PAY_TYPE_UNKNOWN",
12    "openid" : "oUpF8uMuAJO_M2pxb1Q9zNjWeS6o",
13    "sub_mchid" : "1900000109",
14    "total_amount" : 1,
15    "paid_amount" : 1,
16    "out_trade_no" : "4200001234567890123456789012",
17    "pay_channel" : "PAY_CHANNEL_UNKNOWN",
18    "pay_time" : 1719128975,
19    "token" : "msg_pay_token_example",
20    "wx_trade_no" : "4200001234567890123456789012"
21  }'
22

应答参数

200 OK

 code  选填   string(32)

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


 message  选填   string(256)

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

应答示例

200 OK

1{
2  "code" : "PARAM_ERROR",
3  "message" : "参数错误"
4}
5

 

错误码

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

状态码

错误码

描述

解决方案

400

PARAM_ERROR

参数错误

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

400

INVALID_REQUEST

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

请参阅 接口规则

401

SIGN_ERROR

验证不通过

请参阅 签名常见问题

500

SYSTEM_ERROR

系统异常,请稍后重试

请稍后重试

 

反馈
目录
置顶