中國銀行電子商務商戶接口文檔全集

1、IPPS產品對商戶端接口標準單位中國銀行撰寫人IPPS開發(fā)組版本修 訂 說 明序號修改人日期版本號修改說明1.梁棟2010-6-26Ver 0.1完成初稿2.梁棟2010-11-8Ver 0.2修改查詢類接口的返回報文3.喬大偉2010-11-17Ver 0.3將本文檔定義為產品級文檔，補充所有對商戶端接口。4.梁棟2010-12-7Ver 0.4修改理財直付和協(xié)議支付批量部分字段項5.喬大偉2011-03-16Ver 0.5滬蘇吳批次針對人行二號令對本文檔進行如下修改：2.2.4 修改 銀行返回訂單支付結果(頁面通知)2.2.5 修改 銀行返回訂單支付結果(主動通知)2.2.7 新增 商戶發(fā)

2、送查詢訂單請求(支持卡戶信息判斷)5.2.10 修改 商戶發(fā)送訂單支付請求新增 商戶發(fā)送B2B訂單查詢請求(支持卡戶信息判斷)6.喬大偉2011-05-23Ver 1.1公共以湘鄂桂批次實現(xiàn)為基線，建立基礎版本1.17.喬大偉2011-06-13Ver 1.2.1粵深4.2.3 修改 銀行反饋認證結果(主動通知)增加notifyType8.喬大偉2011-06-17Ver 1.2.2公共整理文檔內容，重新歸納安全機制，整理聯(lián)機部分接口。9.喬大偉2011-06-21Ver 1.2.3粵深5.2.4 修改 商戶發(fā)送修改協(xié)議請求 增加agreeUrl。10.李紅梅2011-06-21

3、Ver 1.2.4公共6.2.2 修改 根據B2B相關文檔補充數(shù)據說明項11.李紅梅2011-07-25Ver 1.2.5公共2.2.12 刪除 交易流水文件生成12.喬大偉2011-07-25Ver 1.3.1粵深后批次 鐵道部緊急需求變更修改 商戶發(fā)送網上銀行支付訂單13.李新2011-10-24Ver 1.4.1P201修改 協(xié)議支付簽約返回結果增加簽約渠道修改 協(xié)議支付簽約、改約、解約，查詢協(xié)議、訂單支付，查詢訂單接口中返回數(shù)據項卡號返回規(guī)則修改14.李新2012-03-14Ver 1.5.1P204新增 商戶對接上傳下載文件接口規(guī)約15.喬大偉2012-04-19Ver 1.6.1P

4、20516.李紅梅2012-07-09Ver 1.7.1P207新增 商戶發(fā)送網上銀行分期支付訂單17.梁棟2012-07-25Ver 1.7.2P207新增 分行特色業(yè)務接口18.喬大偉陳發(fā)建梁曉曉2012-08-31Ver 1.8.1P301文檔結構進行重大調整；協(xié)議支付增加對商戶屬性管理的支持；19.梁棟2012-9-18Ver 1.8.2P301B2B訂單支付(監(jiān)管商戶、非監(jiān)管商戶)增加超時時間數(shù)據項20.李紅梅2012-11-01Ver 1.8.3P301 修改B2B訂單查詢接口的返回報文和示例21.李紅梅2012-11-21Ver 1.8.4P301 增加P301錯誤碼22.張鶴2

5、013-9-5Ver 1.9.1P401B2C協(xié)議支付增加訪問者IP和訪問者Refer信息23.喬大偉2013-9-17Ver 1.10.1P402商戶發(fā)送B2B訂單支付請求(直付商戶)增加二級商戶信息商戶發(fā)送B2B訂單支付請求(保付商戶)增加二級商戶信息24.喬大偉張鶴2013-11-5Ver 1.11.1P401新增 對B2C體彩商戶接口規(guī)約注：版本號規(guī)則 a.b.c 其中a表示大版本更新，b表示批次更新，c表示批次內修改流水。1.2.x 表示這些修改都是在粵深批次進行的。 IPPS產品總體設計(商戶端接口)第1章 概述1.1 文檔說明本文描述了中國銀行IPPS相關服務通訊協(xié)議、報文格式、

