互联网商户及收单机构接入接口规范.docx
- 文档编号:370430
- 上传时间:2022-10-09
- 格式:DOCX
- 页数:43
- 大小:33.10KB
互联网商户及收单机构接入接口规范.docx
《互联网商户及收单机构接入接口规范.docx》由会员分享,可在线阅读,更多相关《互联网商户及收单机构接入接口规范.docx(43页珍藏版)》请在冰豆网上搜索。
互联网商户及收单机构接入接口规范
中国银联股份有限公司发布
2011-2-10实施
2011-2-10发布
互联网商户及收单机构接入接口规范
Q/CUP099.1—2011
Q/CUP
中国银联股份有限公司企业标准
i
1版本修订信息
版本号
完成日期
拟稿和修改人
发布日期
变更说明
1.0.6
2011-7-16
杨惠雄
2011-7-17
更新自动生成的目录及页码
1.0.7
2011-7-22
杨惠雄
2011-7-22
商户保留域增加担保支付和预授权的标志位
系统保留域增加返回支付方式
1.0.8
2011-7-25
杨惠雄
2011-7-25
增加响应码40及41的说明
1.0.9
2011-7-26
夏晶晶
2011-7-26
增加响应码42及37的说明
1.1.0
2011-7-29
夏晶晶
2011-7-29
商户简称长度改为32字节
1.1.1
2011-8-18
夏晶晶
2011-8-18
信息查询应答去掉交易类型
1.1.2
2011-8-22
夏晶晶
2011-8-22
订单号支持-,添加交易币种用法说明
1.1.3
2011-8-24
夏晶晶
2011-8-24
消息域说明修改
1.1.4
2011-8-30
夏晶晶
2011-8-30
添加担保消费交易说明
1.1.5
2011-9-6
夏晶晶
2011-9-6
添加二级商户字段说明
1.1.6
2011-9-16
夏晶晶
2011-9-16
添加收单机构与商户说明
1.1.7
2011-9-19
夏晶晶
2011-9-19
更新响应码
1.1.8
2011-9-27
夏晶晶
2011-9-27
添加isCustomPay字段 (牡丹畅通卡)说明
1.1.9
2011-10-11
夏晶晶
2011-10-11
添加merUserId字段 (商户端用户ID)说明
1.1.9
2011-10-11
夏晶晶
2011-10-11
添加merUserId字段 (商户端用户ID)说明
1.2.0
2011-10-17
夏晶晶
2011-10-17
添加响应码73
1.2.1
2011-11-7
夏晶晶
2011-11-7
添加响应码86
1.2.2
2011-11-8
夏晶晶
2011-11-8
添加专享支付方式字段说明
1.2.3
2011-11-10
夏晶晶
2011-11-10
添加customIp域针对防钓鱼说明
1.2.4
2011-11-23
张旭东
2011-11-23
用户保留域增加订单超时时间(orderTimeoutDate)说明
1.2.5
2011-11-25
夏晶晶
2011-11-25
添加对bizType,bizSubType,riskFlag的说明
目次
前言
本标准规定了商户及收单机构接入中国银联互联网系统使用的报文接口,包括交易种类、交易正常处理流程、异常情况的处理流程、消息域说明、消息格式以及交易报文格式说明。
本标准由中国银联股份有限公司提出。
本标准由中国银联股份有限公司制定。
本标准主要起草单位:
中国银联互联网业务部。
本标准主要起草人:
互联网商户及收单机构接入接口规范
11 范围
本标准规定了互联网商户及收单机构使用的报文接口,包括交易种类、交易正常处理流程和异常情况的处理流程、消息域说明、消息格式以及交易报文格式说明。
本标准的本部分适用于所有加入中国银联互联网系统的商户及收单机构。
参与方描述:
收单机构
指加入银联网络,与银联签订《银联卡无卡支付业务合作协议》开展银联无卡支付收单业务的境内成员机构。
商户
指加入银联网络,与银联签订《银联卡无卡支付业务合作协议》开展银联无卡支付业务的商户。
本文档中针对商户且未有特殊说明的同样适用于收单机构;仅针对于收单机构的特殊项则会加以特别描述(一般不适用于商户)。
12 规范性引用文件
下列文件中的条款通过本标准的引用而成为本标准的条款。
凡是注日期的引用文件,其随后所有的修改单(不包括勘误的内容)或修订版均不适用于本标准,然而,鼓励根据本标准达成协议的各方研究是否可使用这些文件的最新版本。
凡是不注日期的引用文件,其最新版本适用于本标准。
Q/CUP006《银行卡联网联合技术规范V2.0》
Q/CUP001《银行卡信息交换术语》
13 术语和定义
下列术语和定义适用于本标准。
表1 术语解释
代码
含义
样例
UPOP
中国银联互联网交易系统的简称
商户代码
商户是指与收单机构签订商户协议,代理银行卡的零售商、个人、公司或其他组织,收单机构方为其提供收单服务。
商户接入UPOP时,由UPOP分配的全局唯一的id
1
清算日期
指处理中心在转接各类交易请求时,在转接信息中增加的处理中心的时间戳。
该时间戳作为处理中心对转接信息进行币种转换、清算、收费、对账、查询以及统计的日期依据。
清算金额
用于清算的资金轧差额。
处理中心与入网机构约定清算时,事先指定清算币种,并采用轧差净额清算。
对账
交易双方之间的交易总额核对,以达到账务一致
合作密钥
商户和UPOP签订接入协议时,由双方共同确定的密钥串,该值可以在必要的时候双方重新确定。
该串用于商户和UPOP通信时的签名。
密钥串的长度为32。
90abcdef090abcdef
签名信息
采用特定签名算法对交易过程中的关键信息和合作密钥进行签名,具有防篡改和防抵赖的特性。
签名信息的长度暂定位32。
商户应严格保密该密钥串,若该密钥串泄露或者长时间密钥更换,建议主动要求更换密钥串。
否则造成的损失由商户承担。
90abcdef090abcdef
14 交易处理说明
在互联网电子商务交易中涉及商户、购买者、中间服务方三个角色。
交易时,购买者在商户网站上选购一件或者多件商品,形成商品订单。
购买者将商品订单提交给中间服务方,中间服务方实现从购买者账户到商户账户的资金转移。
其中中国银联互联网系统充当网上交易过程中的中间服务方的角色,帮助买家付款,帮助商家收款。
UPOP的接入功能集成在商户网站中,为了更好的为商户提供服务,提供商户的交易支付接口和交易信息查询接口。
14.1 交易分类说明
按交易的功能分类,可以将交易分为金融类、管理及安全控制类等。
金融类包括消费、消费撤销、退货、预授权、预授权撤销、预授权完成、预授权完成撤销。
管理及安全控制类包括交易信息查询。
14.2 金融类业务流程介绍
1)持卡人浏览商户网站、购买商品、选择使用银联快捷支付方式进行网上支付
2)商户网站将持卡人浏览器页面定向到中国银联互联网系统支付页面
3)用户完成支付相关信息的输入
4)中国银联互联网系统返回交易结果
4.1)通过页面跳转的方式返回交易结果。
此种方式是异步交互的
4.2)通过后台通知的方式主动向商户系统发送交易结果
5)商户在收到中国银联互联网交易系统的交易结果通知时,若交易状态为成功,则建议应该立即向UPOP发起交易查询(该步骤可选),查询该交易是否成功,以此来防范第三方伪造交易成功的信息。
6)中国银联互联网交易系统返回查询结果给商户
通知重发机制
对支持交易结果后台通知的商户,在交易结束后会将交易结果发送给商户。
若一次没有发送成功,通过退避策略重新发送后台交易通知。
具体方法为2(i-1)分钟发送后台交易结果通知,在重新发送通知的过程中,只要有一次成功,则中断重发策略。
其中i是重新发送的次数,i∈[1,5]。
说明:
商户端在接收到交易通知时,应该立即确认已经收到,并且丢弃重复的交易结果通知。
14.3 管理类业务流程介绍
1)当商户对无法确认交易结果或者对交易处理有异议时,可以主动发起信息查询
2)中国银联互联网交易系统返回查询结果
15 消息结构
采用HTTP标准的POST协议。
16 消息域说明
16.1 报文域的属性说明
在银联互联网系统与各商户的报文中,各报文域的数据类型、长度属性及格式如下表所示:
表2 报文域数据类型、长度属性及格式含义表
字符
含义
A
字母字符,A至Z,a至z,向左靠,右边多余位填空格
B
数据的二进制表示,后跟数字表示位(bit)的个数
B
用于表示变长的二进制数,后跟数字表示二进制数据所占字节(Byte)的个数
n
数值,0至9,右靠,首位有效数字前填零。
若表示人民币金额,则最右二位为角、分
p
填充字符,如空格
s
特殊符号
an
字母和数字字符,左靠,右边多余位填空格
as
字母和特殊字符,左靠,右边多余位填空格
cn
压缩数字码,即BCD码
ns
数字和特殊字符,左靠,右边多余位填空格
ans
字母、数字和特殊字符,左靠,右边多余位填空格
ansb
字母、数字、特殊字符和二进制数,左靠,右边多余位填空格
MM
月份,01至12
DD
日期,01至31
YY
年份,00至99
hh
时,00至23
mm
分,00至59
ss
秒,00至59
VAR
可变长度数据元
3
3字符的固定长度
..17
最大17个字符的可变长度。
X
借贷符号,贷记为“C”,借记为“D”,并且总是与一个数字型金额数据元相连,例如,
净对账金额中X+N16含义为前缀“C”或“D”和净对账金额的16位数字。
Z
ISO4909和ISO7813中定义的磁卡第二、三磁道的代码集
16.2 消息版本号
MessageVersionNumber
对应KEY元素
version
变量属性
ns5..8,5到8位数字或字符.
域描述
用于表示支持的协议版本号。
消息版本号必须表示为:
*.*.*,其中
“*”表示1到2个数字
用法
在所有的消息中,各组件都必须填写自身支持的协议版本号。
消息版本号不能低于1.0.0。
16.3 字符编码
CharacterSet
对应KEY元素
charset
变量属性
ans1..20,最长20位数字、字母或者特殊符号
域描述
本域指明了报文中字符的编码规范。
用法
目前支持的包括GBK、UTF-8等。
16.4 签名方法
SigningMethod
对应KEY元素
signMethod
变量属性
an1..10,最长10位数字、字母
域描述
本域指明了报文中签名的算法。
用法
在交易应答中该域内容应与交易请求一致。
目前支持的签名算法包括MD5。
16.5 签名信息
SigningMessages
对应KEY元素
signature
变量属性
an32,32位定长的字母、数字
域描述
采用特定签名算法对交易过程中的关键信息和合作密钥进行签名,具有防篡改和防抵赖的特性。
签名信息的长度暂定位32。
商户应严格保密该密钥串,若该密钥串泄露或者长时间密钥更换,建议主动要求更换密钥串。
否则造成的损失由商户承担。
用法
算法请参考(规范性附录)数字签名
当交易双方计算出来的签名信息不一致时,则直接拒绝交易。
16.6 交易类型
Transactiontype
对应KEY元素
transType
变量属性
n2,2位定长数字
域描述
本域指明了交易的种类。
交易类型分段区分,具体定义如下表所示:
表3 交易类型分段
代码
含义
01—30
金融类交易
31—60
金融撤销类交易
61—65
收单机构发起的金融通知类交易
66—70
发卡机构发起的金融通知
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- 互联网 商户 机构 接入 接口 规范
![提示](https://static.bdocx.com/images/bang_tan.gif)