中國銀聯股份有限公司福建分公司
二○一○年五月十二日
版本控制信息
版本 日期 擬稿和修改 說明
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 
