中國銀行理財直付產品接口文檔（商戶端）

-IPPSInterfaceSpecification（formerchant）

單位電子渠道開發(fā)部（網銀團隊）

撰寫人曹克、孫永、延冰、梁棟、喬大偉

版本VI.1

修訂說明

序修改人日期修改說明

號

1梁林2010-6-26完成初稿

2梁棟2010-11-8修改告詢類接口的返回報文

3喬大偉2010-11-17將本文檔定義為產品級文檔，補充所有對商戶端接口。該文檔成為日后向商戶

出文檔的基礎。

4梁棟2010-12-7修改理財直付和協(xié)議支付批量部分字段項

5喬大偉2011-02-12增加持卡人姓名，修改簽名項

份^中聞能行軟竹中心

總體設計

目錄

IPPS產品接口文檔（商戶端）.

-IPPSINTERFACESPECIFICATION（FORMERCHANT）....................................................................................................................................................................................................1

第1章前三...............................................................................................................................4

1.1文檔說明.........................................................................................................4

1.2編寫目的.........................................................................................................4

1.3參考資料.........................................................................................................4

1.4適用讀者.........................................................................................................4

第2章對B2c理財直付商戶接口規(guī)約........................................................................................................4

2.1通訊協(xié)議.........................................................................................................4

2.2接口報文.........................................................................................................5

2.2.1商戶發(fā)送認證麗求..............................................................................................

2.2.2銀行反饋認證結果（頁面通知）.....................................................................................

2.2.3銀行反饋認證結果（主動通知）.....................................................................................

2.2.4商戶發(fā)送訂單支付請求-綁定類...................................................................................

2.2.5銀行反饋訂推支付結果-綁定類（頁面通知）...........................................................................

2.2.6銀行反饋訂單支付結果-綁定類（主動通知）..........................................................................

2.2.7商戶發(fā)送訂單支付請求-作綁定類..................................................................................

2.2.8銀行反饋訂單支付結果-非綁定類（頁面通知）........................................................................

2.2.9銀行反饋訂單支付結果;IE綁定類（主動通知）.........................................................................

2.2.10商戶發(fā)送退貨交易請求..........................................................................................

2.2.11商戶發(fā)送查詢認證請求...........................................................................................

2.2.12商戶發(fā)送查詢訂電請求...........................................................................................

2.2.13訂單業(yè)務對賬文件...............................................................................................

2.2.14財務對賬文件..................................................................................................

2.2.15認證流水文件...................................................................................................

2.3安全機制.........................................................................................................................44

2.3.1安全機制簡介..................................................................................................................44

中國或行攸竹中心

01CHINA"TWAMrwT”總體設計

2.3.2筌名與臆蝮..................................................................................................

第1章前后

L1文檔說明

本文描述了中國銀行IPPS相關服務通訊協(xié)議、報文格式，安全機制。作為商戶端系統(tǒng)技術人員開發(fā)的參考文檔。

L2編寫目的

為使商戶端系統(tǒng)開發(fā)人員了解IPPS服務的相關通訊接口細節(jié)。

1.3參考資料

中國銀行IPPS相關的業(yè)務流程見《商戶端開發(fā)指引》。本文不在復述。

1.4適用讀者

商戶端系統(tǒng)開發(fā)人員（分析師、設計人員、程序員）

第2章對B2C理財直付商戶接口規(guī)約

2?1通訊協(xié)議

目前網銀系統(tǒng)支持三種方式與商戶之間傳遞信息：

網銀I才隊支付小組第4頁共46頁

寸圖葭行攸竹中心

01CHINAMTTTWAairtNTtM總體設計

＞通過客戶瀏覽搟間按通訊；

a.商戶引導客戶瀏覽器，將信息提交到網銀系統(tǒng)。商戶發(fā)送身份認證指令以及支付指令接口時采用該方式通訊。表單數據中需

包含商戶對身份認證信息和訂單信息的簽名。

b.網銀引導客戶瀏覽器將信息提交到商戶系統(tǒng)。網銀反饋身份認證和支付結果接口采用該通訊方式。表單數據中包含網銀系統(tǒng)

