中国银行理财直付产品接口文档（商户端）

中国银行理财直付产品接口文档（商户端）

-IPPSInterfaceSpecification（formerchant）

单位电子渠道开发部（网银团队）

撰写人曹克、孙永、延冰、梁栋、乔大伟

版本VI.1

修订说明

序修改人日期修改说明

号

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

2梁栋2010-11-8修改告询类接口的返回报文

3乔大伟2010-11-17将本文档定义为产品级文档，补充所有对商户端接口。该文档成为日后向商户

出文档的基础。

4梁栋2010-12-7修改理财直付和协议支付批量部分字段项

5乔大伟2011-02-12增加持卡人姓名，修改签名项

份^中闻能行软竹中心

总体设计

目录

IPPS产品接口文档（商户端）.

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

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

1.1文档说明.........................................................................................................4

1.2编写目的.........................................................................................................4

1.3参考资料.........................................................................................................4

1.4适用读者.........................................................................................................4

第2章对B2c理财直付商户接口规约........................................................................................................4

2.1通讯协议.........................................................................................................4

2.2接口报文.........................................................................................................5

2.2.1商户发送认证丽求..............................................................................................

2.2.2银行反馈认证结果（页面通知）.....................................................................................

2.2.3银行反馈认证结果（主动通知）.....................................................................................

2.2.4商户发送订单支付请求-绑定类...................................................................................

2.2.5银行反馈订推支付结果-绑定类（页面通知）...........................................................................

2.2.6银行反馈订单支付结果-绑定类（主动通知）..........................................................................

2.2.7商户发送订单支付请求-作绑定类..................................................................................

2.2.8银行反馈订单支付结果-非绑定类（页面通知）........................................................................

2.2.9银行反馈订单支付结果;IE绑定类（主动通知）.........................................................................

2.2.10商户发送退货交易请求..........................................................................................

2.2.11商户发送查询认证请求...........................................................................................

2.2.12商户发送查询订电请求...........................................................................................

2.2.13订单业务对账文件...............................................................................................

2.2.14财务对账文件..................................................................................................

2.2.15认证流水文件...................................................................................................

2.3安全机制.........................................................................................................................44

2.3.1安全机制简介..................................................................................................................44

中国或行攸竹中心

01CHINA"TWAMrwT”总体设计

2.3.2筌名与臆蝮..................................................................................................

第1章前后

L1文档说明

本文描述了中国银行IPPS相关服务通讯协议、报文格式，安全机制。作为商户端系统技术人员开发的参考文档。

L2编写目的

为使商户端系统开发人员了解IPPS服务的相关通讯接口细节。

1.3参考资料

中国银行IPPS相关的业务流程见《商户端开发指引》。本文不在复述。

1.4适用读者

商户端系统开发人员（分析师、设计人员、程序员）

第2章对B2C理财直付商户接口规约

2・1通讯协议

目前网银系统支持三种方式与商户之间传递信息：

网银I才队支付小组第4页共46页

寸图葭行攸竹中心

01CHINAMTTTWAairtNTtM总体设计

＞通过客户浏览擀间按通讯；

a.商户引导客户浏览器，将信息提交到网银系统。商户发送身份认证指令以及支付指令接口时采用该方式通讯。表单数据中需

包含商户对身份认证信息和订单信息的签名。

b.网银引导客户浏览器将信息提交到商户系统。网银反馈身份认证和支付结果接口采用该通讯方式。表单数据中包含网银系统

的签名信息。

＞商户操作员通过浏览器操作网银：

商户操作员登录网银操作网银功能，用来下载业务对账文件与财务对账文件。（网银系统提供的其他商户操作员功能如状态台

询等由于不设计系统之间的接口规范，因此不再描述）

＞直接通讯：

商户系统与网银系统之间直接建立通讯链路，该通讯采用HTTPS协议，由商户系统主动发起通讯。支付状态查询接口和身份认

证结果查询接口采用此通讯方式。

2.2接口报文

2.2.1商户发送认证请求

理财直付商户网站进行对客户的身份认证，选择中行后，商户系统负责按此数据规格将客户身份信息发往中行支付网关系统

请求入口：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总体设计

