YKY管理平臺開發(fā)文檔

1、YKY管理后臺開發(fā)文檔機構(gòu)管理菜單目錄結(jié)構(gòu)：機構(gòu)管理機構(gòu)資料錄入機構(gòu)資料查詢功能實現(xiàn)：機構(gòu)資料錄入：頁面錄入以下信息，機構(gòu)編號、機構(gòu)名稱、法人姓名、法人手機號碼、地區(qū)、經(jīng)營地址、營業(yè)執(zhí)照號、法人身份證號、常用郵箱、賬戶姓名、賬戶號、開戶行、聯(lián)行號、法人身份證正反面照、法人手持身份證半身照、銀行卡正反面照、營業(yè)執(zhí)照照片、稅務(wù)登記證照片、組織機構(gòu)代碼證照片、開戶證明、是否OEM機構(gòu)、機構(gòu)logo上傳；（紅色為必填，以下不再表述）代理商編號：固定3位，先從表中獲取最大機構(gòu)號，加1顯示，該字段可人為修改；地區(qū)：獲取地區(qū)表省字段，下拉列表顯示；聯(lián)行號：聯(lián)行號文本框后頭跟一個link,選擇聯(lián)行號，點擊彈出

2、懸浮窗,根據(jù)清算銀行，支行進行模糊查詢，加載相應(yīng)聯(lián)行號，選中某個聯(lián)行號，點擊確定，關(guān)閉懸浮窗，對應(yīng)聯(lián)行號顯示在文本框內(nèi)，支行名稱出現(xiàn)在開戶行全程內(nèi)；所有照片，上傳后，統(tǒng)一放在以機構(gòu)編號新建的文件夾內(nèi)，上傳完畢，頁面需顯示縮略圖；狀態(tài)：默認0;進件日期：默認系統(tǒng)時間進件用戶Id:當前登陸用戶Id;最后修改UID:當前登錄用戶Id;最后修改時間：默認系統(tǒng)時間；（所有表操作如果有以上兩個字段，每次update操作，都需要更新著兩個字段，以下不再表述）代理商管理菜單目錄結(jié)構(gòu)：代理商管理代理商資料錄入代理商資料審核代理商資料查詢功能實現(xiàn)：代理商資料錄入：頁面錄入以下信息，代理商編號、代理商名稱、運營商編

3、號、代理級別、上級代理編號、法人姓名、法人手機號碼、地區(qū)、經(jīng)營地址、營業(yè)執(zhí)照號、法人身份證號、常用郵箱、賬戶姓名、賬戶號、開戶行、聯(lián)行號、法人身份證正反面照、法人手持身份證半身照、銀行卡正反面照、營業(yè)執(zhí)照照片、稅務(wù)登記證照片、組織機構(gòu)代碼證照片、是否OTO代理、開戶證明；代理商編號：固定3位，先從表中獲取最大機構(gòu)號，加1顯示，該字段可人為修改；地區(qū)：獲取地區(qū)表省字段，下拉列表顯示；聯(lián)行號：聯(lián)行號文本框后頭跟一個link,選擇聯(lián)行號，點擊彈出懸浮窗,根據(jù)清算銀行，支行進行模糊查詢，加載相應(yīng)聯(lián)行號，選中某個聯(lián)行號，點擊確定，關(guān)閉懸浮窗，對應(yīng)聯(lián)行號顯示在文本框內(nèi)，支行名稱出現(xiàn)在開戶行全程內(nèi)；所有照片

4、，上傳后，統(tǒng)一放在以代理商編號新建的文件夾內(nèi)，上傳完畢，頁面需顯示縮略圖；OTO代理：可分配一個卡bin，固定6位數(shù)字，以9開頭；狀態(tài)：默認0;進件日期：默認系統(tǒng)時間進件用戶Id:當前登陸用戶Id;代理商資料審核：點擊默認顯示agentStat=0的代理商列表信息，抬頭如下；序號、代理商ID、代理商名稱、法人、手機號、所屬區(qū)域、狀態(tài)、錄入時間、查看詳情點擊查看詳情，進入詳情頁面，將代理商信息全部顯示出來;最下端添加兩個功能按鈕，一個審核通過，一個審核駁回；審核通過：狀態(tài)字段agentStat為2,審核用戶Id:當前登陸用戶Id;審核通過日期：當期系統(tǒng)日期；跳入分配后臺用戶界面分配userid,

