IPPS产品总体设计(商户端接口)_new

更新时间：2023-04-30 00:49:01 阅读量：综合文库文档下载

说明：文章内容仅供预览，部分内容可能不全。下载后的文档，内容与下面显示的完全一致。下载之前请确认下面内容是否您想要的，是否完整无缺。

ipps推荐度：
相关推荐

IPPS产品对商户端接口标准

单位中国银行

撰写人IPPS开发组

版本

修订说明

序号修改人日期版本号修改说明

1.梁栋2010-6-26 Ver 0.1 完成初稿

2.梁栋2010-11-8 Ver 0.2 修改查询类接口的返回报文

3.乔大伟2010-11-17 Ver 0.3 将本文档定义为产品级文档，补充所有对商户端接口。

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

5.乔大伟2011-03-16 Ver 0.5沪苏吴批次针对人行二号令对本文档进行如下修改：

2.2.4 修改银行返回订单支付结果(页面通知)

2.2.5 修改银行返回订单支付结果(主动通知)

2.2.7 新增商户发送查询订单请求(支持卡户信息判

断)

5.2.10 修改商户发送订单支付请求

6.2.1.4新增商户发送B2B订单查询请求(支持卡户信息

判断)

6.乔大伟2011-05-23 Ver 1.1 [公共]

以湘鄂桂批次实现为基线，建立基础版本1.1

7.乔大伟2011-06-13 Ver 1.2.1 [粤深]

4.2.3 修改银行反馈认证结果(主动通知)增加

notifyType

8.乔大伟2011-06-17 Ver 1.2.2 [公共]

整理文档内容，重新归纳安全机制，整理联机部分接口。

9.乔大伟2011-06-21 Ver 1.2.3 [粤深]

5.2.4 修改商户发送修改协议请求增加agreeUrl。10.李红梅2011-06-21 Ver 1.2.4 [公共]

6.2.2 修改根据B2B相关文档补充数据说明项

11.李红梅2011-07-25 Ver 1.2.5 [公共]

2.2.12 删除交易流水文件生成

12.乔大伟2011-07-25 Ver 1.3.1 [粤深后批次] 铁道部紧急需求变更

修改商户发送网上银行支付订单

13.李新2011-10-24 Ver 1.4.1 [P201]

修改协议支付签约返回结果增加签约渠道

修改协议支付签约、改约、解约，查询协议、订单支

付，查询订单接口中返回数据项卡号返回规则修改

14.李新2012-03-14 Ver 1.5.1 [P204]

新增商户对接上传下载文件接口规约

15.乔大伟2012-04-19 Ver 1.6.1 [P205]

16.李红梅2012-07-09 Ver 1.7.1 [P207]

新增商户发送网上银行分期支付订单

17.梁栋2012-07-25 Ver 1.7.2 [P207]

新增分行特色业务接口

18.乔大伟

陈发建2012-08-31 Ver 1.8.1 [P301]

文档结构进行重大调整；

梁晓晓协议支付增加对商户属性管理的支持；

19.梁栋2012-9-18 Ver 1.8.2 [P301]

B2B订单支付(监管商户、非监管商户)增加超时时间数据

项

20.李红梅2012-11-01 Ver 1.8.3 [P301]

修改B2B订单查询接口的返回报文和示例

21.李红梅2012-11-21 Ver 1.8.4 [P301]

增加P301错误码

22.张鹤2013-9-5 Ver 1.9.1 [P401]

B2C协议支付增加访问者IP和访问者Refer信息

23.乔大伟2013-9-17 Ver 1.10.1 [P402]

商户发送B2B订单支付请求(直付商户)增加二级商户信息

商户发送B2B订单支付请求(保付商户)增加二级商户信息

24.乔大伟

张鹤2013-11-5 Ver 1.11.1 [P401]

新增对B2C体彩商户接口规约

注：版本号规则a.b.c 其中a表示大版本更新，b表示批次更新，c表示批次内修改流水。

1.2.x 表示这些修改都是在粤深批次进行的。

IPPS

第1章概述

1.1文档说明

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

1.2编写目的

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

1.3通讯协议

目前中行系统支持以下三种方式与商户系统通讯：

通过客户浏览器间接通讯：

a. 商户引导客户浏览器，将信息提交到网银系统。商户发送身份认证指令以及支付指

