寂寂无言--BodyFlag 业务体报文块存在标识
--ReturnCode 报文处理返回码
7.
BusinessBody 业务体报文块
[0..1]8.
--交易信息
----商户号
----商户订单号
----银行订单流水号
----订单状态
----银行卡类别
15. ----持卡人姓名
此数据域可能不存在 16. ----支付卡省行联行号
----支付时间
----支付金额
----访问者IP
[1..1] X(3000)
……….
IPPS 产品总体设计(商户端接口)
网银团队支付小组 第 10 页 共 172页 接口示例：
456351*************
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
2. BusinessHeade r
业务头报文块
IPPS 产品总体设计(商户端接口)
网银团队支付小组 第 12 页 共 172页 3. --MessageId 报文标识号
处理状态
在标识
--商户号
--币种
位 即：不超过10位整数位+1位小数点+2位小数
无效格式如123，.10，1.1,有效格式
如1.00，0.10
12. --商户订单号
13. --银行订单流水号
14. --订单金额
位 即：不超过10位整数位+1位小数点+2位小数
无效格式如123，.10，1.1,有效格式
如1.00，0.10
15. --银行交易流水号
16. --银行交易时间 [1..1] 9(14) 退款交易处理的日期时间 格式：YYYYMMDDHHMISS
17. --中行签名数据
金额|银行交易流水号|银行交易时间|
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
业务头报文块
处理状态
IPPS 产品总体设计(商户端接口)
网银团队支付小组 第 14 页 共 172页
在标识
6.
--ReturnCode 报文处理返回码
BusinessBody 业务体报文块
[0..1]8.
--交易信息
[0..n]
交易信息 9.
----商户号
[1..1] X(20) BOC 商户ID
10.
----商户订单号
商户系统产生的订单号
11.
----银行订单流水号
标识）
12.
----订单状态
[1..1] X(2)
订单状态： 0-未处理 1-支付 4-未明 5-失败
13.
----银行卡类别
14.
----支付卡号 [1..1] X(18)
为保护客户信息，我行暂不提供完整的卡号信息。为便于客户准确识别签约银行卡，我行向商户反馈客户的卡号后六位
协议支付商户请参考 附件：商户属性配置
说明
15.
----持卡人姓名
[1..1] X(30) 为保护客户信息，我行暂不提供该数据项，
以****反馈商户
协议支付商户请参考 附件：商户属性配置说明
16.
----支付卡省行
联行号
协议支付商户请参考 附件：商户属性配置说明
17.
----支付时间
----支付金额
[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 信息
第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
