適用對象：服務商
請求URL：https://api.mch.weixin.qq.com/v3/vehicle/parking/parkings
請求方式：POST
path 指該參數(shù)為路徑參數(shù)
query 指該參數(shù)為URL參數(shù)
body 指該參數(shù)需在請求JSON傳參
| 參數(shù)名 | 變量 | 類型[長度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 子商戶號 | sub_mchid | string[1, 32] | 是 | body微信支付分配的子商戶號 示例值：1900000109 |
| 商戶入場id | out_parking_no | string[1, 64] | 是 | body商戶側入場標識id，在同一個商戶號下唯一 示例值：1231243 |
| 車牌號 | plate_number | string[1, 32] | 是 | body車牌號，僅包括省份+車牌，不包括特殊字符。 示例值：粵B888888 |
| 車牌顏色 | plate_color | string[1, 32] | 是 | body車牌顏色，枚舉值 BLUE：藍色 GREEN：綠色 YELLOW：黃色 BLACK：黑色 WHITE：白色 LIMEGREEN：黃綠色 示例值：BLUE |
| 回調通知url | notify_url | string[1, 256] | 是 | body接受入場狀態(tài)變更回調通知的url，注意回調url只接受https 示例值：https://yoursite.com/wxpay.html |
| 入場時間 | start_time | string[1, 32] | 是 | body入場時間，遵循rfc3339標準格式，格式為yyyy-MM-DDTHH:mm:ss+TIMEZONE，yyyy-MM-DD表示年月日，T出現(xiàn)在字符串中，表示time元素的開頭，HH:mm:ss表示時分秒，TIMEZONE表示時區(qū)（+08:00表示東八區(qū)時間，領先UTC 8小時，即北京時間）。例如：2015-05-20T13:29:35+08:00表示，北京時間2015年5月20日 13點29分35秒。 示例值：2017-08-26T10:43:39+08:00 |
| 停車場名稱 | parking_name | string[1, 32] | 是 | body所在停車位車場的名稱 示例值：歡樂海岸停車場 |
| 免費時長 | free_duration | int | 是 | body停車場的免費停車時長，單位為秒 示例值：3600 |
{
"sub_mchid": "1900000109",
"out_parking_no": "1231243",
"plate_number": "粵B888888",
"plate_color": "BLUE",
"notify_url": "https://yoursite.com/wxpay.html",
"start_time": "2017-08-26T10:43:39+08:00",
"parking_name": "歡樂海岸停車場",
"free_duration": 3600
}
| 參數(shù)名 | 變量 | 類型[長度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 停車入場id | id | string[1, 32] | 是 | 車主服務為商戶分配的入場id 示例值：5K8264ILTKCH16CQ250 |
| 商戶入場id | out_parking_no | string[1, 64] | 是 | 商戶側入場標識id，在同一個商戶號下唯一 示例值：212434321 |
| 車牌號 | plate_number | string[1, 32] | 是 | 車牌號，僅包括省份+車牌，不包括特殊字符。 示例值：粵B888888 |
| 車牌顏色 | plate_color | string[1, 32] | 是 | 車牌顏色，枚舉值： BLUE：藍色 GREEN：綠色 YELLOW：黃色 BLACK：黑色 WHITE：白色 LIMEGREEN：黃綠色 示例值：BLUE |
| 入場時間 | start_time | string[1, 32] | 是 | 入場時間，遵循rfc3339標準格式，格式為yyyy-MM-DDTHH:mm:ss+TIMEZONE，yyyy-MM-DD表示年月日，T出現(xiàn)在字符串中，表示time元素的開頭，HH:mm:ss表示時分秒，TIMEZONE表示時區(qū)（+08:00表示東八區(qū)時間，領先UTC 8小時，即北京時間）。例如：2015-05-20T13:29:35+08:00表示，北京時間2015年5月20日 13點29分35秒。 示例值：2017-08-26T10:43:39+08:00 |
| 停車場名稱 | parking_name | string[1, 32] | 是 | 所在停車位車場的名稱 示例值：歡樂海岸停車場 |
| 免費時長 | free_duration | int | 是 | 停車場的免費停車時長，單位為秒 示例值：3600 |
| 停車入場狀態(tài) | state | string[1, 32] | 是 | 本次入場車牌的服務狀態(tài)， NORMAL：正常狀態(tài)，可以使用微信支付分停車服務， BLOCKED：不可用狀態(tài)，暫時不可以使用微信支付分停車服務 示例值：NORMAL |
| 不可用狀態(tài)描述 | block_reason | string[1, 32] | 否 | block服務狀態(tài)描述，返回車牌狀態(tài)為BLOCKED，會返回該字段，描述具體BLOCKED的原因， PAUSE：已暫停微信支付分停車服務； OVERDUE：已授權簽約但欠費，不能提供服務, OUT_SERVICE：車牌未開通微信支付分停車服務， EVALUATION_FAILED：綜合評估未通過，用戶支付分不可用的情況，會返回該狀態(tài)。 示例值：PAUSE |
{
"id": "5K8264ILTKCH16CQ250",
"out_parking_no": "212434321",
"plate_number": "粵B888888",
"plate_color": "BLUE",
"start_time": "2017-08-26T10:43:39+08:00",
"parking_name": "歡樂海岸停車場",
"free_duration": 3600,
"state": "NORMAL",
"block_reason": "PAUSE"
}
| 狀態(tài)碼 | 錯誤碼 | 描述 | 解決方案 |
|---|---|---|---|
| 429 | RATELIMIT_EXCEEDED | 達到調用速率限制 | 接口調用頻率過快，請降低請求頻率 |
| 400 | PARAM_ERROR | 參數(shù)錯誤 | 參數(shù)錯誤，請依照文檔檢查各參數(shù)是否合法 |
| 400 | INVALID_REQUEST | 商戶入場id非法，請檢查商戶入場id | 商戶多次請求，傳參的同一個商戶入場id，對應了不同的停車入場信息，請保持商戶入場id在同一個商戶下唯一 |
| 403 | NO_AUTH | 商戶未入駐 | 當前扣款商戶無權限扣款，請確認當前扣款商戶已開通微信支付分停車產品權限。修復商戶權限后可原參數(shù)重試 |
| 500 | SYSTEM_ERROR | 出現(xiàn)內部服務器錯誤 | 5開頭的錯誤碼均為系統(tǒng)錯誤，請使用相同的參數(shù)稍后重試 |