最新更新時(shí)間:2021.04.08 版本說(shuō)明
車輛入場(chǎng)以后,商戶調(diào)用該接口,創(chuàng)建停車入場(chǎng)信息。
適用對(duì)象:直連商戶
請(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)度限制] | 必填 | 描述 |
---|---|---|---|---|
商戶入場(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 |
{
"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 | PARAM_ERROR | 參數(shù)錯(cuò)誤 | 參數(shù)錯(cuò)誤,請(qǐng)依照文檔檢查各參數(shù)是否合法 |
400 | INVALID_REQUEST | 商戶入場(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è)商戶下唯一 |
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ù)稍后重試 |