的簽名信息。

＞商戶操作員通過瀏覽器操作網銀：

商戶操作員登錄網銀操作網銀功能，用來下載業(yè)務對賬文件與財務對賬文件。（網銀系統(tǒng)提供的其他商戶操作員功能如狀態(tài)臺

詢等由于不設計系統(tǒng)之間的接口規(guī)范，因此不再描述）

＞直接通訊：

商戶系統(tǒng)與網銀系統(tǒng)之間直接建立通訊鏈路，該通訊采用HTTPS協(xié)議，由商戶系統(tǒng)主動發(fā)起通訊。支付狀態(tài)查詢接口和身份認

證結果查詢接口采用此通訊方式。

2.2接口報文

2.2.1商戶發(fā)送認證請求

理財直付商戶網站進行對客戶的身份認證，選擇中行后，商戶系統(tǒng)負責按此數據規(guī)格將客戶身份信息發(fā)往中行支付網關系統(tǒng)

請求入口：LCPVerify.do

序號名稱字段最大長度說明

必填

1.商戶號merchantNoX(20)

BOC商戶ID

網銀If隊支付小組第5頁共46頁

份^中聞能行軟竹中心

總體設說

2.必填

持卡人的證件類型

1：身份證

證件類型identityTypeX(2)

3：戶口薄、

4:軍人身份證

5：武裝警察身份證

必填

3.證件號碼identityNumberX(30)

持卡人證件號碼

持卡人姓

4.holderNameX(30)持卡人姓名

名

必填

5.認證卡號acctNox(19)

認證卡號

商戶網站必填

6.IcpMerchantUrlX(100)

URL認證完成后返回商戶網站的URL

7.必填

商戶提交格式：YYYYMMDDHHMMSS

verifyTimeX(14)

時間其中時間為24小時格式，例:2010年3月2日下午4點5分28

秒表示為20100302160528

8.必填

商戶簽名數據串格式，各項數據用管道符分隔：

商戶簽名

signDataX(4000)商戶號|證件類型|證件號碼|持卡人姓名|認證卡號|商戶提交時間

數據

merchantNo|identityType|identityNumber|holderName|

acctNo|verifyTime

接口示例：

網銀II隊支付小組第6頁共46頁

中國簸行軟竹中心

01CHINAMTTTWAairtNTtM總體設計

理財直付商戶端接口一商戶發(fā)送認證請求:LCPVerify.do

<FORMMETHOD="POST"ACTION="https://domainname/PGWPortal/LCPVerify.do">

.商戶號一〉

<INPUTTYPE="HIDDEN"ID="merchantNo"NAME="merchantNo"VALUE="104123123409234"xBR/>

<!-02.證件類型

<INPUTTYPE="HIDDEN"ID="identityType"NAME="identityType"VALUE="l"><BR/>

<!-03.證件號碼一

<INPUTTYPE="HIDDEN"ID="identityNumber"NAME="identityNumber"VALUE="23214119810101231"><BR/>

<!-04.持卡人姓名

<INPUTTYPE="HIDDEN"ID="holderNamewNAME=MholderNamewVAIUE="張三

<!-05.認證卡號

<INPUTTYPE^'HIDDEN"ID="3CCTNo"NAME="acCXNo"VALUE="4563510100123456789"><BR/>

<!-06.商戶網站URL-->

<INPUTTYPE="HIDDEN"ID="lcpMerchantUri"NAME="lcpMerchantUrl"VALUE="http://domainname/webapp/"><BR/>

<!-07.商戶提交時間

<INPUTTYPE="HIDDEN"ID="verifyTime"NAME="verifyTime"VALUE=',2OO9O6O1121212"xBR/>

<1-08.商戶簽名數據

<INPUTTYPE="HIDDEN"ID="signData"NAME="signData"VALUE="vsdfdscdsgtfewtaa"xBR/>

</F0RM>

2.2.2銀行反饋認證結果（頁面通知）

網關接收商戶發(fā)來的身份認證請求后進行認證處理，處理完成后向商戶系統(tǒng)按以下數據規(guī)格反饋支付結果。

序號名稱字段最大長度說明