理财直付商户端接口一商户发送认证请求: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银行反馈认证结果（页面通知）

网关接收商户发来的身份认证请求后进行认证处理，处理完成后向商户系统按以下数据规格反馈支付结果。

序号名称字段最大长度说明

「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)

认证卡省行联

6.ibknumX⑸认证卡省行联行号

行号

7.认证卡号acctNoX(19)认证卡号

8.商户提交时间verifyTime9(14)商户提交身份认证的「I期时间格式：YYYYMMDDHHMMSS

9.银行认证时间bocVerifyTime9(14)银行认证的日期时间格式：YYYYMMDDHHMMSS

10.uwST

认证状态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)|认证状态|限行认证时间|认证，•省行联行号

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)持卡人姓名

认证卡省行联

6.ibknumX⑸认证卡省行联行号

行号

r7.认证卡号acctNoX(19)认证卡号

P8.商户提交时间verifyTime9(14)商户提交身份认证的口期时间格式：YYYYMMDDHIIMMSS

网银If队支付小组第9页共46页

中国簸行软竹中心

01CHINAMTTTWAairtNTtM总体设计

9.银行认证时间bocVerifvTime9(14)银行认证的日期时间格式：YYYYMMDDHHMMSS

10.认证状态：

认证状态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认证状态I银行认证时间I认证卡省行联行号

merchantNo|validId|identityType|identityNumber|hol

derName|acctNo|status|bocVerifyTime|ibknum

2.2.4商户发送订单支付请求-已完成签约认证

持卡人在绑定类商户网站确认进行订单支付，选择中行支付后，商户系统负责按此数据规格将消费交易信息发往中行支付网关系

统。

请求入口：LCPBindRecvOrder.do

网银If队支付小组第10页共46页

份^中闻能行软竹中心

总体设说

序号名称字段最大长度说明

3、填

1商户号merchantNoX(20)

BOC商户ID

必填

2.商户订单号orderNoX(19)

商户系统产生的订单号[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

接口示例:

理财直付商户端接口一商户发送支付指令: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银行反馈订单支付结果-已完成签约认证（页面通知）

网关接收绑定类商户发来的支付请求后进行支付处理，处理完成后向商户系统按以下数据规格反馈支付结果。

序号名称字段最大长度说明

1.商户号merchantNoX(20)BOC商户ID

2.商户订单号orderNoX(30)商户系统产生的订单号

银行订单流

3.orderSeq9(20)银行的订单流水号（银行产生的订单唯一标识）

水号

4.银行卡类别：

01：中行借记卡

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

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

11：银联借记卡

21：VISA借记卡

银行卡类别cardTypX(2)

22：VISA信用卡

31：MC借记卡

32：MC信用卡

42：运通卡

52：大来卡

62：JCB卡

5.支付时间payTime9(14)支付交易的日期时间

网银If队支付小组第13页共46页

份^中闻能行软竹中心

总体设说

格式：YYYYMMDDHHMISS

订单状态：

未处

6.理

0：

支付

1:

撤销

订单状态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)支付卡省行联行号

联行号

银行交易流银行交易流水号

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)支付省行联行号|银行类别|支付时间|订单状态|支付金额

据Ikk

merchantNo|orderNo|orderSeq|bankTranSeq|holderNam

e|ibknum|cardTyp|payTime|orderStatus|payAmount

2.2.6银行反馈订单支付结果-已完成签约认证（主动通知）

参考：银行反馈支付结果-绑定类（页面通知）

2.2.7商户发送订单支付请求-支付过程中完成身份认证（支付接口中含客户姓名、证件类型、号码信息）

持卡人在非绑定类商户网站（即该网站是和消费持卡人没有绑定关系的，在支付交易时需要商户同时上送持卡人的证件类型，证

件号码以及支付卡号）确认进行订单支付，选择中行支付后，商户系统负责按此数据规格将消费交易信息发往中行支付网关系统。

请求入口：ICPNoBindRecvOrder.do

序号名称字段最大长度说明

必填

1.商户号merchantNoX(20)

BOC商户ID

必填

2.商户订单号orderNoX(30)

商户系统产生的订单号[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)持卡人姓名