交通銀行校園卡接口規(guī)范-1.2版

1、銀校通校園一卡通接口規(guī)范內(nèi)部使用校園一卡通接口規(guī)范交通銀行湖南省分行-應(yīng)用開發(fā)組2012年06月修訂記錄日期版本修訂目的描述作者2012-7-21.0文檔初建賀鑫2014-7-21.1修正賀鑫校園圈存機(jī)系統(tǒng)拓?fù)鋱D 銀校通系統(tǒng)通過專線連接，系統(tǒng)通過socket同步短連接，采用定長格式報文進(jìn)行交互。校園圈存機(jī)與銀行校園卡前置進(jìn)行交互。本系統(tǒng)主要實(shí)現(xiàn)了以下功能：1、 校園卡與銀行的綁定批量綁定和單個綁定批量綁定：批量綁定采用文件接口，學(xué)校按照銀行提供的批量處理的文件格式上傳批量處理文件給銀行，銀行后臺對批量文件進(jìn)行批量處理，對后臺開卡成功的數(shù)據(jù)進(jìn)行校園卡與銀行卡的關(guān)系綁定。 單個綁定：一般用于維護(hù)單

2、個學(xué)生的校園卡與銀行綁定關(guān)系的維護(hù)，學(xué)生持校園卡通過銀行柜面或者自助通進(jìn)行綁定關(guān)系的簽約。2、 校園卡圈存機(jī)圈存 學(xué)生持校園卡在校園內(nèi)的任意一臺圈存機(jī)上進(jìn)行圈存，輸入校園卡密碼和充值金額即可完成充值。3、 校園卡充值 繳費(fèi)用戶通過各種銀行渠道對校園卡用戶進(jìn)行充值，銀行系統(tǒng)完成充值交易后，通知校園圈存機(jī)前置充值繳費(fèi)成功，同時校園卡圈存機(jī)系統(tǒng)中對該校園卡產(chǎn)生一筆待寫卡記錄，校園卡的持卡人可在任何時候任意一臺校園圈存機(jī)上進(jìn)行補(bǔ)寫卡操作，從而完成校園卡充值。接口約定：校園圈存機(jī)前置<>銀行銀校通前置通訊方式“校園圈存機(jī)前置”通過專線向“銀行銀校通前置”相互請求，TCP/IP SOCKET同

3、步短連接方式。報文協(xié)議報文協(xié)議：八位長度+定長報文頭+報文體 ,長度不包括八位長度本身。通訊包格式：定長格式。上送下傳報文頭： requestid10學(xué)校代碼（湘南學(xué)院 XNXY 銀行 BANKCOMM）trancode8交易代碼requesttime14交易時間(yyyymmddhhmmss)userid10請求的機(jī)具編號(圈存機(jī)編號)tranflowno20交易請求流水responsecode6返回碼(成功000000失敗相應(yīng)錯誤碼)responsemsg100返回信息交易對照表：交易名稱交易碼備注校園卡圈存YXT10001學(xué)校發(fā)起，銀行提供服務(wù)校園卡圈存沖正YXT19001學(xué)校發(fā)起，銀行

4、提供服務(wù)校園卡充值YXT20002銀行發(fā)起，學(xué)校提供服務(wù)校園卡充值沖正YXT29002銀行發(fā)起，學(xué)校提供服務(wù)學(xué)生基本信息查詢YXT20003銀行發(fā)起，學(xué)校提供服務(wù)對賬請求YXT30001銀行發(fā)起，學(xué)校提供服務(wù)1. 圈存機(jī)圈存YXT10001（校園發(fā)起）1.1. 功能描述 學(xué)生通過校園圈存機(jī)發(fā)起圈存的請求，把學(xué)號、圈存金額、身份證、姓名等信息發(fā)送到銀行校園卡前置，待銀行完成賬務(wù)處理后，返回處理結(jié)果給校園圈機(jī)前置，校園圈存機(jī)完成寫卡后，交易結(jié)束。1.2. 接口描述v 學(xué)校銀行輸入項(xiàng)名稱輸入屬性參數(shù)名備注說明長度學(xué)號必輸barcode學(xué)號30圈存金額必輸amount以分為單位，不帶小數(shù)點(diǎn)15客戶姓名

5、必輸custname校園卡持卡人的姓名60客戶身份證必輸custid校園卡持卡人的身份證20客戶單位名稱可輸custunit校園卡持卡人的單位名稱100備注可輸note60v 銀行學(xué)校輸入項(xiàng)名稱輸入屬性參數(shù)名備注說明長度銀行帳務(wù)日期必輸bankdate雙方對帳用8銀行交易受理流水號必輸bankflowno銀行端返回的流水號20學(xué)號必輸barcode學(xué)號30圈存金額必輸amount以分為單位，沒有小數(shù)點(diǎn)10客戶姓名必輸custname校園卡持卡人的姓名60備注可輸note602. 學(xué)生基本信息查詢YXT20003（銀行發(fā)起）2.1. 功能描述用于銀行渠道查詢和驗(yàn)證學(xué)號的基本信息。2.2. 接口描

6、述v 銀行學(xué)校輸入項(xiàng)名稱輸入屬性參數(shù)名備注說明長度學(xué)號必輸barcode30v 學(xué)校銀行輸入項(xiàng)名稱輸入屬性參數(shù)名備注說明長度學(xué)號必輸barcode30姓名必輸custname60身份證必輸custid20性別必輸custsex1 男 0 女1出生年月選輸birthdayyyyymmdd8班級/部門名稱必輸classname1003. 校園卡充值YXT20002 (銀行發(fā)起)3.1. 功能描述校園卡充值主要用于充值人通過銀行繳費(fèi)渠道在異地對校園卡進(jìn)行空中充值，在銀行端確認(rèn)充值成功后，銀行端發(fā)起交易請求通知校園一卡通系統(tǒng)充值成功，校園一卡通系統(tǒng)產(chǎn)生該校園卡的一條待寫卡的充值成功數(shù)據(jù)，校園卡的持卡人

7、可持卡在校園內(nèi)的任意一臺圈存機(jī)上進(jìn)行補(bǔ)寫卡的操作。3.2. 接口描述v 銀行學(xué)校輸入項(xiàng)名稱輸入屬性參數(shù)名備注說明長度學(xué)號/校園卡號必輸barcode被充值的校園卡號30銀行帳務(wù)日期必輸bankdate雙方對帳用8充值金額必輸amount以分為單位，沒有小數(shù)點(diǎn)15付款交易銀行流水號必輸bankflowno20備注可輸note60v 學(xué)校銀行輸入項(xiàng)名稱輸入屬性參數(shù)名備注說明長度學(xué)號/校園卡號必輸barcode被充值的校園卡號30充值金額必輸amount以分為單位，沒有小數(shù)點(diǎn)15校方的受理成功流水號可輸schoolflowno20備注可輸note604. 銀行對賬文件4.1. 功能描述每日日終后，銀行首先產(chǎn)生上一日的銀行成功流水明細(xì)文件，傳到學(xué)校指定的FTP服務(wù)器上。學(xué)校對賬產(chǎn)生的差異以銀行交易數(shù)據(jù)為準(zhǔn)，學(xué)校按銀行提供的明細(xì)數(shù)據(jù)調(diào)平，對于異常情況，由雙方人員手工處理。4.2. 文件接口描述v 銀行上送的對賬文件對帳文件名稱：學(xué)校代碼+對帳日期（yyyymmdd）.txt對帳文件內(nèi)容：對帳文件每行一條記錄，每條記錄定長格式，最后一行是匯總：每