第一范文网 - 专业文章范例文档资料分享平台

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

来源:用户分享 时间:2022-04-19 本文由寂寂无言 分享 下载这篇文档 手机版
说明:文章内容仅供预览,部分内容可能不全,需要完整文档或者需要复制内容,请下载word后使用。下载word有问题请添加微信号:xxxxxx或QQ:xxxxxx 处理(尽可能给您提供完整文档),感谢您的支持与谅解。
[1..1] [A|B|K] ………. 5.

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

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

7.

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

8.

--交易信息 [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

A

0

104012345678901

TEST0001

12345678

1

12

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

张三

47428

20091225182140

0.01

104012345678901

TEST0002

12345679

0

12

张三

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

17. --中行签名数据 [1..1] X(4000) 中行签名数据串格式,各项数据用管道符分隔: 商户号|商户退款交易流水号|退款金额|商户订单号|银行订单流水号|订单

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

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页

在标识

6.

--ReturnCode 报文处理返回码

[0..1] 7.

BusinessBody 业务体报文块

[0..1]

8.

--交易信息

[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

搜索“diyifanwen.net”或“第一范文网”即可找到本站免费阅读全部范文。收藏本站方便下次阅读,第一范文网,提供最新综合文库IPPS产品总体设计(商户端接口)_new(2)全文阅读和word下载服务。

IPPS产品总体设计(商户端接口)_new(2).doc 将本文的Word文档下载到电脑,方便复制、编辑、收藏和打印
本文链接:https://www.diyifanwen.net/wenku/1410062.html(转载请注明文章来源)
热门推荐
Copyright © 2018-2022 第一范文网 版权所有 免责声明 | 联系我们
声明 :本网站尊重并保护知识产权,根据《信息网络传播权保护条例》,如果我们转载的作品侵犯了您的权利,请在一个月内通知我们,我们会及时删除。
客服QQ:xxxxxx 邮箱:xxxxxx@qq.com
渝ICP备2023013149号
Top