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

寂寂无言分享 2022-04-19 下载文档

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

银行订单流

水号

orderSeq 9(20) 银行的订单流水号（银行产生的订单唯一标识） 4. 银行卡类别 cardTyp X(2) 请参考附件：常用数据域说明 5. 支付时间 payTime

9(14)

格式：YYYYMMDDHHMISS 6. 订单状态 orderStatus

X(2)

0：未处理 1：支付 2：撤销 3：退货 4：未明 5：失败

7. 支付金额 payAmount

X(13)

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

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

网银团队支付小组第 21 页共 172页即：不超过10位整数位+1位小数点+2位小数无效格式如123，.10，1.1,有效格式如1.00，0.10 8.

支付卡号 acctNo X(19) 需要持卡人卡户信息的商户例如人行通过的第三方支付公司，银行在返回结果时提供该项，否则用****表示 9.

持卡人姓名 holderName X(30) 需要持卡人卡户信息的商户例如人行通过的第三方支付公司，银行在返回结果时提供该项，否则用****表示 10.

支付卡省行联行号 ibknum X(5) 需要持卡人卡户信息的商户例如人行通过的第三方支付公司，银行在返回结果时提供该项，否则用****表示 11.

客户支付IP 地址 orderIp X(40) 客户通过网银支付时的IP 地址信息格式：n.n.n.n 其中n 为0-255的数字例如：192.168.0.1 12.

客户浏览器Refer 信息 orderRefer X(200) 客户浏览器跳转至网银支付登录界面前所在页面的URL （urlEncode 格式） 13.

银行交易流水号 bankTranSeq X(22) 银行交易日期(8位)+POS 终端号(8位)+POS 流水号(6位) 14.

返回操作类型 returnActFlag X(1) 1：支付结果通知 2：电话订单结果通知 3：退款结果通知 4：订单查询结果 15.

需要持卡户信息的商户：

商户号|商户订单号|银行订单流水号|银行卡类

卡人姓名|支付卡省行联行号

merchantNo|orderNo|orderSeq|cardTyp

共3页:

IPPS产品总体设计(商户端接口)_new(3).doc 将本文的Word文档下载到电脑

下载这篇word文档