5、分配費率；審核駁回：agentStat為1;審核用戶Id：當前登陸用戶Id;審核通過日期：當期系統(tǒng)日期；當前頁面關(guān)閉，顯示待審核代理商列表；審核通過，配置費率代理商資料查詢：查詢條件字段為，代理商ID、代理商名稱、法人姓名、狀態(tài)、錄入時間、所屬地區(qū)；查詢結(jié)果顯示字段為：序號、代理商ID、代理商名稱、法人、手機號、所屬區(qū)域、狀態(tài)、錄入時間、查看詳情點擊查看詳情，進入詳情頁面，將代理商信息全部顯示出來；具有相應(yīng)修改/刪除權(quán)限的用戶，可選中某條記錄，點擊修改按鈕，進入修改頁面；點擊刪除，彈出確認刪除對話框；商戶管理菜單目錄結(jié)構(gòu)：商戶管理商戶進件申請商戶進件審核商戶清算變更商戶查詢終端查詢功能實現(xiàn)：商

6、戶進件申請：頁面錄入以下信息，商戶號、代理商編號、地區(qū)ID、MCC碼、法人姓名、法人手機號碼、商戶名稱、經(jīng)營地址、經(jīng)營范圍、營業(yè)執(zhí)照號、法人身份證號、常用郵箱、賬戶姓名、賬戶號、開戶行、聯(lián)行號、清算標志、法人身份證正反面照、法人手持身份證半身照、銀行卡正反面照、營業(yè)執(zhí)照照片、稅務(wù)登記證照片、組織機構(gòu)代碼證照片、門頭照片、內(nèi)景照片、是否OTO商戶、開戶證明；以及終端信息包括：終端號、終端名稱（小票名）、聯(lián)系人姓名、聯(lián)系人手機號碼、地址；一個商戶可申請多個終端，最少一個；商戶號生成規(guī)則：固定15位，3位代理商編號+4位地區(qū)碼+4位MCC碼+4位順序終端號生產(chǎn)規(guī)則：3位代理商編號+5位順序位OTO商

7、戶，終端可增加最多兩名收銀員，輸入會員卡號；（后期可修改來完善）代理商編號：獲取當前登陸用戶所屬代理商編號，賦給商戶號頭三位；地區(qū)碼：獲取地區(qū)表字段，下拉列表顯示，將所選地區(qū)4位地區(qū)碼賦值給商戶號第3-7位；MCC碼：獲取MCC碼表字段，下拉列表顯示，將所選行業(yè)MCC碼賦值給商戶號第8-12位；選定MCC碼的同時，將對應(yīng)手續(xù)費扣率記入商戶扣率當做默認推薦扣率保存；聯(lián)行號：聯(lián)行號文本框后頭跟一個link,選擇聯(lián)行號，點擊彈出懸浮窗,根據(jù)清算銀行，支行進行模糊查詢，加載相應(yīng)聯(lián)行號，選中某個聯(lián)行號，點擊確定，關(guān)閉懸浮窗，對應(yīng)聯(lián)行號顯示在文本框內(nèi)，支行名稱出現(xiàn)在開戶行全程內(nèi)；所有照片，上傳后，統(tǒng)一放在

8、以商戶號新建的文件夾內(nèi)，上傳完畢，頁面需顯示縮略圖；OTO商戶，需選擇積分規(guī)則、設(shè)置凍結(jié)金額、業(yè)務(wù)員姓名等；狀態(tài)：默認0;進件日期：默認系統(tǒng)時間進件用戶Id:當前登陸用戶Id;商戶進件審核：點擊默認顯示merStat=0的代理商列表信息，抬頭如下；序號、代理商編號、商戶號、商戶名稱、法人、手機號、所屬區(qū)域、狀態(tài)、錄入時間、查看詳情點擊查看詳情，進入詳情頁面，將商戶信息全部顯示出來；最下端添加兩個功能按鈕，一個審核通過，一個審核駁回；配置費率：默認顯示MCC對應(yīng)費率，根據(jù)簽約實際費率進行配置；選擇風控規(guī)則：獲取風控規(guī)則表(risk_regular_info)信息，下拉列表顯示；配置交易類型：復選

