(高清版)GBT 39465-2020 城市智慧卡互聯互通 充值數據接口

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