中国银联股份有限公司福建分公司
二○一○年五月十二日
版本控制信息
版本 日期 拟稿和修改 说明
1.0 2010.05.12 中国银联福建分公司 初稿
2010.5.21 中国银联福建分公司 根据和医院沟通修改
2010.5.24 中国银联福建分公司 完善参数描述，合并代付文件格式
目 录
1引言 3
2接口函数定义 3
2.1卡片信息查询接口 3
2.2脱机消费接口 4
2.3 卡片交易明细查询接口 4
3.交易明细的清算 6
4、代付文件格式
1引言
本规范规定了福建省社会保障金融IC卡在医院就诊流程中进行小额支付结算的软件接口函数等内容，不涉及金融（或行业）前置系统、银联前置系统的规定。
本规范作为《中国银联商户MIS系统技术标准》和《中国银联直联POS终端规范》的补充规范使用，仅适用于福建银行IC卡试点使用。规范适用于嵌入到商户MIS系统，POS终端只负责脱机交易处理，而交易流水日志维护和上送由MIS系统负责的情况。终端其它硬件、软件和安全要求应按照《中国银联直联POS终端规范》并通过相关认证、具备相关资质，MIS商户系统安全要求应参照《中国银联商户MIS系统技术标准》执行。
2接口函数定义
2.1卡片信息查询接口
函数原型 long YKT_ICGetInfo (
unsigned int nInfoType,
char *szCardInfo,
unsigned long *ulBalance,
char *szWarnmsg,
char *szErrmsg
)
功能说明 读取IC卡上信息内容，本函数包含的卡基本信息查询、余额查询等两个功能。
入口 nInfoType：信息类型
0 – 读卡信息及余额
1 – 只读卡信息,
2 – 只读余额
出口 szCardInfo：卡信息内容
当nInfoType = 0 或 = 1时，取值如下：
偏移地址 描述 长度（字节） 数据类型
0－31 姓名 32 AN
32－33 性别 2 AN
34－41 出生日期 8 AN
42－43 证件类型 2 AN
44－75 证件号码 32 AN
76－95 银行卡号 20 AN
96－104 社保卡号 9 AN
当nInfoType = 2时，此域无意义
性别：“01”－男，“00”－女
证件类型：
“00”－身份证
“01”－军官证
“02”－护照
“03”－入境证（仅限香港/台湾居民使用）
“04”－临时身份证
“05”－其他
ulBalance：卡片余额
当nInfoType = 1时，此域无意义
szWarnmsg:警告信息，非空时应显示
szErrmsg:错误信息
社保卡号从社保应用获取
函数返回值 0表示成功，非0表示失败，错误信息见szErrmsg参数。
注：数据类型AN的含义是字母和数字。
2.2脱机消费接口
函数原型 long YKT_ICPurchase (
unsigned long ulAmount,
char *szTransTime,
char *szTransOutInfo,
unsigned long *ulTransCounter,
unsigned long *ulBalance,
char *szName,
char szBankCardNo[19+1],
char *szCertID,
char szSecureID[9+1],
char ucTransAttachment[142+1],
char *szWarnmsg,
char *szErrmsg
)
功能说明 脱机消费时调用或使用。
入口 ulAmount：交易金额（以分为单位）
szTransTime：交易日期时间（ASCII码14字节）
例如：“20100512133959”
szWarnmsg:警告信息，非空时应显示
szErrmsg:错误信息
出口 szTransOutInfo：交易输出信息
偏移地址 描述 长度（字节） 数据类型
0－19 电子钱包帐号（前19位） 20 AN
20－31 终端机编号 12 AN
32－45 交易日期时间 14 AN
ulTransCounter：卡片交易计数器
ulBalance：交易后余额 （以分为单位）
szName 姓名，最长32字节
szBankCardNo 电子钱包帐号(不是磁条卡帐号)，定长19字节，左对齐，不足右补空格，此值用来拷贝到脱机批扣文件段0内的19位主账号
szCertID 证件号码，最长32字节
szSecureID 社保卡号，定长9位，从社保应用获取
ucTransAttachment：交易附加域，转成ASC字符串，格式见下表 （用于上送银联，固定长度 142+1 个字节）
szWarnmsg:警告信息，非空时应显示
szErrmsg:错误信息
|
|
资源大小：35.78 KB 