9、框顯示銀行卡功能、會員卡功能、支付寶功能；分配渠道：默認點對點類型，點擊選擇彈出懸浮窗，加載同地區(qū)商戶渠道信息，支持模糊查詢，查找對應(yīng)渠道商戶終端，選定將主鍵ID賦值給商戶表的chId字段;分配用戶：默認商戶號作為登陸賬號，密碼默認1234qwer,角色默認商戶；審核通過：狀態(tài)字段merStat為2,審核用戶Id:當前登陸用戶Id;審核通過日期：當期系統(tǒng)日期；審核駁回：merStat為1;審核用戶Id:當前登陸用戶Id;審核通過日期：當期系統(tǒng)日期；當前頁面關(guān)閉，顯示待審核商戶列表；商戶清算變更：查詢條件：商戶號、終端號；顯示信息：該商戶清算標志、簽約費率、開戶行名稱、開戶行行號、賬戶姓名、賬戶

10、號；可對以上信息進行修改；商戶查詢：查詢條件：商戶號、終端號、所屬區(qū)域、錄入時間、審核狀態(tài)、商戶名稱查詢結(jié)果顯示字段為：序號、商戶號、商戶名稱、法人、手機號、所屬區(qū)域、商戶狀態(tài)、錄入時間、查看詳情點擊查看詳情，進入詳情頁面，將商戶信息全部顯示出來；具有相應(yīng)修改權(quán)限的用戶，可選中某條記錄，點擊修改按鈕，進入修改頁面；修改界面，只能修改基本信息，不包含商戶清算信息（簽約費率、清算銀行、清算賬戶等）；終端查詢：查詢條件：終端號、聯(lián)系人、終端狀態(tài)查詢結(jié)果顯示字段為：序號、商戶號、終端號、小票抬頭、聯(lián)系人、手機號、終端狀態(tài)、錄入時間、查看詳情點擊查看詳情，進入詳情頁面，將終端信息全部顯示出來；具有相應(yīng)修

11、改權(quán)限的用戶，可選中某條記錄，點擊修改按鈕，進入修改頁面;渠道管理菜單目錄結(jié)構(gòu)：渠道管理渠道地址管理渠道商戶管理渠道費率管理功能實現(xiàn)：渠道地址管理：點擊默認顯示所有渠道地址信息，字段如下：序號、渠道名稱、IP地址、端口、TPDU、HEADER、機構(gòu)號、渠道狀態(tài)、渠道密鑰、開通日期；根據(jù)登陸用戶權(quán)限，顯示功能按鈕（新增、修改）點擊新增，彈出新增窗口，錄入信息如下：渠道名稱、IP地址、端口、TPDU、HEADER、機構(gòu)號、渠道密鑰；點擊修改，可對以上信息包括渠道狀態(tài)進行修改；渠道商戶管理：查詢字段：渠道商戶號、渠道終端號、代理商、地區(qū)；點擊默認顯示所有渠道商戶信息，字段如下：序號、渠道商戶名稱、渠

12、道商戶號、渠道終端號、渠道批次號、渠道流水號、渠道狀態(tài)、渠道類型、開通日期、詳細信息；點擊詳細，顯示以上信息外加所屬地址、所屬代理商、地區(qū)Id、資金池；根據(jù)登陸用戶權(quán)限，顯示功能按鈕（新增、修改、批量導入），點擊新增，彈出新增窗口，錄入信息如下：渠道商戶名稱、渠道商戶號、渠道終端號、終端主密鑰、渠道類型、選擇渠道費率、選擇代理商、選擇地區(qū)；點擊修改，可對以上信息包括渠道狀態(tài)進行修改；渠道費率管理：點擊默認顯示所有渠道費率信息，字段如下：序號、費率名稱、費率類型、費率點數(shù)、封頂金額、錄入日期；根據(jù)登陸用戶權(quán)限，顯示功能按鈕（新增、修改、刪除），點擊新增，彈出新增窗口，錄入信息如下：費率名稱、費率

