統(tǒng)一充值平臺與支撐系統(tǒng)接口分冊V1

1、中國電信企業(yè)標準統(tǒng)一充值平臺與支撐系統(tǒng)接口分冊版本號：1.0前 言本技術(shù)方案為中國電信統(tǒng)一充值平臺方案設(shè)計和實施的指導(dǎo)性文件，規(guī)定了中國電信統(tǒng)一充值平臺的相關(guān)內(nèi)容，包括：總體框架、業(yè)務(wù)目標、業(yè)務(wù)場景、業(yè)務(wù)功能、業(yè)務(wù)流程、相關(guān)規(guī)則、路由方案、接口、系統(tǒng)的實施與升級等方面。本文檔用于提供中國電信統(tǒng)一充值平臺建設(shè)在業(yè)務(wù)、技術(shù)方面的指導(dǎo)。本技術(shù)方案由中國電信股份有限公司提出并歸口。本方案起草單位： 中國電信股份有限公司廣州研究院本方案主要起草人： 張少明 池煒成 朱明英 薛彩霞 劉敬東 牟巍本方案解釋單位： 中國電信集團企業(yè)信息化部目 錄第1章自服務(wù)平臺接入接口51.1充值51.1.1接口定義51.1

2、.2請求參數(shù)51.1.3響應(yīng)參數(shù)61.2充值記錄查詢71.2.1接口定義71.2.2請求參數(shù)71.2.3響應(yīng)參數(shù)71.3余額查詢81.3.1接口定義81.3.2請求參數(shù)81.3.3響應(yīng)參數(shù)9第2章與HB/OCS充值處理接口92.1充值92.1.1接口定義92.1.2請求參數(shù)102.1.3應(yīng)答參數(shù)102.2余額查詢112.2.1接口定義112.2.2請求參數(shù)112.2.3響應(yīng)參數(shù)112.3充值交易沖正122.3.1接口定義122.3.2請求參數(shù)122.3.3響應(yīng)參數(shù)12第3章與CRM處理接口133.1用戶驗證接口133.1.1接口定義133.1.2請求參數(shù)133.1.3響應(yīng)參數(shù)133.2資料更新

3、請求接口143.2.1接口定義143.2.2請求參數(shù)143.2.3響應(yīng)參數(shù)143.3卡信息查詢接口153.3.1接口定義153.3.2請求參數(shù)153.3.3響應(yīng)參數(shù)153.4充值記錄查詢163.4.1接口定義163.4.2請求參數(shù)163.4.3響應(yīng)參數(shù)163.5充值173.5.1接口定義173.5.2請求參數(shù)173.5.3響應(yīng)參數(shù)183.6卡管理接口193.6.1接口定義193.6.2請求參數(shù)193.6.3響應(yīng)參數(shù)193.7解除風險控制名單接口203.7.1接口定義203.7.2請求參數(shù)203.7.3響應(yīng)參數(shù)20第4章與SID間的TUXEDO接口224.1接口描述224.2TUXEDO實現(xiàn)概述

4、224.3服務(wù)說明224.3.1資料同步接口23第5章附錄255.1自服務(wù)平臺接口WSDL255.2OCS/HB 服務(wù)接口WSDL255.3VC與CRM接口WSDL25第1章 自服務(wù)平臺接入接口所有字段都必須出現(xiàn)，當出現(xiàn)不適用的情況時，INT型字段填0，STRING型字段，填“NA”。用戶號碼字段，固網(wǎng)和小靈通用戶為帶0區(qū)號不帶86的用戶號碼，3G用戶的用戶號碼前不帶區(qū)號和0。流水號編碼規(guī)則：YYYYMMDDHHMMSS+8位循環(huán)數(shù)字+2位數(shù)字各省自用+2位VC平臺編號。1.1 充值1.1.1 接口定義接口名稱 recharge接口描述自服務(wù)平臺請求充值請求消息名FillInfoReq應(yīng)答消息

5、名FillInfoResp接口方式Webservice主要使用者自服務(wù)平臺1.1.2 請求參數(shù)名稱說明數(shù)據(jù)類型RequestSource自服務(wù)平臺標識或IP地址StringRequestUser用戶如果登錄填寫登錄用戶名，未登錄填寫請求用戶IPStringRequestId請求流水StringRequestTime請求時間，YYYYMMDDHHMMSSStringOperationCode請求類型：0普通充值；1批量充值；2卡分拆充值IntAccessType充值接入途徑（1：IVR； 2：SMS； 3： 網(wǎng)上營業(yè)廳即WEB方式；4：WAP；5：USSD；6：CRM）IntRequestAmo