6、安全機制等內容。作為商戶端系統(tǒng)技術人員開發(fā)的參考文檔。1.2 編寫目的為使商戶端系統(tǒng)開發(fā)人員了解IPPS服務的相關通訊接口細節(jié)。1.3 通訊協(xié)議目前中行系統(tǒng)支持以下三種方式與商戶系統(tǒng)通訊：Ø 通過客戶瀏覽器間接通訊：a. 商戶引導客戶瀏覽器，將信息提交到網銀系統(tǒng)。商戶發(fā)送身份認證指令以及支付指令接口時采用該方式通訊。表單數(shù)據中需包含商戶對身份認證信息和訂單信息的簽名。b. 網銀引導客戶瀏覽器將信息提交到商戶系統(tǒng)。網銀反饋身份認證和支付結果接口采用該通訊方式。表單數(shù)據中包含網銀系統(tǒng)的簽名信息。Ø 商戶操作員通過瀏覽器操作網銀：商戶操作員登錄網銀操作網銀功能，用來下載業(yè)務對賬文

7、件與清算對賬文件。（網銀系統(tǒng)提供的其他商戶操作員功能如狀態(tài)查詢等由于不涉及系統(tǒng)之間的接口規(guī)范，因此不再描述）Ø 直接通訊：商戶系統(tǒng)與網銀系統(tǒng)之間直接建立通訊鏈路，該通訊采用HTTPS協(xié)議，由商戶系統(tǒng)主動發(fā)起通訊。支付狀態(tài)查詢接口、身份認證結果查詢接口等業(yè)務采用此通訊方式。1.4 安全機制商戶與支付網關之間的通訊采用HTTPS協(xié)議，SSL握手時驗證支付網關服務器證書，加密算法要求128位以上。服務器證書采用Verisign簽發(fā)的中國銀行網上銀行服務器證書。SSL協(xié)議保證傳輸通道的安全，包括通訊數(shù)據加密、服務器身份認證?？蛻舳说纳矸菡J證依靠銀行驗證商戶的數(shù)據簽名實現(xiàn)。中國銀行CA中心為商

8、戶簽發(fā)文件簽名證書，用于對商戶發(fā)送的請求指令(如支付指令、支付狀態(tài)查詢指令)進行簽名，中國銀行CA中心為網上支付系統(tǒng)簽發(fā)交易簽名證書，用于對銀行反饋處理結果(頁面通知、主動通知)進行簽名。中國銀行還要給商戶提供中行CA中心二級根證書，用于商戶驗證銀行反饋處理結果的簽名信息。1.5 簽名與驗簽簽名原文串采用UTF-8(無BOM)格式。商戶進行數(shù)字簽名：數(shù)字簽名采用pkcs7格式，經過BASE64編碼傳送。簽名中不包括被簽名的明文，包括簽名公鑰證書。明文由交易要素字符串組成，需要注意金額數(shù)據格式要求整數(shù)部分不補0，小數(shù)部分補足兩位，日期格式為14位24小時格式：“YYYYMMDDHHMISS”。交

9、易數(shù)字簽名明文格式示例交易示例明文由管道符“|”分割，如：商戶訂單號|訂單時間|訂單幣種|訂單金額|商戶號orderNo|orderTime|curCode|orderAmount|merchantNo簽名證書存在文件形式的證書庫中，證書庫可以是pfx格式或jks格式，由中行提供。調用中行提供的PKCS7Tool.jar中的PKCS7Tool類可以在java中實現(xiàn)簽名。簽名代碼示例如下：/ String keyStorePath: 證書庫路徑/ String keyStorePassword: 證書庫口令/ String keyPassword: 簽名私鑰口令，一般與證書庫口令相同PKCS7T

10、ool tool = PKCS7Tool.getSigner(keyStorePath, keyStorePassword, keyPassword);/簽名，返回signature：base64格式的簽名結果/ byte data: 明文字符串String signature = tool.sign(data);商戶驗證銀行數(shù)字簽名：數(shù)字簽名采用pkcs7格式，經過BASE64編碼傳送。簽名中不包括被簽名的明文，包括簽名公鑰證書。交易數(shù)字簽名明文格式示例交易示例明文由管道符“|”分割，如：商戶號|商戶訂單號|銀行訂單流水號|銀行卡類別|支付時間|訂單狀態(tài)|支付金額merchantNo|ord

11、erNo|orderSeq|cardTyp|payTime|orderStatus|payAmount調用中行提供的PKCS7Tool.jar中的PKCS7Tool類可以在java中實現(xiàn)驗證簽名。驗證簽名需要提供銀行發(fā)送的簽名結果、簽名明文、由中行提供的cer格式的信任公鑰證書文件。簽名代碼示例如下：/ String rootCertificatePath: 根證書路徑PKCS7Tool tool = PKCS7Tool.getVerifier(rootCertificatePath);/驗簽名，如果失敗拋出異常/ String signature：簽名/ byte data：明文數(shù)據/ St