「1.1商戶號merchantNoX(20)BOC商戶ID

網銀II隊支付小組第7頁共46頁

份^中聞能行軟竹中心

<”CHINAMWTW?MC?Mt?總體設it

2.認證流水號validld9(20)銀行產生的認證流水號

3.痔K人的證件類型

1：身份證

證件類型identityTypeX(2)3：戶口薄、

4:軍人身份證

5:武裝警察身份證

4.證件號碼identityNumberX(30)

5.持卡人姓名holderNcmeX(30)

認證卡省行聯(lián)

6.ibknumX⑸認證卡省行聯(lián)行號

行號

7.認證卡號acctNoX(19)認證卡號

8.商戶提交時間verifyTime9(14)商戶提交身份認證的「I期時間格式：YYYYMMDDHHMMSS

9.銀行認證時間bocVerifyTime9(14)銀行認證的日期時間格式：YYYYMMDDHHMMSS

10.uwST

認證狀態(tài)statusX(l)1-認證成功

2-認證失敗

11.再方通過兩銀婦寸時的］P地址信息

格式：n.n.n.n

訪問者IPvisitorlpX(40)

其中n為0-255的數字

例如：192,168.0.1

12.訪問者Refer客戶瀏覽器跳轉至網銀支付登錄界面前所在頁面的URL

visitorReferX(3000)

信息（urlEncode格式）

網銀If隊支付小組第8頁共46頁

中國簸行軟竹中心

總體設計

113.中行簽名數據串格式，各項數據用管道符分廂：

寓戶號|認證流水號|證件類型|證件號碼|持卡人姓名|認證卡號

中行簽名數據signDataX(4000)|認證狀態(tài)|限行認證時間|認證，?省行聯(lián)行號

merchantNo|validId|identityType|identitylNumber|hol

derName|acctNo|status|bocVerifyTime|ibknum

2.2.3銀行反饋認證結果（主動通知）

序號名稱字段最大長度說明

1I.商戶號merchantNoX(20)BOC商戶】D

2.認證流水號validld9(20)銀行產生的認證流水號

3.持卡人的證件類型

1:身份證

證件類型identityTypeX(2)3:戶口簿、

4:軍人身份證

5:武裝警察身份證

4.證件號碼identityNumberX(30)持卡人證件號碼

5.持卡人姓名holderNcmeX(30)持卡人姓名

認證卡省行聯(lián)

6.ibknumX⑸認證卡省行聯(lián)行號

行號

r7.認證卡號acctNoX(19)認證卡號

P8.商戶提交時間verifyTime9(14)商戶提交身份認證的口期時間格式：YYYYMMDDHIIMMSS

網銀If隊支付小組第9頁共46頁

中國簸行軟竹中心

01CHINAMTTTWAairtNTtM總體設計

9.銀行認證時間bocVerifvTime9(14)銀行認證的日期時間格式：YYYYMMDDHHMMSS

10.認證狀態(tài)：

認證狀態(tài)statusX(l)1-認證成功

2-認證失敗

11.客戶通過網銀支付時的IP地址信息

格式：n.n.n.n

訪問者IPvisitorlpX(40)

其中n為0-255的數字

例如：

12.訪問者Refer客戶瀏覽器跳轉至網銀支付登錄界面前所在頁面的URL

visitorReferX(3000)

信息（urlEncode格式）

13.主動通知類型

主動通知類型notlfyTypeX(l)

V-認證通知

r中行簽名數據串格式，各項數據用管道符分隔：

商戶號I認證流水號|證件類型|證件號碼I持卡人姓名I認證卡號

中行簽名數據signDataX(4000)I認證狀態(tài)I銀行認證時間I認證卡省行聯(lián)行號

merchantNo|validId|identityType|identityNumber|hol

derName|acctNo|status|bocVerifyTime|ibknum

2.2.4商戶發(fā)送訂單支付請求-已完成簽約認證

持卡人在綁定類商戶網站確認進行訂單支付，選擇中行支付后，商戶系統(tǒng)負責按此數據規(guī)格將消費交易信息發(fā)往中行支付網關系

統(tǒng)。