6、unt充值請求記錄數(shù) （普通充值、卡分拆充值時RequestAmount=1;分批充值時RequestAmount!=1參數(shù)組會多次出現(xiàn)）Int*Recharge-Item充值項，一個充值請求可以有多個充值項GroupedCardPin充值卡密碼（18位）StringSubId子流水號（分拆/分批充值時此項必填YYYYMMDD+8位循環(huán)數(shù)字+2位各省自用+99(固定值)StringRequestAmount充值請求記錄數(shù)；普通充值時RequestAmount =1；分拆充值時RequestAmount!=1參數(shù)組會多次出現(xiàn)Int*SubRecharge-Item被充值用戶賬號，可同時充多個(即

7、分拆充值)。Grouped Sequence分拆序號（從1開始）IntDestinationId被充值用戶號碼StringDestinationAttr被充值用戶屬性（0-固話;1-小靈通;2-移動；3-ADSL；4-智能公話；5-互聯(lián)星空）IntObjType號碼類型，5BB：客戶；5BC：用戶StringBalanceType余額類型，根據(jù)各地情況分別定義 IntRechargeUnit充值金額單位：0分；1條；IntRechargeAmount充值金額數(shù)量（卡分拆充值時使用，其他情況填缺省值0）Int1.1.3 響應(yīng)參數(shù)名稱說明數(shù)據(jù)類型ResponseId響應(yīng)流水，對應(yīng)請求的Reques

8、tIdStringResponseTime響應(yīng)時間，YYYYMMDDHHMMSSStringOperationCode請求類型：0普通充值；1批量充值；2卡分拆充值IntResponseAmount充值響應(yīng)記錄數(shù)（跟請求相對應(yīng)）Int*Recharge-Item針對每個充值項的響應(yīng)結(jié)果。GroupedSubId子流水號(對應(yīng)請求的子流水號)StringRechargeAmount充值金額(單位：分)IntResult充值結(jié)果（詳見技術(shù)規(guī)范附錄操作結(jié)果定義）IntResponseAmount分拆充值響應(yīng)記錄數(shù)（跟請求相對應(yīng)）Int*SubRecharge-Item多個被充值用戶賬號被充值后返回的

9、結(jié)果信息。GroupedSequence分拆序號（從1開始）Int BalanceUnit余額單位，0分；1條IntBalanceType余額類型，根據(jù)各地情況分別定義 IntBalance余額賬本余額IntEffectiveTime余額生效日期(YYYYMMDD)StringExpirationTime余額失效日期(YYYYMMDD)StringResponseAmount贈送記錄數(shù)Int*Bonus-Item獎勵項，一個充值項可存在多個獎勵項。Grouped BonusUnit贈送金額單位，0分；1條IntBonusBalanceType優(yōu)惠余額類型，根據(jù)各地情況分別定義 IntBonus

10、Amount贈送金額IntStartTime贈送金額起始日期(YYYYMMDD)StringEndTime贈送金額失效日期(YYYYMMDD)String1.2 充值記錄查詢1.2.1 接口定義接口名稱 queryFillRecord接口描述自服務(wù)平臺請求充值記錄查詢請求消息名QueryInfoReq 應(yīng)答消息名QueryInfoResp 接口方式Webservice主要使用者自服務(wù)平臺1.2.2 請求參數(shù)名稱說明數(shù)據(jù)類型RequestSource自服務(wù)平臺標識或IP地址StringRequestUser用戶如果登錄填寫登錄用戶名，未登錄填寫請求用戶IPStringRequestId請求流水S

11、tringRequestTime請求時間，YYYYMMDDHHMMSSStringAccessType充值接入途徑（1：IVR； 2：SMS； 3： 網(wǎng)上營業(yè)廳即WEB方式；4：WAP；5：USSD；6：CRM）IntDestinationId被充值號碼StringDestinationAttr被充值用戶屬性（0-固話;1-小靈通;2-移動；3-ADSL；4-智能公話；5-互聯(lián)星空）IntDestinationIdPin用戶服務(wù)密碼StringStartTime查詢開始時間（YYYYMMDD）StringEndTime查詢結(jié)束時間（YYYYMMDD）String1.2.3 響應(yīng)參數(shù)名稱說明數(shù)據(jù)

