中国银行电子商务商户接口文档全集

1、IPPS产品对商户端接口标准单位中国银行撰写人IPPS开发组版本修 订 说 明序号修改人日期版本号修改说明1.梁栋2010-6-26Ver 0.1完成初稿2.梁栋2010-11-8Ver 0.2修改查询类接口的返回报文3.乔大伟2010-11-17Ver 0.3将本文档定义为产品级文档，补充所有对商户端接口。4.梁栋2010-12-7Ver 0.4修改理财直付和协议支付批量部分字段项5.乔大伟2011-03-16Ver 0.5沪苏吴批次针对人行二号令对本文档进行如下修改：2.2.4 修改 银行返回订单支付结果(页面通知)2.2.5 修改 银行返回订单支付结果(主动通知)2.2.7 新增 商户发

2、送查询订单请求(支持卡户信息判断)5.2.10 修改 商户发送订单支付请求新增 商户发送B2B订单查询请求(支持卡户信息判断)6.乔大伟2011-05-23Ver 1.1公共以湘鄂桂批次实现为基线，建立基础版本1.17.乔大伟2011-06-13Ver 1.2.1粤深4.2.3 修改 银行反馈认证结果(主动通知)增加notifyType8.乔大伟2011-06-17Ver 1.2.2公共整理文档内容，重新归纳安全机制，整理联机部分接口。9.乔大伟2011-06-21Ver 1.2.3粤深5.2.4 修改 商户发送修改协议请求 增加agreeUrl。10.李红梅2011-06-21

3、Ver 1.2.4公共6.2.2 修改 根据B2B相关文档补充数据说明项11.李红梅2011-07-25Ver 1.2.5公共2.2.12 删除 交易流水文件生成12.乔大伟2011-07-25Ver 1.3.1粤深后批次 铁道部紧急需求变更修改 商户发送网上银行支付订单13.李新2011-10-24Ver 1.4.1P201修改 协议支付签约返回结果增加签约渠道修改 协议支付签约、改约、解约，查询协议、订单支付，查询订单接口中返回数据项卡号返回规则修改14.李新2012-03-14Ver 1.5.1P204新增 商户对接上传下载文件接口规约15.乔大伟2012-04-19Ver 1.6.1P

4、20516.李红梅2012-07-09Ver 1.7.1P207新增 商户发送网上银行分期支付订单17.梁栋2012-07-25Ver 1.7.2P207新增 分行特色业务接口18.乔大伟陈发建梁晓晓2012-08-31Ver 1.8.1P301文档结构进行重大调整；协议支付增加对商户属性管理的支持；19.梁栋2012-9-18Ver 1.8.2P301B2B订单支付(监管商户、非监管商户)增加超时时间数据项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协议支付增加访问者IP和访问者Refer信息23.乔大伟2013-9-17Ver 1.10.1P402商户发送B2B订单支付请求(直付商户)增加二级商户信息商户发送B2B订单支付请求(保付商户)增加二级商户信息24.乔大伟张鹤2013-11-5Ver 1.11.1P401新增 对B2C体彩商户接口规约注：版本号规则 a.b.c 其中a表示大版本更新，b表示批次更新，c表示批次内修改流水。1.2.x 表示这些修改都是在粤深批次进行的。 IPPS产品总体设计(商户端接口)第1章 概述1.1 文档说明本文描述了中国银行IPPS相关服务通讯协议、报文格式、

6、安全机制等内容。作为商户端系统技术人员开发的参考文档。1.2 编写目的为使商户端系统开发人员了解IPPS服务的相关通讯接口细节。1.3 通讯协议目前中行系统支持以下三种方式与商户系统通讯：Ø 通过客户浏览器间接通讯：a. 商户引导客户浏览器，将信息提交到网银系统。商户发送身份认证指令以及支付指令接口时采用该方式通讯。表单数据中需包含商户对身份认证信息和订单信息的签名。b. 网银引导客户浏览器将信息提交到商户系统。网银反馈身份认证和支付结果接口采用该通讯方式。表单数据中包含网银系统的签名信息。Ø 商户操作员通过浏览器操作网银：商户操作员登录网银操作网银功能，用来下载业务对账文

