ICS35.240L65中華人民共和國(guó)國(guó)家標(biāo)準(zhǔn)城市智慧卡互聯(lián)互通充值數(shù)據(jù)接口C—I國(guó)家市場(chǎng)監(jiān)督管理總局國(guó)家標(biāo)準(zhǔn)化管理委員會(huì)GB／T39465—2020前言 2規(guī)范性引用文件 3術(shù)語(yǔ)和定義 4縮略語(yǔ) 5充值架構(gòu)及功能 6報(bào)文和接口數(shù)據(jù)定義 7充值申請(qǐng) 8充值操作 9充值異常處理 10對(duì)賬文件處理 參考文獻(xiàn) GB／T39465—2020本標(biāo)準(zhǔn)按照GB/T1.1—2009給出的規(guī)則起草。本標(biāo)準(zhǔn)由中華人民共和國(guó)住房和城鄉(xiāng)建設(shè)部提出。本標(biāo)準(zhǔn)由全國(guó)智能建筑及居住區(qū)數(shù)字化標(biāo)準(zhǔn)化技術(shù)委員會(huì)(SAC/TC426)歸口。本標(biāo)準(zhǔn)起草單位：北京億速碼數(shù)據(jù)處理有限責(zé)任公司、中外建設(shè)信息有限責(zé)任公司、城聯(lián)數(shù)據(jù)有限公司、北京智芯微電子科技有限公司、東信和平科技股份有限公司、中城智物聯(lián)網(wǎng)技術(shù)研究（深圳）有限公司、天津通卡智能網(wǎng)絡(luò)科技股份有限公司、山東華冠智能卡有限公司、上海復(fù)旦微電子集團(tuán)股份有限公司、浙江創(chuàng)建科技有限公司、北京握奇數(shù)據(jù)股份有限公司、武漢天喻信息產(chǎn)業(yè)股份有限公司、青島海納云科技控股有限公司、廣東天波教育科技有限公司、廣東永華通訊科技有限公司、杭州國(guó)朗科技有限公司、珠海市珠海通科技有限公司、中建新疆建工（集團(tuán)）有限公司。本標(biāo)準(zhǔn)主要起草人：蔡文成、張永剛、謝躍文、馬虹、王莎、金學(xué)明、范琳琳、周亮、尚治宇、孫式方、Ⅰ1GB／T39465—2020城市智慧卡互聯(lián)互通充值數(shù)據(jù)接口本標(biāo)準(zhǔn)規(guī)定了城市智慧卡互聯(lián)互通充值架構(gòu)及功能、報(bào)文和接口數(shù)據(jù)定義、充值申請(qǐng)、充值操作、充值異常處理及對(duì)賬文件處理等。本標(biāo)準(zhǔn)適用于城市智慧卡互聯(lián)互通充值數(shù)據(jù)接口的設(shè)計(jì)、開發(fā)和應(yīng)用。2規(guī)范性引用文件下列文件對(duì)于本文件的應(yīng)用是必不可少的。凡是注日期的引用文件，僅注日期的版本適用于本文件。凡是不注日期的引用文件，其最新版本（包括所有的修改單）適用于本文件。GB/T1988—1998信息技術(shù)信息交換用七位編碼字符集GB/T13000—2010信息技術(shù)通用多八位編碼字符集(UCS)GB/T31778—2015數(shù)字城市一卡通互聯(lián)互通通用技術(shù)要求3術(shù)語(yǔ)和定義下列術(shù)語(yǔ)和定義適用于本文件。3.1城市智慧卡社區(qū)／園區(qū)應(yīng)用、停車場(chǎng)管理等多項(xiàng)業(yè)務(wù)需求，具有微處理器芯片的識(shí)別卡。注：本標(biāo)準(zhǔn)中提到的IC卡均指城市智慧卡。3.2充值平臺(tái)通過通信網(wǎng)絡(luò)實(shí)現(xiàn)對(duì)城市智慧卡充值申請(qǐng)、操作、異常處理和對(duì)賬的系統(tǒng)。3.3清分當(dāng)日的全部網(wǎng)絡(luò)交易數(shù)據(jù)按照平臺(tái)間進(jìn)行匯總、整理、分類的過程。3.4報(bào)文充值終端和城市智慧卡相互發(fā)送，不含傳輸控制字符的字節(jié)串。3.5圈存持卡人將相關(guān)賬戶上的資金劃轉(zhuǎn)到城市智慧卡電子錢包的過程。,定義4縮略語(yǔ)下列縮略語(yǔ)適用于本文件。應(yīng)用協(xié)議數(shù)據(jù)單元(2GB／T39465—2020嵌入式安全單元(文件傳輸協(xié)議(基于主機(jī)的卡模擬(集成電路(身份標(biāo)識(shí)號(hào)(腳本對(duì)象簡(jiǎn)譜(報(bào)文認(rèn)證碼(非對(duì)稱加密算法(安全單元(5充值架構(gòu)及功能城市智慧卡互聯(lián)互通平臺(tái)與第三方充值平臺(tái)的充值數(shù)據(jù)接口應(yīng)按照充值申請(qǐng)、充值操作、充值異常處理、對(duì)賬文件處理的流程進(jìn)行規(guī)范，并約定報(bào)文和接口數(shù)據(jù)要求。城市智慧卡第三方充值架構(gòu)，見圖1城市智慧卡第三方充值架構(gòu)3GB／T39465—20205.2功能要求城市智慧卡互聯(lián)互通平臺(tái)充值數(shù)據(jù)接口應(yīng)符合下列要求：a)應(yīng)具備與第三方充值平臺(tái)的充值申請(qǐng)、充值操作和充值異常處理、對(duì)賬文件處理等進(jìn)行對(duì)接的功能；GB/T31778—2015的規(guī)定；c)宜兼容手機(jī)APP充值終端、自助充值終端、手機(jī)eSE錢包和手機(jī)HCE錢包等多種充值方式。6報(bào)文和接口數(shù)據(jù)定義6.1報(bào)文格式說明報(bào)文格式應(yīng)符合下列要求：a)通信方式應(yīng)采用請(qǐng)求-響應(yīng)協(xié)議，使用投遞和的要求。數(shù)據(jù)的格式應(yīng)為格式。示例請(qǐng)求參數(shù)報(bào)文集合。報(bào)文體內(nèi)容也應(yīng)為JSON格式。示例b)應(yīng)答參數(shù)數(shù)據(jù)格式應(yīng)為JSON格式。示例返回參數(shù)集合。報(bào)文體內(nèi)容也應(yīng)為JSON格式。示例c)報(bào)文中的數(shù)據(jù)應(yīng)區(qū)分大小寫。d)通信應(yīng)使用短鏈接。6.2報(bào)文安全說明報(bào)文安全應(yīng)符合下列要求：a)報(bào)文內(nèi)容中應(yīng)包含簽名信息，報(bào)文發(fā)送方用本方的私鑰對(duì)報(bào)文進(jìn)行簽名，報(bào)文接收方用對(duì)方的公鑰驗(yàn)簽，當(dāng)服務(wù)端驗(yàn)簽失敗，應(yīng)返回失敗并丟棄報(bào)文；b)通卡平臺(tái)應(yīng)下發(fā)公鑰給充值平臺(tái)，充值平臺(tái)接入通卡平臺(tái)前，應(yīng)提供公鑰給通卡平臺(tái)，通卡平臺(tái)將充值平臺(tái)的公鑰進(jìn)行配置。6.3接口及數(shù)據(jù)域定義接口及數(shù)據(jù)域定義應(yīng)符合表1的規(guī)定。4GB／T39465—2020表1接口及數(shù)據(jù)域定義序號(hào)內(nèi)容名稱類型備注1通用請(qǐng)求參數(shù)VersionString接口版本號(hào)2Format請(qǐng)求參數(shù)格式，僅支持3Charset應(yīng)符合GB/T1988—1998和GB/T13000—2010中UTF-8的要求4Timestamp格式5簽名方式，SM2、MD5、RSA等6Sign簽名7Parastr參數(shù)集合8充值交易參數(shù)Name交易類型名稱，含驗(yàn)卡、圈存、查詢9Plat_id發(fā)起充值請(qǐng)求的平臺(tái)標(biāo)識(shí)充值服務(wù)提供商在充值平臺(tái)上的注冊(cè)IDCardNo卡號(hào)，卡密鑰分散因子Orderid充值訂單號(hào)、流水號(hào)OrderStatus充值訂單狀態(tài)，分訂單創(chuàng)建、充值成功、充值失敗、充值異常、訂單關(guān)閉、訂單處理中等用于標(biāo)識(shí)訂單在交易流程中的不同情況Amount充值金額交易支付類型APDUsetAPDU指令序列，可包含多個(gè)APDU指令A(yù)PDU指令執(zhí)行結(jié)果，可包含多個(gè)APDUAPDUver支持多版本APDU,可用于標(biāo)識(shí)APDU是否加密0:APDU指令信息為非空，下發(fā)APDU指令，執(zhí)行完APDU指令后提交結(jié)果繼續(xù)圈存過程。1:APDU指令信息為空，圈存結(jié)束TerminalNo終端機(jī)編號(hào)StatuscodeStatusdescription狀態(tài)描述7充值申請(qǐng)充值申請(qǐng)操作應(yīng)符合下列要求：a)充值申請(qǐng)操作應(yīng)包括訂單預(yù)處理和訂單確認(rèn)；b)持卡人應(yīng)通過充值終端連接充值平臺(tái)，通過充值平臺(tái)與通卡后臺(tái)的充值申請(qǐng)接口通信，實(shí)現(xiàn)IC卡的充值申請(qǐng)操作，并完成向通卡平臺(tái)賬戶的充值；5GB／T39465—2020圖2充值申請(qǐng)時(shí)序圖7.2通卡平臺(tái)充值申請(qǐng)流程通卡平臺(tái)充值申請(qǐng)業(yè)務(wù)流程見圖3。6GB／T39465—2020圖3通卡平臺(tái)充值申請(qǐng)業(yè)務(wù)流程當(dāng)充值平臺(tái)接收到充值終端發(fā)起的充值申請(qǐng)時(shí)，應(yīng)驗(yàn)證申請(qǐng)報(bào)文是否符合6.3的要求，同時(shí)將訂單請(qǐng)求上送給通卡平臺(tái)驗(yàn)證訂單狀態(tài)是否合法。當(dāng)?shù)玫酵ㄆ脚_(tái)的驗(yàn)證結(jié)果后，如果不合法，應(yīng)申請(qǐng)終止，否則組織并下發(fā)讀取IC卡指令，啟動(dòng)充值申請(qǐng)操作。充值終端接收并向IC卡轉(zhuǎn)發(fā)指令，IC卡執(zhí)行相應(yīng)指令，并將結(jié)果返回。充值終端收到命令響應(yīng)報(bào)文后，通過充值平臺(tái)將響應(yīng)數(shù)據(jù)傳給通卡后臺(tái)。通卡平臺(tái)確認(rèn)該IC卡是否正常，從而做最終的訂單確認(rèn)。當(dāng)訂單確認(rèn)成功，則進(jìn)行接下來的充值操作；否則，需返回錯(cuò)誤狀態(tài)至充值平臺(tái)，充值平臺(tái)通知充值終端中止交易。訂單確認(rèn)包含的內(nèi)容如下：卡讀取指令返回碼認(rèn)證；卡是否為本系統(tǒng)卡；卡是否為黑名單；）；e)充值余額是否達(dá)到上限。8充值操作持卡人通過充值終端連接充值平臺(tái)，通過充值平臺(tái)與通卡后臺(tái)的充值接口通信，實(shí)現(xiàn)IC卡充值操作，持卡人可將相應(yīng)賬戶上的資金劃入電子存折或電子錢包中。充值操作接口應(yīng)支持用戶充值平臺(tái)和7GB／T39465—2020通卡后臺(tái)間信息交互，交易過程可能存在多次交互。充值操作流程見圖4。圖4充值操作流程8GB／T39465—2020充值時(shí)序見圖5。圖5充值時(shí)序圖流程說明組織圈存初始化指令當(dāng)充值平臺(tái)接收到充值終端發(fā)起的充值請(qǐng)求時(shí)，應(yīng)組織并下發(fā)INITIALIZEFORLOAD指令啟GB／T39465—2020動(dòng)充值操作。處理圈存初始化指令充值終端接收并轉(zhuǎn)發(fā)INITIALIZEFORLOAD指令至IC卡，IC卡將進(jìn)行下列操作：a)檢查錢包是否被灰鎖。如果灰鎖，應(yīng)回送狀態(tài)碼‘9408’,但不回送其他信息，同時(shí)終止命令的處理過程。b)檢查是否支持命令中包含的密鑰索引號(hào)。如果不支持，應(yīng)回送狀態(tài)碼‘9403’,但不回送任何其他數(shù)據(jù)，同時(shí)終止命令的處理過程。c)產(chǎn)生一個(gè)偽隨機(jī)數(shù)，過程密鑰和一個(gè)報(bào)文認(rèn)證碼(MAC1),供通卡后臺(tái)驗(yàn)證充值操作及IC卡的合法性?？▽NITIALIZEFORLOAD響應(yīng)報(bào)文回送給充值終端處理。如果IC卡回送的狀態(tài)碼不是‘9000’,充值操作應(yīng)終止。收到INITIALIZEFORLOAD命令響應(yīng)報(bào)文后，充值終端通過充值平臺(tái)將響應(yīng)數(shù)據(jù)傳給通卡后臺(tái)。通卡后臺(tái)將生成并確認(rèn)MAC1是否有效。如果MAC1有效，充值操作將繼續(xù)執(zhí)行。否則，應(yīng)返回錯(cuò)誤狀態(tài)至充值平臺(tái)，充值平臺(tái)通知充值終端中止交易。組織圈存指令確認(rèn)充值交易后，充值平臺(tái)將從持卡人在的相應(yīng)賬戶中扣減充值金額，并通知通卡平臺(tái)。通卡平臺(tái)產(chǎn)生一個(gè)報(bào)文認(rèn)證碼2(MAC2),用于IC卡對(duì)通卡平臺(tái)合法性檢查。成功充值交易后，通卡平臺(tái)將電子存折聯(lián)機(jī)交易序號(hào)或電子錢包聯(lián)機(jī)交易序號(hào)加1,并向充值平臺(tái)發(fā)送一個(gè)充值交易接受報(bào)文，其中包括MAC2、交易日期和交易時(shí)間，充值平臺(tái)根據(jù)報(bào)文組織CREDITFORLOAD指令。處理圈存指令充值終端收到充值平臺(tái)CREDITFORLOAD指令后下發(fā)到IC卡，更新卡上電子存折或電子錢包余額。收到CREDITFORLOAD命令后，IC卡應(yīng)確認(rèn)MAC2的有效性。如果MAC2有效，IC卡將電子存折聯(lián)機(jī)交易序號(hào)或電子錢包聯(lián)機(jī)交易序號(hào)加1,并且把交易金額加在電子存折或電子錢包的余額上，IC卡將根據(jù)充值交易信息生成TAC。否則將向終端回送狀態(tài)碼‘9302’,充值操作結(jié)束，進(jìn)入異常處理。在MAC驗(yàn)證成功后，IC卡通過CREDITFORLOAD命令的響應(yīng)報(bào)文將TAC回送給充值終端。充值終端將通過充值平臺(tái)將TAC上送給通卡平臺(tái)，通卡平臺(tái)驗(yàn)證TAC后，向充值平臺(tái)返回驗(yàn)證結(jié)果，若通過，充值平臺(tái)應(yīng)通知充值終端充值操作完成，否則應(yīng)進(jìn)入充值異常處理。9充值異常處理充值平臺(tái)對(duì)接通卡平臺(tái)充值異?？砂ㄏ铝星闆r：9GB／T39465—2020a)調(diào)用充值接口，沒有獲得交易應(yīng)答信息；c)從通卡平臺(tái)獲得的充值指令傳至IC卡，沒有從IC卡獲得應(yīng)答代碼。充值平臺(tái)應(yīng)根據(jù)異常情況，重新發(fā)起充值接口的調(diào)用，通卡平臺(tái)在接口調(diào)用過程中，根據(jù)IC卡充值狀態(tài)進(jìn)行異常處理，也可調(diào)用充值結(jié)果查詢接口，根據(jù)返回結(jié)果選擇退款或重新發(fā)起充值。充值異常操作時(shí)序見圖6。圖6充值異常操作時(shí)序圖GB／T39465—20209.2通卡平臺(tái)異常處理流程通卡平臺(tái)下發(fā)圈存初始化指令給充值平臺(tái)，充值平臺(tái)執(zhí)行指令并上送指令執(zhí)行結(jié)果。通卡平臺(tái)針對(duì)交易前后IC卡交易計(jì)數(shù)器的值進(jìn)行比較，判斷流程見圖7,并應(yīng)符合下列要求：卡計(jì)數(shù)器未發(fā)生變化：充值失敗，繼續(xù)進(jìn)行充值流程，校驗(yàn)MAC1成功下發(fā)圈存指令，繼續(xù)完成充值流程；卡計(jì)數(shù)器增加：比較最后一條交易記錄的充值終端機(jī)編號(hào)是否與充值平臺(tái)該訂單使用的充值終端機(jī)編號(hào)相同，如果相同，證明充值成功，下發(fā)獲取TAC的指令，完成充值。如果不相同，應(yīng)更新該訂單的交易計(jì)數(shù)器為當(dāng)前計(jì)數(shù)器，校驗(yàn)MAC1成功下發(fā)圈存指令，繼續(xù)完成充值流程；c)判斷為失敗的充值交易，充值平臺(tái)可選擇調(diào)用充值結(jié)果查詢接口，根據(jù)返回結(jié)果選擇退款或重新發(fā)起充值，也可不調(diào)用充值結(jié)果查詢接口，直接調(diào)用充值接口充值，這時(shí)交易日期和時(shí)間應(yīng)變化，以充值成功日期為準(zhǔn)；d)判斷為成功的充值交易，進(jìn)行正常的清分與結(jié)算處理；e)判斷為可疑的充值交易，由通卡平臺(tái)的清分部門根據(jù)該卡后續(xù)的交易情況進(jìn)行可疑交易調(diào)整。調(diào)整為成功交易的正常清分與結(jié)算處理，調(diào)整為失敗的交易通知充值平臺(tái)退款。GB／T39465—2020圖7充值異常判斷流程10對(duì)賬文件處理充值平臺(tái)和通卡平臺(tái)對(duì)賬應(yīng)符合下列要求：a)通卡平臺(tái)每日生成充值交易明細(xì)數(shù)據(jù)文件，作為對(duì)賬的依據(jù)；b)通卡平臺(tái)只要在充值操作中發(fā)出CREDITFORLOAD指令，即視作充值成功，記錄至充值交易明細(xì)數(shù)據(jù)文件；c)通卡平臺(tái)在軋差中如發(fā)現(xiàn)以前的充值不成功，應(yīng)在發(fā)現(xiàn)的當(dāng)日在充值交易明細(xì)數(shù)據(jù)文件中進(jìn)行結(jié)算修正；GB／T39465—2020d)如果不一致，雙方可協(xié)商采用人工對(duì)賬并查出原因。對(duì)賬數(shù)據(jù)處理流程應(yīng)符合下列要求：通卡平臺(tái)T+1日時(shí)先對(duì)T日的實(shí)時(shí)充值交易的數(shù)據(jù)統(tǒng)計(jì)，根據(jù)不同的充值平臺(tái)生成相應(yīng)的充值交易明細(xì)數(shù)據(jù)文件，并把數(shù)據(jù)文件放至指定的FTP目錄上；b)充值平臺(tái)從不同的通卡平臺(tái)通過FTP獲取T+0日充值交易明細(xì)數(shù)據(jù)文件；c)充值平臺(tái)按規(guī)定格式檢查和解析充值交易明細(xì)數(shù)據(jù)文件，并按城市分類對(duì)賬。10.3對(duì)賬數(shù)據(jù)備份對(duì)賬數(shù)據(jù)的備份應(yīng)每天進(jìn)行當(dāng)天交易日志的增量備份，定期進(jìn)行全量數(shù)據(jù)備份，根據(jù)需要進(jìn)行整個(gè)數(shù)據(jù)庫(kù)備份。通卡平臺(tái)和充值平臺(tái)備份數(shù)據(jù)應(yīng)至少保留3年。10.4充值交易明細(xì)數(shù)據(jù)文件用于規(guī)范地方通卡平臺(tái)下發(fā)的充值交易明細(xì)文件，