12、類型ResponseId響應(yīng)流水，對應(yīng)請求的RequestIdStringResponseTime響應(yīng)時間，YYYYMMDDHHMMSSStringResponseAmount充值響應(yīng)記錄數(shù)（跟請求相對應(yīng)）IntResult操作結(jié)果（詳見技術(shù)規(guī)范附錄操作結(jié)果定義）Int*Recharge-Item充值歷史紀錄項GroupedResult充值結(jié)果（詳見技術(shù)規(guī)范附錄操作結(jié)果定義）IntRechargeUserType充值請求用戶類型（0-固話;1-小靈通;2-移動;3-他網(wǎng)用戶;4-WEB用戶）IntRechargeUser充值發(fā)起用戶標識StringCardNo充值卡卡號StringRechar

13、geTime充值時間(YYYYMMDD)StringRechargeUnit充值金額單位：0分；1條IntRechargeAmount充值金額(單位：分)IntBonusInfo贈送策略描述信息String1.3 余額查詢1.3.1 接口定義接口名稱 accountQuery接口描述自服務(wù)平臺請求帳戶余額查詢請求消息名AccountInfoReq應(yīng)答消息名AccountInfoResp接口方式Webservice主要使用者自服務(wù)平臺1.3.2 請求參數(shù)名稱說明數(shù)據(jù)類型RequestSource自服務(wù)平臺標識或IP地址StringRequestUser用戶如果登錄填寫登錄用戶名，未登錄填寫請求用

14、戶IPStringRequestId請求流水StringRequestTime請求時間，YYYYMMDDHHMMSSStringAccessType充值接入途徑（1：IVR； 2：SMS； 3： 網(wǎng)上營業(yè)廳即WEB方式；4：WAP；5：USSD；6：CRM）IntDestinationId被查詢用戶號碼StringDestinationAttr被查詢用戶屬性（0-固話;1-小靈通;2-移動；3-ADSL；4-智能公話；5-互聯(lián)星空）IntObjType號碼類型，5BB：客戶；5BC：用戶StringDestinationIdPin用戶服務(wù)密碼StringBalanceType余額類型，根據(jù)各地

15、情況分別定義Int1.3.3 響應(yīng)參數(shù)名稱說明數(shù)據(jù)類型ResponseId響應(yīng)流水，對應(yīng)請求的RequestIdStringResponseTime響應(yīng)時間，YYYYMMDDHHMMSSStringResult查詢結(jié)果（詳見技術(shù)規(guī)范附錄操作結(jié)果定義）IntResponseAmount余額查詢響應(yīng)記錄數(shù)（跟請求相對應(yīng)）Int*Query-Item余額查詢紀錄項GroupedBalanceType余額類型，根據(jù)各地情況分別定義IntBalanceUnit余額單位：0分；1條IntBalance余額賬本余額IntEffectiveTime余額生效日期(YYYYMMDD)StringExpiratio

16、nTime余額失效日期(YYYYMMDD)String第2章 與HB/OCS充值處理接口2.1 充值2.1.1 接口定義接口名稱Recharge接口描述充值平臺請求OCS/HB充值請求消息名RechargeRequestRequest應(yīng)答消息名RechargeResponse接口方式Webservice主要使用者充值平臺2.1.2 請求參數(shù)名稱說明數(shù)據(jù)類型RequestId請求流水StringRequestTime請求時間，YYYYMMDDHHMMSSStringDestinationId被充值用戶號碼StringDestinationAttr被充值用戶屬性（0-固話;1-小靈通;2-移動；3

17、-ADSL；4-智能公話；5-互聯(lián)星空）IntObjType號碼類型，5BB：客戶；5BC：用戶StringBalanceType余額類型，根據(jù)各地情況分別定義IntRechargeUnit充值金額單位：0分；1條IntRechargeAmount充值金額IntProlongDays充值延長有效期(天數(shù))IntRequestAmount贈送條數(shù)：當贈送為分月形式時，RequestAmount！1Int*Bonus贈送項，一個充值項可存在多個贈送項。GroupedBalanceType余額類型，根據(jù)各地情況分別定義IntBonusUnit贈送金額單位，0分；1條Int BonusAmount贈送

