文檔時間技術(shù)支持編寫人D.T2018‐05‐232018‐05‐23新增全 對對接停車場系1.目準(zhǔn)技術(shù)對接方已有一組可用的http服一SDK二socket直連 術(shù)語說上行與下對接需求概移動支商 月卡/次卡/儲值移動支付接口詳獲取停車訂訂單支付結(jié)果停車場實時數(shù)據(jù)(停車位等)拉最近出入場車輛車輛自動支付權(quán)限車輛出場鎖定獲取停車記錄4.84.85商券5.2月卡/次卡/簽9.2 AA1A2A31.目本文檔主要介紹了停車場系統(tǒng)如何和PP停車完成對接以實現(xiàn)移動支付流程并介紹了準(zhǔn)針對停車場的網(wǎng)絡(luò)環(huán)境,PP停車提供多種對接方已有一組可用的http服可以使用http的方式進(jìn)行對接.由PP這邊進(jìn)行開發(fā)對接還沒有相關(guān)的http服—道閘可以使用SDK,根據(jù)本文檔進(jìn)行開發(fā)注:目前SDK已經(jīng)支持的語言:C#.后續(xù)會為的語言提供SDK二socket直連對于還未提供SDK的語言,可以采用socket直連的方式,根據(jù)本文檔進(jìn)行開發(fā)三程使用PP的程序(PPProxy-.zip)間接進(jìn)行網(wǎng)絡(luò)通信 根據(jù)本文檔進(jìn)行開發(fā)程序PPProxy的機(jī)制PPProxy安裝在停車系統(tǒng)軟件所在局域網(wǎng)的一臺機(jī)器上.PPProxy會通過TCP與PP停車云平臺PYun保持長連接.停車場系統(tǒng)軟件直接和PPProxy通過局域網(wǎng)進(jìn)行通信.PYun請求時,會先將請求到PPProxy上,然后PPProxy在將請求轉(zhuǎn)發(fā)到停車場上行與上行:指停車場系統(tǒng)主動請求PP停車下行:指PP停車主動請求停車場如果沒有特殊說明,本文的接口都是下行接口對接需求概Y8商戶N2N2主要對接需求有:獲取停車支付訂單,訂單支付結(jié)果通知,同步車輛列表(下行)車輛自動支付權(quán)限(下行)等.進(jìn)一步介紹見下表:YYYY直接放行；超過額度則取消本次預(yù)標(biāo)記；PP停車根據(jù)出場中返回的實際支付額度完成用戶扣款Y用戶可鎖定車輛,鎖定后,Na.停車信息:出入場時間、停車時長、金額、信息、員信息、出入b.信息:本地停車所有成功的記錄，需要區(qū)分支付方式Y(jié) 后,PP停車會調(diào)用該接口完成入場開Y大型商場都具有多種,面對種類繁多的類型,PP停車為商場提供純電子化YYPP停車為停車場提供月卡/次卡/儲值卡續(xù)費的移動支付方案YY移動支付接口詳停車場在開發(fā)過程中應(yīng)保證數(shù)據(jù)的正確有效位,可能發(fā)起多次支付結(jié)果通知！)以免訂單的多次支付.自動支付注意事項PP停車會提供當(dāng)前用戶可用額度如果出場時停車費用大于用戶可用額度應(yīng)拒停車場系統(tǒng)需標(biāo)記該車輛當(dāng)次停車費由PP停車代收方便后續(xù)對賬.自動支付權(quán)限僅當(dāng)次停車有效,若用戶出場后,重新入場無效！開通自動支付權(quán)限時需驗證車輛狀態(tài) 如果車輛已出場應(yīng)返回設(shè)置失敗取消車輛自動支付權(quán)限時需驗證車輛狀態(tài)如果車輛已出場應(yīng)返回設(shè)置失敗.若車輛自動支付權(quán)限已取消,則車輛出場不放行(使用其他支付方式).若重復(fù)受到開通自動支付權(quán)限停車場應(yīng)更新當(dāng)前用戶自動支付信用額度等相關(guān)當(dāng)停車場檢測到當(dāng)前用戶信用額度不足 應(yīng)自動取消自動支付權(quán)限協(xié)議說明當(dāng)用戶在PP停車場時獲取停車訂單時,PP停車將發(fā)送該協(xié)議請求到停車場系統(tǒng),通過請求Y服務(wù)名:Y版本號:Y字符集:YY停車場編號,由PPNNN用戶通行證ID,N通道編號ID,無牌車時可傳遞觸發(fā)開閘 為互斥參數(shù).若傳遞 應(yīng)答Y服務(wù)名:Y版本號:Y字符集:Y狀態(tài)碼1001訂單獲取成功,業(yè)務(wù)參數(shù)將返回1002未查詢到停車信息1003月卡車輛,不允許支付1401簽名錯誤,請檢查配置1500接口處理異常Y狀態(tài)碼處理描述,如:返回錯誤信息YNNY停車流水,標(biāo)識具體某次停車事件,需保證該停車場下唯一Y停車支付訂單號,需保證該停車場下唯一.注:Y入場時間,格式y(tǒng)yyyMMddHHmmssYY總停車費用(單位分),為用戶從入場到現(xiàn)在獲取訂單時的總費用Y已金額(單位分),為停車場在當(dāng)前停車費用時已經(jīng)給予的金額,如Y已支付金額(單位分為當(dāng)次停車用戶已經(jīng)支付的金額比如當(dāng)用戶先支付了一筆后,超時未出場重新查詢訂單時須返回以支付金額.Y應(yīng)支付金額(單位分這里停車場系統(tǒng)需處理如果結(jié)果為負(fù)數(shù)的情況直接返NNngN車輛所在位置信息例如:gY鎖車標(biāo)識:1已鎖,0未鎖,-1N自動支付狀態(tài):1已開啟,0協(xié)議說明當(dāng)用戶完成支付后,PP停車將主動發(fā)起支付結(jié)果通知通知客戶端訂單支付結(jié)果.為保證通知正常處理,服務(wù)端可能發(fā)起多次支付結(jié)果通知,客戶端需做好去重邏輯對于已經(jīng)受到支付結(jié)果通知的訂單,應(yīng)應(yīng)答通知成功,已告知服務(wù)端不必繼續(xù)通知.Y服務(wù)名:Y版本號:Y字符集:YYY停車流水,原客戶端提交Y停車支付訂單號,原客戶端提交N通道編號ID,時可傳遞觸發(fā)開閘YPP停車支付流水,對賬可用Y支付時間,格式:yyyyMMddHHmmssY支付金額(單位分Y0PP48Y支付來源說明,例如:PP應(yīng)答參數(shù)Y服務(wù)名:Y版本號:Y字符集:Y1001接口處理成功1401簽名錯誤,請檢查配置1500接口內(nèi)部處理失敗YY狀態(tài)碼處理描述,如:返回錯誤信息協(xié)議說明PP停車將以固定頻率調(diào)用該接口獲取總停車位和場中車輛等數(shù)據(jù)的獲取請求參數(shù)Y服務(wù)名:Y版本號:Y字符集:YY應(yīng)答參數(shù)Y服務(wù)名:Y版本號:Y字符集:Y本次請求狀態(tài)返回碼示例:1001狀態(tài)碼含義1001獲取成功,業(yè)務(wù)參數(shù)將返回1401簽名錯誤,請檢查配置1500接口處理異常Y當(dāng)前請求應(yīng)答結(jié)果,簽名方法參考附錄Y狀態(tài)碼處理描述,如:返回錯誤信息YY協(xié)議說明PP停車將固定頻率調(diào)用該接口完成數(shù)據(jù)獲取,時段每3分鐘獲取一次,非時30分鐘獲取一次.每次查詢需返回時間范圍內(nèi)的所有出/入場車輛信息注請求參數(shù)Y服務(wù)名:Y版本號:Y字符集:YYY查詢范圍開始時間,格式:yyyyMMddHHmmssY查詢范圍結(jié)束時間,格式:yyyyMMddHHmmss應(yīng)答參數(shù)Y服務(wù)名:Y版本號:Y字符集:Y本次請求狀態(tài)返回碼示例:1001狀態(tài)碼含義1001獲取成功,業(yè)務(wù)參數(shù)將返回1401簽名錯誤,請檢查配置1500接口處理異常Y當(dāng)前請求應(yīng)答結(jié)果,簽名方法參考附錄Y狀態(tài)碼處理描述,如:返回錯誤信息N設(shè)備狀態(tài)集合,對象參考后面的設(shè)備狀態(tài)N入場車輛集合,對象參考后面車輛信息N出場車輛集合,對象參考后面車輛信息車輛信息NN車型NN車型:1小車,2大車,-1NNN支付停車卡物理ID,停車場系統(tǒng)識別的Y停車流水,標(biāo)識具體某次停車事件,需保證該停車場下唯一Y入場時間,格式:yyyyMMddHHmmssYYY.N出場時間,格式:yyyyMMddHHmmssNNN.YYNNNY支付信息N停車支付訂單號,現(xiàn)金支付無需返回Y平臺支付流水,現(xiàn)金支付無需返回Y支付類型Y支付時間,格式:yyyyMMddHHmmssY支付金額(單位分注注:total_value=online_value+cash_value+prepaid_value+設(shè)備狀態(tài)YY1:2:3:4:Y10:-1:協(xié)議說明當(dāng)用戶滿足自動支付條件時 PP停車主停車場系統(tǒng)發(fā)起設(shè)置車輛自動支付權(quán)限注:車牌自動支付出場的,需寫入一條支付記錄,標(biāo)記該筆訂單由PP停車扣 請求參數(shù)Y服務(wù)名:Y版本號:Y字符集:YYY當(dāng)前用戶可用信用額度(分),credits大于零則開啟Y停車流水,標(biāo)識具體某次停車事件,需保證該停車場下唯一N0PP48N支付來源說明,例如:PPY鎖定車輛,后可出場:1鎖定,0不鎖應(yīng)答參數(shù)Y服務(wù)名:Y版本號:Y字符集:本次請求狀態(tài)返回碼示例:1001狀態(tài)碼含義Y1001接口處理成功,業(yè)務(wù)參數(shù)將返回10021401簽名錯誤請檢查配置.1403車輛已出1500接口處理異常Y當(dāng)前請求應(yīng)答結(jié)果,簽名方法參考附錄Y狀態(tài)碼處理描述,如:返回錯誤信息協(xié)議說明該協(xié)議主要用于車牌識別停車場,當(dāng)用戶設(shè)置車輛安全鎖定后,用戶離場前主動觸發(fā)解請求參數(shù)Y服務(wù)名:Y版本號:Y字符集:YYY停車流水,標(biāo)識具體某次停車事件,需保證該停車場下唯一Y鎖車狀態(tài):1鎖定,應(yīng)答參數(shù)Y服務(wù)名:Y版本號:Y字符集:Y本次請求狀態(tài)返回碼示例:1001狀態(tài)碼含義1001接口處理成功,業(yè)務(wù)參數(shù)將返回10021401簽名錯誤,請檢查配置1403車輛已出場1400參數(shù)錯誤,請檢查參數(shù)1500接口處理異常Y當(dāng)前請求應(yīng)答結(jié)果,簽名方法參考附錄Y狀態(tài)碼處理描述,如:返回錯誤信息協(xié)議說明該協(xié)議主要用于處理異常訂單,方便PP停車?yán)∮唵卧斍?已方便對賬以及異常訂單處Y服務(wù)名:Y版本號:Y字符集:YYY應(yīng)答參數(shù)Y服務(wù)名:Y版本號:Y字符集:Y本次請求狀態(tài)返回碼示例:1001狀態(tài)碼含義1001獲取成功,業(yè)務(wù)參數(shù)將返回1002未查詢到停車信息1401簽名錯誤,請檢查配置1500接口處理異常Y當(dāng)前請求應(yīng)答結(jié)果,簽名方法參考附錄Y狀態(tài)碼處理描述,如:返回錯誤信息NNN支付停車卡物理ID,停車場系統(tǒng)識別的N車型NN車型:1小車,2大車,-1Y停車流水,標(biāo)識具體某次停車事件,需保證該停車場下唯一Y入場時間,格式y(tǒng)yyyMMddHHmmssYYY.Y停車時長(單位秒N 金額(單位分)N出場時間,格式:yyyyMMddHHmmssNNN.YY支付信息N停車支付訂單號,現(xiàn)金支付無需返回Y平臺支付流水,現(xiàn)金支付無需返回Y支付類型Y支付時間,格式Y(jié)支付金額(單位分說明為實現(xiàn)無人值守針對無牌車通過掃碼后平臺會調(diào)用該接口完成入場開閘.若短時間重請求參數(shù)Y服務(wù)名:Y版本號:Y字符集:YYY用戶通行證ID,停車場可用作虛擬卡ID,Y通道編號應(yīng)答參數(shù)Y服務(wù)名:Y版本號:Y字符集:Y本次請求狀態(tài)返回碼示例:1001狀態(tài)碼含義1001操作成功1002未檢測到車輛1401簽名錯誤,請檢查配置1403短時間重復(fù)入場1500接口處理異常Y當(dāng)前請求應(yīng)答結(jié)果,簽名方法參考附錄Y狀態(tài)碼處理描述,如:返回錯誤信息Y入場時間,格式Y(jié)Y停車時長,單位Y停車流水商戶券接口詳商戶根據(jù)到停車系統(tǒng)后,若未清除則本次停車均有效?出場時停車場系統(tǒng)應(yīng)自動查詢出金額、已支付金額,來判斷是否需要收取現(xiàn)金.協(xié)議說明無論用戶移動支付或現(xiàn)金支付動抵扣停車費停車場系統(tǒng)均到本次無論用戶移動支付或現(xiàn)金支付動抵扣停車費停車場系統(tǒng)均到本次停車關(guān)聯(lián)的停并請求參數(shù)Y服務(wù)名:Y版本號:Y字符集:YYN停車流水,標(biāo)識具體某次停車事件,需保證該停車場下唯一NYY類型:1金額,2時長,3全免,4Y金額N給予原因,例如:購物滿300,免費停車2小時NNN券減免規(guī)則ID用于配置減免是減免前面還是減免后面一般一個停N則規(guī)則ID用于配置改應(yīng)答參數(shù)Y服務(wù)名:Y版本號:Y字符集:Y本次請求狀態(tài)返回碼示例:1001狀態(tài)碼含義1002停車信息未找到1403當(dāng)前車輛已享受其他1401簽名錯誤,請檢查配置1500接口處理異常Y當(dāng)前請求應(yīng)答結(jié)果,簽名方法參考附錄Y狀態(tài)碼處理描述,如:返回錯誤信息注一次停車在停車系統(tǒng)只允許存在一條有效信息提交到停車場系統(tǒng)后,默認(rèn)立即生效,且僅本次停車有效該商戶給予后,在獲取停車訂單時,接口應(yīng)返回相應(yīng)的信息若提交enfore給予券 則本次停車已有的使用本次提交的替換接口提交的voucher用于消費對賬,不用于賬單核銷,停車場系統(tǒng)實現(xiàn)可作為協(xié)議說明用于在錯誤是,清空指定停車記錄已的商戶是否是在特定時間內(nèi)才可以撤回還是任意時間都能撤這樣有點不合理,如果車主離開商場了,出場時發(fā)現(xiàn)券沒了,這時候會引起爭議的?嗯,那是否限制發(fā)出去后10分鐘后不可撤銷.如果發(fā)出去5分鐘內(nèi)車主離場了但是6分鐘后才發(fā)覺發(fā)錯了這時候撤不回怎么如果發(fā)現(xiàn)已經(jīng)出場,那么返回?zé)o法撤銷,車輛已出場.Y服務(wù)名:Y版本號:Y字符集:YYY應(yīng)答參數(shù)Y服務(wù)名:Y版本號:Y字符集:Y本次請求狀態(tài)返回碼示例:1001狀態(tài)碼含義1002停車信息未找到1401簽名錯誤,請檢查配置1500接口處理異常Y當(dāng)前請求應(yīng)答結(jié)果,簽名方法參考附錄Y狀態(tài)碼處理描述,如:返回錯誤信息月卡/次卡/儲值卡接協(xié)議說明PP停車發(fā)起向停車場,查詢指定車輛月卡/次卡/儲值卡信息,停車場返回對應(yīng)車牌/客戶請求參數(shù)Y服務(wù)名:Y版本號:Y字符集:YYN應(yīng)答參數(shù)Y服務(wù)名:Y版本號:Y字符集:Y本次請求狀態(tài)返回碼示例:1001狀態(tài)碼含義1001接口處理成功,業(yè)務(wù)參數(shù)將返回1002沒有查到相關(guān)貴賓記錄1401簽名錯誤,請檢查配置1500接口處理異常Y當(dāng)前請求應(yīng)答結(jié)果,簽名方法參考附錄Y狀態(tài)碼處理描述,如:返回錯誤信息N貴賓集合,即月卡/次卡/儲值卡中的一種,對象參考后面貴賓信息貴賓信息Y客戶YNNN標(biāo)準(zhǔn)類型標(biāo)識?例如:MON_A、N當(dāng)前貴賓標(biāo)準(zhǔn)描述?例如:月卡N單價,單位分Y綁定的號Y綁定 號Y辦理時間,格式:Y過期時間,格式:Y0Y儲值為余額單位分?注:若月卡當(dāng)前到期則balance=0,按照此規(guī)則計協(xié)議說明PP停車發(fā)起請求,對月卡,次卡或儲值卡進(jìn)行續(xù)費請求參數(shù)Y服務(wù)名:Y版本號:Y字符集:YYNNNY續(xù)費時間,格式:Y支付流水,用于對賬Y客戶支付金額,單位分Y貴賓類型:(參考以停車場為準(zhǔn))0Y續(xù)費金額儲值續(xù)費金額單位分?應(yīng)答參數(shù)Y服務(wù)名:Y版本號:Y字符集:Y本次請求狀態(tài)返回碼示例:1001狀態(tài)碼含義1001接口處理成功,業(yè)務(wù)參數(shù)將返回1002沒有查到相關(guān)貴賓記錄1401簽名錯誤,請檢查配置1500接口處理異常Y當(dāng)前請求應(yīng)答結(jié)果,簽名方法參考附錄Y狀態(tài)碼處理描述,如:返回錯誤信息其他接協(xié)議說明PP停車在需要停車場本地文件業(yè)務(wù)處理時通過本協(xié)議獲取指定文件請求參數(shù)Y服務(wù)名:Y版本號:Y字符集:YYY指定的上 Y指定文件權(quán)限,1公開,0私N上傳有效時間,單位Y例: YY應(yīng)答參數(shù)Y服務(wù)名:Y版本號:Y字符集:Y本次請求狀態(tài)返回碼示例:1001狀態(tài)碼含義1001獲取成功,業(yè)務(wù)參數(shù)將返回1400參數(shù)錯誤,請檢查參數(shù)1401簽名錯誤,請檢查配置1500接口處理異常Y當(dāng)前請求應(yīng)答結(jié)果,簽名方法參考附錄Y狀態(tài)碼處理描述,如:返回錯誤信息Y協(xié)議說明PP停車在需要停車場本地文件業(yè)務(wù)處理時通過本協(xié)議獲取指定文件請求參數(shù)Y服務(wù)名 Y版本號:Y字符集:YYN N執(zhí)行參數(shù)N等待執(zhí)行結(jié)束,0不等待,1等待N執(zhí)行超時時間,單位應(yīng)答參數(shù)Y服務(wù)名 Y版本號:Y字符集:Y本次請求狀態(tài)返回碼示例:1001狀態(tài)碼含義1001獲取成功,業(yè)務(wù)參數(shù)將返回1400參數(shù)錯誤,請檢查參數(shù)1401簽名錯誤,請檢查配置1500接口處理異常Y當(dāng)前請求應(yīng)答結(jié)果,簽名方法參考附錄Y狀態(tài)碼處理描述,如:返回錯誤信息N執(zhí)行完成退出碼,當(dāng)waite_exit=1返回N執(zhí)行輸出結(jié)果,當(dāng)waite_exit=1返回特殊情況和相應(yīng)的 每次獲取訂單都應(yīng)將本次停車之前未成功支付的訂單狀態(tài)標(biāo)記為已撤銷關(guān)于現(xiàn)金支付:若是支付,用戶先獲取訂單,然后在亭完成現(xiàn)金支付后,本次停車之前的所有未受到支付通知的訂單都標(biāo)記為已撤銷.注:簡單的說就是對于當(dāng)次停車,只有的一條支付記錄是可處理的.如果的支付記錄是現(xiàn)金支付,那么之前的未支付訂單狀態(tài)都不可被支付.若用戶獲取訂單后未支付,走現(xiàn)金支付了?之