中國(guó)銀行電子商務(wù)商戶接口文檔全集

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

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

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

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

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

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

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

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

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

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

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

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

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

14、<FORM METHOD="POST" ACTION="https:/domainName/PGWPortal/RecvOrder.do"><!-01.商戶號(hào)-><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.商戶訂單號(hào)-><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.訂單時(shí)間-><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.超時(shí)時(shí)間 -><INPUT TYPE="HIDDEN" SIZE="14" ID

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

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

21、覽器Refer信息orderReferX(200).10.銀行交易流水號(hào)bankTranSeqX(22).11.返回操作類型returnActFlagX(1).12.電話號(hào)碼phoneNumX(50).13.中行簽名數(shù)據(jù)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 銀行直連接收交易結(jié)果示例針對(duì)商戶與銀行直連類交易（如聯(lián)機(jī)退貨、訂單查詢等），我行均按照相關(guān)接口定義采用XML格式同步返回交易結(jié)果，內(nèi)容使用UTF-8編碼格式。以 B2C訂單查詢 為例，說明銀行系統(tǒng)同步反饋數(shù)據(jù)形式 (本節(jié)以下內(nèi)容僅作為示例使用)。序號(hào)報(bào)文要素<XML Tag>屬性類型備注1.Message root<res>1.12.BusinessHeader業(yè)務(wù)頭報(bào)文塊<header>1.13.-MessageId 報(bào)文標(biāo)識(shí)號(hào)<msgId>1.1.4.-

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

25、derStatus>1.1X(2).13.-銀行卡類別<cardTyp>1.1X(2).14.-支付卡號(hào)<acctNo>1.1X(18).15.-持卡人姓名<holderName>0.1X(30)在不同業(yè)務(wù)配置情況下，此數(shù)據(jù)域可能不存在16.-支付卡省行聯(lián)行號(hào)<ibknum>0.1X(5)在不同業(yè)務(wù)配置情況下，此數(shù)據(jù)域可能不存在17.-支付時(shí)間<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ù)據(jù)域?yàn)榭?/p>

28、選項(xiàng)-><ibknum>47428</ibknum> <!此數(shù)據(jù)域?yàn)榭蛇x項(xiàng)-><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ù)據(jù)域?yàn)榭蛇x項(xiàng)-><payTime>20110624171313</payTime> <payAmount>100.00</payAmount> <visitorIp />

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

45、目前只支持001：人民幣固定填0015.訂單金額orderAmountX(13)必填格式：整數(shù)位不前補(bǔ)零,小數(shù)位補(bǔ)齊2位即：不超過10位整數(shù)位+1位小數(shù)點(diǎn)+2位小數(shù)無效格式如123，.10，1.1,有效格式如1.00，0.106.分期計(jì)劃planCodeX(4)必填分期計(jì)劃格式：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.訂單時(shí)間orderTime9(14)必填格式：YYYYMMDDHHMISS其中時(shí)間為24小時(shí)格式，例:2010

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

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

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

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

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

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

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

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