7、件与清算对账文件。（网银系统提供的其他商户操作员功能如状态查询等由于不涉及系统之间的接口规范，因此不再描述）Ø 直接通讯：商户系统与网银系统之间直接建立通讯链路，该通讯采用HTTPS协议，由商户系统主动发起通讯。支付状态查询接口、身份认证结果查询接口等业务采用此通讯方式。1.4 安全机制商户与支付网关之间的通讯采用HTTPS协议，SSL握手时验证支付网关服务器证书，加密算法要求128位以上。服务器证书采用Verisign签发的中国银行网上银行服务器证书。SSL协议保证传输通道的安全，包括通讯数据加密、服务器身份认证。客户端的身份认证依靠银行验证商户的数据签名实现。中国银行CA中心为商

8、户签发文件签名证书，用于对商户发送的请求指令(如支付指令、支付状态查询指令)进行签名，中国银行CA中心为网上支付系统签发交易签名证书，用于对银行反馈处理结果(页面通知、主动通知)进行签名。中国银行还要给商户提供中行CA中心二级根证书，用于商户验证银行反馈处理结果的签名信息。1.5 签名与验签签名原文串采用UTF-8(无BOM)格式。商户进行数字签名：数字签名采用pkcs7格式，经过BASE64编码传送。签名中不包括被签名的明文，包括签名公钥证书。明文由交易要素字符串组成，需要注意金额数据格式要求整数部分不补0，小数部分补足两位，日期格式为14位24小时格式：“YYYYMMDDHHMISS”。交

9、易数字签名明文格式示例交易示例明文由管道符“|”分割，如：商户订单号|订单时间|订单币种|订单金额|商户号orderNo|orderTime|curCode|orderAmount|merchantNo签名证书存在文件形式的证书库中，证书库可以是pfx格式或jks格式，由中行提供。调用中行提供的PKCS7Tool.jar中的PKCS7Tool类可以在java中实现签名。签名代码示例如下：/ String keyStorePath: 证书库路径/ String keyStorePassword: 证书库口令/ String keyPassword: 签名私钥口令，一般与证书库口令相同PKCS7T

10、ool tool = PKCS7Tool.getSigner(keyStorePath, keyStorePassword, keyPassword);/签名，返回signature：base64格式的签名结果/ byte data: 明文字符串String signature = tool.sign(data);商户验证银行数字签名：数字签名采用pkcs7格式，经过BASE64编码传送。签名中不包括被签名的明文，包括签名公钥证书。交易数字签名明文格式示例交易示例明文由管道符“|”分割，如：商户号|商户订单号|银行订单流水号|银行卡类别|支付时间|订单状态|支付金额merchantNo|ord

11、erNo|orderSeq|cardTyp|payTime|orderStatus|payAmount调用中行提供的PKCS7Tool.jar中的PKCS7Tool类可以在java中实现验证签名。验证签名需要提供银行发送的签名结果、签名明文、由中行提供的cer格式的信任公钥证书文件。签名代码示例如下：/ String rootCertificatePath: 根证书路径PKCS7Tool tool = PKCS7Tool.getVerifier(rootCertificatePath);/验签名，如果失败抛出异常/ String signature：签名/ byte data：明文数据/ St

12、ring dn：银行签名证书DN，如果为空则不验证DNtool.verify(signature, data, dn);商户验证银行数字签名异常后的处理：在实际业务处理环境中，如果银行签名环节出现异常，提供商户的签名项为空，则会导致商户验证银行签名失败或异常。出现这种情况为保证商户尽快处理交易，建议商户主动向银行网关发起订单查询获得订单支付状态。1.6 数据类型定义报文规范中数据类型的定义说明：9表示数字型数据。X表示字符型数据。1.7 联机接口示例1.7.1 商户发送请求示例商户系统请按照相关接口定义采用POST方式发送请求至我行支付网关，内容请使用UTF-8编码格式。下面以 B2C标准商户