請求入口：LCPBindRecvOrder.do

網銀If隊支付小組第10頁共46頁

份^中聞能行軟竹中心

總體設說

序號名稱字段最大長度說明

3、填

1商戶號merchantNoX(20)

BOC商戶ID

必填

2.商戶訂單號orderNoX(19)

商戶系統(tǒng)產生的訂單號[a-zA-ZO-9]

3.必填

訂單幣種curCodeX(3)目前只支持001-人民幣

固定填001

4.必填

格式：整數位不前補零，小數位補齊2位

訂單金額orderAmountX(13)

即：不超過10位整數位+1位小數點+2位小數

無效格式如123,.10,1.1,有效格式如1.00.0.10

5.必填

格式：YYYYMMDDHHMMSS

訂單時間orderTimeX(14)

其中時間為24小時格式，例:2010年3月2日下午4點5分28秒表

示為20100302160528

選填

6.訂單說明orderNoteX(200)

訂單描述，要求如果全中文最多允許60個漢字長度

必填

7.支付卡號acctNoX(19)

持寺人綁定的支付卡號

商戶網站必填

8.orderllrlX(100)

URL持k人支付完成后能夠返回的商戶網站URL

商戶簽名數X(400必填

9.signData

據0)商戶簽名數據串格式，各項數據用管道符分隔：

網銀II隊支付小組第11頁共46頁

份^中聞能行軟竹中心

總體設說

商戶號1商戶訂單號1訂單幣種1訂單金額1訂單時間1支付卜?號

merchantNo|orderNo|curCode|orderAmount|orderTime|acctN

0

接口示例:

理財直付商戶端接口一商戶發(fā)送支付指令:LCPBindRecvOrder,do====

<FORMMETHOD="POST"ACTION="https://domainname/PGWPortal/LCPBindRecvOrder.do">

<!一01.商戶號一>

<INPUTTYPE="HIDDEN"ID="merchantNo"NAME="merchantNo"VALUE="104123123409234"xBR/>

<!-02.商戶訂單號

<INPUTTYPE="HIDDEN"ID="orderNo"NAME="orderNo"VALUE="order001"><BR/>

<!-03.訂單幣種-->

<INPUTTYPE="HIDDEN"ID="curCode"NAME="curCode"VALUE="001"xBR/>

<!-04.訂單金額->

<INPUTTYPE="HIDDEN"ID="orderAmount"NAME="orderAmount"VALUE="0.01"><BR/>

<!-05.訂單時間“>

<INPUTTYPE="HIDDEN"ID="orderTime"NAME="orderTime"VALUE="20090601121212"><BR/>

<!-06.訂單說明

<INPUTTYPE="HIDDEN"ID="orderNote"NAME="orderNote"VALUE="test"xBR/>

<!--07.支付卡號.>

<INPUTTYPE="HIDDEN"ID="acctNo"NAME="acctNo"VALUE="4563510100123419401"xBR/>

<!-08.商戶網站URL->

<INPUTTYPE="HIDDEN"ID="orderllrl"NAiyE="orderUrl"VALUE="/app"xBR/>

<!-09.商戶簽名數據—>

<INPUTTYPE="HIDDEN"ID="signData"NAME="signData"VALUE="sdfwerewfds"xBR/>

<BR/>

網銀If隊支付小組第12頁共46頁

中國簸行軟竹中心

總體設計

〈/FORM>

2.2.5銀行反饋訂單支付結果-已完成簽約認證（頁面通知）

網關接收綁定類商戶發(fā)來的支付請求后進行支付處理，處理完成后向商戶系統(tǒng)按以下數據規(guī)格反饋支付結果。

序號名稱字段最大長度說明

1.商戶號merchantNoX(20)BOC商戶ID

2.商戶訂單號orderNoX(30)商戶系統(tǒng)產生的訂單號

銀行訂單流

3.orderSeq9(20)銀行的訂單流水號（銀行產生的訂單唯一標識）

水號

4.銀行卡類別：

01：中行借記卡

02：中行信用卡，信用卡（分行卡）

04：中行信用卡，信用卡（總行卡）

11：銀聯(lián)借記卡