18、金額Int StartTime贈送有效期起始時間（yyyymmdd）String EndTime贈送有效期終結(jié)時間（yyyymmdd）String2.1.3 應(yīng)答參數(shù)名稱說明數(shù)據(jù)類型ResponseId響應(yīng)流水，對應(yīng)請求的RequestIdStringResponseTime響應(yīng)時間，YYYYMMDDHHMMSSStringResult操作結(jié)果(詳見技術(shù)規(guī)范附錄操作結(jié)果定義)IntBalanceUnit余額單位，0分；1條Int BalanceType余額類型，根據(jù)各地情況分別定義 IntBalance余額賬本余額IntEffectiveTime余額生效日期(YYYYMMDD)StringEx

19、pirationTime余額失效日期(YYYYMMDD)String2.2 余額查詢2.2.1 接口定義接口名稱AccountQuery接口描述充值平臺請求OCS/HB系統(tǒng)請求消息名AccountQueryRequest應(yīng)答消息名AccountQueryResponse接口方式Webservice主要使用者充值平臺2.2.2 請求參數(shù)名稱說明數(shù)據(jù)類型RequestId請求流水StringRequestTime請求時間，YYYYMMDDHHMMSSStringDestinationId被查詢用戶號碼StringDestinationAttr被查詢用戶屬性（0-固話;1-小靈通;2-移動；3-AD

20、SL；4-智能公話；5-互聯(lián)星空）IntObjType號碼類型，5BB：客戶；5BC：用戶StringBalanceType余額類型，根據(jù)各地情況分別定義Int2.2.3 響應(yīng)參數(shù)名稱說明數(shù)據(jù)類型ResponseId響應(yīng)流水，對應(yīng)請求的RequestIdStringResponseTime響應(yīng)時間，YYYYMMDDHHMMSSStringResult操作結(jié)果(詳見技術(shù)規(guī)范附錄操作結(jié)果定義)IntResponseAmount余額查詢響應(yīng)記錄數(shù)（跟請求相對應(yīng)）Int*Query-Item余額查詢紀錄項GroupedBalanceType余額類型，根據(jù)各地情況分別定義IntBalanceUnit余額

21、單位：0分；1條IntBalance余額賬本余額IntEffectiveTime余額生效日期(YYYYMMDD)StringExpirationTime余額失效日期(YYYYMMDD)String2.3 充值交易沖正2.3.1 接口定義接口名稱Refund接口描述充值平臺請求OCS/HB系統(tǒng)請求消息名RefundRequest應(yīng)答消息名RefundResponse接口方式Webservice主要使用者充值平臺2.3.2 請求參數(shù)名稱說明數(shù)據(jù)類型RequestId請求流水StringRequestTime請求時間，YYYYMMDDHHMMSSStringOldRequestId被沖正的充值流水號

22、StringDestinationId被充值用戶號碼StringDestinationAttr被充值用戶屬性（0-固話;1-小靈通;2-移動；3-ADSL；4-智能公話；5-互聯(lián)星空）IntObjType號碼類型，5BB：客戶；5BC：用戶String2.3.3 響應(yīng)參數(shù)名稱說明數(shù)據(jù)類型ResponseId響應(yīng)流水，對應(yīng)請求的RequestIdStringResponseTime響應(yīng)時間，YYYYMMDDHHMMSSStringResult操作結(jié)果(詳見技術(shù)規(guī)范附錄操作結(jié)果定義)Int第3章 與CRM處理接口3.1 用戶驗證接口3.1.1 接口定義接口名稱Authentication接口描述統(tǒng)

23、一充值平臺請求CRM系統(tǒng)請求消息名AuthenticationRequest應(yīng)答消息名AuthenticationResponse接口方式Webservice主要使用者充值系統(tǒng)3.1.2 請求參數(shù)名稱說明數(shù)據(jù)類型RequestId請求流水StringRequestTime請求時間，YYYYMMDDHHMMSSStringDestinationId待驗證用戶號碼StringDestinationAttr待驗證用戶屬性（0-固話;1-小靈通;2-移動；3-ADSL；4-智能公話；5-互聯(lián)星空）IntDestinationIdPin用戶服務(wù)密碼String3.1.3 響應(yīng)參數(shù)名稱說明數(shù)據(jù)類型Resp