13、订单支付 为例说明商户系统上送数据形式 (本节以下内容仅作为示例使用)。接口名称：RecvOrder.do数据项说明：序号名称字段最大长度说明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.商户签名数据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.商户签名数据-><INPUT TYPE="HIDDEN" ID="signData" NAME="signData" VALUE="PD94bWwgI.49IjEu"><BR/></FORM>1.7.2 商户接收银行通知示例我行提供的接口

20、名称中如果提及页面通知或主动通知，银行系统均按照相关接口定义向商户系统发送POST通知，内容使用UTF-8编码格式。以B2C标准商户订单支付 为例，说明商户系统接收到银行系统反馈数据形式 (本节以下内容仅作为示例使用)数据项说明：序号名称字段最大长度说明1.商户号merchantNoX(20).2.商户订单号orderNoX(19).3.银行订单流水号orderSeq9(20).4.银行卡类别cardTypX(2).5.支付时间payTime9(14).6.订单状态orderStatusX(2).7.支付金额payAmountX(13).8.客户支付IP地址orderIpX(40).9.客户浏

21、览器Refer信息orderReferX(200).10.银行交易流水号bankTranSeqX(22).11.返回操作类型returnActFlagX(1).12.电话号码phoneNumX(50).13.中行签名数据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 银行直连接收交易结果示例针对商户与银行直连类交易（如联机退货、订单查询等），我行均按照相关接口定义采用XML格式同步返回交易结果，内容使用UTF-8编码格式。以 B2C订单查询 为例，说明银行系统同步反馈数据形式 (本节以下内容仅作为示例使用)。序号报文要素<XML Tag>属性类型备注1.Message root<res>1.12.BusinessHeader业务头报文块<header>1.13.-MessageId 报文标识号<msgId>1.1.4.-

24、HandleStatus 处理状态<hdlSts>1.1A|B|K.5.-BodyFlag 业务体报文块存在标识<bdFlg>1.10|1.6.-ReturnCode 报文处理返回码<rtnCd>0.1.7.BusinessBody业务体报文块<body>0.18.-交易信息<orderTrans>0.n.9.-商户号<merchantNo>1.1X(20).10.-商户订单号<orderNo>1.1X(19).11.-银行订单流水号<orderSeq>1.19(20).12.-订单状态<or

25、derStatus>1.1X(2).13.-银行卡类别<cardTyp>1.1X(2).14.-支付卡号<acctNo>1.1X(18).15.-持卡人姓名<holderName>0.1X(30)在不同业务配置情况下，此数据域可能不存在16.-支付卡省行联行号<ibknum>0.1X(5)在不同业务配置情况下，此数据域可能不存在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> <!此数据域为可

28、选项-><ibknum>47428</ibknum> <!此数据域为可选项-><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> <!此数据域为可选项-><payTime>20110624171313</payTime> <payAmount>100.00</payAmount> <visitorIp />

30、 <visitorRefer /> </orderTrans></body></res>1.8 适用读者商户端系统技术人员（分析师、设计人员、程序员）。第2章 对B2C商户公共接口规约2.1 商户发送退货交易请求客户与商户协商退货后，商户系统对原来已经支付成功的订单进行退款时，商户系统采用HTTPS协议按此数据规格将B2C退款交易信息发往中行支付网关系统，银行完成退款处理后向商户实时反馈处理结果。商户主动发往银行网关的指令均以POST方式发送，并且使用UTF8编码格式。2.1.1 请求交易入口CommonRefundOrder.do2.1.2 数

31、据规格说明 商户请求数据规格说明序号名称字段最大长度说明1.商户号merchantNoX(20)必填BOC商户ID2.商户退款交易流水号mRefundSeqX(30)必填商户系统产生的交易流水号3.退款币种curCodeX(3)必填目前只支持001：人民币固定填0014.退款金额refundAmountX(13)必填退款金额格式：整数位不前补零,小数位补齐2位即：不超过10位整数位+1位小数点+2位小数无效格式如123，.10，1.1,有效格式如1.00，0.105.商户订单号orderNoX(19)必填商户系统产生的订单号，原支付订单的商户订单号6.商户签名数据signData

