客戶端新團購產(chǎn)品需求文檔-20130701

標(biāo)題：客戶端新團購產(chǎn)品需求文檔項目編號：文檔負(fù)責(zé)人：左圣烈版本號：V1.3最后修改日期：修改人：頁碼：左圣烈PAGE61ofNUMPAGES61客戶端新團購產(chǎn)品需求文檔

修訂控制頁編號文檔版本修訂章節(jié)修訂原因修訂日期修訂人1V1.0初始版本--2013-6-13左圣烈2V對訂單退款部分進(jìn)行了詳細(xì)說明2013-6-17左圣烈3V增加了客戶端對團購券狀態(tài)的封裝說明2013-6-21左圣烈4V窩窩團購訂單一券一用“券號碼”取“供應(yīng)商訂單編號“2013-7-1左圣烈5678910

目錄TOC\o"1-4"\h\z\u1. 概述 91.1. 文檔說明 91.2. 名詞說明 91.3. 產(chǎn)品背景及概述 91.4. 需求關(guān)聯(lián)對象 92. 功能總覽 92.1. IT總覽 102.2. 功能清單 103. 功能詳情 113.1. 團購城市列表 113.1.1. 團購城市獲取及展示 11. 功能需求描述 11. 核心流程及規(guī)則 11. 頁面原型及說明 13. 頁面處理規(guī)則 13. 關(guān)聯(lián)改造說明 13. 接口說明 143.2. 團購產(chǎn)品展示 143.2.1. 團購產(chǎn)品列表 14. 功能需求描述 14. 核心流程及規(guī)則 14. 頁面原型及說明 15. 頁面處理規(guī)則 16. 關(guān)聯(lián)改造說明 16. 接口說明 173.2.2. 團購篩選 17. 功能需求描述 17. 核心流程及規(guī)則 17. 頁面原型及說明 18. 頁面處理規(guī)則 19. 關(guān)聯(lián)改造說明 19. 接口說明 203.2.3. 團購搜索 20. 功能需求描述 20. 核心流程及規(guī)則 20. 頁面原型及說明 21. 頁面處理規(guī)則 22. 關(guān)聯(lián)改造說明 22. 接口說明 223.2.4. 團購產(chǎn)品詳情 22. 功能需求描述 22. 核心流程及規(guī)則 22. 頁面原型及說明 23. 頁面處理規(guī)則 27. 關(guān)聯(lián)改造說明 28. 接口說明 283.3. 團購下單 283.3.1. 訂單提交與創(chuàng)建 28. 功能需求描述 28. 核心流程及規(guī)則 28. 頁面原型及說明 30. 頁面處理規(guī)則 31. 關(guān)聯(lián)改造說明 31. 接口說明 313.4. 團購訂單支付 313.4.1. 易付寶余額支付 31. 功能需求描述 31. 核心流程及規(guī)則 31. 頁面原型及說明 33. 頁面處理規(guī)則 35. 關(guān)聯(lián)改造說明 35. 接口說明 353.4.2. 銀聯(lián)手機支付 35. 功能需求描述 36. 核心流程及規(guī)則 36. 頁面原型及說明 37. 頁面處理規(guī)則 38. 關(guān)聯(lián)改造說明 38. 接口說明 383.5. 團購訂單展示 393.5.1. 訂單列表 39. 功能需求描述 39. 核心流程及規(guī)則 39. 頁面原型及說明 40. 頁面處理規(guī)則 40. 關(guān)聯(lián)改造說明 41. 接口說明 413.5.2. 訂單篩選 41. 功能需求描述 41. 核心流程及規(guī)則 41. 頁面原型及說明 42. 頁面處理規(guī)則 43. 關(guān)聯(lián)改造說明 43. 接口說明 433.5.3. 訂單詳情 43. 功能需求描述 43. 核心流程及規(guī)則 43. 頁面原型及說明 44. 頁面處理規(guī)則 47. 關(guān)聯(lián)改造說明 49. 接口說明 493.6. 團購訂單管理 493.6.1. 訂單取消 49. 功能需求描述 49. 核心流程及規(guī)則 49. 頁面原型及說明 50. 頁面處理規(guī)則 51. 關(guān)聯(lián)改造說明 51. 接口說明 513.6.2. 訂單二次支付 52. 功能需求描述 52. 核心流程及規(guī)則 52. 頁面原型及說明 53. 頁面處理規(guī)則 53. 關(guān)聯(lián)改造說明 53. 接口說明 543.6.3. 訂單退款 54. 功能需求描述 54. 核心流程及規(guī)則 54. 頁面原型及說明 56. 頁面處理規(guī)則 58. 關(guān)聯(lián)改造說明 59. 接口說明 593.7. 附：錯誤信息列表 59

