市民卡在线消费动态链接库说明书-南京12320.doc

文件编号：WSXX2012005 文件版次：WSXX2012005-001 文档编号： 版 本 号：1.0 发布日期：2012-5-20 南京市医疗一卡通 小额支付方案技术支持： 1. 引言 3 1.1 目的 3 1.2 项目背景 3 1.3 术语与缩略词 3 1.4 参考资料 3 2. 动态链接库说明 5 2.1 动态链接库结构 5 2.2 动态链接库命名 5 2.3 准驱动级动态链接库 5 2.3.1 机具通讯服务端信息设置 5 2.3.2 机具本地IP信息设置 6 2.3.3 查询交易服务器IP设置信息 6 2.3.4 查询机具本地IP信息设置 7 2.3.5 日始函数 7 2.3.6 日终函数 8 2.3.7 在线钱包消费函数 9 2.3.8 在线钱包消费撤销函数 9 2.4 应用级动态链接库 10 3. 数据结构说明 11 3.1 机具通讯参数 11 3.1.1 Strct_CommOlnPara 11 3.1.2 Strct_CommLocOlnPara 11 3.2 业务相关 11 3.2.1 Strct_OlnStrtDayInfo 11 3.2.2 Strct_OlnStrtDayRtrnInfo 12 3.2.3 Strct_OlnEndDayInfo 12 3.2.4 Strct_OlnEndDayRtrnInfo 12 3.2.5 Strct_OlnConsumWInfo 12 3.2.6 Strct_OlnConsumWRetrnInfo 13 3.2.7 Strct_OlnCnsmRdrRqst 13 4. 返回值说明 14 引言 本文规定使用市民卡非接触芯片的调用方式以及相关的内容。 项目背景 市民卡在医疗一卡通中的支付类型包括：在线钱包支付和在线账户支付。本文档所涉及的系统仅针对于市民卡AB卡非接触电子钱包在线应用，作为市民卡公司非接触系统的在线钱包应用的标准化系统，为A、B卡在线钱包支付作接口说明。 术语与缩略词 如果没有特殊说明，读卡器句柄通过《就诊卡读卡器动态库说明》.doc相关函数获得。 所有函数约定：在没有特殊说明的情况下，返回值为0，表示函数调用成功。否则参考返回值说明。 参考资料/或数字，左靠，右部多余部分填空格 ANS 字母、数字和/或特殊符号，左靠，右部多余部分填空格 AS 字母和/或特殊符号，左靠，右部多余部分填空格 H ASCII码的十六进制数，即数字0-F，其中A-F为大写字母 DD 日 Hh 时 MM 月 Mm 分 N 数值，右靠，首位有效数字前充零，若表示金额，则最右二位为角分 S 特殊符号 B 字节 Byte Ss 秒 YY 年 动态链接库说明 动态链接库结构 动态链接库分成2个层次。第一层次为准驱动级，实现设备参数设置和交易流程。以C++语言作为主要应用接入对象。第二层次为应用层。主要解决不同开发语言，尤其是缺少指针支持或者复杂数据结构支持的语言，如：PB相关系统等。 所有相关的数据结构均使用1字节对齐。所有相关函数输出除特殊定义的外，均采用stdcall。 动态链接库命名 准驱动级动态链接库：TFReader.dll 应用级动态链接库： njsmkOlAppCons.dll 准驱动级动态链接库 名称：njsmkOnlnCons.dll 机具通讯服务端信息设置 功能 设置机具通信服务器相关信息。 原型 int setCommOlnTermInfo(int hReader,Strct_CommOlnPara* pstrctCommPara); 参数说明 hReader:读卡器句柄。 pstrctCommPara:通讯参数设置，参见数据结构说明 返回值说明 0,成功。其他：参见返回值说明 机具本地IP信息设置 功能 设置机具本身通信服务用的本地地址相关信息。对机具本身存在独立网卡时使用。 原型 int setCommLocOlnTermInfo(int hReader,Strct_CommLocOlnPara* pstrctCommPara); 参数说明 hReader:读卡器句柄。 pstrctCommPara:通讯参数设置，参见数据结构说明 返回值说明 0,成功。其他：参见返回值说明 查询交易服务器IP设置信息 功能 设置机具通信服务器相关信息。 原型 int getCommOlnTermInfo(int hReader,Strct_CommOlnPara* pstrctCommPara); 参数说明 hReader:读卡器句柄。 pstrctCommPara:通讯参数设置，参见数据结构说明 返回值说明 0,成功。其他：参见返回值说明 查询机具本地IP信息设置 功能 设置机具本身通信服务用的本地地址相关信息。对机具本身存在独立网卡