中國銀聯(lián)股份有限公司福建分公司
二○一○年五月十二日
版本控制信息
版本 日期 擬稿和修改 說明
1.0 2010.05.12 中國銀聯(lián)福建分公司 初稿
2010.5.21 中國銀聯(lián)福建分公司 根據(jù)和醫(yī)院溝通修改
2010.5.24 中國銀聯(lián)福建分公司 完善參數(shù)描述，合并代付文件格式
目 錄
1引言 3
2接口函數(shù)定義 3
2.1卡片信息查詢接口 3
2.2脫機消費接口 4
2.3 卡片交易明細(xì)查詢接口 4
3.交易明細(xì)的清算 6
4、代付文件格式
1引言
本規(guī)范規(guī)定了福建省社會保障金融IC卡在醫(yī)院就診流程中進行小額支付結(jié)算的軟件接口函數(shù)等內(nèi)容，不涉及金融（或行業(yè)）前置系統(tǒng)、銀聯(lián)前置系統(tǒng)的規(guī)定。
本規(guī)范作為《中國銀聯(lián)商戶MIS系統(tǒng)技術(shù)標(biāo)準(zhǔn)》和《中國銀聯(lián)直聯(lián)POS終端規(guī)范》的補充規(guī)范使用，僅適用于福建銀行IC卡試點使用。規(guī)范適用于嵌入到商戶MIS系統(tǒng)，POS終端只負(fù)責(zé)脫機交易處理，而交易流水日志維護和上送由MIS系統(tǒng)負(fù)責(zé)的情況。終端其它硬件、軟件和安全要求應(yīng)按照《中國銀聯(lián)直聯(lián)POS終端規(guī)范》并通過相關(guān)認(rèn)證、具備相關(guān)資質(zhì)，MIS商戶系統(tǒng)安全要求應(yīng)參照《中國銀聯(lián)商戶MIS系統(tǒng)技術(shù)標(biāo)準(zhǔn)》執(zhí)行。
2接口函數(shù)定義
2.1卡片信息查詢接口
函數(shù)原型 long YKT_ICGetInfo (
unsigned int nInfoType,
char *szCardInfo,
unsigned long *ulBalance,
char *szWarnmsg,
char *szErrmsg
)
功能說明 讀取IC卡上信息內(nèi)容，本函數(shù)包含的卡基本信息查詢、余額查詢等兩個功能。
入口 nInfoType：信息類型
0 – 讀卡信息及余額
1 – 只讀卡信息,
2 – 只讀余額
出口 szCardInfo：卡信息內(nèi)容
當(dāng)nInfoType = 0 或 = 1時，取值如下：
偏移地址 描述 長度（字節(jié)） 數(shù)據(jù)類型
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
當(dāng)nInfoType = 2時，此域無意義
性別：“01”－男，“00”－女
證件類型：
“00”－身份證
“01”－軍官證
“02”－護照
“03”－入境證（僅限香港/臺灣居民使用）
“04”－臨時身份證
“05”－其他
ulBalance：卡片余額
當(dāng)nInfoType = 1時，此域無意義
szWarnmsg:警告信息，非空時應(yīng)顯示
szErrmsg:錯誤信息
社�？ㄌ枏纳绫�(yīng)用獲取
函數(shù)返回值 0表示成功，非0表示失敗，錯誤信息見szErrmsg參數(shù)。
注：數(shù)據(jù)類型AN的含義是字母和數(shù)字。
2.2脫機消費接口
函數(shù)原型 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
)
功能說明 脫機消費時調(diào)用或使用。
入口 ulAmount：交易金額（以分為單位）
szTransTime：交易日期時間（ASCII碼14字節(jié)）
例如：“20100512133959”
szWarnmsg:警告信息，非空時應(yīng)顯示
szErrmsg:錯誤信息
出口 szTransOutInfo：交易輸出信息
偏移地址 描述 長度（字節(jié)） 數(shù)據(jù)類型
0－19 電子錢包帳號（前19位） 20 AN
20－31 終端機編號 12 AN
32－45 交易日期時間 14 AN
ulTransCounter：卡片交易計數(shù)器
ulBalance：交易后余額 （以分為單位）
szName 姓名，最長32字節(jié)
szBankCardNo 電子錢包帳號(不是磁條卡帳號)，定長19字節(jié)，左對齊，不足右補空格，此值用來拷貝到脫機批扣文件段0內(nèi)的19位主賬號
szCertID 證件號碼，最長32字節(jié)
szSecureID 社�？ㄌ�，定長9位，從社保應(yīng)用獲取
ucTransAttachment：交易附加域，轉(zhuǎn)成ASC字符串，格式見下表 （用于上送銀聯(lián)，固定長度 142+1 個字節(jié)）
szWarnmsg:警告信息，非空時應(yīng)顯示
szErrmsg:錯誤信息
|
|
資源大小：35.78 KB 