概述文檔說明本文檔用于定義“客戶端新團購”的產(chǎn)品需求，包含功能說明、核心流程及規(guī)則、接口說明、頁面原型及處理規(guī)則等內(nèi)容，為客戶端開發(fā)、接口開發(fā)及測試提供作業(yè)依據(jù)。名詞說明編號名詞說明產(chǎn)品背景及概述電子商務(wù)中心去年上線了生活類團購（），包含了自營和代銷兩部分，代銷部分的供應(yīng)商主要有藝龍和窩窩團兩家，酒店團購產(chǎn)品絕大部分都是來自藝龍的需求關(guān)聯(lián)對象編號對象名稱對象說明用戶易購客戶端虛擬團購系統(tǒng)易付寶支付核心銀聯(lián)功能總覽IT總覽功能清單編號一級功能二級功能對應(yīng)接口1團購城市列表1.1團購城市獲取及展示團購城市列表接口2團購產(chǎn)品展示2.1團購產(chǎn)品列表團購產(chǎn)品列表接口2.2團購篩選2.3團購搜索2.4團購產(chǎn)品詳情團購產(chǎn)品詳情接口3團購下單3.1訂單提交與創(chuàng)建團購提交訂單接口4團購訂單支付4.1易付寶余額支付團購易付寶余額支付接口4.2銀聯(lián)手機支付團購銀聯(lián)手機支付接口5團購訂單展示5.1訂單列表團購訂單列表接口5.2訂單篩選5.3訂單詳情團購訂單詳情接口6團購訂單管理6.1訂單取消團購訂單取消接口6.2訂單二次支付無6.3訂單退款團購訂單退款接口功能詳情團購城市列表團購城市獲取及展示功能需求描述核心流程及規(guī)則流程圖流程描述用戶進(jìn)入團購頻道客戶端判斷是否存在緩存城市是，則根據(jù)緩存城市查詢團購產(chǎn)品列表（見3.2.1章節(jié)）否，再判斷是否存在緩存城市列表是，展示緩存的城市列表否，則調(diào)用團購城市列表接口提交查詢請求至團購系統(tǒng)團購系統(tǒng)處理查詢請求，將團購城市列表返回給客戶端客戶端展示團購城市列表供用戶選擇，并將城市列表緩存在客戶端本地規(guī)則描述團購城市列表由“熱門城市”和“所有城市”組成，其中“所有城市”以城市名稱首字母進(jìn)行列表拆分團購城市的緩存機制為始終保存用戶最后選擇的城市，退出客戶端后不清除；團購城市列表的緩存機制是退出客戶端后立即清除本章節(jié)中由于客戶端自身原因?qū)е碌膱箦e統(tǒng)一提示為“網(wǎng)絡(luò)調(diào)用異常，請稍后再試“；當(dāng)接口返回的處理結(jié)果為失敗時，客戶端直接展示錯誤描述，無需根據(jù)錯誤碼進(jìn)行報錯提示（見3.7章節(jié)）頁面原型及說明11編號名稱描述團購城市列表界面字段數(shù)據(jù)僅供演示頁面處理規(guī)則從易購首頁進(jìn)入該頁面時，點擊返回按鈕返回到易購客戶端首頁；從團購產(chǎn)品列表頁進(jìn)入該頁面時，點擊返回按鈕返回到團購產(chǎn)品列表頁關(guān)聯(lián)改造說明接口說明編號接口名稱接口描述團購城市列表接口提交查詢請求，獲取團購城市列表團購產(chǎn)品展示團購產(chǎn)品列表功能需求描述核心流程及規(guī)則流程圖流程描述用戶在團購城市列表界面選擇團購城市客戶端調(diào)用團購產(chǎn)品列表接口提交查詢請求至團購系統(tǒng)團購系統(tǒng)處理查詢請求，將團購產(chǎn)品列表及對應(yīng)的篩選條件返回給客戶端客戶端展示團購產(chǎn)品列表（篩選條件供提交篩選請求時使用，見3.2.2章節(jié)）規(guī)則描述團購產(chǎn)品列表默認(rèn)展示全部團購，以團購系統(tǒng)的默認(rèn)序值來排序團購產(chǎn)品列表有大圖和列表兩種視圖，接口則返回了三種規(guī)格的圖片url，用戶切換視圖時客戶端下載尺寸合適的圖片大圖視圖中團購產(chǎn)品的標(biāo)題需要由商品描述前綴（原團購所在區(qū)域）和團購產(chǎn)品名稱拼接，若商品描述前綴返回值為空，客戶端將其處理成其他團購列表接口還返回了產(chǎn)品是否為藝龍團購的標(biāo)示（產(chǎn)品類型），供查詢產(chǎn)品詳情時使用，詳見3.2.4章節(jié)旅游、酒店類的團購產(chǎn)品列表不受團購城市控制，查詢?nèi)我獬鞘卸际欠祷厝慨a(chǎn)品；電影、美食、生活、娛樂、麗人類的團購產(chǎn)品根據(jù)團購城市來動態(tài)展示（接口及服務(wù)端的邏輯）本章節(jié)中由于客戶端自身原因?qū)е碌膱箦e統(tǒng)一提示為“網(wǎng)絡(luò)調(diào)用異常，請稍后再試“；當(dāng)接口返回的處理結(jié)果為失敗時，客戶端直接展示錯誤描述，無需根據(jù)錯誤碼進(jìn)行報錯提示（見3.7章節(jié)）頁面原型及說明2121編號名稱描述團購產(chǎn)品列表-列表視圖字段數(shù)據(jù)僅供演示團購產(chǎn)品列表-大圖視圖字段數(shù)據(jù)僅供演示頁面處理規(guī)則團購所在區(qū)域分單店和多店，單店直接顯示所在區(qū)域；非藝龍團購的多店顯示為“x店通用”，藝龍團購的多店顯示為“多店通用”（接口及服務(wù)端的邏輯，客戶端直接展示即可）團購產(chǎn)品列表的展示字段為團購產(chǎn)品圖片、團購產(chǎn)品名稱、團購價格、原價、已購買數(shù)、商品描述前綴，列表的分頁數(shù)量為12條關(guān)聯(lián)改造說明接口說明編號接口名稱接口描述團購產(chǎn)品列表接口提交查詢請求，獲取團購產(chǎn)品列表團購篩選功能需求描述核心流程及規(guī)則流程圖流程描述用戶在團購產(chǎn)品列表頁點擊側(cè)邊欄按鈕客戶端滑出側(cè)邊欄，并展示篩選條件用戶點擊篩選條件客戶端調(diào)用團購產(chǎn)品列表接口提交查詢請求至團購系統(tǒng)團購系統(tǒng)處理查詢請求，將團購產(chǎn)品列表及對應(yīng)的篩選條件返回給客戶端客戶端展示團購產(chǎn)品列表規(guī)則描述考慮到接口全面性，團購系統(tǒng)每次返回查詢結(jié)果時都會帶上篩選條件，由于接口沒有返回“全部分類”，所以需要客戶端寫死在頁面上的（一二級篩選條件都需要加），并默認(rèn)選中由于旅游、酒店類團購不受團購城市控制，所以無論選擇任何城市，這兩個一級類目都是存在的，其二級篩選條件是團購城市（接口及服務(wù)端的邏輯）電影、美食、生活、娛樂、麗人類團購受到團購城市控制，所以若該城市沒有這些類目的團購，則不展示該類目的入口，這五個一級類目下的二級篩選條件是團購二級類目（接口及服務(wù)端的邏輯）本章節(jié)中由于客戶端自身原因?qū)е碌膱箦e統(tǒng)一提示為“網(wǎng)絡(luò)調(diào)用異常，請稍后再試“；當(dāng)接口返回的處理結(jié)果為失敗時，客戶端直接展示錯誤描述，無需根據(jù)錯誤碼進(jìn)行報錯提示（見3.7章節(jié)）頁面原型及說明2121編號名稱描述團購篩選界面-二級類目展開字段數(shù)據(jù)僅供演示團購篩選界面-二級類目收起字段數(shù)據(jù)僅供演示頁面處理規(guī)則用戶選擇篩選條件后，客戶端收起側(cè)邊欄展示接口返回的團購產(chǎn)品列表關(guān)聯(lián)改造說明接口說明編號接口名稱接口描述團購產(chǎn)品列表接口提交查詢請求，獲取團購產(chǎn)品列表團購搜索功能需求描述核心流程及規(guī)則流程圖流程描述用戶在團購產(chǎn)品列表頁點擊搜索框客戶端展示團購搜索界面用戶輸入關(guān)鍵字，確認(rèn)搜索客戶端調(diào)用團購產(chǎn)品列表接口提交搜索請求至團購系統(tǒng)，并本地保存搜索記錄團購系統(tǒng)處理搜索請求，將搜索結(jié)果返回給客戶端客戶端展示團購產(chǎn)品列表規(guī)則描述團購搜索結(jié)果不支持篩選和視圖切換用戶輸入關(guān)鍵字點擊搜索后，客戶端即本地保存搜索記錄，上限數(shù)量為10條，若超出則按保存時間從舊到新逐條覆蓋本章節(jié)中由于客戶端自身原因?qū)е碌膱箦e統(tǒng)一提示為“網(wǎng)絡(luò)調(diào)用異常，請稍后再試“；當(dāng)接口返回的處理結(jié)果為失敗時，客戶端直接展示錯誤描述，無需根據(jù)錯誤碼進(jìn)行報錯提示（見3.7章節(jié)）頁面原型及說明2121編號名稱描述團購搜索界面字段數(shù)據(jù)僅供演示團購搜索結(jié)果字段數(shù)據(jù)僅供演示頁面處理規(guī)則團購搜索結(jié)果列表的展示字段與團購產(chǎn)品列表一致，分頁數(shù)量為12條；搜索無結(jié)果時在頁面中間顯示“沒有找到相關(guān)團購，請重新搜索”關(guān)聯(lián)改造說明接口說明編號接口名稱接口描述團購產(chǎn)品列表接口提交查詢請求，獲取團購產(chǎn)品列表團購產(chǎn)品詳情功能需求描述核心流程及規(guī)則流程圖流程描述用戶點擊團購產(chǎn)品列表行項目客戶端調(diào)用團購產(chǎn)品詳情接口提交查詢請求至團購系統(tǒng)（輸入產(chǎn)品ID、產(chǎn)品類型等參數(shù)），同時根據(jù)產(chǎn)品類型打開對應(yīng)的頁面模板團購系統(tǒng)處理查詢請求，將團購產(chǎn)品詳情返回給客戶端客戶端在對應(yīng)的頁面模板展示團購產(chǎn)品詳情規(guī)則描述產(chǎn)品類型說明：電影、美食、生活、娛樂、麗人、旅游類團購的產(chǎn)品詳情數(shù)據(jù)及頁面展示是一致的，藝龍酒店團購則是單獨的，在團購產(chǎn)品列表接口中返回了該標(biāo)示（是否為藝龍團購）非藝龍團購產(chǎn)品詳情中的“本單詳情”與藝龍團購中的“團購包含項目“處理成了網(wǎng)頁，客戶端通過團購詳情接口返回的ur來打開頁面團購標(biāo)題需要由商品描述前綴（原團購所在區(qū)域）和團購產(chǎn)品描述拼接，若商品描述前綴返回值為空，客戶端將其處理成其他團購產(chǎn)品詳情接口返回了該團購產(chǎn)品的單次可購買數(shù)量，作為提交訂單時的檢查規(guī)則本章節(jié)中由于客戶端自身原因?qū)е碌膱箦e統(tǒng)一提示為“網(wǎng)絡(luò)調(diào)用異常，請稍后再試“；當(dāng)接口返回的處理結(jié)果為失敗時，客戶端直接展示錯誤描述，無需根據(jù)錯誤碼進(jìn)行報錯提示（見3.7章節(jié)）頁面原型及說明121233545466編號名稱描述非藝龍團購產(chǎn)品詳情展示字段為團購圖片、團購價格、原價、團購剩余時間、已購買數(shù)、團購標(biāo)題（商品描述前綴+團購產(chǎn)品描述）、是否支持未消費退款標(biāo)示非藝龍團購產(chǎn)品詳情-本單詳情網(wǎng)頁形式非藝龍團購產(chǎn)品詳情-商家地址展示字段為商家名稱、地址、電話、交通提示藝龍團購產(chǎn)品詳情展示字段為團購圖片、團購價格、原價、團購剩余時間、已購買數(shù)、團購標(biāo)題（商品描述前綴+團購產(chǎn)品描述）、是否支持未消費退款標(biāo)示藝龍團購產(chǎn)品詳情-團購包含項目網(wǎng)頁形式藝龍團購產(chǎn)品詳情-商家信息展示字段為酒店名稱、酒店地址、預(yù)約電話頁面處理規(guī)則團購詳情頁面需要根據(jù)接口返回值來進(jìn)行以下處理判斷該團購是否已結(jié)束：否，展示“購買“按鈕，是，則展示”已結(jié)束“按鈕且不可點擊判斷該團購是否支持未消費退款、是否支持過期退款，并展示對應(yīng)標(biāo)示，如下圖團購詳情中的“團購服務(wù)熱線”和商品信息中的電話號碼，點擊后可以進(jìn)行撥號選擇關(guān)聯(lián)改造說明接口說明編號接口名稱接口描述團購產(chǎn)品詳情接口提交查詢請求，獲取團購產(chǎn)品詳情團購下單訂單提交與創(chuàng)建功能需求描述核心流程及規(guī)則流程圖流程描述用戶在團購產(chǎn)品詳情頁點擊“購買”按鈕客戶端判斷用戶是否登錄是，則展示團購下單界面，帶出團購產(chǎn)品名稱、單價、單次可購買數(shù)量及手機號碼否，則走登錄流程用戶在下單界面填寫訂單信息，確認(rèn)提交客戶端檢查表單信息是否合法，具體規(guī)則如下：購買數(shù)量：需大于0，不超過單次可購買數(shù)量，若不符合則提示”購買數(shù)量輸入有誤，請重新輸入“手機號碼：需為13、14、15、18開頭的11位數(shù)字，若不符合則提示”手機號碼輸入有誤，請重新輸入“表單檢查通過后，客戶端調(diào)用團購提交訂單接口申請創(chuàng)建訂單團購系統(tǒng)接收客戶端下單請求，進(jìn)行訂單檢查、訂單創(chuàng)建，完畢后將訂單處理結(jié)果返回給客戶端客戶端接收訂單處理結(jié)果，提示用戶若處理結(jié)果為成功，則展示支付方式選擇界面若為失敗，則直接展示接口返回的錯誤描述，常見的錯誤描述如下（詳見3.7章節(jié)）對不起，您來晚了，團購已結(jié)束，請重新選擇商品庫存不足，無法滿足訂單需求規(guī)則描述團購單次可購買數(shù)量是在團購產(chǎn)品詳情接口返回的，設(shè)該數(shù)量為N，若N小于等于99，則用戶單次至多可購買N件；若N大于99，則單次至多可購買99件購買數(shù)量輸入框默認(rèn)值為1，程序控制只能輸入一到兩位數(shù)字，不可輸入其他字符，若第一位數(shù)字輸入0則修改成1手機號碼從會員信息中帶出，可自行修改，如果無手機號信息則為空，輸入框只能輸入11位數(shù)字，不可輸入其他字符提交訂單接口也需要傳入團購產(chǎn)品類型本章節(jié)中由于客戶端自身原因?qū)е碌膱箦e統(tǒng)一提示為“網(wǎng)絡(luò)調(diào)用異常，請稍后再試“；當(dāng)接口返回的處理結(jié)果為失敗時，客戶端直接展示錯誤描述，無需根據(jù)錯誤碼進(jìn)行報錯提示（見3.7章節(jié)）1頁面原型及說明1編號名稱描述團購下單界面字段數(shù)據(jù)僅供演示頁面處理規(guī)則頁面上的“總價“由客戶端根據(jù)產(chǎn)品單價和購買數(shù)量計算關(guān)聯(lián)改造說明接口說明編號接口名稱接口描述團購提交訂單接口申請創(chuàng)建團購訂單團購訂單支付易付寶余額支付功能需求描述核心流程及規(guī)則流程圖流程描述用戶成功提交訂單，進(jìn)入支付方式選擇頁面客戶端調(diào)用易付寶賬戶查詢接口提交查詢請求（這個接口是朱德斌調(diào)會員組的邏輯，中間的過程省略）會員組處理查詢請求，把用戶易付寶賬戶信息返回給客戶端（余額、是否激活）客戶端根據(jù)查詢結(jié)果進(jìn)行對應(yīng)處理（易付寶余額充足標(biāo)簽才可點擊，詳見下方頁面處理規(guī)則）用戶選擇易付寶支付客戶端展示易付寶支付界面，帶出訂單金額及易付寶余額用戶輸入支付密碼，點擊確認(rèn)支付客戶端調(diào)用團購易付寶余額支付接口申請支付，提交會員編號、訂單號、訂單金額、支付密碼、支付方式等參數(shù)虛擬團購系統(tǒng)接收客戶端支付請求并處理，檢查團購訂單是否合法（包括訂單中的團購產(chǎn)品是否在售、庫存是否充足、價格有無變化、訂單狀態(tài)有無變化等）是，則調(diào)用易付寶扣款接口申請支付，提交訂單號、支付金額、支付密碼等參數(shù)否，則將報錯信息返回給客戶端客戶端接收報錯信息，提示用戶（客戶端直接展示接口返回的錯誤描述即可，詳見3.7章節(jié)），常見的錯誤描述如下對不起，您來晚了，團購已結(jié)束，請重新選擇庫存不足，無法滿足訂單需求易付寶接收團購系統(tǒng)支付請求，檢查支付信息（包括商戶信息檢查、用戶信息檢查、支付密碼檢查等），創(chuàng)建支付訂單，進(jìn)行支付后續(xù)處理，完畢后更新支付訂單，將支付結(jié)果通知團購系統(tǒng)團購系統(tǒng)接收支付結(jié)果通知，將支付結(jié)果返回給客戶端（包括是否支付成功、支付密碼錯誤次數(shù)等），并異步更新團購訂單，進(jìn)行訂單后續(xù)處理客戶端接收支付結(jié)果，提示用戶若支付成功，展示支付成功界面若支付失敗，展示報錯信息支付密碼錯誤3次以內(nèi)，提示“密碼已錯誤N次，若達(dá)到3次賬戶將被凍結(jié)24小時”支付密碼錯誤3次及以上，提示“密碼已錯誤三次，請24小時之后再試”其他錯誤或異常直接展示接口返回的錯誤描述，見3.7章節(jié)規(guī)則描述客戶端不對支付密碼的字符長度、類型做任何限制，不為空即可本章節(jié)中由于客戶端自身原因?qū)е碌膱箦e統(tǒng)一提示為“網(wǎng)絡(luò)調(diào)用異常，請稍后再試“；當(dāng)接口返回的處理結(jié)果為失敗時，客戶端直接展示錯誤描述，無需根據(jù)錯誤碼進(jìn)行報錯提示（見3.7章節(jié)）頁面原型及說明113232編號名稱描述支付方式選擇界面字段數(shù)據(jù)僅供演示易付寶付款界面字段數(shù)據(jù)僅供演示支付成功界面字段數(shù)據(jù)僅供演示頁面處理規(guī)則客戶端在支付方式選擇界面根據(jù)用戶易付寶賬戶狀態(tài)進(jìn)行如下處理：若易付寶賬戶未激活，則展示“您的易付寶未激活，無法支付”，易付寶支付標(biāo)簽不可點擊若易付寶賬戶已激活，再判斷賬戶余額是否大于等于訂單金額是，則展示“賬戶余額充足，可以支付”，易付寶支付標(biāo)簽可點擊否，則展示“賬戶余額不足，請選擇其他支付方式”，易付寶支付標(biāo)簽不可點擊若用戶未輸入支付密碼點擊“確認(rèn)支付“，客戶端提示”支付密碼不能為空“提交訂單成功后，用戶在支付方式選擇界面點擊返回按鈕返回到團購產(chǎn)品詳情頁；在訂單詳情頁通過付款按鈕進(jìn)入支付方式選擇界面時，點擊返回按鈕返回到訂單詳情頁支付方式選擇界面的快捷支付是之前的匯付天下，現(xiàn)在不做關(guān)聯(lián)改造說明接口說明編號接口名稱接口描述易付寶賬戶查詢接口查詢用戶易付寶賬戶信息團購易付寶余額支付接口提交支付請求，接收訂單校驗結(jié)果及易付寶支付處理結(jié)果銀聯(lián)手機支付功能需求描述核心流程及規(guī)則流程圖流程描述用戶成功提交訂單，選擇銀聯(lián)手機支付客戶端調(diào)用團購銀聯(lián)手機支付接口申請支付，提交會員編號、訂單號、訂單金額、、支付方式等參數(shù)，并打開銀聯(lián)支付控件虛擬團購系統(tǒng)接收客戶端支付請求并處理，檢查團購訂單是否合法（包括訂單中的團購產(chǎn)品是否在售、庫存是否充足、價格有無變化、訂單狀態(tài)有無變化等）是，則調(diào)用易付寶支付接口申請支付，提交訂單號、支付金額等參數(shù)否，則將報錯信息返回給客戶端客戶端接收報錯信息，提示用戶（客戶端直接展示接口返回的錯誤描述即可，詳見3.7章節(jié)），常見的錯誤描述如下對不起，您來晚了，團購已結(jié)束，請重新選擇庫存不足，無法滿足訂單需求易付寶接收團購系統(tǒng)支付請求，檢查支付信息，創(chuàng)建支付訂單，生成銀聯(lián)支付參數(shù)（支付回調(diào)地址、商戶名稱、支付金額、簽名等），將銀聯(lián)支付參數(shù)發(fā)送給團購系統(tǒng)，團購系統(tǒng)接收銀聯(lián)支付參數(shù)，返回給客戶端客戶端接收銀聯(lián)支付參數(shù)，展示支付界面用戶在銀聯(lián)支付控件中輸入支付信息，點擊確認(rèn)支付銀聯(lián)支付控件調(diào)用銀聯(lián)支付接口申請支付銀聯(lián)檢查支付信息，處理支付請求，完畢后將銀聯(lián)支付結(jié)果通知到易付寶和銀聯(lián)支付控件易付寶接收銀聯(lián)支付結(jié)果通知，進(jìn)行對應(yīng)處理，完畢后更新支付訂單，將易付寶支付處理結(jié)果通知團購系統(tǒng)團購系統(tǒng)接收易付寶支付結(jié)果通知，更新團購訂單，進(jìn)行訂單后續(xù)處理銀聯(lián)支付控件接收支付結(jié)果，提示用戶若支付成功，關(guān)閉銀聯(lián)支付控件，展示客戶端支付成功界面若支付失敗，銀聯(lián)支付界面展示報錯信息規(guī)則描述銀聯(lián)支付控件運行過程中出現(xiàn)的錯誤由銀聯(lián)公司控制，商戶無從得知本章節(jié)中由于客戶端自身原因?qū)е碌膱箦e統(tǒng)一提示為“網(wǎng)絡(luò)調(diào)用異常，請稍后再試“；當(dāng)接口返回的處理結(jié)果為失敗時，客戶端直接展示錯誤描述，無需根據(jù)錯誤碼進(jìn)行報錯提示（見3.7章節(jié)）頁面原型及說明11編號名稱描述銀聯(lián)支付控件字段數(shù)據(jù)僅供演示頁面處理規(guī)則若用戶未支付完成退出銀聯(lián)支付控件，客戶端依然展示支付方式選擇界面關(guān)聯(lián)改造說明接口說明編號接口名稱接口描述團購銀聯(lián)支付接口提交支付請求，接收訂單校驗結(jié)果及銀聯(lián)支付參數(shù)團購訂單展示訂單列表功能需求描述核心流程及規(guī)則流程圖流程描述用戶進(jìn)入“我的團購“客戶端檢查用戶是否登錄，是則調(diào)用團購訂單列表接口提交查詢請求至團購系統(tǒng)（未登錄走登錄流程）團購系統(tǒng)處理查詢請求，將團購訂單列表及訂單類型返回給客戶端客戶端展示團購訂單列表（訂單類型供查詢訂單詳情時使用，見3.5.3章節(jié)）規(guī)則描述本章節(jié)中由于客戶端自身原因?qū)е碌膱箦e統(tǒng)一提示為“網(wǎng)絡(luò)調(diào)用異常，請稍后再試“；當(dāng)接口返回的處理結(jié)果為失敗時，客戶端直接展示錯誤描述，無需根據(jù)錯誤碼進(jìn)行報錯提示（見3.7章節(jié)）1頁面原型及說明1編號名稱描述團購訂單列表字段數(shù)據(jù)僅供演示頁面處理規(guī)則訂單列表按下單時間從近到遠(yuǎn)排序，默認(rèn)展示所有狀態(tài)的訂單，分頁數(shù)量為12條，訂單狀態(tài)有四種：等待付款、支付完成、交易關(guān)閉、退款中，展示字段為團購產(chǎn)品名稱、購買數(shù)量、訂單狀態(tài)、訂單金額若沒有訂單記錄，則頁面中間顯示“沒有訂單記錄關(guān)聯(lián)改造說明接口說明編號接口名稱接口描述團購訂單列表接口查詢團購訂單列表訂單篩選功能需求描述核心流程及規(guī)則流程圖流程描述用戶在團購訂單列表點擊篩選條件客戶端調(diào)用團購訂單列表接口提交查詢請求至團購系統(tǒng)團購系統(tǒng)處理查詢請求，將團購訂單列表及訂單類型返回給客戶端客戶端展示團購訂單列表（訂單類型供查詢訂單詳情時使用，見3.5.3章節(jié)）規(guī)則描述本章節(jié)中由于客戶端自身原因?qū)е碌膱箦e統(tǒng)一提示為“網(wǎng)絡(luò)調(diào)用異常，請稍后再試“；當(dāng)接口返回的處理結(jié)果為失敗時，客戶端直接展示錯誤描述，無需根據(jù)錯誤碼進(jìn)行報錯提示（見3.7章節(jié)）頁面原型及說明11編號名稱描述團購訂單列表字段數(shù)據(jù)僅供演示頁面處理規(guī)則用戶可通過訂單狀態(tài)篩選訂單：所有狀態(tài)、等待付款、支付完成、交易關(guān)閉、退款中，默認(rèn)展示所有狀態(tài)的訂單若無訂單記錄，則頁面中間顯示“沒有訂單記錄關(guān)聯(lián)改造說明接口說明編號接口名稱接口描述團購訂單列表接口查詢團購訂單列表訂單詳情功能需求描述核心流程及規(guī)則流程圖流程描述用戶點擊團購訂單列表行項目客戶端調(diào)用團購訂單詳情接口提交查詢請求至團購系統(tǒng)（輸入訂單ID、訂單類型等參數(shù)），同時根據(jù)訂單類型打開對應(yīng)的頁面模板團購系統(tǒng)處理查詢請求，將團購訂單詳情（包括是否支持退款）返回給客戶端客戶端在對應(yīng)的頁面模板展示團購訂單詳情規(guī)則描述訂單類型說明：電影、美食、生活、娛樂、麗人、旅游類團購的訂單詳情數(shù)據(jù)及頁面展示是一致的，藝龍酒店團購則是單獨的，在團購訂單列表接口中返回了該標(biāo)示（是否為藝龍訂單）非藝龍訂單又分為一券一用和一券多用，在團購訂單詳情接口返回了該標(biāo)示是否支持退款標(biāo)示便于客戶端在訂單詳情中判斷是否展示“退款“按鈕，詳見3.6.3章節(jié)非藝龍團購訂單中的“溫馨提示”與藝龍訂單中的“團購包含項目“處理成了網(wǎng)頁，客戶端通過訂單詳情接口返回的ur來打開頁面本章節(jié)中由于客戶端自身原因?qū)е碌膱箦e統(tǒng)一提示為“網(wǎng)絡(luò)調(diào)用異常，請稍后再試“；當(dāng)接口返回的處理結(jié)果為失敗時，客戶端直接展示錯誤描述，無需根據(jù)錯誤碼進(jìn)行報錯提示（見3.7章節(jié)）頁面原型及說明2121434356568787編號名稱描述非藝龍團購訂單詳情字段數(shù)據(jù)僅供演示非藝龍團購訂單詳情-溫馨提示網(wǎng)頁形式非藝龍團購訂單詳情-團購券信息-一券一用字段數(shù)據(jù)僅供演示非藝龍團購訂單詳情-團購券信息-一券多用字段數(shù)據(jù)僅供演示藝龍團購訂單詳情字段數(shù)據(jù)僅供演示藝龍團購訂單詳情-團購券信息-一券一用字段數(shù)據(jù)僅供演示藝龍團購訂單詳情-團購包含項目網(wǎng)頁形式藝龍團購訂單詳情-團購券信息-商家信息字段數(shù)據(jù)僅供演示頁面處理規(guī)則團購券一券一用是指一個團購訂單N個商品，生成N個團購券，每個團購券可到商家驗證一次；一券多用是指一個團購訂單N個商品，生成1個團購券，此團購券可到商家驗證N次藝龍團購訂單不存在一券多用的情況，都是一券一用；非藝龍團購訂單是一券一用和一券多用共存，其中一券一用又分為自營商品團購券（有券號無密碼）、供應(yīng)商團購券（一券號對應(yīng)多密碼）只有支付完成的團購訂單才會有團購券信息的入口非藝龍團購訂單中“供應(yīng)商來源“若為“窩窩團”，則一券一用的“券號碼”取接口中“供應(yīng)商訂單編號”字段的返回值一券一用在訂單詳情接口返回的是券系統(tǒng)狀態(tài)，客戶端需要進(jìn)行封裝，便于用戶理解（先判斷訂單類型，再判斷券類型）非藝龍訂單一券一用的券系統(tǒng)狀態(tài)有9種返回值與券狀態(tài)的對應(yīng)關(guān)系如下：（0）未生成（1）待生效（未成團前）（2）已生效（已成團）（3）已過期（4）已使用（5）待退款（6）已退款（7）使用退款中（8）使用退款完成處理規(guī)則如下：當(dāng)返回值為0、1時，頁面不展示券為2時，券狀態(tài)展示為未使用為3時，券狀態(tài)展示為已過期為4時，券狀態(tài)展示為已使用為5、6、7、8時：券狀態(tài)展示為已作廢藝龍訂單一券一用的券系統(tǒng)狀態(tài)有6種，返回值與狀態(tài)的對應(yīng)關(guān)系如下：（0）待生效（1）未使用（2）已使用（3）已失效（4）已作廢（5）已退款處理規(guī)則如下：當(dāng)返回值為0時，頁面不展示券為1時，券狀態(tài)展示為未使用為2時，券狀態(tài)展示為已使用為3時，券狀態(tài)展示為已過期（PC是處理成已失效，一個意思）為4、5時：券狀態(tài)展示為已作廢一券一用和一券多用都會存在訂單已付款而券全部未生成或待生效的情況（很少出現(xiàn)），此時進(jìn)入團購券信息頁面，顯示“團購券還未生效，請等待”酒店團購訂單中商家信息的電話號碼，點擊之后可以選擇撥號點擊項目名稱進(jìn)入對應(yīng)的團購詳情頁關(guān)聯(lián)改造說明接口說明編號接口名稱接口描述團購訂單詳情接口查詢團購訂單詳情團購訂單管理訂單取消功能需求描述核心流程及規(guī)則流程圖流程描述客戶端在訂單詳情界面根據(jù)訂單狀態(tài)進(jìn)行展示處理，具體如下若團購訂單詳情接口返回的訂單狀態(tài)為等待付款，則展示“取消“按鈕用戶點擊“取消“按鈕客戶端調(diào)用團購訂單取消接口申請關(guān)閉訂單團購系統(tǒng)進(jìn)行訂單檢查、訂單關(guān)閉，完畢后將處理結(jié)果返回給客戶端客戶端接收處理結(jié)果，若處理結(jié)果為成功，則提示用戶訂單取消成功，并返回訂單列表界面，重新調(diào)用訂單列表接口更新訂單狀態(tài)；若失敗，則直接展示接口返回的錯誤描述（詳見3.7章節(jié)）規(guī)則描述本章節(jié)中由于客戶端自身原因?qū)е碌膱箦e統(tǒng)一提示為“網(wǎng)絡(luò)調(diào)用異常，請稍后再試“；當(dāng)接口返回的處理結(jié)果為失敗時，客戶端直接展示錯誤描述，無需根據(jù)錯誤碼進(jìn)行報錯提示（見3.7章節(jié)）頁面原型及說明11編號名稱描述訂單取消界面字段數(shù)據(jù)僅供演示頁面處理規(guī)則用戶點擊取消按鈕后，客戶端需彈出提示框供用戶確認(rèn)，見上圖關(guān)聯(lián)改造說明接口說明編號接口名稱接口描述團購訂單取消接口申請關(guān)閉團購訂單訂單二次支付功能需求描述核心流程及規(guī)則流程圖流程描述客戶端在訂單詳情界面根據(jù)訂單狀態(tài)進(jìn)行展示處理，具體如下若團購訂單詳情接口返回的訂單狀態(tài)為等待付款，則展示“付款“按鈕用戶點擊“付款“按鈕客戶端展示支付方式選擇界面（無需調(diào)用接口，直接通關(guān)）用戶選擇支付方式確認(rèn)支付走正常支付流程（見3.4章節(jié)）規(guī)則描述本章節(jié)中由于客戶端自身原因?qū)е碌膱箦e統(tǒng)一提示為“網(wǎng)絡(luò)調(diào)用異常，請稍后再試“；當(dāng)接口返回的處理結(jié)果為失敗時，客戶端直接展示錯誤描述，無需根據(jù)錯誤碼進(jìn)行報錯提示（見3.7章節(jié)）1頁面原型及說明1編號名稱描述訂單二次支付界面字段數(shù)據(jù)僅供演示頁面處理規(guī)則關(guān)聯(lián)改造說明接口說明編號接口名稱接口描述無需調(diào)用接口訂單退款功能需求描述核心流程及規(guī)則流程圖流程描述客戶端在團購券詳情界面根據(jù)訂單詳情接口返回值進(jìn)行展示處理，具體如下：先判斷訂單中的團購產(chǎn)品是否支持未消費退款，若是，再判斷團購券是一券一用還是一券多用若為一券一用，接著判斷團購券的狀態(tài)是否為“未使用”（判斷到每一行），若是，則退款復(fù)選框可選擇，反之則不可選若為一券多用，接著判斷團購券的“未使用數(shù)”是否大于0，若是，則展示退款按鈕，反之則不展示用戶選擇團購券，點擊“退款“按鈕，客戶端展示退款申請界面一券一用的退款申請是先勾選團購券再點擊退款按鈕，一券多用是直接點擊退款按鈕，兩者的退款申請界面也有細(xì)微差別，詳見頁面原型用戶選擇退款原因，確認(rèn)退款一券多用的退款還需輸入退款數(shù)量，退款數(shù)量的處理規(guī)則如下：設(shè)團購券的“未使用數(shù)”為A，當(dāng)A小于5時，單次可退款數(shù)等于A；當(dāng)A大于等于5時，單次可退款數(shù)等于5客戶端對退款數(shù)量輸入框進(jìn)行以下限制：默認(rèn)值為1，程序控制只能輸入一位數(shù)字，不可輸入其他字符，若輸入0則修改成1，若超過單次可退款數(shù)則修改為單次可退款數(shù)客戶端調(diào)用團購訂單退款接口申請退款團購系統(tǒng)進(jìn)行訂單檢查，若通過則將退款請求提交到易付寶（不通過的報錯見3.7章節(jié)）易付寶檢查退款信息，創(chuàng)建退款訂單，將退款受理結(jié)果返回給團購系統(tǒng)，團購系統(tǒng)再返回給客戶端客戶端接收退款受理結(jié)果，若處理結(jié)果為成功，則提示用戶“退款申請成功，請等待退款：易付寶付款1個工作日到賬，網(wǎng)銀或信用卡3-15個工作日到賬”，并返回訂單列表界面，重新調(diào)用訂單列表接口更新訂單狀態(tài)；若失敗，則直接展示接口返回的錯誤描述（詳見3.7章節(jié)）規(guī)則描述藝龍團購不支持用戶在線退款、不支持過期自動退款，只能電話退款（系統(tǒng)邏輯），客戶端團購券詳情中的退款復(fù)選框不可選非藝龍團購的部分產(chǎn)品支持未消費退款及過期自動退款，在團購產(chǎn)品詳情接口和訂單詳情接口中返回了對應(yīng)標(biāo)示本章節(jié)中由于客戶端自身原因?qū)е碌膱箦e統(tǒng)一提示為“網(wǎng)絡(luò)調(diào)用異常，請稍后再試“；當(dāng)接口返回的處理結(jié)果為失敗時，客戶端直接展示錯誤描述，無需根據(jù)錯誤碼進(jìn)行報錯提示（見3.7章節(jié)）頁面原型及說明21214343編號名稱描述非藝龍團購訂單詳情-團購券信息-一券一用字段數(shù)據(jù)僅供演示非藝龍團購訂單詳情-團購券信息-一券一用退款申請界面字段數(shù)據(jù)僅供演示非藝龍團購訂單詳情-團購券信息-一券多用字段數(shù)據(jù)僅供演示非藝龍團購訂單詳情-團購券信息-一券多用退款申請界面字段數(shù)據(jù)僅供演示頁面處理規(guī)則一券一用和一券多用退款申請界面的退款原因默認(rèn)選中“現(xiàn)在不想買了”，還可選擇“商品價格高”、“錯誤或者重復(fù)下單”、“其他原因”退款申請界面中的退款金額由客戶端根據(jù)產(chǎn)品單價和退款數(shù)量計算