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