令接口时采用该方式通讯。表单数据中需包含商户对身份认证信息和订单信息的签名。

b. 网银引导客户浏览器将信息提交到商户系统。网银反馈身份认证和支付结果接口采

用该通讯方式。表单数据中包含网银系统的签名信息。

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

商户操作员登录网银操作网银功能，用来下载业务对账文件与清算对账文件。（网银

系统提供的其他商户操作员功能如状态查询等由于不涉及系统之间的接口规范，因此

不再描述）

直接通讯：

商户系统与网银系统之间直接建立通讯链路，该通讯采用HTTPS协议，由商户系统主动发起通讯。支付状态查询接口、身份认证结果查询接口等业务采用此通讯方式。1.4安全机制

商户与支付网关之间的通讯采用HTTPS协议，SSL握手时验证支付网关服务器证书，加密算法要求128位以上。服务器证书采用Verisign签发的中国银行网上银行服务器证书。SSL协议保证传输通道的安全，包括通讯数据加密、服务器身份认证。客户端的身份认证依靠银行验证商户的数据签名实现。

IPPS 产品总体设计(商户端接口)

网银团队支付小组第 5 页共 172页中国银行CA 中心为商户签发文件签名证书，用于对商户发送的请求指令(如支付指令、支付状态查询指令)进行签名，中国银行CA 中心为网上支付系统签发交易签名证书，用于对银行反馈处理结果(页面通知、主动通知)进行签名。中国银行还要给商户提供中行CA 中心二级根证书，用于商户验证银行反馈处理结果的签名信息。

1.5 签名与验签

签名原文串采用UTF-8(无BOM)格式。

商户进行数字签名：

数字签名采用pkcs7格式，经过BASE64编码传送。签名中不包括被签名的明文，包括签名公钥证书。明文由交易要素字符串组成，需要注意金额数据格式要求整数部分不补0，小数部分补足两位，日期格式为14位24小时格式：“YYYYMMDDHHMISS ”。交易

数字签名明文格式示例交易示例明文由管道符“|”分割，如：

商户订单号|订单时间|订单币种|订单金额|商户号

orderNo|orderTime|curCode|orderAmount|merchantNo

签名证书存在文件形式的证书库中，证书库可以是pfx 格式或jks 格式，由中行提供。调用中行提供的PKCS7Tool.jar 中的PKCS7Tool 类可以在java 中实现签名。

签名代码示例如下：

// String keyStorePath: 证书库路径

// String keyStorePassword: 证书库口令

// String keyPassword: 签名私钥口令，一般与证书库口令相同

PKCS7Tool tool = PKCS7Tool.getSigner (keyStorePath, keyStorePassword, keyPassword);

//签名，返回signature ：base64格式的签名结果

// byte[] data: 明文字符串

String signature = tool.sign(data);

商户验证银行数字签名：

数字签名采用pkcs7格式，经过BASE64编码传送。签名中不包括被签名的明文，包括签名公钥证书。

IPPS 产品总体设计(商户端接口)

网银团队支付小组第 6 页共 172页交易

数字签名明文格式示例交易示例明文由管道符“|”分割，如：

调用中行提供的PKCS7Tool.jar 中的PKCS7Tool 类可以在java 中实现验证签名。验证签名需要提供银行发送的签名结果、签名明文、由中行提供的cer 格式的信任公钥证书文件。

签名代码示例如下：

// String rootCertificatePath: 根证书路径

PKCS7Tool tool = PKCS7Tool.getVerifier (rootCertificatePath);

//验签名，如果失败抛出异常

// String signature ：签名

// byte[] data ：明文数据

// String dn ：银行签名证书DN ，如果为空则不验证DN

tool.verify(signature, data, dn);

商户验证银行数字签名异常后的处理：

在实际业务处理环境中，如果银行签名环节出现异常，提供商户的签名项为空，则会导致商户验证银行签名失败或异常。出现这种情况为保证商户尽快处理交易，建议商户主动向银行网关发起订单查询获得订单支付状态。

1.6 数据类型定义

报文规范中数据类型的定义说明：

9表示数字型数据。 X 表示字符型数据。

IPPS 产品总体设计(商户端接口)

网银团队支付小组第 7 页共 172页

1.7 联机接口示例

1.7.1 商户发送请求示例