12、ring dn：銀行簽名證書DN，如果為空則不驗證DNtool.verify(signature, data, dn);商戶驗證銀行數(shù)字簽名異常后的處理：在實際業(yè)務處理環(huán)境中，如果銀行簽名環(huán)節(jié)出現(xiàn)異常，提供商戶的簽名項為空，則會導致商戶驗證銀行簽名失敗或異常。出現(xiàn)這種情況為保證商戶盡快處理交易，建議商戶主動向銀行網關發(fā)起訂單查詢獲得訂單支付狀態(tài)。1.6 數(shù)據類型定義報文規(guī)范中數(shù)據類型的定義說明：9表示數(shù)字型數(shù)據。X表示字符型數(shù)據。1.7 聯(lián)機接口示例1.7.1 商戶發(fā)送請求示例商戶系統(tǒng)請按照相關接口定義采用POST方式發(fā)送請求至我行支付網關，內容請使用UTF-8編碼格式。下面以 B2C標準商戶

13、訂單支付 為例說明商戶系統(tǒng)上送數(shù)據形式 (本節(jié)以下內容僅作為示例使用)。接口名稱：RecvOrder.do數(shù)據項說明：序號名稱字段最大長度說明1.商戶號merchantNoX(20).2.支付類型payTypeX(10).3.商戶訂單號orderNoX(19).4.訂單幣種curCodeX(3).5.訂單金額orderAmountX(13).6.訂單時間orderTime9(14).7.訂單說明orderNoteX(200).8.商戶接收通知URLorderUrlX(100).9.超時時間orderTimeoutDate9(14).10.商戶簽名數(shù)據signDataX(4000).接口示例：

14、<FORM METHOD="POST" ACTION="https:/domainName/PGWPortal/RecvOrder.do"><!-01.商戶號-><INPUT TYPE="HIDDEN" SIZE="20" ID="merchantNo" NAME="merchantNo" VALUE="104012345678901"><BR/><!-02.支付類型-><INPUT TYP

15、E="HIDDEN" SIZE="10" ID="payType" NAME="payType" VALUE="1"><BR/><!-03.商戶訂單號-><INPUT TYPE="HIDDEN" SIZE="19" ID="orderNo" NAME="orderNo" VALUE="TEST0001"><BR/><!-04.訂單幣種-&

16、gt;<INPUT TYPE="HIDDEN" SIZE="3" ID="curCode" NAME="curCode" VALUE="001"><BR/><!-05.訂單金額-><INPUT TYPE="HIDDEN" SIZE="13" ID="orderAmount" NAME="orderAmount" VALUE="0.01"><BR

17、/><!-06.訂單時間-><INPUT TYPE="HIDDEN" SIZE="14" ID="orderTime" NAME="orderTime" VALUE="20091225182059"><BR/><!-07.訂單說明-><INPUT TYPE="HIDDEN" SIZE="30" ID="orderNote" NAME="orderNote"

18、VALUE="BuyGoods"><BR/><!-08.商戶接收通知URL-><INPUT TYPE="HIDDEN" SIZE="100" ID="orderUrl" NAME="orderUrl" VALUE="https:/merchant/recv.do"><BR/><!-09.超時時間 -><INPUT TYPE="HIDDEN" SIZE="14" ID

19、="orderTimeoutDate" NAME="orderTimeoutDate" VALUE="20091225183059"><BR/><!-10.商戶簽名數(shù)據-><INPUT TYPE="HIDDEN" ID="signData" NAME="signData" VALUE="PD94bWwgI.49IjEu"><BR/></FORM>1.7.2 商戶接收銀行通知示例我行提供的接口

20、名稱中如果提及頁面通知或主動通知，銀行系統(tǒng)均按照相關接口定義向商戶系統(tǒng)發(fā)送POST通知，內容使用UTF-8編碼格式。以B2C標準商戶訂單支付 為例，說明商戶系統(tǒng)接收到銀行系統(tǒng)反饋數(shù)據形式 (本節(jié)以下內容僅作為示例使用)數(shù)據項說明：序號名稱字段最大長度說明1.商戶號merchantNoX(20).2.商戶訂單號orderNoX(19).3.銀行訂單流水號orderSeq9(20).4.銀行卡類別cardTypX(2).5.支付時間payTime9(14).6.訂單狀態(tài)orderStatusX(2).7.支付金額payAmountX(13).8.客戶支付IP地址orderIpX(40).9.客戶瀏