13、類型、費率點數(shù)、封頂金額、錄入日期；點擊修改，可對以上信息進行修改；點擊刪除，刪除相應(yīng)費率；機具管理菜單目錄結(jié)構(gòu)：機具管理機具型號管理機具入庫機具查詢功能實現(xiàn)：機具型號管理：點擊默認顯示所有機具型號信息，字段如下：序號、品牌名稱、型號、類型、備注、錄入日期；根據(jù)登陸用戶權(quán)限，顯示功能按鈕(新增、修改、刪除)，點擊新增，彈出新增窗口，下拉選擇品牌名稱、型號、類型、備注；點擊修改，可對以上信息進行修改；點擊刪除，刪除相應(yīng)機型；機具入庫：錄入進貨批次信息：進貨批次號、下拉選擇品牌、下拉選擇型號、下拉選擇入網(wǎng)類型、數(shù)量、進貨單價、進貨總價；進貨批次號生產(chǎn)規(guī)則，默認顯示8位當前日期+2位順序位；整理機具

14、SN號，制作txt或者excel文件，txt格式為批次號，機具SN號中間以逗號分割，將改文件導入，插入device_info,其余字段給默認值；機具查詢：操作表名(device_info);查詢條件：品牌、型號、機具SN號、機具狀態(tài)、終端號；顯示信息如下：品牌、型號、類型、SN號、所屬代理商、狀態(tài)、錄入時期、終端號、綁定日期當狀態(tài)為已綁定時，終端號跟綁定日期有值，且點擊終端號，鏈接至終端詳細信息;交易管理菜單目錄結(jié)構(gòu):交易管理當前交易查詢歷史交易查詢交易匯總查詢功能實現(xiàn)：當前交易查詢:查詢條件：起始日期、結(jié)束日期、交易類型、手機號、會員姓名、交易金額、會員號、交易狀態(tài)、商戶號、終端號、流水號、

15、卡號顯示信息：交易日期、交易時間、商戶、終端號、流水號、消費類型、卡號、會員姓名、手機全交易金額、交易狀態(tài)、應(yīng)答碼、詳細點擊詳細，進入交易詳情界面；點擊手機號,進入會員詳細信息界面;點擊商戶，進入商戶詳細信息界面；歷史交易查詢：查詢條件：交易日期、交易類型、手機號、會員姓名、交易金額、會員號、交易狀態(tài)、商戶號、終端號、流水號、卡號此處，先考慮一張歷史表，根據(jù)實際數(shù)據(jù)量，來進行分表處理，如果有分表出現(xiàn),時，查詢條件，需先選擇過往年份或月份；顯示信息：交易日期、交易時間、商戶、終端號、流水號、消費類型、卡號、會員姓名、手機宣、交易金額、交易狀態(tài)、消費類型、詳細點擊詳細，進入交易詳情界面；點擊手機號

16、,進入會員詳細信息界面;點擊商戶，進入商戶詳細信息界面；交易匯總查詢：批處理：每天凌晨1點，對前一天交易數(shù)據(jù)進行統(tǒng)計匯總，將匯總信息錄入?yún)R總表；查詢條件：交易日期、交易類型、代理商、商戶號、終端號（商戶角色登入時）顯示信息：序號、匯總?cè)掌?、代理商、商戶號、終端號（商戶角色顯示）、交易類別、交易筆數(shù)、交易金額、交易積分、手續(xù)費、結(jié)算金額、分潤金額;差錯管理菜單目錄結(jié)構(gòu)：差錯管理差錯交易查詢調(diào)單申請調(diào)單審核功能實現(xiàn)：當前交易查詢：查詢條件：對賬日期、代理商、商戶號、終端號、狀態(tài)顯示信息：序號、對賬日期、差錯類別、交易日期、交易時間、代理商編號、商戶號、終端號、流水號、批次號、卡號、交易金額、處理狀