32、X(4000)必填商户签名数据串格式，各项数据用管道符分隔：商户号|商户退款交易流水号|退款币种|退款金额|商户订单号merchantNo|mRefundSeq|curCode|refundAmount|orderNo 银行应答数据规格说明(XML)序号报文要素<XML Tag>属性类型备注1.Message root<res>1.12.BusinessHeader业务头报文块<header>1.13.-MessageId 报文标识号<msgId>1.14.-HandleStatus 处理状态<hdlSts>1.1A|B

33、|KA-成功 B-失败 K-未明5.-BodyFlag 业务体报文块存在标识<bdFlg>1.10|10-有包体1-无包体6.-ReturnCode 报文处理返回码<rtnCd>0.17.BusinessBody业务体报文块<body>0.n8.-商户号<merchantNo>1.1X(20)BOC商户ID9.-商户退款交易流水号<mRefundSeq>1.1X(30)商户系统产生的交易流水号10.-币种<curCode>1.1X(3)目前只支持001：人民币11.-退款金额<refundAmount>1.1X

34、(13)退款金额格式：整数位不前补零,小数位补齐2位即：不超过10位整数位+1位小数点+2位小数无效格式如123，.10，1.1,有效格式如1.00，0.1012.-商户订单号<orderNo>1.1X(19)商户系统产生的订单号，原支付订单的商户订单号13.-银行订单流水号<orderSeq>1.19(20)银行的订单流水号（银行产生的订单唯一标识）14.-订单金额<orderAmount>1.1X(13)订单金额格式：整数位不前补零,小数位补齐2位即：不超过10位整数位+1位小数点+2位小数无效格式如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.-中行签名数据<signData>1.1X(4000)中行签名数据串格式，各项数据用管道符分隔：商户号|商户退款交易流水号|退款金额|商户订单号|银行订单流水号|订单金额|银行交易流水号|银行交易时间|处理状态merchantNo|mRefundSeq|refundAmount|orderNo|order

36、Seq|orderAmount|bankTranSeq|tranTime|hdlSts2.2 商户发送查询订单请求商户通过https指令向中行支付网关请求查询指定订单的支付情况。商户系统需要参照以下数据规格构造https订单支付情况查询指令。2.2.1 请求交易入口CommonQueryOrder.do2.2.2 数据规格说明 商户请求数据规格说明序号名称字段最大长度说明1.商户号merchantNoX(20)BOC商户ID2.商户订单号字符串orderNosX(1000)商户系统产生的订单号，支持输入多个订单号进行查询，最多支持50个订单号的查询格式：orderNo|order

37、No|orderNo例如：4|11|10|12|133.商户签名信息signDataX(4000)商户签名数据串格式，各项数据用冒号分隔（其中多笔订单号使用管道符分隔）：商户号:商户订单号字符串merchantNo:orderNos 银行应答数据规格说明(XML)序号报文要素<XML Tag>属性类型备注1.Message root<res>1.12.BusinessHeader业务头报文块<header>1.13.-MessageId 报文标识号<msgId>1.14.-HandleStatus 处理状态<hdlSts>

38、;1.1A|B|KA-成功 B-失败 K-未明5.-BodyFlag 业务体报文块存在标识<bdFlg>1.10|10-有包体 1-无包体6.-ReturnCode 报文处理返回码<rtnCd>0.17.BusinessBody业务体报文块<body>0.18.-交易信息<orderTrans>0.n交易信息9.-商户号<merchantNo>1.1X(20)BOC商户ID10.-商户订单号<orderNo>1.1X(19)商户系统产生的订单号11.-银行订单流水号<orderSeq>1.19(20)银行的订单

39、流水号（银行产生的订单唯一标识）12.-订单状态<orderStatus>1.1X(2)订单状态：0-未处理1-支付4-未明5-失败13.-银行卡类别<cardTyp>1.1X(2)请参考 附件：常用数据域说明14.-支付卡号<acctNo>1.1X(18)为保护客户信息，我行暂不提供完整的卡号信息。为便于客户准确识别签约银行卡，我行向商户反馈客户的卡号后六位协议支付商户请参考 附件：商户属性配置说明15.-持卡人姓名<holderName>1.1X(30)为保护客户信息，我行暂不提供该数据项，以*反馈商户协议支付商户请参考 附件：商户属性配置说

