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