24、onseId響應(yīng)流水，對應(yīng)請求的RequestIdStringResponseTime響應(yīng)時間，YYYYMMDDHHMMSSStringResult驗證結(jié)果(詳見技術(shù)規(guī)范附錄操作結(jié)果定義)Int3.2 資料更新請求接口3.2.1 接口定義接口名稱Update接口描述CRM系統(tǒng)請求統(tǒng)一充值平臺求消息名UpdateRequest應(yīng)答消息名UpdateResponse接口方式Webservice主要使用者CRM系統(tǒng)3.2.2 請求參數(shù)名稱說明數(shù)據(jù)類型RequestId請求流水StringRequestTime請求時間，YYYYMMDDHHMMSSStringOperationCode操作類型，0-新

25、增，1-更新(CRM發(fā)更新請求時，要求將以下所有參數(shù)再帶一遍)，2-刪除IntObject用戶號碼StringAreaCode用戶號碼區(qū)號，帶0StringObject State用戶狀態(tài)StringObject Home號碼歸屬系統(tǒng)(1：OCS，2：HB，3：SID)IntServId主產(chǎn)品實例IDLongProductId主產(chǎn)品 （固話、小靈通等）：描述號碼屬于哪種業(yè)務(wù)，用于1）各種業(yè)務(wù)充值的統(tǒng)計；IntPayType預(yù)付后付屬性String3.2.3 響應(yīng)參數(shù)名稱說明數(shù)據(jù)類型ResponseId響應(yīng)流水，對應(yīng)請求的RequestIdStringResponseTime響應(yīng)時間，YYYYM

26、MDDHHMMSSStringResult更新結(jié)果(詳見技術(shù)規(guī)范附錄操作結(jié)果定義)Int3.3 卡信息查詢接口3.3.1 接口定義接口名稱 queryCardRecord接口描述CRM系統(tǒng)請求統(tǒng)一充值平臺查詢卡信息請求消息名QueryCardReq 應(yīng)答消息名QueryCardResp 接口方式Webservice主要使用者CRM系統(tǒng)3.3.2 請求參數(shù)名稱說明數(shù)據(jù)類型RequestSourceCRM的標識或IP地址StringRequestUserCRM登錄用戶名或者營業(yè)員工號StringRequestId請求流水StringRequestTime請求時間，YYYYMMDDHHMMSSStr

27、ingCardNo充值卡卡號String3.3.3 響應(yīng)參數(shù)名稱說明數(shù)據(jù)類型ResponseId響應(yīng)流水，對應(yīng)請求的RequestIdStringResponseTime響應(yīng)時間，YYYYMMDDHHMMSSStringResult操作結(jié)果（詳見技術(shù)規(guī)范附錄操作結(jié)果定義）IntCard -Info充值卡信息項GroupedCardNo充值卡卡號StringCardPublisher充值卡發(fā)卡地StringCardStatus充值卡狀態(tài)（0：初始1：可用2：鎖定 3：已使用4：保留5：注銷）IntExpirationTime充值卡有效期(YYYYMMDD)StringProlongDays充值卡

28、延長有效期IntCardValue充值卡面額Int3.4 充值記錄查詢3.4.1 接口定義接口名稱 crmFillRecord接口描述CRM系統(tǒng)請求統(tǒng)一充值平臺查詢充值記錄請求消息名QueryFillReq 應(yīng)答消息名QueryFillResp 接口方式Webservice主要使用者CRM系統(tǒng)3.4.2 請求參數(shù)名稱說明數(shù)據(jù)類型RequestSourceCRM的標識或IP地址StringRequestUserCRM登錄用戶名或者營業(yè)員工號StringRequestId請求流水StringRequestTime請求時間，YYYYMMDDHHMMSSStringCardNo充值卡卡號String3

29、.4.3 響應(yīng)參數(shù)名稱說明數(shù)據(jù)類型ResponseId響應(yīng)流水，對應(yīng)請求的RequestIdStringResponseTime響應(yīng)時間，YYYYMMDDHHMMSSStringResponseAmount充值響應(yīng)記錄數(shù)（跟請求相對應(yīng)）IntResult操作結(jié)果（詳見技術(shù)規(guī)范附錄操作結(jié)果定義）Int*Recharge-Item充值歷史紀錄項GroupedResult充值結(jié)果（詳見技術(shù)規(guī)范附錄操作結(jié)果定義）IntRechargeUserType充值請求用戶類型（0-固話;1-小靈通;2-移動;3-他網(wǎng)用戶;4-WEB用戶）IntRechargeUser充值發(fā)起用戶標識StringCardNo充值