40、明16.-支付卡省行联行号<ibknum>1.1X(5)为保护客户信息，我行暂不提供该数据项，以*反馈商户协议支付商户请参考 附件：商户属性配置说明17.-支付时间<payTime>1.19(14)格式：YYYYMMDDHHMISS18.-支付金额<payAmount>1.1X(13)支付金额，格式：整数位不前补零,小数位补齐2位即：不超过10位整数位+1位小数点+2位小数无效格式如123，.10，1.1,有效格式如1.00，0.1019.-访问者IP<visitorIp>1.1X(40)客户通过网银支付时的IP地址信息格式：n.n.n.n其中n

41、为0-255的数字例如：20.-访问者Refer信息<visitorRefer>1.1X(3000)客户浏览器跳转至网银支付登录界面前所在页面的URL（urlEncode格式）第3章 对B2C标准商户接口规约3.1 商户发送网上银行支付订单客户在商户网站确认进行订单支付，选择中行网上银行支付后，商户系统负责按此数据规格将消费交易信息发往中行支付网关系统；商户主动发往银行网关的指令均以POST方式发送，并且使用UTF8编码格式。3.1.1 请求交易入口RecvOrder.do3.1.2 数据规格说明序号名称字段最大长度说明1.商户号merchantNoX(20)

42、必填BOC商户ID2.支付类型payTypeX(10)必填商户支付服务类型1：网上购物3.商户订单号orderNoX(19)必填商户系统产生的订单号4.订单币种curCodeX(3)必填目前只支持001：人民币固定填0015.订单金额orderAmountX(13)必填格式：整数位不前补零,小数位补齐2位即：不超过10位整数位+1位小数点+2位小数无效格式如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)必填客户支付完成后银行向商户发送支付结果，商户系统负责接收银行通知的URL9.超时时间orderTimeoutDate9(14)选填格式：YYYYMMDDHHMISS其中时间为24小时格式，例:2010年3月2日下午4点5分28秒表示为2010030216052810.商户签名数据signDataX(4000)必填商户签名数据串格式，各项数据用管道符分隔：商户订单号|订单时间|订单币种|订单金额|商户号orderNo|orderTime|curCode|orderA

44、mount|merchantNo3.2 商户发送网上银行分期支付订单客户在商户网站确认进行订单支付，选择中行网上银行分期支付后，商户系统负责按此数据规格将消费交易信息发往中行支付网关系统；商户主动发往银行网关的指令均以POST方式发送，并且使用UTF8编码格式。3.2.1 请求交易入口RecvOrder4PlanPay.do3.2.2 数据规格说明序号名称字段最大长度说明1.商户号merchantNoX(20)必填BOC商户ID2.支付类型payTypeX(10)必填商户支付服务类型1：网上购物3.商户订单号orderNoX(19)必填商户系统产生的订单号4.订单币种curCodeX(3)必填

45、目前只支持001：人民币固定填0015.订单金额orderAmountX(13)必填格式：整数位不前补零,小数位补齐2位即：不超过10位整数位+1位小数点+2位小数无效格式如123，.10，1.1,有效格式如1.00，0.106.分期计划planCodeX(4)必填分期计划格式：IP0X，其中X取值有1、2、3、4、5、6、7、8、9示例：IP017.分期期数planNumber9(2)必填分期期数，例如，3代表分3期目前支持分期期数有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)必填客户支付完成后银行向商户发送支付结果，商户系统负责接收银行通知的URL11.超时时间orderTimeoutDate9(14)选填格式：YYYYMMDDHHMISS其中时间为24小时格式，例:2010年3月2日下午4点5分28秒表示为2010030216052812.商户签名数据signDataX(4000)必填商户签名数据串格式，各项数据用管道符分隔：商户订单号|订单时间|订单币种|订

