交通银行校园卡接口规范-1.2版

1、银校通校园一卡通接口规范内部使用校园一卡通接口规范交通银行湖南省分行-应用开发组2012年06月修订记录日期版本修订目的描述作者2012-7-21.0文档初建贺鑫2014-7-21.1修正贺鑫校园圈存机系统拓扑图 银校通系统通过专线连接，系统通过socket同步短连接，采用定长格式报文进行交互。校园圈存机与银行校园卡前置进行交互。本系统主要实现了以下功能：1、 校园卡与银行的绑定批量绑定和单个绑定批量绑定：批量绑定采用文件接口，学校按照银行提供的批量处理的文件格式上传批量处理文件给银行，银行后台对批量文件进行批量处理，对后台开卡成功的数据进行校园卡与银行卡的关系绑定。 单个绑定：一般用于维护单

2、个学生的校园卡与银行绑定关系的维护，学生持校园卡通过银行柜面或者自助通进行绑定关系的签约。2、 校园卡圈存机圈存 学生持校园卡在校园内的任意一台圈存机上进行圈存，输入校园卡密码和充值金额即可完成充值。3、 校园卡充值 缴费用户通过各种银行渠道对校园卡用户进行充值，银行系统完成充值交易后，通知校园圈存机前置充值缴费成功，同时校园卡圈存机系统中对该校园卡产生一笔待写卡记录，校园卡的持卡人可在任何时候任意一台校园圈存机上进行补写卡操作，从而完成校园卡充值。接口约定：校园圈存机前置<>银行银校通前置通讯方式“校园圈存机前置”通过专线向“银行银校通前置”相互请求，TCP/IP SOCKET同

3、步短连接方式。报文协议报文协议：八位长度+定长报文头+报文体 ,长度不包括八位长度本身。通讯包格式：定长格式。上送下传报文头： requestid10学校代码（湘南学院 XNXY 银行 BANKCOMM）trancode8交易代码requesttime14交易时间(yyyymmddhhmmss)userid10请求的机具编号(圈存机编号)tranflowno20交易请求流水responsecode6返回码(成功000000失败相应错误码)responsemsg100返回信息交易对照表：交易名称交易码备注校园卡圈存YXT10001学校发起，银行提供服务校园卡圈存冲正YXT19001学校发起，银行

4、提供服务校园卡充值YXT20002银行发起，学校提供服务校园卡充值冲正YXT29002银行发起，学校提供服务学生基本信息查询YXT20003银行发起，学校提供服务对账请求YXT30001银行发起，学校提供服务1. 圈存机圈存YXT10001（校园发起）1.1. 功能描述 学生通过校园圈存机发起圈存的请求，把学号、圈存金额、身份证、姓名等信息发送到银行校园卡前置，待银行完成账务处理后，返回处理结果给校园圈机前置，校园圈存机完成写卡后，交易结束。1.2. 接口描述v 学校银行输入项名称输入属性参数名备注说明长度学号必输barcode学号30圈存金额必输amount以分为单位，不带小数点15客户姓名

5、必输custname校园卡持卡人的姓名60客户身份证必输custid校园卡持卡人的身份证20客户单位名称可输custunit校园卡持卡人的单位名称100备注可输note60v 银行学校输入项名称输入属性参数名备注说明长度银行帐务日期必输bankdate双方对帐用8银行交易受理流水号必输bankflowno银行端返回的流水号20学号必输barcode学号30圈存金额必输amount以分为单位，没有小数点10客户姓名必输custname校园卡持卡人的姓名60备注可输note602. 学生基本信息查询YXT20003（银行发起）2.1. 功能描述用于银行渠道查询和验证学号的基本信息。2.2. 接口描

6、述v 银行学校输入项名称输入属性参数名备注说明长度学号必输barcode30v 学校银行输入项名称输入属性参数名备注说明长度学号必输barcode30姓名必输custname60身份证必输custid20性别必输custsex1 男 0 女1出生年月选输birthdayyyyymmdd8班级/部门名称必输classname1003. 校园卡充值YXT20002 (银行发起)3.1. 功能描述校园卡充值主要用于充值人通过银行缴费渠道在异地对校园卡进行空中充值，在银行端确认充值成功后，银行端发起交易请求通知校园一卡通系统充值成功，校园一卡通系统产生该校园卡的一条待写卡的充值成功数据，校园卡的持卡人

7、可持卡在校园内的任意一台圈存机上进行补写卡的操作。3.2. 接口描述v 银行学校输入项名称输入属性参数名备注说明长度学号/校园卡号必输barcode被充值的校园卡号30银行帐务日期必输bankdate双方对帐用8充值金额必输amount以分为单位，没有小数点15付款交易银行流水号必输bankflowno20备注可输note60v 学校银行输入项名称输入属性参数名备注说明长度学号/校园卡号必输barcode被充值的校园卡号30充值金额必输amount以分为单位，没有小数点15校方的受理成功流水号可输schoolflowno20备注可输note604. 银行对账文件4.1. 功能描述每日日终后，银行首先产生上一日的银行成功流水明细文件，传到学校指定的FTP服务器上。学校对账产生的差异以银行交易数据为准，学校按银行提供的明细数据调平，对于异常情况，由双方人员手工处理。4.2. 文件接口描述v 银行上送的对账文件对帐文件名称：学校代码+对帐日期（yyyymmdd）.txt对帐文件内容：对帐文件每行一条记录，每条记录定长格式，最后一行是汇总：每