交通银行校园卡接口规范-1.2版讲述.doc

[内部使用] 校园一卡通接口规范 交通银行湖南省分行-应用开发组 2012年06月 修订记录 日期 版本 修订目的描述 作者 2012-7-2 1.0 文档初建 贺鑫 2014-7-2 1.1 修正 贺鑫 校园圈存机系统拓扑图 银校通系统通过专线连接，系统通过socket同步短连接，采用定长格式报文进行交互。校园圈存机与银行校园卡前置进行交互。 本系统主要实现了以下功能： 校园卡与银行的绑定批量绑定和单个绑定 批量绑定： 批量绑定采用文件接口，学校按照银行提供的批量处理的文件格式上传批量处理文件给银行，银行后台对批量文件进行批量处理，对后台开卡成功的数据进行校园卡与银行卡的关系绑定。 单个绑定： 一般用于维护单个学生的校园卡与银行绑定关系的维护，学生持校园卡通过银行柜面或者自助通进行绑定关系的签约。 校园卡圈存机圈存 学生持校园卡在校园内的任意一台圈存机上进行圈存，输入校园卡密码和充值金额即可完成充值。 校园卡充值 缴费用户通过各种银行渠道对校园卡用户进行充值，银行系统完成充值交易后，通知校园圈存机前置充值缴费成功，同时校园卡圈存机系统中对该校园卡产生一笔待写卡记录，校园卡的持卡人可在任何时候任意一台校园圈存机上进行补写卡操作，从而完成校园卡充值。 接口约定： 校园圈存机前置－银行银校通前置 通讯方式 “校园圈存机前置”通过专线向“银行银校通前置”相互请求，TCP/IP SOCKET同步短连接方式。 报文协议 报文协议：八位长度+定长报文头+报文体 ,长度不包括八位长度本身。 通讯包格式：定长格式。 上送下传报文头： requestid 10 学校代码（湘南学院 XNXY 银行 BANKCOMM） trancode 8 交易代码 requesttime 14 交易时间(yyyymmddhhmmss) userid 10 请求的机具编号(圈存机编号) tranflowno 20 交易请求流水 responsecode 6 返回码　(成功000000　失败　相应错误码) responsemsg 100 返回信息 交易对照表： 交易名称 交易码 备注 校园卡圈存 YXT10001 学校发起，银行提供服务 校园卡圈存冲正 YXT19001 学校发起，银行提供服务 校园卡充值 YXT20002 银行发起，学校提供服务 校园卡充值冲正 YXT29002 银行发起，学校提供服务 学生基本信息查询 YXT20003 银行发起，学校提供服务 对账请求 YXT30001 银行发起，学校提供服务 圈存机圈存YXT10001（校园发起） 功能描述 学生通过校园圈存机发起圈存的请求，把学号、圈存金额、身份证、姓名等信息发送到银行校园卡前置，待银行完成账务处理后，返回处理结果给校园圈机前置，校园圈存机完成写卡后，交易结束。 接口描述 学校→银行 输入项名称 输入属性 参数名 备注说明 学号 必输 barcode 学号 30 圈存金额 必输 amount 以分为单位，不带小数点 15 客户姓名 必输 custname 校园卡持卡人的姓名 60 客户身份证 必输 custid 校园卡持卡人的身份证 20 客户单位名称 可输 custunit 校园卡持卡人的单位名称 100 备注 可输 note 60 银行→学校 输入项名称 输入属性 参数名 备注说明 银行帐务日期 必输 bankdate 双方对帐用 8 银行交易受理流水号 必输 bankflowno 银行端返回的流水号 20 学号 必输 barcode 学号 30 圈存金额 必输 amount 以分为单位，没有小数点 10 客户姓名 必输 custname 校园卡持卡人的姓名 60 备注 可输 note 60 学生基本信息查询YXT20003（银行发起） 功能描述 用于银行渠道查询和验证学号的基本信息。 接口描述 银行→学校 输入项名称 输入属性 参数名 备注说明 学号 必输 barcode 30 学校→银行 输入项名称 输入属性 参数名 备注说明 学号 必输 barcode 30 姓名 必输 custname 60 身份证 必输 custid 20 性别 必输 custsex 1 男 0 女 1 出生年月 选输 birthday yyyymmdd 8 班级/部门名称 必输 classname 100 校园卡充值YXT20002 (银行发起) 功能描述 校园卡充值主要用于充值人通过银行缴费渠道在异地对校园卡进行空中充值