商户系统请按照相关接口定义采用POST 方式发送请求至我行支付网关，内容请使用UTF-8编码格式。下面以 B2C 标准商户订单支付为例说明商户系统上送数据形式 (本节以下内容仅

作为示例使用)。接口名称： RecvOrder.do 数据项说明：

序号名称

字段

最大长度

说明

1. 商户号 merchantNo

X(20) ………. 2. 支付类型 payType X(10) ………. 3. 商户订单号 orderNo X(19) ………. 4. 订单币种 curCode

X(3) ………. 5. 订单金额 orderAmount X(13) ………. 6. 订单时间 orderTime 9(14) ………. 7. 订单说明

orderNote X(200) ………. 8. 商户接收通知URL orderUrl

X(100) ………. 9. 超时时间 orderTimeoutDate 9(14) ………. 10. 商户签名数据

signData

X(4000)

……….

接口示例：

IPPS 产品总体设计(商户端接口)

网银团队支付小组第 8 页共 172页

1.7.2 商户接收银行通知示例

我行提供的接口名称中如果提及页面通知或主动通知，银行系统均按照相关接口定义向商户系统发送POST 通知，内容使用UTF-8编码格式。以B2C 标准商户订单支付为例，说明商户系统接收到银行系统反馈数据形式 (本节以下内容仅作为示例使用)

数据项说明：序号名称

字段

最大长度

说明 1. 商户号 merchantNo X(20) ………. 2. 商户订单号 orderNo X(19) ………. 3. 银行订单流水号 orderSeq 9(20) ………. 4. 银行卡类别 cardTyp X(2) ………. 5. 支付时间 payTime

9(14) ………. 6. 订单状态 orderStatus X(2) ………. 7. 支付金额

payAmount X(13) ………. 8. 客户支付IP 地址

orderIp X(40) ………. 9. 客户浏览器Refer 信息 orderRefer X(200) ………. 10. 银行交易流水号 bankTranSeq X(22) ………. 11. 返回操作类型 returnActFlag X(1) ………. 12. 电话号码 phoneNum X(50) ………. 13. 中行签名数据

signData

X(4000)

……….

接口示例：

----------header info-------------- user-agent=Java/1.5.0

host=221.123.123.123:8080