30、卡卡號StringRechargeTime充值時間(YYYYMMDD)StringDestinationId被充值號碼StringDestinationAttr被充值用戶屬性（0-固話;1-小靈通;2-移動；3-ADSL；4-智能公話；5-互聯(lián)星空）IntRechargeUnit充值金額單位：0分；1條IntRechargeAmount充值金額(單位：分)IntBonusInfo贈送策略描述信息String3.5 充值3.5.1 接口定義接口名稱 rechargeCrm接口描述CRM請求充值請求消息名FillCrmReq應(yīng)答消息名FillCrmResp接口方式Webservice主要使用者CR

31、M系統(tǒng)3.5.2 請求參數(shù)名稱說明數(shù)據(jù)類型RequestSourceCRM的標識或IP地址StringRequestUserCRM登錄用戶名或者營業(yè)員工號StringRequestId請求流水StringRequestTime請求時間，YYYYMMDDHHMMSSStringOperationCode請求類型：0普通充值；1批量充值；2卡分拆充值IntAccessType充值接入途徑（1：IVR； 2：SMS； 3： 網(wǎng)上營業(yè)廳即WEB方式；4：WAP；5：USSD；6：CRM）IntRequestAmount充值請求記錄數(shù) （普通充值、卡分拆充值時RequestAmount=1;分批充值時R

32、equestAmount!=1參數(shù)組會多次出現(xiàn)）Int*Recharge-Item充值項，一個充值請求可以有多個充值項GroupedCardPin充值卡密碼（18位）StringSubId子流水號（分拆/分批充值時此項必填YYYYMMDD+8位循環(huán)數(shù)字+2位各省自用+99(固定值)StringRequestAmount充值請求記錄數(shù)；普通充值時RequestAmount =1；分拆充值時RequestAmount!=1參數(shù)組會多次出現(xiàn)Int*SubRecharge-Item被充值用戶賬號，可同時充多個(即分拆充值)。Grouped Sequence分拆序號（從1開始）IntDestinatio

33、nId被充值用戶號碼StringDestinationAttr被充值用戶屬性（0-固話;1-小靈通;2-移動；3-ADSL；4-智能公話；5-互聯(lián)星空）IntObjType號碼類型，5BB：客戶；5BC：用戶StringBalanceType余額類型，根據(jù)各地情況分別定義 IntRechargeUnit充值金額單位：0分；1條；IntRechargeAmount充值金額數(shù)量（卡分拆充值時使用，其他情況填缺省值0）Int3.5.3 響應(yīng)參數(shù)名稱說明數(shù)據(jù)類型ResponseId響應(yīng)流水，對應(yīng)請求的RequestIdStringResponseTime響應(yīng)時間，YYYYMMDDHHMMSSStrin

34、gOperationCode請求類型：0普通充值；1批量充值；2卡分拆充值IntResponseAmount充值響應(yīng)記錄數(shù)（跟請求相對應(yīng)）Int*Recharge-Item針對每個充值項的響應(yīng)結(jié)果。GroupedSubId子流水號(對應(yīng)請求的子流水號)StringRechargeAmount充值金額(單位：分)IntResult充值結(jié)果（詳見技術(shù)規(guī)范附錄操作結(jié)果定義）IntResponseAmount分拆充值響應(yīng)記錄數(shù)（跟請求相對應(yīng)）Int*SubRecharge-Item多個被充值用戶賬號被充值后返回的結(jié)果信息。GroupedSequence分拆序號（從1開始）Int BalanceUnit

35、余額單位，0分；1條IntBalanceType余額類型，根據(jù)各地情況分別定義 IntBalance余額賬本余額IntEffectiveTime余額生效日期(YYYYMMDD)StringExpirationTime余額失效日期(YYYYMMDD)StringResponseAmount贈送記錄數(shù)Int*Bonus-Item獎勵項，一個充值項可存在多個獎勵項。Grouped BonusUnit贈送金額單位，0分；1條IntBonusBalanceType優(yōu)惠余額類型，根據(jù)各地情況分別定義 IntBonusAmount贈送金額IntStartTime贈送金額起始日期(YYYYMMDD)Strin

36、gEndTime贈送金額失效日期(YYYYMMDD)String3.6 卡管理接口3.6.1 接口定義接口名稱 CardManage接口描述CRM系統(tǒng)請求統(tǒng)一充值平臺對卡進行鎖卡和解鎖請求消息名CardManageReq 應(yīng)答消息名CardManageResp 接口方式Webservice主要使用者CRM系統(tǒng)3.6.2 請求參數(shù)名稱說明數(shù)據(jù)類型RequestSourceCRM的標識或IP地址StringRequestUserCRM登錄用戶名或者營業(yè)員工號StringRequestId請求流水StringRequestTime請求時間，YYYYMMDDHHMMSSStringOperationC