17、態(tài)、操作（處理完成）；清算人員根據(jù)實際處理情況，可對某條不平記錄進行狀態(tài)更改操作；調(diào)單申請：錄入信息：交易日期、代理商、商戶號、終端號、流水號、檢索參考號、交易金額、卡號、最晚期限、申請類型、發(fā)起方、上傳憑證、備注；錄入時，自動去匹配交易流水表，更改patchStat;調(diào)單審核：查詢條件：代理商、商戶號、終端號、發(fā)起方、發(fā)起類型、交易日期、卡號、檢索參考號、批處理狀態(tài)；默認顯示，調(diào)單申請狀態(tài)的記錄；序號、機構(gòu)號、商戶號、終端號、卡號、交易金額、交易時間、檢索參考號、最晚處理期限、發(fā)起方、發(fā)起類型、調(diào)單狀態(tài)、批處理狀態(tài)、操作點擊操作，進入詳情操作頁面，顯示調(diào)單詳細信息，可對該條記錄進行審核駁回、

18、審核通過待確認、確認通過等操作；會員卡管理菜單目錄結(jié)構(gòu)：會員卡管理卡Bin查詢制卡申請制卡審核卡庫存管理推廣員領(lǐng)卡錄入推廣員退卡受理會員卡查詢批量充值功能實現(xiàn)：卡BIN查詢：輸入卡bin,查詢對應(yīng)卡bin運營商信息;制卡申請：輸入元素：選擇卡名稱、代理商、選擇卡種類、制卡數(shù)量、制卡批次、起始卡號、結(jié)束卡號、卡有效期、服務(wù)碼、制卡序號；新增時根據(jù)卡機構(gòu)需要取到卡bin號；須先判斷卡bin+卡種類+制卡批次在表中不存在；需要校驗結(jié)束卡號-起始卡號=制卡數(shù)量、卡有效期需要大于當前日期；服務(wù)碼固定填500;制卡序號，前11固定為RY+yyMM+機構(gòu)Id+批次(RY141100101)后5位為00001

19、累加；申請狀態(tài)為0;制卡審核：更改審核狀態(tài)，通過后，出現(xiàn)“生成制卡文件”按鈕；生成卡號、二磁道、密碼等數(shù)據(jù)，插入card_info表的同時，生成制卡文件;制卡文件生成好后，以zip格式提示下載；卡號生成規(guī)則：6位卡bin+4位卡種類+2位批次+6位起始卡號+1位校驗位9020010001010000013校驗位算法為Luhn模10“隔位2倍加”的計算公式；二磁道生成規(guī)則：;卡號=有效期+服務(wù)碼+補0?除去起始位總共37位;9020010001000000013=15055000000000000?制卡文件格式：制卡序號|卡號|密碼|有效期|二磁道信息|RY14110010100001|9020

20、010001000000013|123456|1505|;9020010001000000012=15055000000000000?|插入card_info時，密碼跟二磁道信息采用MD5加密，二磁道加密數(shù)據(jù)去除首尾符號；狀態(tài)初始值為1未啟用；卡庫存管理：每天凌晨對前一天卡數(shù)據(jù)進行統(tǒng)計，將統(tǒng)計數(shù)據(jù)記錄在card_total_info中；顯示卡庫存表信息：序號、統(tǒng)計日期、卡總數(shù)、未啟用總數(shù)、出庫未激活數(shù)、激活卡總數(shù)、凍結(jié)卡總數(shù)、掛失卡總數(shù)；推廣員領(lǐng)卡受理：錄入信息：代理商、會員Id（手機號）、數(shù)量、卡號前9位、起始卡號、結(jié)束卡號;推廣員前提是平臺會員；領(lǐng)用類別為推廣員，狀態(tài)置為0,領(lǐng)卡日期默認當