47、单金额|商户号|分期计划|分期期数orderNo|orderTime|curCode|orderAmount|merchantNo| planCode|planNumber3.3 商户发送手机银行支付订单客户在商户手机WAP网站确认进行订单支付，选择中行手机银行支付后，商户系统负责按此数据规格将消费交易信息发往中行支付网关系统；商户主动发往银行网关的指令均以POST方式发送，并且使用UTF8编码格式。3.3.1 请求交易入口B2CMobileRecvOrder.do3.3.2 数据规格说明序号名称字段最大长度说明1.商户号merchantNoX(20)必填BOC商户ID2.支付类型payTyp

48、eX(10)必填商户支付服务类型1：网上购物3.商户订单号orderNoX(19)必填商户系统产生的订单号4.订单币种curCodeX(3)必填目前只支持001：人民币固定填0015.订单金额orderAmountX(13)必填格式：整数位不前补零,小数位补齐2位即：不超过10位整数位+1位小数点+2位小数无效格式如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)必填客户支付完成后银行向商户发送支付结果，商户系统负责接收银行通知的URL9.WAP客户标识spMobileX(54)选填如果客户通过商户系统直接发订单到中行网关，该域可空；如果客户通过中行手机商城的链接到商户时，中行手机商城会生成由渠道号和手机号组合加密的数据传送给WAP商户系统，客户在WAP商户系统对订单进行支付时，WAP商户系统需要提供该信息；10.超时时间orderTimeoutDate9(14)选填格式：YYYYMMDDHHMISS其中时间为24小时格式，例:2010年3月2日下午4点5分28秒表

50、示为2010030216052811.商户签名数据signDataX(4000)必填商户签名数据串格式，各项数据用管道符分隔：商户订单号|订单时间|订单币种|订单金额|商户号orderNo|orderTime|curCode|orderAmount|merchantNo3.4 商户发送家居银行支付订单客户在商户电视机顶盒系统界面确认进行订单支付，选择中行家居银行支付后，商户系统负责按此数据规格将消费交易信息发往中行支付网关系统；商户主动发往银行网关的指令均以POST方式发送，并且使用UTF8编码格式。3.4.1 请求交易入口HomeBankRecvOrder.do3.4.2 数据规格说明序号名

51、称字段最大长度说明1.商户号merchantNoX(20)必填BOC商户ID2.支付类型payTypeX(10)必填商户支付服务类型1：网上购物3.商户订单号orderNoX(19)必填商户系统产生的订单号4.订单币种curCodeX(3)必填目前只支持001：人民币固定填0015.订单金额orderAmountX(13)必填格式：整数位不前补零,小数位补齐2位即：不超过10位整数位+1位小数点+2位小数无效格式如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)必填客户支付完成后银行向商户发送支付结果，商户系统负责接收银行通知的URL9.超时时间orderTimeoutDate9(14)选填格式：YYYYMMDDHHMISS其中时间为24小时格式，例:2010年3月2日下午4点5分28秒表示为2010030216052810.商户签名数据signDataX(4000)必填商户签名数据串格式，各项数据用管道符分隔：商户订单号|订单时间|订单币种|订单金额|商户号ord

53、erNo|orderTime|curCode|orderAmount|merchantNo3.5 银行反馈订单支付结果(页面通知)中行支付网关接收商户发来的网上银行支付（包括分期支付）订单、手机银行支付订单或家居银行支付订单后，引导客户进行支付确认，客户通过中行网银、手机银行或家居银行提交支付指令后，支付网关进行支付处理，处理完成后由网上银行支付（包括分期支付）结果页面、手机银行支付结果页面或家居银行支付结果页面向商户系统按以下数据规格反馈订单支付结果；指令均以POST方式发送，并且使用UTF8编码格式。3.5.1 数据规格说明序号名称字段最大长度说明1.商户号merchantNoX(20)BOC商户ID2.商户订单号orderNoX(19)商户系统产生的订单号3.银行订单流水号orderSeq9(20)银行的订单流水号（银行产生的订单唯一标识）4.银行卡类别cardTypX(2)请参考 附件：常用数据域说明5.支付时间payTime9(14)格式：YYYYMMDDHHMISS6.订单状态orderS