37、ode請求類型：0鎖卡； 1解鎖IntCardNo充值卡卡號String3.6.3 響應(yīng)參數(shù)名稱說明數(shù)據(jù)類型ResponseId響應(yīng)流水，對應(yīng)請求的RequestIdStringResponseTime響應(yīng)時間，YYYYMMDDHHMMSSStringResult操作結(jié)果（詳見技術(shù)規(guī)范附錄操作結(jié)果定義）Int3.7 解除風險控制名單接口3.7.1 接口定義接口名稱ReleaseCaller接口描述統(tǒng)一充值平臺請求CRM系統(tǒng)請求消息名ReleaseReq應(yīng)答消息名ReleaseResp接口方式Webservice主要使用者CRM系統(tǒng)3.7.2 請求參數(shù)名稱說明數(shù)據(jù)類型RequestSourceC

38、RM的標識或IP地址StringRequestUserCRM登錄用戶名或者營業(yè)員工號StringRequestId請求流水StringRequestTime請求時間，YYYYMMDDHHMMSSStringCallNum解除風險控制號碼String3.7.3 響應(yīng)參數(shù)名稱說明數(shù)據(jù)類型ResponseId響應(yīng)流水，對應(yīng)請求的RequestIdStringResponseTime響應(yīng)時間，YYYYMMDDHHMMSSStringResult驗證結(jié)果(詳見技術(shù)規(guī)范附錄操作結(jié)果定義)Int第4章 與SID間的TUXEDO接口4.1 接口描述充值平臺和SID系統(tǒng)通過TUXEDO接口通訊。SID為充值平臺

39、提供充值處理、余額查詢、沖正處理、用戶資料同步等服務(wù)。4.2 TUXEDO實現(xiàn)概述TUXEDO采用C/S結(jié)構(gòu)，系統(tǒng)首先定義公共的數(shù)據(jù)緩沖類型文件（常用的是FML32類型及XML類型），客戶端向緩沖區(qū)填入數(shù)據(jù)，然后調(diào)用服務(wù)器端的服務(wù)，發(fā)起服務(wù)請求，服務(wù)器接受到服務(wù)請求后，從緩沖區(qū)獲取服務(wù)參數(shù)，進行業(yè)務(wù)處理，然后返回處理結(jié)果。4.3 服務(wù)說明TUXEDO的服務(wù)接口參數(shù)同WEB SERVICE，只是使用的技術(shù)和數(shù)據(jù)表現(xiàn)方式不同，相關(guān)的服務(wù)命名如下：序號服務(wù)名服務(wù)說明1.Recharge充值服務(wù)2.AccountQuery余額查詢3.Refund沖正服務(wù)4.GetUpdUser用戶資料同步服務(wù)以上接口

40、中VC作為客戶端的服務(wù)有Recharge(充值服務(wù))，AccountQuery（余額查詢），Refund(沖正服務(wù)) ，接口內(nèi)容和保持一致，接口方式為Tuxedo。這三個接口由VC發(fā)起調(diào)用SID的服務(wù)，在實現(xiàn)方式上采用同步請求/應(yīng)答方式，即客戶端通過tpcall()給服務(wù)器發(fā)送服務(wù)請求，服務(wù)器在處理請求時，客戶端將等待，不繼續(xù)運行，直到服務(wù)器返回相應(yīng)的結(jié)果。 處理流程如下：Tpinit()Tpalloc()Tpcall()Tpterm()TOUPPER(TPSVCINFO *rqst) 在傳輸參數(shù)上，常用的有FML32緩沖區(qū)及XML緩沖區(qū)，但考慮到XML的靈活性及可擴展性，且XML在實現(xiàn)上也要簡單得多，同時可以與WEB服務(wù)(HB,OCS采用web服務(wù))的參數(shù)形式統(tǒng)一起來，建議采用XML緩沖區(qū)作為通信的基礎(chǔ)，當然在實現(xiàn)上也可以考慮其它的方式作為緩沖區(qū)。以XML緩沖區(qū)為例，VC對于各服務(wù)參數(shù)的封裝，采用前面WEB服