福建省社会保障金融卡医院小额支付结算接口说明XXXX052

福建省社会保障金融IC卡医院就诊小额支付结算接口规范中国银联股份有限公司福建分公司二○一○年五月十二日福建省社会保障金融卡医院就诊小额支付结算接口规范i版本控制信息版本日期拟稿和修改说明1.02010.05.12中国银联福建分公司初稿2010.5.21中国银联福建分公司根据和医院沟通修改2010.5.24中国银联福建分公司完善参数描述，合并代付文件格式福建省社会保障金融卡医院就诊小额支付结算接口规范ii目录1引言...............................................................................................42接口函数定义...............................................................................42.1卡片信息查询接口......................................42.2脱机消费接口.........................................5UCTRANSATTACHMENT格式.......................................62.3卡片交易明细查询接口.................................73.交易明细的清算...........................................................................83．1IC卡脱机消费批扣文件接口............................83．1．1文件功能..................................................83.1.2.命名规则及交易类型..........................................83．1．3交易代码说明..............................................83．1.4IC卡脱机批扣文件的组成....................................93．1.5基本记录格式定义...........................................9系统概述.........................................................................................15数据传输安全................................................................................15数据接口.........................................................................................16概述....................................................16字段类型定义说明........................................16字段类型属性.....................................................16委托批量代收/代付申请文件...............................17文件名..........................................................17文件格式.........................................................17文件记录格式.....................................................17委托代收/代付处理结果应答文件...........................20文件名..........................................................20文件格式.........................................................21文件记录格式.....................................................21注意事项.........................................................................................24传输过程中文件的定义....................................24参与MD5校验的数据......................................24应答文件注意事项........................................24分配的代码使用注意事项..................................24附表.................................................................................................24福建省社会保障金融卡医院就诊小额支付结算接口规范iii行业单位代码对照表......................................24银行代码表..............................................26处理结果代码表..........................................27医院问题答疑................................................................................28代收与代付是否可以在同一个文件中？......................28代收代付文件名称REQCYYYYMMDD？...........................28医院行业单位代码是什么？................................28医院代收付项目代码是什么？..............................28代收付请求文件中的用户号是什么？........................28委托代收付提出日期是什么？是文件生成日期或数据交易日期...28为纪录的MD5校验值如何生成？用第三方工具？...............28代收代付文件生成否如何传送？............................28批量委托关系建立/撤销申请文件含义是什么？................29其他行业在生成代收代付文件后（即已上传），如何重新生成代收代付文件？规范中并未有重复提交的校验？......................29一日内是否可以多个上传文件？............................29代收代付金额（N12.2）转换成字符后是否应该为13位？.......29代收付系统环境如何搭建？................................29若电子钱包交易成功，但医院系统若出现错误之类的没有上送相关数据，银行是否未来会将交易取消？医院是否需要一代收，一代付上传交易？..................................................29服务提供商保留信息是否为医院保留信息？..................29代收代付应答处理结果文件何时返还，何时到达医院账户？.....29福建省社会保障金融卡医院就诊小额支付结算接口规范41引言本规范规定了福建省社会保障金融IC卡在医院就诊流程中进行小额支付结算的软件接口函数等内容，不涉及金融（或行业）前置系统、银联前置系统的规定。本规范作为《中国银联商户MIS系统技术标准》和《中国银联直联POS终端规范》的补充规范使用，仅适用于福建银行IC卡试点使用。规范适用于嵌入到商户MIS系统，POS终端只负责脱机交易处理，而交易流水日志维护和上送由MIS系统负责的情况。终端其它硬件、软件和安全要求应按照《中国银联直联POS终端规范》并通过相关认证、具备相关资质，MIS商户系统安全要求应参照《中国银联商户MIS系统技术标准》执行。2接口函数定义2.1卡片信息查询接口函数原型longYKT_ICGetInfo(unsignedintnInfoType,char*szCardInfo,unsignedlong*ulBalance,char*szWarnmsg,char*szErrmsg)功能说明读取IC卡上信息内容，本函数包含的卡基本信息查询、余额查询等两个功能。入口nInfoType：信息类型0–读卡信息及余额1–只读卡信息,2–只读余额出口szCardInfo：卡信息内容当nInfoType=0或=1时，取值如下：偏移地址描述长度（字节）数据类型0－31姓名32AN32－33性别2AN34－41出生日期8AN42－43证件类型2AN44－75证件号码32AN76－95银行卡号20AN96－104社保卡号9AN当nInfoType=2时，此域无意义性别：“01”－男，“00”－女证件类型：“00”－身份证“01”－军官证“02”－护照“03”－入境证（仅限香港/台湾居民使用）福建省社会保障金融卡医院就诊小额支付结算接口规范5“04”－临时身份证“05”－其他ulBalance：卡片余额当nInfoType=1时，此域无意义szWarnmsg:警告信息，非空时应显示szErrmsg:错误信息社保卡号从社保应用获取函数返回值0表示成功，非0表示失败，错误信息见szErrmsg参数。注：数据类型AN的含义是字母和数字。2.2脱机消费接口函数原型longYKT_ICPurchase(unsignedlongulAmount,char*szTransTime,char*szTransOutInfo,unsignedlong*ulTransCounter,unsignedlong*ulBalance,char*szName,charszBankCardNo[19+1],char*szCertID,charszSecureID[9+1],charucTransAttachment[142+1],char*szWarnmsg,char*szErrmsg)功能说明脱机消费时调用或使用。入口ulAmount：交易金额（以分为单位）szTransTime：交易日期时间（ASCII码14字节）例如：“20100512133959”szWarnmsg:警告信息，非空时应显示szErrmsg:错误信息出口szTransOutInfo：交易输出信息偏移地址描述长度（字节）数据类型0－19电子钱包帐号（前19位）20AN20－31终端机编号12AN32－45交易日期时间14ANulTransCounter：卡片交易计数器ulBalance：交易后余额（以分为单位）szName姓名，最长32字节szBankCardNo电子钱包帐号(不是磁条卡帐号)，定长19字节，左对齐，福建省社会保障金融卡医院就诊小额支付结算接口规范6不足右补空格，此值用来拷贝到脱机批扣文件段0内的19位主账号szCertID证件号码，最长32字节szSecureID社保卡号，定长9位，从社保应用获取ucTransAttachment：交易附加域，转成ASC字符串，格式见下表（用于上送银联，固定长度142+1个字节）szWarnmsg:警告信息，非空时应显示