21、覽器Refer信息orderReferX(200).10.銀行交易流水號bankTranSeqX(22).11.返回操作類型returnActFlagX(1).12.電話號碼phoneNumX(50).13.中行簽名數(shù)據signDataX(4000).接口示例：-header info-user-agent=Java/1.5.0host=23:8080accept=text/html, image/gif, image/jpeg, *; q=.2, */*; q=.2connection=keep-alivecontent-type=application/x-www

22、-form-urlencodedcontent-length=1969-para info-merchantNo=104012345678901orderNo=TEST0001orderSeq=12345678cardTyp=12payTime=20091225182140orderStatus=1payAmount=0.01orderIp=2orderRefer=http%3A%2F%2Flocalhost%2FB2C.htmlbankTranSeq=2009122533011575000001returnActFlag=1phoneNum=signData=MIIEZ

23、gYJKoZu3ukpfzDOJ8onjJl+gUxoP1FcWqQqlhzo1.7.3 銀行直連接收交易結果示例針對商戶與銀行直連類交易（如聯(lián)機退貨、訂單查詢等），我行均按照相關接口定義采用XML格式同步返回交易結果，內容使用UTF-8編碼格式。以 B2C訂單查詢 為例，說明銀行系統(tǒng)同步反饋數(shù)據形式 (本節(jié)以下內容僅作為示例使用)。序號報文要素<XML Tag>屬性類型備注1.Message root<res>1.12.BusinessHeader業(yè)務頭報文塊<header>1.13.-MessageId 報文標識號<msgId>1.1.4.-

24、HandleStatus 處理狀態(tài)<hdlSts>1.1A|B|K.5.-BodyFlag 業(yè)務體報文塊存在標識<bdFlg>1.10|1.6.-ReturnCode 報文處理返回碼<rtnCd>0.1.7.BusinessBody業(yè)務體報文塊<body>0.18.-交易信息<orderTrans>0.n.9.-商戶號<merchantNo>1.1X(20).10.-商戶訂單號<orderNo>1.1X(19).11.-銀行訂單流水號<orderSeq>1.19(20).12.-訂單狀態(tài)<or

25、derStatus>1.1X(2).13.-銀行卡類別<cardTyp>1.1X(2).14.-支付卡號<acctNo>1.1X(18).15.-持卡人姓名<holderName>0.1X(30)在不同業(yè)務配置情況下，此數(shù)據域可能不存在16.-支付卡省行聯(lián)行號<ibknum>0.1X(5)在不同業(yè)務配置情況下，此數(shù)據域可能不存在17.-支付時間<payTime>1.19(14).18.-支付金額<payAmount>1.1X(13).19.-訪問者IP<visitorIp>1.1X(40).20.-訪問者

26、Refer信息<visitorRefer>1.1X(3000).接口示例：<?xml version="1.0" encoding="utf-8" ?> <res><header><msgId>0000204</msgId> <hdlSts>A</hdlSts> <bdFlg>0</bdFlg> <rtnCd /> </header><body><orderTrans><mercha

27、ntNo>104012345678901</merchantNo> <orderNo>TEST0001</orderNo> <orderSeq>12345678</orderSeq> <orderStatus>1</orderStatus> <cardTyp>12</cardTyp> <acctNo>4563510100123456789</acctNo> <holderName>張三</holderName> <!此數(shù)據域為可

28、選項-><ibknum>47428</ibknum> <!此數(shù)據域為可選項-><payTime>20091225182140</payTime> <payAmount>0.01</payAmount> <visitorIp /> <visitorRefer /></orderTrans><orderTrans><merchantNo>104012345678901</merchantNo> <orderNo>TEST000

29、2</orderNo> <orderSeq>12345679</orderSeq> <orderStatus>0</orderStatus> <cardTyp>12</cardTyp> <holderName>張三</holderName> <!此數(shù)據域為可選項-><payTime>20110624171313</payTime> <payAmount>100.00</payAmount> <visitorIp />

30、 <visitorRefer /> </orderTrans></body></res>1.8 適用讀者商戶端系統(tǒng)技術人員（分析師、設計人員、程序員）。第2章 對B2C商戶公共接口規(guī)約2.1 商戶發(fā)送退貨交易請求客戶與商戶協(xié)商退貨后，商戶系統(tǒng)對原來已經支付成功的訂單進行退款時，商戶系統(tǒng)采用HTTPS協(xié)議按此數(shù)據規(guī)格將B2C退款交易信息發(fā)往中行支付網關系統(tǒng)，銀行完成退款處理后向商戶實時反饋處理結果。商戶主動發(fā)往銀行網關的指令均以POST方式發(fā)送，并且使用UTF8編碼格式。2.1.1 請求交易入口CommonRefundOrder.do2.1.2 數(shù)

31、據規(guī)格說明 商戶請求數(shù)據規(guī)格說明序號名稱字段最大長度說明1.商戶號merchantNoX(20)必填BOC商戶ID2.商戶退款交易流水號mRefundSeqX(30)必填商戶系統(tǒng)產生的交易流水號3.退款幣種curCodeX(3)必填目前只支持001：人民幣固定填0014.退款金額refundAmountX(13)必填退款金額格式：整數(shù)位不前補零,小數(shù)位補齊2位即：不超過10位整數(shù)位+1位小數(shù)點+2位小數(shù)無效格式如123，.10，1.1,有效格式如1.00，0.105.商戶訂單號orderNoX(19)必填商戶系統(tǒng)產生的訂單號，原支付訂單的商戶訂單號6.商戶簽名數(shù)據signData

32、X(4000)必填商戶簽名數(shù)據串格式，各項數(shù)據用管道符分隔：商戶號|商戶退款交易流水號|退款幣種|退款金額|商戶訂單號merchantNo|mRefundSeq|curCode|refundAmount|orderNo 銀行應答數(shù)據規(guī)格說明(XML)序號報文要素<XML Tag>屬性類型備注1.Message root<res>1.12.BusinessHeader業(yè)務頭報文塊<header>1.13.-MessageId 報文標識號<msgId>1.14.-HandleStatus 處理狀態(tài)<hdlSts>1.1A|B

33、|KA-成功 B-失敗 K-未明5.-BodyFlag 業(yè)務體報文塊存在標識<bdFlg>1.10|10-有包體1-無包體6.-ReturnCode 報文處理返回碼<rtnCd>0.17.BusinessBody業(yè)務體報文塊<body>0.n8.-商戶號<merchantNo>1.1X(20)BOC商戶ID9.-商戶退款交易流水號<mRefundSeq>1.1X(30)商戶系統(tǒng)產生的交易流水號10.-幣種<curCode>1.1X(3)目前只支持001：人民幣11.-退款金額<refundAmount>1.1X

34、(13)退款金額格式：整數(shù)位不前補零,小數(shù)位補齊2位即：不超過10位整數(shù)位+1位小數(shù)點+2位小數(shù)無效格式如123，.10，1.1,有效格式如1.00，0.1012.-商戶訂單號<orderNo>1.1X(19)商戶系統(tǒng)產生的訂單號，原支付訂單的商戶訂單號13.-銀行訂單流水號<orderSeq>1.19(20)銀行的訂單流水號（銀行產生的訂單唯一標識）14.-訂單金額<orderAmount>1.1X(13)訂單金額格式：整數(shù)位不前補零,小數(shù)位補齊2位即：不超過10位整數(shù)位+1位小數(shù)點+2位小數(shù)無效格式如123，.10，1.1,有效格式如1.00，0.101

35、5.-銀行交易流水號<bankTranSeq>1.1X(22)銀行交易流水號銀行交易日期(8位)+POS終端號(8位)+POS流水號(6位)16.-銀行交易時間<tranTime>1.19(14)退款交易處理的日期時間格式：YYYYMMDDHHMISS17.-中行簽名數(shù)據<signData>1.1X(4000)中行簽名數(shù)據串格式，各項數(shù)據用管道符分隔：商戶號|商戶退款交易流水號|退款金額|商戶訂單號|銀行訂單流水號|訂單金額|銀行交易流水號|銀行交易時間|處理狀態(tài)merchantNo|mRefundSeq|refundAmount|orderNo|order

36、Seq|orderAmount|bankTranSeq|tranTime|hdlSts2.2 商戶發(fā)送查詢訂單請求商戶通過https指令向中行支付網關請求查詢指定訂單的支付情況。商戶系統(tǒng)需要參照以下數(shù)據規(guī)格構造https訂單支付情況查詢指令。2.2.1 請求交易入口CommonQueryOrder.do2.2.2 數(shù)據規(guī)格說明 商戶請求數(shù)據規(guī)格說明序號名稱字段最大長度說明1.商戶號merchantNoX(20)BOC商戶ID2.商戶訂單號字符串orderNosX(1000)商戶系統(tǒng)產生的訂單號，支持輸入多個訂單號進行查詢，最多支持50個訂單號的查詢格式：orderNo|order

37、No|orderNo例如：4|11|10|12|133.商戶簽名信息signDataX(4000)商戶簽名數(shù)據串格式，各項數(shù)據用冒號分隔（其中多筆訂單號使用管道符分隔）：商戶號:商戶訂單號字符串merchantNo:orderNos 銀行應答數(shù)據規(guī)格說明(XML)序號報文要素<XML Tag>屬性類型備注1.Message root<res>1.12.BusinessHeader業(yè)務頭報文塊<header>1.13.-MessageId 報文標識號<msgId>1.14.-HandleStatus 處理狀態(tài)<hdlSts>

38、;1.1A|B|KA-成功 B-失敗 K-未明5.-BodyFlag 業(yè)務體報文塊存在標識<bdFlg>1.10|10-有包體 1-無包體6.-ReturnCode 報文處理返回碼<rtnCd>0.17.BusinessBody業(yè)務體報文塊<body>0.18.-交易信息<orderTrans>0.n交易信息9.-商戶號<merchantNo>1.1X(20)BOC商戶ID10.-商戶訂單號<orderNo>1.1X(19)商戶系統(tǒng)產生的訂單號11.-銀行訂單流水號<orderSeq>1.19(20)銀行的訂單

39、流水號（銀行產生的訂單唯一標識）12.-訂單狀態(tài)<orderStatus>1.1X(2)訂單狀態(tài)：0-未處理1-支付4-未明5-失敗13.-銀行卡類別<cardTyp>1.1X(2)請參考 附件：常用數(shù)據域說明14.-支付卡號<acctNo>1.1X(18)為保護客戶信息，我行暫不提供完整的卡號信息。為便于客戶準確識別簽約銀行卡，我行向商戶反饋客戶的卡號后六位協(xié)議支付商戶請參考 附件：商戶屬性配置說明15.-持卡人姓名<holderName>1.1X(30)為保護客戶信息，我行暫不提供該數(shù)據項，以*反饋商戶協(xié)議支付商戶請參考 附件：商戶屬性配置說

40、明16.-支付卡省行聯(lián)行號<ibknum>1.1X(5)為保護客戶信息，我行暫不提供該數(shù)據項，以*反饋商戶協(xié)議支付商戶請參考 附件：商戶屬性配置說明17.-支付時間<payTime>1.19(14)格式：YYYYMMDDHHMISS18.-支付金額<payAmount>1.1X(13)支付金額，格式：整數(shù)位不前補零,小數(shù)位補齊2位即：不超過10位整數(shù)位+1位小數(shù)點+2位小數(shù)無效格式如123，.10，1.1,有效格式如1.00，0.1019.-訪問者IP<visitorIp>1.1X(40)客戶通過網銀支付時的IP地址信息格式：n.n.n.n其中n

41、為0-255的數(shù)字例如：20.-訪問者Refer信息<visitorRefer>1.1X(3000)客戶瀏覽器跳轉至網銀支付登錄界面前所在頁面的URL（urlEncode格式）第3章 對B2C標準商戶接口規(guī)約3.1 商戶發(fā)送網上銀行支付訂單客戶在商戶網站確認進行訂單支付，選擇中行網上銀行支付后，商戶系統(tǒng)負責按此數(shù)據規(guī)格將消費交易信息發(fā)往中行支付網關系統(tǒng)；商戶主動發(fā)往銀行網關的指令均以POST方式發(fā)送，并且使用UTF8編碼格式。3.1.1 請求交易入口RecvOrder.do3.1.2 數(shù)據規(guī)格說明序號名稱字段最大長度說明1.商戶號merchantNoX(20)

42、必填BOC商戶ID2.支付類型payTypeX(10)必填商戶支付服務類型1：網上購物3.商戶訂單號orderNoX(19)必填商戶系統(tǒng)產生的訂單號4.訂單幣種curCodeX(3)必填目前只支持001：人民幣固定填0015.訂單金額orderAmountX(13)必填格式：整數(shù)位不前補零,小數(shù)位補齊2位即：不超過10位整數(shù)位+1位小數(shù)點+2位小數(shù)無效格式如123，.10，1.1,有效格式如1.00，0.106.訂單時間orderTime9(14)必填格式：YYYYMMDDHHMISS其中時間為24小時格式，例:2010年3月2日下午4點5分28秒表示為201003021605287.訂單說明

43、orderNoteX(200)必填訂單描述，要求如果全中文最多允許60個漢字長度8.商戶接收通知URLorderUrlX(100)必填客戶支付完成后銀行向商戶發(fā)送支付結果，商戶系統(tǒng)負責接收銀行通知的URL9.超時時間orderTimeoutDate9(14)選填格式：YYYYMMDDHHMISS其中時間為24小時格式，例:2010年3月2日下午4點5分28秒表示為2010030216052810.商戶簽名數(shù)據signDataX(4000)必填商戶簽名數(shù)據串格式，各項數(shù)據用管道符分隔：商戶訂單號|訂單時間|訂單幣種|訂單金額|商戶號orderNo|orderTime|curCode|orderA

44、mount|merchantNo3.2 商戶發(fā)送網上銀行分期支付訂單客戶在商戶網站確認進行訂單支付，選擇中行網上銀行分期支付后，商戶系統(tǒng)負責按此數(shù)據規(guī)格將消費交易信息發(fā)往中行支付網關系統(tǒng)；商戶主動發(fā)往銀行網關的指令均以POST方式發(fā)送，并且使用UTF8編碼格式。3.2.1 請求交易入口RecvOrder4PlanPay.do3.2.2 數(shù)據規(guī)格說明序號名稱字段最大長度說明1.商戶號merchantNoX(20)必填BOC商戶ID2.支付類型payTypeX(10)必填商戶支付服務類型1：網上購物3.商戶訂單號orderNoX(19)必填商戶系統(tǒng)產生的訂單號4.訂單幣種curCodeX(3)必填

45、目前只支持001：人民幣固定填0015.訂單金額orderAmountX(13)必填格式：整數(shù)位不前補零,小數(shù)位補齊2位即：不超過10位整數(shù)位+1位小數(shù)點+2位小數(shù)無效格式如123，.10，1.1,有效格式如1.00，0.106.分期計劃planCodeX(4)必填分期計劃格式：IP0X，其中X取值有1、2、3、4、5、6、7、8、9示例：IP017.分期期數(shù)planNumber9(2)必填分期期數(shù)，例如，3代表分3期目前支持分期期數(shù)有3、6、9、12、18、24、36、48、608.訂單時間orderTime9(14)必填格式：YYYYMMDDHHMISS其中時間為24小時格式，例:2010

46、年3月2日下午4點5分28秒表示為201003021605289.訂單說明orderNoteX(200)必填訂單描述，要求如果全中文最多允許60個漢字長度10.商戶接收通知URLorderUrlX(100)必填客戶支付完成后銀行向商戶發(fā)送支付結果，商戶系統(tǒng)負責接收銀行通知的URL11.超時時間orderTimeoutDate9(14)選填格式：YYYYMMDDHHMISS其中時間為24小時格式，例:2010年3月2日下午4點5分28秒表示為2010030216052812.商戶簽名數(shù)據signDataX(4000)必填商戶簽名數(shù)據串格式，各項數(shù)據用管道符分隔：商戶訂單號|訂單時間|訂單幣種|訂

47、單金額|商戶號|分期計劃|分期期數(shù)orderNo|orderTime|curCode|orderAmount|merchantNo| planCode|planNumber3.3 商戶發(fā)送手機銀行支付訂單客戶在商戶手機WAP網站確認進行訂單支付，選擇中行手機銀行支付后，商戶系統(tǒng)負責按此數(shù)據規(guī)格將消費交易信息發(fā)往中行支付網關系統(tǒng)；商戶主動發(fā)往銀行網關的指令均以POST方式發(fā)送，并且使用UTF8編碼格式。3.3.1 請求交易入口B2CMobileRecvOrder.do3.3.2 數(shù)據規(guī)格說明序號名稱字段最大長度說明1.商戶號merchantNoX(20)必填BOC商戶ID2.支付類型payTyp

48、eX(10)必填商戶支付服務類型1：網上購物3.商戶訂單號orderNoX(19)必填商戶系統(tǒng)產生的訂單號4.訂單幣種curCodeX(3)必填目前只支持001：人民幣固定填0015.訂單金額orderAmountX(13)必填格式：整數(shù)位不前補零,小數(shù)位補齊2位即：不超過10位整數(shù)位+1位小數(shù)點+2位小數(shù)無效格式如123，.10，1.1,有效格式如1.00，0.106.訂單時間orderTime9(14)必填格式：YYYYMMDDHHMISS其中時間為24小時格式，例:2010年3月2日下午4點5分28秒表示為201003021605287.訂單說明orderNoteX(200)必填訂單描述

49、，要求如果全中文最多允許60個漢字長度8.商戶接收通知URLorderUrlX(100)必填客戶支付完成后銀行向商戶發(fā)送支付結果，商戶系統(tǒng)負責接收銀行通知的URL9.WAP客戶標識spMobileX(54)選填如果客戶通過商戶系統(tǒng)直接發(fā)訂單到中行網關，該域可空；如果客戶通過中行手機商城的鏈接到商戶時，中行手機商城會生成由渠道號和手機號組合加密的數(shù)據傳送給WAP商戶系統(tǒng)，客戶在WAP商戶系統(tǒng)對訂單進行支付時，WAP商戶系統(tǒng)需要提供該信息；10.超時時間orderTimeoutDate9(14)選填格式：YYYYMMDDHHMISS其中時間為24小時格式，例:2010年3月2日下午4點5分28秒表

50、示為2010030216052811.商戶簽名數(shù)據signDataX(4000)必填商戶簽名數(shù)據串格式，各項數(shù)據用管道符分隔：商戶訂單號|訂單時間|訂單幣種|訂單金額|商戶號orderNo|orderTime|curCode|orderAmount|merchantNo3.4 商戶發(fā)送家居銀行支付訂單客戶在商戶電視機頂盒系統(tǒng)界面確認進行訂單支付，選擇中行家居銀行支付后，商戶系統(tǒng)負責按此數(shù)據規(guī)格將消費交易信息發(fā)往中行支付網關系統(tǒng)；商戶主動發(fā)往銀行網關的指令均以POST方式發(fā)送，并且使用UTF8編碼格式。3.4.1 請求交易入口HomeBankRecvOrder.do3.4.2 數(shù)據規(guī)格說明序號名

51、稱字段最大長度說明1.商戶號merchantNoX(20)必填BOC商戶ID2.支付類型payTypeX(10)必填商戶支付服務類型1：網上購物3.商戶訂單號orderNoX(19)必填商戶系統(tǒng)產生的訂單號4.訂單幣種curCodeX(3)必填目前只支持001：人民幣固定填0015.訂單金額orderAmountX(13)必填格式：整數(shù)位不前補零,小數(shù)位補齊2位即：不超過10位整數(shù)位+1位小數(shù)點+2位小數(shù)無效格式如123，.10，1.1,有效格式如1.00，0.106.訂單時間orderTime9(14)必填格式：YYYYMMDDHHMISS其中時間為24小時格式，例:2010年3月2日下午4

52、點5分28秒表示為201003021605287.訂單說明orderNoteX(200)必填訂單描述，要求如果全中文最多允許60個漢字長度8.商戶接收通知URLorderUrlX(100)必填客戶支付完成后銀行向商戶發(fā)送支付結果，商戶系統(tǒng)負責接收銀行通知的URL9.超時時間orderTimeoutDate9(14)選填格式：YYYYMMDDHHMISS其中時間為24小時格式，例:2010年3月2日下午4點5分28秒表示為2010030216052810.商戶簽名數(shù)據signDataX(4000)必填商戶簽名數(shù)據串格式，各項數(shù)據用管道符分隔：商戶訂單號|訂單時間|訂單幣種|訂單金額|商戶號ord

53、erNo|orderTime|curCode|orderAmount|merchantNo3.5 銀行反饋訂單支付結果(頁面通知)中行支付網關接收商戶發(fā)來的網上銀行支付（包括分期支付）訂單、手機銀行支付訂單或家居銀行支付訂單后，引導客戶進行支付確認，客戶通過中行網銀、手機銀行或家居銀行提交支付指令后，支付網關進行支付處理，處理完成后由網上銀行支付（包括分期支付）結果頁面、手機銀行支付結果頁面或家居銀行支付結果頁面向商戶系統(tǒng)按以下數(shù)據規(guī)格反饋訂單支付結果；指令均以POST方式發(fā)送，并且使用UTF8編碼格式。3.5.1 數(shù)據規(guī)格說明序號名稱字段最大長度說明1.商戶號merchantNoX(20)BOC商戶ID2.商戶訂單號orderNoX(19)商戶系統(tǒng)產生的訂單號3.銀行訂單流水號orderSeq9(20)銀行的訂單流水號（銀行產生的訂單唯一標識）4.銀行卡類別cardTypX(2)請參考 附件：常用數(shù)據域說明5.支付時間payTime9(14)格式：YYYYMMDDHHMISS6.訂單狀態(tài)orderS