accept=text/html, image/gif, image/jpeg, *; q=.2, */*; q=.2 connection=keep-alive

content-type=application/x-www-form-urlencoded content-length=1969

----------para info-------------- merchantNo=104012345678901 orderNo=TEST0001 orderSeq=12345678 cardTyp=12

payTime=20091225182140 orderStatus=1 payAmount=0.01

orderIp=201.12.12.12

orderRefer=http%3A%2F%2Flocalhost%2FB2C bankTranSeq=2009122533011575000001 returnActFlag=1 phoneNum=

signData=MIIEZgYJKoZu3ukpfzDOJ8onjJl+gUxoP1FcWqQqlhzo

IPPS 产品总体设计(商户端接口)

网银团队支付小组第 9 页共 172页

1.7.3 银行直连接收交易结果示例

针对商户与银行直连类交易（如联机退货、订单查询等），我行均按照相关接口定义采用XML 格式同步返回交易结果，内容使用UTF-8编码格式。

以 B2C 订单查询为例，说明银行系统同步反馈数据形式 (本节以下内容仅作为示例使

用)。

序号

报文要素属性类型

备注

Message root [1..1] 2.

BusinessHeader 业务头报文块

[1..1]

--MessageId 报文标识号

[1..1]

……….

--HandleStatus 处理状态 [1..1] [A|B|K] ………. 5.

--BodyFlag 业务体报文块存在标识 [1..1] [0|1] ………. 6.

--ReturnCode 报文处理返回码 [0..1] ……….

BusinessBody 业务体报文块 [0..1]

--交易信息 [0..n] ………. 9.

----商户号 [1..1] X(20) ………. 10.

----商户订单号 [1..1] X(19) ………. 11.

----银行订单流水号 [1..1] 9(20) ………. 12.

----订单状态 [1..1] X(2) ………. 13.

----银行卡类别 [1..1] X(2) ………. 14. ----支付卡号 [1..1] X(18) ……….

15. ----持卡人姓名

[0..1] X(30) 在不同业务配置情况下，

此数据域可能不存在 16. ----支付卡省行联行号

[0..1] X(5) 在不同业务配置情况下，此数据域可能不存在 17.

----支付时间 [1..1] 9(14) ………. 18.

----支付金额 [1..1] X(13) ………. 19.

----访问者IP [1..1] X(40) ………. 20. ----访问者Refer 信息

[1..1] X(3000)

……….

IPPS 产品总体设计(商户端接口)

网银团队支付小组第 10 页共 172页接口示例：

0000204

104012345678901

TEST0001

12345678

456351*************

张三

47428

20091225182140

0.01

104012345678901

TEST0002

12345679

张三

20110624171313

100.00

1.8 适用读者

商户端系统技术人员（分析师、设计人员、程序员）。

第2章对B2C 商户公共接口规约

2.1 商户发送退货交易请求

客户与商户协商退货后，商户系统对原来已经支付成功的订单进行退款时，商户系统采用HTTPS 协议按此数据规格将B2C 退款交易信息发往中行支付网关系统，银行完成退款处理后向

IPPS 产品总体设计(商户端接口)

网银团队支付小组第 11 页共 172页商户实时反馈处理结果。商户主动发往银行网关的指令均以POST 方式发送，并且使用UTF8编码格式。

2.1.1 请求交易入口

CommonRefundOrder.do

2.1.2 数据规格说明

2.1.2.1 商户请求数据规格说明序号名称字段

最大长度说明 1. 商户号

merchantNo X(20) 必填 BOC 商户ID 2.

商户退款交易流水号 mRefundSeq X(30) 必填商户系统产生的交易流水号 3.

退款币种 curCode X(3) 必填目前只支持001：人民币固定填001 4.

退款金额 refundAmount X(13) 必填退款金额格式：整数位不前补零,小数位补齐2位即：不超过10位整数位+1位小数点+2位小数无效格式如123，.10，1.1,有效格式如1.00，0.10 5.

商户订单号 orderNo X(19) 必填商户系统产生的订单号，原支付订单的商户订单号 6. 商户签名数据 signData X(4000) 必填商户签名数据串格式，各项数据用管道符分隔：商户号|商户退款交易流水号|退款币种|退款

金额|商户订单号

merchantNo|mRefundSeq|curCode|refu

ndAmount|orderNo

2.1.2.2 银行应答数据规格说明(XML)

序号报文要素属性类型

备注 1. Message root [1..1]

2. BusinessHeade r

业务头报文块

[1..1]

IPPS 产品总体设计(商户端接口)

网银团队支付小组第 12 页共 172页 3. --MessageId 报文标识号

[1..1] 4. --HandleStatu s

处理状态

[1..1] [A|B|K] A-成功 B-失败 K-未明 5. --BodyFlag 业务体报文块存

在标识

[1..1] [0|1] 0-有包体1-无包体 6. --ReturnCode 报文处理返回码

[0..1] 7. BusinessBody 业务体报文块

[0..n] 8.

--商户号 [1..1] X(20) BOC 商户ID 9. --商户退款交易流水号

[1..1] X(30) 商户系统产生的交易流水号 10.

--币种 [1..1] X(3) 目前只支持001：人民币 11. --退款金额 [1..1] X(13) 退款金额格式：整数位不前补零,小数位补齐2

位即：不超过10位整数位+1位小数点+2位小数

无效格式如123，.10，1.1,有效格式

如1.00，0.10

12. --商户订单号 [1..1] X(19) 商户系统产生的订单号，原支付订单的商户订单号

13. --银行订单流水号 [1..1] 9(20) 银行的订单流水号（银行产生的订单唯一标识）

14. --订单金额 [1..1] X(13) 订单金额格式：整数位不前补零,小数位补齐2

位即：不超过10位整数位+1位小数点+2位小数

无效格式如123，.10，1.1,有效格式

如1.00，0.10

15. --银行交易流水号 [1..1] X(22) 银行交易流水号银行交易日期(8位)+POS 终端号(8位)+POS 流水号(6位)

16. --银行交易时间 [1..1] 9(14) 退款交易处理的日期时间格式：YYYYMMDDHHMISS

金额|银行交易流水号|银行交易时间|

IPPS 产品总体设计(商户端接口)

网银团队支付小组第 13 页共 172页处理状态

merchantNo|mRefundSeq|refun

dAmount|orderNo|orderSeq|or

derAmount|bankTranSeq|tranT

ime|hdlSts

2.2 商户发送查询订单请求

商户通过https 指令向中行支付网关请求查询指定订单的支付情况。商户系统需要参照以下数据规格构造https 订单支付情况查询指令。

2.2.1 请求交易入口

CommonQueryOrder.do

2.2.2 数据规格说明

2.2.2.1 商户请求数据规格说明序号名称字段最大长度说明

1. 商户号

merchantNo X(20) BOC 商户ID 2. 商户订单号字符串

orderNos X(1000) 商户系统产生的订单号，支持输入多个订单号进行查询，最多支持50个订单号的查询格式：orderNo|orderNo|orderNo 例如：4|11|10|12|13 3. 商户签名信息 signData X(4000) 商户签名数据串格式，各项数据用冒号分隔（其中多笔订单号使用管道符分隔）：

商户号:商户订单号字符串merchantNo:orderNos

2.2.2.2 银行应答数据规格说明(XML) 序号报文要素属性类型

备注 1. Message root

[1..1] 2. BusinessHeade r

业务头报文块

[1..1] 3. --MessageId 报文标识号

[1..1] 4. --HandleStatu s

处理状态

[1..1] [A|B|K] A-成功 B-失败 K-未明 5. --BodyFlag 业务体报文块存 [1..1] [0|1] 0-有包体 1-无包体

IPPS 产品总体设计(商户端接口)

网银团队支付小组第 14 页共 172页

在标识

--ReturnCode 报文处理返回码

[0..1] 7.

BusinessBody 业务体报文块

[0..1]

--交易信息

[0..n]

交易信息 9.

----商户号

[1..1] X(20) BOC 商户ID

10.

----商户订单号 [1..1] X(19)

商户系统产生的订单号

11.

----银行订单流水号

[1..1] 9(20) 银行的订单流水号（银行产生的订单唯一

标识）

12.

----订单状态

[1..1] X(2)

订单状态： 0-未处理 1-支付 4-未明 5-失败

13.

----银行卡类别 [1..1] X(2) 请参考附件：常用数据域说明

14.

----支付卡号 [1..1] X(18)

为保护客户信息，我行暂不提供完整的卡号信息。为便于客户准确识别签约银行卡，我行向商户反馈客户的卡号后六位

协议支付商户请参考附件：商户属性配置

说明

15.

----持卡人姓名

[1..1] X(30) 为保护客户信息，我行暂不提供该数据项，

以****反馈商户

协议支付商户请参考附件：商户属性配置说明

16.

----支付卡省行

联行号

[1..1] X(5) 为保护客户信息，我行暂不提供该数据项，以****反馈商户

协议支付商户请参考附件：商户属性配置说明

17.

----支付时间 [1..1] 9(14) 格式：YYYYMMDDHHMISS 18.

----支付金额

[1..1] X(13)

支付金额，格式：整数位不前补零,小数位补齐2位即：不超过10位整数位+1位小数点+2位小数

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

19.

----访问者IP

[1..1] X(40)

客户通过网银支付时的IP 地址信息格式：n.n.n.n

其中n 为0-255的数字

IPPS 产品总体设计(商户端接口)

网银团队支付小组第 15 页共 172页例如：192.168.0.1 20.

----访问者Refer 信息

[1..1] X(3000) 客户浏览器跳转至网银支付登录界面前所在页面的URL （urlEncode 格式）

第3章对B2C 标准商户接口规约

3.1 商户发送网上银行支付订单

客户在商户网站确认进行订单支付，选择中行网上银行支付后，商户系统负责按此数据规格将消费交易信息发往中行支付网关系统；商户主动发往银行网关的指令均以POST 方式发送，并且使用UTF8编码格式。

3.1.1 请求交易入口

RecvOrder.do

3.1.2 数据规格说明序号名称字段

最大长度说明 1. 商户号

merchantNo X(20) 必填 BOC 商户ID 2. 支付类型 payType

X(10) 必填商户支付服务类型 1：网上购物 3. 商户订单号 orderNo

X(19) 必填商户系统产生的订单号 4. 订单币种 curCode

X(3) 必填目前只支持001：人民币固定填001 5. 订单金额 orderAmount

X(13) 必填格式：整数位不前补零,小数位补齐2位即：不超过10位整数位+1位小数点+2位小数无效格式如123，.10，1.1,有效格式如1.00，0.10 6. 订单时间 orderTime

9(14) 必填格式：YYYYMMDDHHMISS 其中时间为24小时格式，例:2010年3月2日下午4点5分28秒表示为20100302160528 7. 订单说明 orderNote X(200) 必填订单描述，，要求如果全中文最多允许60个汉

字长度

IPPS 产品总体设计(商户端接口)

网银团队支付小组第 16 页共 172页 8.

商户接收通知URL

orderUrl X(100) 必填

客户支付完成后银行向商户发送支付结果，商户系统负责接收银行通知的URL

9. 超时时间 orderTimeoutDa te 9(14) 选填

格式：YYYYMMDDHHMISS 其中时间为24小时格式，例:2010年3月2日

下午4点5分28秒表示为20100302160528

10. 商户签名数据 signData X(4000) 必填

商户签名数据串格式，各项数据用管道符分隔：

商户订单号|订单时间|订单币种|订单金额|商户号

orderNo|orderTime|curCode|orderAmou

nt|merchantNo 3.2 商户发送网上银行分期支付订单

客户在商户网站确认进行订单支付，选择中行网上银行分期支付后，商户系统负责按此数据规格将消费交易信息发往中行支付网关系统；商户主动发往银行网关的指令均以POST 方式发送，并且使用UTF8编码格式。

3.2.1 请求交易入口

RecvOrder4PlanPay.do

3.2.2 数据规格说明序号名称字段

最大长度说明 1. 商户号

merchantNo X(20) 必填 BOC 商户ID 2. 支付类型 payType X(10)

必填商户支付服务类型 1：网上购物 3. 商户订单号 orderNo

X(19) 必填商户系统产生的订单号 4. 订单币种 curCode X(3)

必填目前只支持001：人民币固定填001 5. 订单金额 orderAmount X(13) 必填格式：整数位不前补零,小数位补齐2位即：不超过10位整数位+1位小数点+2位小

数

无效格式如123，.10，1.1,有效格式如1.00，

0.10

IPPS 产品总体设计(商户端接口)

网银团队支付小组第 17 页共 172页 6. 分期计划 planCode X(4)

必填分期计划格式：IP0X ，其中X 取值有1、2、3、4、5、6、7、8、9 示例：IP01 7. 分期期数 planNumber 9(2) 必填分期期数，例如，3代表分3期目前支持分期期数有3、6、9、12、18、24、

36、48、60

8. 订单时间 orderTime 9(14) 必填

格式：YYYYMMDDHHMISS

其中时间为24小时格式，例:2010年3月2

日下午4点5分28秒表示为

20100302160528

9. 订单说明 orderNote

X(200) 必填

订单描述，，要求如果全中文最多允许60个汉字长度

10. 商户接收通知URL orderUrl X(100) 必填客户支付完成后银行向商户发送支付结果，商户系统负责接收银行通知的URL

11. 超时时间 orderTimeoutD ate 9(14) 选填

格式：YYYYMMDDHHMISS 其中时间为24小时格式，例:2010年3月2

日下午4点5分28秒表示为

20100302160528

12. 商户签名数据 signData X(4000) 必填

商户签名数据串格式，各项数据用管道符分隔：

3.3 商户发送手机银行支付订单

客户在商户手机WAP 网站确认进行订单支付，选择中行手机银行支付后，商户系统负责按此数据规格将消费交易信息发往中行支付网关系统；商户主动发往银行网关的指令均以POST 方式发送，并且使用UTF8编码格式。

3.3.1 请求交易入口

B2CMobileRecvOrder.do

IPPS 产品总体设计(商户端接口)

网银团队支付小组第 18 页共 172页

3.3.2 数据规格说明

序号

名称

字段

最大长度

说明

1. 商户号 merchantNo

X(20)

必填

BOC 商户ID 2. 支付类型

payType X(10)

必填

商户支付服务类型 1：网上购物 3. 商户订单号 orderNo X(19)

必填

商户系统产生的订单号 4. 订单币种

curCode

X(3)

必填

目前只支持001：人民币固定填001 5. 订单金额

orderAmount X(13)

必填

格式：整数位不前补零,小数位补齐2位

即：不超过10位整数位+1位小数点+2位小数

无效格式如123，.10，1.1,有效格式如1.00，0.10 6. 订单时间

orderTime 9(14)

必填

格式：YYYYMMDDHHMISS

其中时间为24小时格式，例:2010年3月2日下午4点5分28秒表示为20100302160528 7. 订单说明

orderNote X(200)

必填

订单描述，要求如果全中文最多允许60个汉字长度 8.

商户接收通

知URL

orderUrl

X(100)

必填

客户支付完成后银行向商户发送支付结果，商户系统负责接收银行通知的URL 9.

WAP 客户

标识

spMobile

X(54)

选填

如果客户通过商户系统直接发订单到中行网关，该域可空；

如果客户通过中行手机商城的链接到商户时，中行手机商城会生成由渠道号和手机号组合加密的数据传送给WAP 商户系统，客户在WAP 商户系统对订单进行支付时，WAP 商户系统需要提供该信息； 10. 超时时间

orderTimeoutDa

9(14)

选填

格式：YYYYMMDDHHMISS

其中时间为24小时格式，例:2010年3月2日下午4点5分28秒表示为20100302160528

IPPS 产品总体设计(商户端接口)

网银团队支付小组第 19 页共 172页

11.

商户签名数

据

signData

X(4000)

必填

商户签名数据串格式，各项数据用管道符分隔：商户订单号|订单时间|订单币种|订单金额|商户号

orderNo|orderTime|curCode|orderAmo unt|merchantNo

3.4 商户发送家居银行支付订单

客户在商户电视机顶盒系统界面确认进行订单支付，选择中行家居银行支付后，商户系统负责按此数据规格将消费交易信息发往中行支付网关系统；商户主动发往银行网关的指令均以POST 方式发送，并且使用UTF8编码格式。

3.4.1 请求交易入口

HomeBankRecvOrder.do

3.4.2 数据规格说明

序号

名称

字段

最大长度

说明

1. 商户号 merchantNo

X(20)

必填

BOC 商户ID 2. 支付类型

payType X(10)

必填

商户支付服务类型 1：网上购物 3. 商户订单号 orderNo X(19)

必填

商户系统产生的订单号 4. 订单币种

curCode

X(3)

必填

目前只支持001：人民币固定填001 5. 订单金额

orderAmount X(13)

必填

格式：整数位不前补零,小数位补齐2位

即：不超过10位整数位+1位小数点+2位小数

无效格式如123，.10，1.1,有效格式如1.00，0.10 6. 订单时间

orderTime 9(14)

必填

格式：YYYYMMDDHHMISS

其中时间为24小时格式，例:2010年3月2日下午4点5分28秒表示为20100302160528 7. 订单说明

orderNote X(200)

必填

IPPS 产品总体设计(商户端接口)

网银团队支付小组第 20 页共 172页

订单描述，要求如果全中文最多允许60个汉字长度 8.

商户接收通

知URL

orderUrl

X(100)

必填

客户支付完成后银行向商户发送支付结果，商户系统负责接收银行通知的URL 9. 超时时间

orderTimeoutDa

9(14)

选填

格式：YYYYMMDDHHMISS

其中时间为24小时格式，例:2010年3月2日下午4点5分28秒表示为20100302160528 10.

商户签名数

据

signData

X(4000)

必填

商户签名数据串格式，各项数据用管道符分隔：商户订单号|订单时间|订单币种|订单金额|商户号

orderNo|orderTime|curCode|orderAmo unt|merchantNo

3.5 银行反馈订单支付结果(页面通知)

中行支付网关接收商户发来的网上银行支付（包括分期支付）订单、手机银行支付订单或家居银行支付订单后，引导客户进行支付确认，客户通过中行网银、手机银行或家居银行提交支付指令后，支付网关进行支付处理，处理完成后由网上银行支付（包括分期支付）结果页面、手机银行支付结果页面或家居银行支付结果页面向商户系统按以下数据规格反馈订单支付结果；指令均以POST 方式发送，并且使用UTF8编码格式。

3.5.1 数据规格说明

序号

名称

字段

最大长度

说明

1. 商户号

merchantNo X(20) BOC 商户ID

2. 商户订单号 orderNo

X(19) 商户系统产生的订单号

银行订单流

水号