21、前；將推廣員會員Id賦值給分配卡號段的extMemberId字段；推廣員退卡受理輸入起始卡號、結(jié)束卡號、數(shù)量；將該批卡原本設(shè)置的推廣員Id置為空;會員卡查詢：查詢條件：選擇卡機構(gòu)、卡號;顯示卡號詳細信息；會員卡批量充值：輸入起始卡號、結(jié)束卡號、數(shù)量、充值金額;可在未啟用狀態(tài)進行批量充值；會員管理菜單目錄結(jié)構(gòu)：會員管理（后臺）會員查詢會員等級設(shè)置功能實現(xiàn)：后臺功能：會員查詢：查詢條件：手機號碼，會員卡號，會員等級、消費金額區(qū)間、積分余額區(qū)間、性別等；顯示信息：序號、手機號、姓名、卡號、會員等級、會員類型、會員狀態(tài)，詳細信點擊詳細，顯示會員詳細資料；會員等級設(shè)置：對該表進行新增、修改、刪除的操作；

22、營銷管理菜單目錄結(jié)構(gòu)：營銷管理活動設(shè)置優(yōu)惠券設(shè)置功能實現(xiàn)：活動設(shè)置：默認顯示登陸用戶角色的活動列表：顯示信息：門店名|活動標題|起始時間|結(jié)束時間|活動說明工具欄有新增、修改、刪除的操作新增輸入元素：商戶發(fā)起：商戶號、活動標題、活動說明、選擇門店、活動起始時間、活動結(jié)束時間、輸入優(yōu)惠彳息（操作favour_info）;代理商發(fā)起：代理商編號，活動標題、活動說明、活動起始時間、活動結(jié)束時間、輸入優(yōu)惠信息（操作favour_info）;一個活動可能包含多條優(yōu)惠信息；優(yōu)惠券設(shè)置：默認顯示該商戶優(yōu)惠券列表：顯示信息：優(yōu)惠券名稱|券類型|有效期|面值|是否支持前臺領(lǐng)取工具欄有新增、修改、刪除的操作新增輸

23、入元素：商戶號、優(yōu)惠券名稱、券類型、數(shù)量、面值、有效期、券使用類型、適用門店、使用條件、是否支持前臺領(lǐng)??；當券使用類型為所有時，適用門店字段為空，當為部分門店時，需加載所屬門店，參與活動的終端號以|符號進行間隔保存；當插入coupon_info成功后，根據(jù)優(yōu)惠券數(shù)量，插入相應(yīng)數(shù)量記錄至sub_coupon_info中個，couponN。的編碼規(guī)則為，2位年份+2位媒質(zhì)種類+商戶號末4位+6位順序位紙質(zhì)為01,電子券為02，如14540101000001總共14位清算管理菜單目錄結(jié)構(gòu)：交易管理銀聯(lián)渠道對賬基礎(chǔ)費率設(shè)置清算報表下載提現(xiàn)申請功能實現(xiàn)：銀聯(lián)渠道對賬：導入銀聯(lián)對賬文件，解析對賬文件，跟數(shù)

24、據(jù)庫流水進行比較，如果平，交易流水對賬標志位checkStatus=2，不平checkStatus=1,長款情況（渠道有本地無），將該條記錄插入對賬信息表中，標志為長款情況；短款情況（渠道無本地有），將該條記錄插入對賬信息表中，標志為短款情況；此處以銀聯(lián)渠道為例，實際根據(jù)上游渠道來解析對賬文件，流程不變;基礎(chǔ)費率設(shè)置:待定清算報表下載：輸入元素：清算日期，代理商編號，商戶號顯示信息：序號，代理商編號，商戶號，交易筆數(shù)，交易金額，手續(xù)費，結(jié)算金額，賬戶名,賬號，聯(lián)行號，開戶行，明細對賬操作后，統(tǒng)計對賬平的記錄；可對查詢信息進行excel導出；點擊明細，進入商戶交易明細查詢;提現(xiàn)申請：默認顯示當前待提現(xiàn)申請信息；查詢條件：提現(xiàn)日期，類型，角色，狀態(tài);顯示信息：序號，提現(xiàn)日期，類型，提現(xiàn)角色，提現(xiàn)金額，狀態(tài)，賬戶名，開戶行