21：VISA借記卡

銀行卡類別cardTypX(2)

22：VISA信用卡

31：MC借記卡

32：MC信用卡

42：運通卡

52：大來卡

62：JCB卡

5.支付時間payTime9(14)支付交易的日期時間

網銀If隊支付小組第13頁共46頁

份^中聞能行軟竹中心

總體設說

格式：YYYYMMDDHHMISS

訂單狀態(tài)：

未處

6.理

0：

支付

1:

撤銷

訂單狀態(tài)orderstatusX(2)2：

：退貨

3未明

4：失收

5：

7.支付金額

格式：整數位不前補零，小數位補齊2位

支付金額payAmountX(13)

即：不超過10位整數位+1位小數點+2位小數

無效格式如123,.10,1.1,有效格式如1.00,0.10

8.支付卡號acctNoX(19)持卡人綁定的支付卡號

9.持卡人姓名holderNameX(30)持卡人姓名

支付卡省行

10.ibknumx(5)支付卡省行聯(lián)行號

聯(lián)行號

銀行交易流銀行交易流水號

11.bankTranSeqx(22)

水號銀行交易日期（8位）+POS終端號（8位）+POS流水號（6位）

12.持卡人通過網銀支付時的IP地址信H

格式：n.n.n.n

訪問者IPvisitorlpX(40)

其中n為0-255的數字

例如：

訪問者持卡人瀏覽朧跳轉至網銀支宿逐泵界面前所在貢面的URL

13.visitorReferX(200)

Refer信息（urlEncode格式）

網銀II隊支付小組第14頁共46頁

中國簸行軟竹中心

01CHINAMTTTWAairtNTtM總體設計

11.中行簽名數據串格式，各項數據用管道符分隔：

商戶號商戶訂單號銀行訂單流水號銀行交易流水號持卡人姓名

中行簽名數1111

signDataX(4000)支付省行聯(lián)行號|銀行類別|支付時間|訂單狀態(tài)|支付金額

據Ikk

merchantNo|orderNo|orderSeq|bankTranSeq|holderNam

e|ibknum|cardTyp|payTime|orderStatus|payAmount

2.2.6銀行反饋訂單支付結果-已完成簽約認證（主動通知）

參考：銀行反饋支付結果-綁定類（頁面通知）

2.2.7商戶發(fā)送訂單支付請求-支付過程中完成身份認證（支付接口中含客戶姓名、證件類型、號碼信息）

持卡人在非綁定類商戶網站（即該網站是和消費持卡人沒有綁定關系的，在支付交易時需要商戶同時上送持卡人的證件類型，證

件號碼以及支付卡號）確認進行訂單支付，選擇中行支付后，商戶系統(tǒng)負責按此數據規(guī)格將消費交易信息發(fā)往中行支付網關系統(tǒng)。

請求入口：ICPNoBindRecvOrder.do

序號名稱字段最大長度說明

必填

1.商戶號merchantNoX(20)

BOC商戶ID

必填

2.商戶訂單號orderNoX(30)

商戶系統(tǒng)產生的訂單號[a-zA-ZO-9]

3.必煩

訂單幣種curCodeX(3)目前只支持001-人民幣

固定填001

網銀If隊支付小組第1S頁共46頁

份^中聞能行軟竹中心

總體設說

4.必填

格式：整數位不前補零，小數位補齊2位

訂單金額orderAmountX(13)

即：不超過10位整數位+1位小數點+2位小數

無效格式如123,.10,1.1,有效格式如1.00,0.10

5.必填

格式：YYYYMMDDHHMMSS

訂單時間orderTimeX(14)

其中時間為24小時格式，例:2010年3月2日下午4點5分28

秒表示為20100302160528

選填

6.訂單說明orderNoteX(200)

訂單描述，要求如果全中文最多允許60個漢字長度

7.必填

持卡人的證件類型

1：身份證

證件類型identityTypex(2)

3：戶口薄、

4:軍人身份證

5：武裝警察身份證

identityNumbe必填

8.證件號碼X(30)

r持卡人證件號碼

9.持卡人姓名holderNameX(30)持卡人姓名