Q/××× ××××—××××
i
版本修订信息
版本号
完成日期
拟稿和修改人
发布日期
变更说明
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的说明
1.2.6
2011-12-22
夏晶晶
2011-12-22
添加返回卡号、卡类型的说明，商户名称改为40字节
1.2.7
2011-12-29
夏晶晶
2011-12-29
普通支付改名为小额支付
1.2.8
2012-2-1
夏晶晶
2012-2-1
无卡自助
规范
编程规范下载gsp规范下载钢格栅规范下载警徽规范下载建设厅规范下载
相关修改
1.2.9
2012-7-12
夏晶晶
2012-7-12
添加6.33章节中对payModes说明，及merReserved变量属性长度修改
1.3.0
2012-7-13
夏晶晶
2012-7-13
修改附录A内容
1.3.1
2012-7-26
夏晶晶
2012-7-26
修改2.1规范相关
1.3.2
2012-8-8
张旭东
2012-08-08
更新响应码
1.3.3
2012-10-8
夏晶晶
2012-10-8
更新响应码
1.3.4
2012-10-11
沈之春
2012-10-11
新增响应码
1.3.5
2013-01-05
张旭东
2013-01-05
商户订单号取消支持-和_
目 次
I版本修订信息
IV前 言
11 范围
12 规范性引用文件
13 术语和定义
24 交易处理说明
24.1 交易分类说明
24.2 金融类业务流程介绍
34.3 管理类业务流程介绍
35 消息结构
46 消息域说明
46.1 报文域的属性说明
46.2 消息版本号
56.3 字符编码
56.4 签名方法
56.5 签名信息
56.6 交易类型
66.7 商户名称
66.8 商户代码
66.9 商户类型
76.10 通知URL
76.11 返回URL
76.12 收单机构代码
76.13 交易开始日期时间
86.14 交易超时时间
86.15 交易完成日期时间
86.16 商户订单号
96.17 商品名称
96.18 商品URL
96.19 商品单价
96.20 商品数量
106.21 运输费用
106.22 优惠信息
106.23 交易金额
116.24 交易币种
116.25 持卡人姓名
116.26 默认支付方式
126.27 默认银行编码
126.28 持卡人IP
126.29 交易流水号
126.30 系统跟踪号
136.31 系统跟踪时间
136.32 原始交易流水号
136.33 商户保留域
166.34 系统保留域
186.35 响应码
186.36 响应时间
186.37 响应信息
186.38 清算金额
196.39 清算币种
196.40 清算汇率
196.41 兑换日期
206.42 清算日期
206.43 查询结果
207 交易报文格式说明
207.1 说明
217.2 报文接口定义
25附 录 A （规范性附录） 报文摘要
26附 录 B （规范性附录） 应答码
前 言
本标准规定了商户接入中国银联互联网系统使用的报文接口，包括交易种类、交易正常处理流程、异常情况的处理流程、消息域说明、消息格式以及交易报文格式说明。
本标准由中国银联股份有限公司提出。
本标准由中国银联股份有限公司制定。
本标准主要起草单位：中国银联互联网业务部。
本标准主要起草人：
互联网商户接入接口规范
1 范围
本标准规定了互联网商户使用的报文接口，包括交易种类、交易正常处理流程和异常情况的处理流程、消息域说明、消息格式以及交易报文格式说明。
本标准的本部分适用于所有加入中国银联互联网系统的商户。
参与方描述：
商户
指加入银联网络，与银联签订《银联卡无卡支付业务合作协议》开展银联无卡支付业务的商户。
2 规范性引用文件
下列文件中的条款通过本标准的引用而成为本标准的条款。凡是注日期的引用文件，其随后所有的修改单（不包括勘误的内容）或修订版均不适用于本标准，然而，鼓励根据本标准达成协议的各方研究是否可使用这些文件的最新版本。凡是不注日期的引用文件，其最新版本适用于本标准。
Q/CUP 006 《银行卡联网联合技术规范V2.1》
Q/CUP 001 《银行卡信息交换术语》
3 术语和定义
下列术语和定义适用于本标准。
表
关于同志近三年现实表现材料材料类招标技术评分表图表与交易pdf视力表打印pdf用图表说话 pdf
1 术语解释
代码
含义
样例
UPOP
中国银联互联网交易系统的简称
商户代码
商户是指与收单机构签订商户协议，代理银行卡的零售商、个人、公司或其他组织，收单机构方为其提供收单服务。
商户接入UPOP时，由UPOP分配的全局唯一的id
1234567890123456
清算日期
指处理中心在转接各类交易请求时，在转接信息中增加的处理中心的时间戳。该时间戳作为处理中心对转接信息进行币种转换、清算、收费、对账、查询以及统计的日期依据。
清算金额
用于清算的资金轧差额。处理中心与入网机构约定清算时，事先指定清算币种，并采用轧差净额清算。
对账
交易双方之间的交易总额核对，以达到账务一致
合作密钥
商户和UPOP签订接入协议时，由双方共同确定的密钥串，该值可以在必要的时候双方重新确定。该串用于商户和UPOP通信时的签名。密钥串的长度为32。
1234567890abcdef01234567890abcdef
签名信息
采用特定签名算法对交易过程中的关键信息和合作密钥进行签名，具有防篡改和防抵赖的特性。签名信息的长度暂定位32。商户应严格保密该密钥串，若该密钥串泄露或者长时间密钥更换，建议主动要求更换密钥串。否则造成的损失由商户承担。
1234567890abcdef01234567890abcdef
4 交易处理说明
在互联网电子商务交易中涉及商户、购买者、中间服务方三个角色。交易时，购买者在商户网站上选购一件或者多件商品，形成商品订单。购买者将商品订单提交给中间服务方，中间服务方实现从购买者账户到商户账户的资金转移。其中中国银联互联网系统充当网上交易过程中的中间服务方的角色，帮助买家付款，帮助商家收款。
UPOP的接入功能集成在商户网站中，为了更好的为商户提供服务，提供商户的交易支付接口和交易信息查询接口。
4.1 交易分类说明
按交易的功能分类，可以将交易分为金融类、管理及安全控制类等。
金融类包括消费、消费撤销、退货、预授权、预授权撤销、预授权完成、预授权完成撤销。
管理及安全控制类包括交易信息查询。
4.2 金融类业务流程介绍
1) 持卡人浏览商户网站、购买商品、选择使用银联快捷支付方式进行网上支付
2) 商户网站将持卡人浏览器页面定向到中国银联互联网系统支付页面
3) 用户完成支付相关信息的输入
4) 中国银联互联网系统返回交易结果
4.1） 通过页面跳转的方式返回交易结果。此种方式是异步交互的
4.2） 通过后台通知的方式主动向商户系统发送交易结果
5) 商户在收到中国银联互联网交易系统的交易结果通知时，若交易状态为成功，则建议应该立即向UPOP发起交易查询（该步骤可选），查询该交易是否成功，以此来防范第三方伪造交易成功的信息。
6) 中国银联互联网交易系统返回查询结果给商户
4.2.1 通知重发机制
对支持交易结果后台通知的商户，在交易结束后UPOP会将交易结果发送给商户。若一次没有发送成功，通过退避策略重新发送后台交易通知。具体方法为2(i-1) 分钟发送后台交易结果通知，在重新发送通知的过程中，只要有一次成功，则中断重发策略。其中i是重新发送的次数，i∈[1, 5]。
说明：商户端在接收到交易通知时，应该立即确认已经收到，并且丢弃重复的交易结果通知。
4.3 管理类业务流程介绍
1) 当商户对无法确认交易结果或者对交易处理有异议时，可以主动发起信息查询
2) 中国银联互联网交易系统返回查询结果
5 消息结构
采用HTTP 标准的POST 协议。
6 消息域说明
6.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
ISO 4909和ISO 7813中定义的磁卡第二、三磁道的代码集
6.2 消息版本号
Message Version Number
6.2.1 对应KEY元素
version
6.2.2 变量属性
ns5..8，5到8位数字或字符.
6.2.3 域描述
用于表示支持的协议版本号。
消息版本号必须表示为：*.*. *，其中
“*” 表示1到2个数字
6.2.4 用法
在所有的消息中，各组件都必须填写自身支持的协议版本号。
消息版本号不能低于1.0.0。
6.3 字符编码
Character Set
6.3.1 对应KEY元素
charset
6.3.2 变量属性
ans1..20，最长20位数字、字母或者特殊符号
6.3.3 域描述
本域指明了报文中字符的编码规范。
6.3.4 用法
目前支持的包括GBK、UTF-8等。
6.4 签名方法
Signing Method
6.4.1 对应KEY元素
signMethod
6.4.2 变量属性
an1..12，最长12位数字、字母
6.4.3 域描述
本域指明了报文中签名的算法。
6.4.4 用法
在交易应答中该域内容应与交易请求一致。
目前支持的签名算法包括MD5。
6.5 签名信息
Signing Messages
6.5.1 对应KEY元素
signature
6.5.2 变量属性
an32，32位定长的字母、数字
6.5.3 域描述
采用特定签名算法对交易过程中的关键信息和合作密钥进行签名，具有防篡改和防抵赖的特性。签名信息的长度暂定位32。商户应严格保密该密钥串，若该密钥串泄露或者长时间密钥更换，建议主动要求更换密钥串。否则造成的损失由商户承担。
6.5.4 用法
算法请参考（规范性附录）数字签名
当交易双方计算出来的签名信息不一致时，则直接拒绝交易。
6.6 交易类型
Transaction type
6.6.1 对应KEY元素
transType
6.6.2 变量属性
n2，2位定长数字
6.6.3 域描述
本域指明了交易的种类。交易类型分段区分，具体定义如下表所示：
表3 交易类型分段
代码
含义
01—30
金融类交易
31—60
金融撤销类交易
61—65
收单机构发起的金融通知类交易
66—70
发卡机构发起的金融通知类交易
71—80
不涉及资金的其他交易
81--99
公共支付类交易
6.6.4 用法
在交易应答中该域内容应与交易请求一致。
具体的用法如下：
表4 交易类型用法
代码
含义
01
消费
31
消费撤销
02
预授权
32
预授权撤销
03
预授权完成
33
预授权完成撤销
04
退货
6.7 商户名称
Merchant Name
6.7.1 对应KEY元素
merAbbr
6.7.2 变量属性
ans1..40，最大40字节，可送字母、数字、空格、符号（包括-_.空格中英文括号）和中文（字符集u4e00-u9fa5）
6.7.3 域描述
商户代码对应的商户名称。一般出现在显示给持卡人的页面中。
6.7.4 用法
一般用于请求消息中，表示商户名称。
6.8 商户代码
Merchant ID
6.8.1 对应KEY元素
merId
6.8.2 变量属性
n15..24，长度15到24个数字
6.8.3 域描述
商户代码。该商户应是已被批准加入银联互联网系统的商户网站的代码。
6.8.4 用法
由中国银联互联网系统统一分配，不得重复。
对所有的请求报文，该域必须出现，且在整个交易周期中保持不变。
6.9 商户类型
Merchant's Type
6.9.1 对应KEY元素
merCode
6.9.2 变量属性
n4，4位定长数字字符
6.9.3 域描述
表示商户分类编码(MCC)。
6.9.4 用法
商户类型码表示商户的服务范围和属性。取值请参见GB/T 20548-2006《金融零售业务 商户类别代码》。
6.10 通知URL
Notify URL
6.10.1 对应KEY元素
backEndUrl
6.10.2 变量属性
ans1..256，最大256个（字母、数字和特殊字符）的商户网站URL，URL编码说明参见7.1.3章节
6.10.3 域描述
商户网站的后台URL。绝对地址，例如：http://www.unionpay.com/main.jsp
6.10.4 用法
当完成买家账户向商户账户的支付时,要求商户返回URL收到通知后进行响应。
6.11 返回URL
Return URL
6.11.1 对应KEY元素
frontEndUrl
6.11.2 变量属性
ans1..256，最大256个（字母、数字和特殊字符）的API地址，URL编码说明参见7.1.3章节
6.11.3 域描述
商户网站的前台URL。例如：http://www.unionpay.com/main.jsp
6.11.4 用法
当完成买家账户向商户账户的支付时,通过商户通知URL进行页面跳转。
6.12 收单机构代码
Acquirer BIN
6.12.1 对应KEY元素
acqCode
6.12.2 变量属性
n..11，最大11位数字的收单机构代码
6.12.3 域描述
收单机构代码。该收单机构应是已被批准加入银联互联网系统的，能为商户网站提供收单服务的入网机构。
6.12.4 用法
收单机构代码是关键信息域，在发送方随后发出的与之相关的交易中该域信息也应保持不变。
6.13 交易开始日期时间
Start Date & Time For Purchase
6.13.1 对应KEY元素
orderTime
6.13.2 变量属性
n14，14位定长数字字符
6.13.3 域描述
交易开始日期和时间均为北京时间。
格式：
YYYYMMDDHHMMSS，其中
YYYY 4个数字，表示年份
MM 01-12，表示月份
DD 01-31，表示日期
HH 00-23，表示小时
MM 00-59，表示分钟
SS 00-59，表示秒
6.13.4 用法
交易发生时的时间日期。
6.14 交易超时时间
Expiring Time For Purchase
6.14.1 对应KEY元素
transTimeout
6.14.2 变量属性
n..10，10位变长数字字符
6.14.3 域描述
单位为毫秒。
6.14.4 用法
交易发生时，该笔交易在银联互联网系统中有效的最长时间。当距离交易开始日期时间超过该时间时，银联互联网系统不再为该笔交易提供支付服务。
6.15 交易完成日期时间
Finishing Date & Time For Purchase
6.15.1 对应KEY元素
respTime
6.15.2 变量属性
n14，14位定长数字字符
6.15.3 域描述
同6.13.3
REF _Ref286149958 \h
\* MERGEFORMAT 域描述
6.15.4 用法
该笔交易银联互联网系统收到发卡机构应答时的时间。
6.16 商户订单号
Merchant Order Number
6.16.1 对应KEY元素
orderNumber
6.16.2 变量属性
an8..32，最大32个字母、数字
6.16.3 域描述
用于表示商户的订单号。在商户内部应唯一。
6.16.4 用法
用于传送商户订单号信息，最大为32个字节的信息。
6.17 商品名称
Merchant Order Information
6.17.1 对应KEY元素
commodityName
6.17.2 变量属性
ans1..256，最大256个字母、数字、空格、符号（包括-_.空格中英文括号）和中文（字符集u4e00-u9fa5）。其编码格式应与6.3
REF _Ref286135121 \h
字符编码相一致。
6.17.3 域描述
用于表示订单的商品信息。
6.17.4 用法
用于传送商户订单的商品信息，最大为256个字节的信息。
6.18 商品URL
Goods URL
6.18.1 对应KEY元素
commodityUrl
6.18.2 变量属性
ans1..1024，最大1024个字母、数字和特殊字符，URL编码说明参见7.1.3章节
6.18.3 域描述
商品的URL。与6.17
REF _Ref286135447 \h
商品名称对应。
6.18.4 用法
表示商品的URL。
6.19 商品单价
Goods Price
6.19.1 对应KEY元素
commodityUnitPrice
6.19.2 变量属性
n1..12，最长12位数字
6.19.3 域描述
单件商品的价格。本域中不带小数点，小数位根据6.24
REF _Ref286135682 \h
交易币种来决定。
6.19.4 用法
见6.23.4
REF _Ref286136582 \h
用法
6.20 商品数量
Goods Amount
6.20.1 对应KEY元素
commodityQuantity
6.20.2 变量属性
n1..10，最大10个数字的商品数量
6.20.3 域描述
商品的总数量。与6.17
REF _Ref286135447 \h
商品名称对应。
6.20.4 用法
表示商品的总数量。
6.21 运输费用
Transportation Expenses
6.21.1 对应KEY元素
transferFee
6.21.2 变量属性
n1..12，最长12位数字
6.21.3 域描述
商品运输时的运费信息。本域中不带小数点，小数位根据6.24
REF _Ref286135682 \h
交易币种来决定。
6.21.4 用法
见6.23.4
REF _Ref286136582 \h
用法
6.22 优惠信息
Favorable Information
6.22.1 对应KEY元素
commodityDiscount
6.22.2 变量属性
n1..12，最长12位数字
6.22.3 域描述
内容是根据优惠券信息，或者折价数目等等交易折扣的金额。该金额表示原始金额和交易实际金额的差值。本域中不带小数点，小数位根据6.24
REF _Ref286135682 \h
交易币种来决定。
6.22.4 用法
见6.23.4
REF _Ref286136582 \h
\* MERGEFORMAT 用法
6.23 交易金额
Purchase Amount
6.23.1 对应KEY元素
orderAmount
6.23.2 变量属性
n1..12，最长12位数字
6.23.3 域描述
交易金额。本域中不带小数点，小数位根据6.24
REF _Ref286135682 \h
交易币种来决定。
6.23.4 用法
本域值是交易的总金额，包括商品的价格和运费。且其值在交易的整个过程中保持不变，其币种由交易币种指明，若本域出现，则交易币种必出现。对于参与多币种交易的发卡方，该域反映了收单方提交请求时的币种。
当交易币种为人民币时，本域的最右两位应包含人民币的角和分。
当交易币种为外币时，如果该币种没有小数位，则该域的值代表实际交易金额；如果该币种有两个小数位，则表示方法同人民币；若有三个小数位，则最后一个小数位必须为零。用法举例如下表所示：
表5 交易金额用法
币种
小数位数
实际金额
本域值
人民币
两位小数
1000．02
100002
外币
没有小数位
1000
1000
两位小数
1000．02
100002
三位小数
1000．112
1000110
6.24 交易币种
Purchase Currency
6.24.1 对应KEY元素
orderCurrency
6.24.2 变量属性
n3，3位定长数字
6.24.3 域描述
表示交易货币代码。
6.24.4 用法
具体的用法如下：
表6 交易币种用法
代码
含义
156
人民币
840
美元
978
欧元
392
日元
756
瑞士法郎
036
澳大利亚元
124
加拿大元
344
港币
826
英镑
446
澳门元
702
新加坡元
901
新台币
360
印尼盾
6.25 持卡人姓名
Cardholder Name
6.25.1 对应KEY元素
customerName
6.25.2 变量属性
ans1..20，最长20个字母、数字、空格、符号（包括.空格中英文括号）和中文（字符集u4e00-u9fa5）
6.25.3 域描述
持卡人真实的姓名。
6.25.4 用法
如果用户的姓名超过20位，则截取前20个字节。
6.26 默认支付方式
Default Payment Method
6.26.1 对应KEY元素
defaultPayType
6.26.2 变量属性
a1…20，最长20字母，区分大小写。
6.26.3 域描述
持卡人在网站购物时，默认的首选交易支付方式。
可能的值为以下中的一种，括号内为中文解释：LitePay（认证支付）,ProPay（快捷支付）,CommonPay（小额支付）,ExpressPay（储值卡支付）,CSPay（网银支付）,DirectPay（后台支付），ICPay（IC卡支付）
6.27 默认银行编码
Default issuer Code
6.27.1 对应KEY元素
defaultBankNumber
6.27.2 变量属性
a1..5，最长5个字母
6.27.3 域描述
持卡人在网站购物时，默认跳往的银行
6.28 持卡人IP
Cardholder IP
6.28.1 对应KEY元素
customerIp
6.28.2 变量属性
ns1..40，最长40个字节的数字或者特殊字符
6.28.3 域描述
持卡人访问商户网站时的IP地址。若开启IP防钓鱼功能，则需上送持卡人真实IP。
6.28.4 用法
该地址可以是IPv4格式，也可以是IPv6格式。只允许上送单个IP。
6.29 交易流水号
Serial Number
6.29.1 对应KEY元素
qid
6.29.2 变量属性
n21，21位定长数字
6.29.3 域描述
对于每一笔支付交易，银联互联网系统都赋予其一个交易流水号。该流水号不得重复。
6.29.4 用法
该值在银联互联网交易系统中唯一标识一笔交易，是系统处理的关键域。
6.30 系统跟踪号
Trace Number
6.30.1 对应KEY元素
traceNumber
6.30.2 变量属性
n6，6位定长数字
6.30.3 域描述
CUPS系统跟踪号，做对账时使用
6.30.4 用法
对账时使用
6.31 系统跟踪时间
Trace Time
6.31.1 对应KEY元素
traceTime
6.31.2 变量属性
n10，10位定长数字 MMDDHHMMSS
6.31.3 域描述
CUPS系统跟踪时间，做对账时使用
6.31.4 用法
对账时使用
6.32 原始交易流水号
Initial Serial Number
6.32.1 对应KEY元素
origQid
6.32.2 变量属性
n21，21位定长数字
6.32.3 域描述
上一笔关联交易的交易流水号，以便于银联互联网系统可以准确定位原始交易。
6.32.4 用法
交易类型为“撤销”、“完成”或者“退货”时必填。
6.33 商户保留域
Merchant Reserved Field
6.33.1 对应KEY元素
merReserved
6.33.2 变量属性
ans1..，允许字母、数字或者特殊字符
6.33.3 域描述
此保留域供商户在请求报文中带给银联。
6.33.4 用法
(1) 消费等前台类交易时，该域用来特殊信息的传递。
1、 子域1（商户摘要）
merAbstract
0-8位可见字符，包括数字、字母、中文等
merReserved={ merAbstract =商户摘要}
(2) 消费等前台类交易时，该域用来传递默认显示的支付方式。
1、 子域1（交易支付方式）
payModes
可能的值为以下中的几种（由逗号分隔），括号内为中文解释：LitePay（认证支付）,ProPay（快捷支付）,CommonPay（小额支付）,ExpressPay（储值卡支付）,CSPay（网银支付）,DirectPay（后台支付），ICPay（IC卡支付）
用法： 保留域外加大括号
merReserved={payModes=LitePay,ProPay,CSPay}
(3) 区分预授权及担保消费的标志位（注：仅在transType=02 时有用）。
1、 子域1（预授权/担保消费 标志位）
isPreAuth
布尔型：“true” 或者 “false”
transType=02&merReserved={isPreAuth=true}
(4) 交易查询时，该域用来收单机构号的传递收单机构号说明见6.12,以收单机构身份接入时必填merReserved={acqCode=收单机构号}
(5) 二级商户信息的传递
表7 商户保留域信息定义
子域1（商户接入类型）
子域2（二级商户代码）
子域3（二级商户全称）
子域4（二级商户简称）
1、 子域1（商户接入类型）
merPlatformType
1位数字，1代表平台类， 0代表直连（普通）类
若上送的该域是1（平台类），则子域4（二级商户代码）、子域5（二级商户全称）、子域6（二级商户简称）都必填
2、 子域2（二级商户代码）
secondaryMerId
an5..15，最大15个字母（a-z）、数字
3、 子域3（二级商户全称）
secondaryMerFullName
ans1..40，最大40字节，可送字母、数字、空格、符号（包括-_.空格中英文括号）和中文（字符集u4e00-u9fa5）
4、 子域4（二级商户简称）
secondaryMerAbbr
ans1..16，最大16个字母、数字、空格、符号（包括-_.空格中英文括号）和中文（字符集u4e00-u9fa5）
merReserved={merPlatformType=1&secondaryMerId=12346789000&secondaryMerFullName=二级商户全称&secondaryMerAbbr=二级商户简称}
(6) 特定商户在商户端摆放“牡丹畅通卡支付”等专享支付方式图标，并上送该域，银联将提供简约的专享支付页面。注：商户上送该域后，银联支付页面将只显示上送的专享支付方式。
1、 子域1（专享支付方式）
customPay
可能的值为以下中的一种，括号内为中文解释：PeonyCardPay（牡丹畅通卡支付）, CrbePay（中铁银通卡支付）
merReserved={customPay=PeonyCardPay}
(7) 商户可以通过该域上送持卡人在商户端的userId
1、 子域1（商户端用户ID）
merUserId
长度：1—60个字符
格式：字母、数字、中文
merReserved={ merUserId =userId}
(8) 商户可以通过该域上送订单超时时间
1. 子域1（订单超时时间）
orderTimeoutDate
订单支付超时时间，超过此时间用户支付成功的交易，不通知商户，系统自动退款，大约5个工作日金额返还到用户账户。
14位定长数字， yyyyMMddHHmmss, GMT+8
merReserved={orderTimeoutDate=20110426100856}
(9) 商户可以通过该域上送业务种类与子类
1、 子域1（业务种类）
bizType
2位定长数字
放置业务种类信息，业务种类定义为：
业务种类
说明
00
普通消费（如果没有填值，默认为普通消费）
01
基金
02
代收
03
订购
04~99
业务种类保留使用（暂不支持）
2、 子域2（业务子类）
bizSubType
2位定长数字
业务种类下业务子类定义：
业务种类
业务种类下业务子类
说明
00
01
一般消费交易（如果没有填值，默认
为一般消费交易）
00
02~99
“普通消费”下业务子类保留使用（暂不支持）
01
01
股票型基金
01
02
货币型基金
01
03~99
“基金”下业务子类保留使用（暂不支持）
02
01~99
“代收“下业务子类保留使用（暂不支持）
03
01~99
“订购“下业务子类保留使用（暂不支持）
04~99
01~99
业务种类下业务子类保留使用
merReserved={bizType=00&bizSubType=01}
(10) 商户可以通过上送该域来标识该笔交易物流情况
1、 子域1（物流标识）
riskFlag
2位定长数字
01:有物流
02:无物流，高风险，收益人不可追溯；此类商品包括：游戏点卡、游戏装备、游戏道具；虚拟货币；账号买卖；手机充值卡；彩票；礼品卡；购物券；商户虚拟账户充值等
03:无物流，可风险，收益人可追溯；此类商品为除“第二类”列举外的商品
04:无物流，其他；对于商户无法区分当前交易风险时请按此标识上送
注：对于一笔交易只可上送以上标识中的一个
merReserved={riskFlag=01}
6.34 系统保留域
UPOP Reserved Field
6.34.1 对应KEY元素
cupReseverd
6.34.2 变量属性
ans1..1024，最长1024个字母、数字或者特殊字符
6.34.3 域描述
此保留域供银联在应答报文中带给商户系统特殊信息。此域内容会根据业务发展有所增加。
6.34.4 用法
(1) 交易查询时，该域用来特殊信息的传递，具体定义如下：
表8 系统保留域信息定义
子域1（订单金额）
子域2（币种）
1、 子域1（订单金额）
orderAmount
0-12位数字, 单位为币种对应的单位
2、 子域2（币种）
orderCurrency
3位定长数字, 交易成功时必填
用法： 保留域外加大括号
cupReserved={orderAmount=100&orderCurrency=156}
(2) 交易支付方式
1、 子域1（交易支付方式）
payMode
默认不返回此域，如需要返此域，需要提交申请。可能的值为以下中的一种，括号内为中文解释：LitePay（认证支付）,ProPay（快捷支付）,CommonPay（小额支付）,ExpressPay（储值卡支付）,CSPay（网银支付）,DirectPay（后台支付），ICPay（IC卡支付）
用法： 保留域外加大括号
cupReserved={payMode=LitePay}
(3) 支付卡号
1、 子域1（支付卡号）
cardNumber
默认不返卡号，如需要返此域，需要提交申请。根据业务规则，银行作为收单机构时返全卡号，商户及第三方收单机构返部分卡号。
用法： 保留域外加大括号
cupReserved={cardNumber=621234*********1111}
(4) 支付卡类型
1、 子域1（卡类型）
cardType
默认不返回此域，如需要返此域，需要提交申请。该域取值为01（借记卡）或02（贷记卡）。
用法： 保留域外加大括号
cupReserved={cardType=02}
(5) 针对预授权完成交易，该域用来传递原始交易流水号
1、 子域1（原始交易流水号）
origQid
该字段具体描述见6.32章节
用法：保留域外加大括号
cupReserved={origQid=201106101324561234512}
6.35 响应码
Response Code
6.35.1 对应KEY元素
respCode
6.35.2 变量属性
an2，2位定长数字字母
6.35.3 域描述
表示对其所收到的交易的处理情况，如成功处理、无法处理或拒绝。若无法处理或拒绝该交易，则将在本域包含无法处理或拒绝的理由。
6.35.4 用法
对每个收到的请求报文，商户都应将本系统处理的结果在本域中返回给发起方。应答码定义详见附 录 B
REF _Ref286671377 \h
（规范性附录）应答码。
6.36 响应时间
Response Time
6.36.1 对应KEY元素
respTime
6.36.2 变量属性
n14，定长14位的数字
6.36.3 域描述
格式：yyyyMMddHHmmss
MM 01-12
dd 01-31
6.36.4 用法
系统的响应时间。
6.37 响应信息
Response Messages
6.37.1 对应KEY元素
respMsg
6.37.2 变量属性
ans1..1024，最长1024位的数字、字母或者特殊字符
6.37.3 域描述
对6.35
REF _Ref286153232 \h
响应码的文字描述
6.37.4 用法
对于系统错误的文字描述。
6.38 清算金额
Settle Amount
6.38.1 对应KEY元素
settleAmount
6.38.2 变量属性
n..12，最大12位数字的清算金额
6.38.3 域描述
用6.36
REF _Ref286153339 \h
清算币种的最小单位表示的清算金额，其中不包含任何标点。
例如：如果清算金额为123.45RMB，则setlAmount元素将包含值12345。
6.38.4 用法
清算金额＝交易金额×清算汇率，其中不包含任何手续费。本域中不带小数点，小数位由清算币种决定。
本域用做商户清算的依据。
如果是跨境交易，银联互联网系统在收到请求消息后，将交易金额根据当时的汇率转换成清算金额添加在应答消息中向商户转发。
6.39 清算币种
Settle Currency
6.39.1 对应KEY元素
settleCurrency
6.39.2 变量属性
n3，3位定长数字
6.39.3 域描述
表示交易清算货币代码。
6.39.4 用法
本域主要用于跨境交易，和清算金额配套使用。
当清算币种与交易币种不同时，要求在应答报文中标识清算币种。
6.40 清算汇率
Settlement Conversion Rate
6.40.1 对应KEY元素
exchangeRate
6.40.2 变量属性
n8，8位定长数字
6.40.3 域描述
银联与入网机构约定的交易币种到清算币种的转换汇率。格式为右对齐，无小数点。小数位数由最左边一位数字表示，第二位至第八位指的是汇率的值。
6.40.4 用法
本域由银联互联网系统填写，返回的应答报文中，该汇率为交易币种转换为商户清算币种的汇率。
当报文中存在交易金额和清算金额时，本域必须存在。若本域出现，则兑换日期、清算币种应同时出现。
6.41 兑换日期
Conversion Date
6.41.1 对应KEY元素
exchangeDate
6.41.2 变量属性
n4，4位定长数字
6.41.3 域描述
格式：MMDD
MM 01-12
DD 01-31
6.41.4 用法
从原始交易币种转换成清算币种的转换汇率的有效日期。日期为MMDD格式，其中MM=月份，DD=日期。
当交易币种和清算币种不一致时出现。
6.42 清算日期
Settle Date
6.42.1 对应KEY元素
settleDate
6.42.2 变量属性
n4，4位定长数字
6.42.3 域描述
格式：MMDD
MM 01-12
DD 01-31
6.42.4 用法
受理方和发卡方之间的交易结算日期。
6.43 查询结果
Query Result
6.43.1 对应KEY元素
queryResult
6.43.2 变量属性
n1，1位定长数字
6.43.3 域描述
在查询交易中，表示待查询的金融类交易在银联互联网系统的处理结果。
6.43.4 用法
具体的用法如下：
表9 查询结果用法
代码
含义
商户处理
0
成功
承兑交易
1
失败
拒绝交易
2
处理中
稍后查询或者拒绝交易
3
无此交易
拒绝交易
7 交易报文格式说明
7.1 说明
7.1.1 符号约定
表10 符号约定
符号
含义
数
据
元
数
值
符
号
M
必须填写的域
C
某条件成立时必须填写的域
C+
某条件成立时增加的域
C-
某条件成立时删除的域
M+
必须增加的域
O
受理方和发卡方自选填写的域
(
转发域
必须与先前报文中对应域的值相同的域
7.1.2 域长度计算说明
长度计算说明：所有长度均按字节计算，中文算两个字节，英文、数字算一个字节。
7.1.3 URL编码说明
URL参数中中文等特殊字符需编码。
7.2 报文接口定义
7.2.1 消费
消费指持卡人在特约商户购买商品或服务时，通过终端联机付款。持卡人在购买商品或服务时请求发卡方批准该交易。
本交易参与清算和对账。
通过POST的方式向银行互联网系统发起交易。
在金融类业务中，商户代码、商户订单号和交易开始日期时间是交易的关键信息域，银联互联网系统将用以上三个域的取值唯一确定一笔交易。
7.2.1.1 消费交易请求
表11 消费交易请求消息
报文域
KEY
处理要求
说明
消息版本号
version
M
字符编码
charset
M
全大写
签名方法
signMethod
M
签名信息
signature
M
交易类型
transType
M
商户名称
merAbbr
M
商户代码
merId
M
商户类型
merCode
C
当收单机构代码出现时，则该域必须出现
通知URL
backEndUrl
M
返回URL
frontEndUrl
M
收单机构代码
acqCode
C
当商户直接与银联互联网系统相连时，该域可不出现
当商户通过其他系统间接与银联互联网系统相连时，该域必须出现
交易开始日期时间
orderTime
M
商户订单号
orderNumber
M
商品名称
commodityName
O
商户可自行选择是否提交订单中包含的商品信息
如果订单中包含多个商品，则商品相关的域可重复出现
商品URL
commodityUrl
O
商品单价
commodityUnitPrice
O
商品数量
commodityQuantity
O
运输费用
transferFee
O
商户可自行选择
优惠信息
commodityDiscount
O
商户可自行选择
交易金额
orderAmount
M
交易币种
orderCurrency
M
持卡人姓名
customerName
O
建议商户提交。出现在支付信息采集页面中
默认支付方式
defaultPayType
O
默认银行编码
defaultBankNumber
O
交易超时时间
transTimeout
O
建议商户提交，以防止钓鱼网站的问
题
快递公司问题件快递公司问题件货款处理关于圆的周长面积重点题型关于解方程组的题及答案关于南海问题
持卡人IP
customerIp
M
原始交易流水号
origQid
C
当交易类型是撤销或者退货时，该域必须出现。
其他交易该域不可出现
商户保留域
merReserved
O
部分已启用，参见6.33.4
7.2.1.2 消费交易应答
银联互联网系统通过POST的方式反馈结果。
其中给前台用于页面跳转的使用请求交易报文中的“返回URL”进行；给后台通知商户处理结果的使用请求交易报文中的“通知URL”进行。
二者的格式相同。
表12 消费交易应答消息
报文域
KEY
处理要求
说明
消息版本号
version
M
字符编码
charset
M
签名方法
signMethod
M
签名信息
signature
M
交易类型
transType
M
响应码
respCode
M+
响应信息
respMsg
M+
该域是对响应码的文字说明，商户可以显示在页面上方便持卡人分析交易失败的结果
商户名称
merAbbr
M
商户代码
merId
M
商户订单号
orderNumber
M
系统跟踪号
traceNumber
M+
系统跟踪时间
traceTime
M+
交易流水号
qid
M+
该域是银联互联网系统给予每笔交易的唯一标识
交易金额
orderAmount
M
交易币种
orderCurrency
M
交易完成时间
respTime
M+
清算金额
settleAmount
M+
清算币种
settleCurrency
M+
清算日期
settleDate
M+
清算汇率
exchangeRate
M+
兑换日期
exchangeDate
M+
系统保留域
cupReserved
O
部分已启用，见6.34
7.2.2 交易信息查询
商户查询特定交易在中国银联互联网系统中的支付处理情况。一般可用于商户对交易处理状态的查询或者订单支付情况的查询。
本交易不参与清算和对账。
通过POST的方式向银行互联网系统发起交易。
7.2.2.1 信息查询请求
表13 信息查询请求消息
报文域
KEY
处理要求
说明
消息版本号
version
M
字符编码
charset
M
全大写
签名方法
signMethod
M
签名信息
signature
M
交易类型
transType
M
同待查询交易的交易类型。例如查询消费交易的处理状态，则该域填写01
商户代码
merId
M
商户订单号
orderNumber
M
交易开始日期时间
orderTime
M
同待查询交易的交易开始日期时间
商户保留域
merReserved
O
见6.33
7.2.2.2 信息查询应答
本应答信息的格式同7.2.1.2
REF _Ref286226018 \h
消费交易应答完全一样，但是处理要求存在差异，具体见下面的消息描述。
商户需同步等待中国银联互联网系统的应答。查询结果以英文连字符（&）连接起来作为纯文本字符串返回。
表14 信息查询应答消息
报文域
KEY
处理要求
说明
消息版本号
version
M
字符编码
charset
M
签名方法
signMethod
M
签名信息
signature
M
响应码
respCode
M+
两位数字，queryResult=0或者2时为00，其余情况下为非全零的两位错误码
响应时间
respTime
M+
yyyyMMddHHmmss
查询结果
queryResult
M+
0：成功
1：失败
2：处理中
3：无此交易
交易流水号
qid
M+
返回待查询交易在银联互联网系统中的流水号
如果针对该笔交易发起撤销、退货等后续交易，则在“原始交易流水号”内填入此值
系统跟踪号
traceNumber
M+
系统跟踪时间
traceTime
M+
清算金额
settleAmount
M+
清算币种
settleCurrency
M+
清算日期
settleDate
M+
清算汇率
exchangeRate
M+
兑换日期
exchangeDate
M+
系统保留域
cupReserved
O
部分已启用，见6.34
7.2.3 消费撤销
消费撤销指特约商户由于自身的原因对持卡人已经通过的联机付款的交易，于当日主动发起的对消费交易的取消。消费撤销交易必须是对原始金融交易的全额撤销。
消费撤销交易与原交易必须发生在同一个结算日。
本交易参与清算和对账。
本交易的报文格式同7.2.1
REF _Ref286226343 \h
消费。相对于消费交易，消费撤销交易增加“原始交易流水号”，其值为原始消费交易的交易流水号。
7.2.4 预授权/担保消费
预授权与担保消费的报文差别在于merReserved保留域字段中是否上送isPreAuth标志位，默认不送代表担保消费，上送isPreAuth=true代表预授权交易。预授权交易在预授权完成时的金额可以超过原交易金额的100%，担保消费则不能超过原交易金额的100%。具体merReserved保留域字段用法请参见6.33。以下由预授权代表预授权/担保消费。
预授权交易用于商户向持卡人的发卡方确认交易许可。商户将预估的消费金额作为预授权金额，发送给持卡人的发卡方。
预授权交易只控制持卡人的可用余额的额度。由预授权完成交易来完成资金结算。一个被批准的预授权交易，仅在有限的时间内有效。
本交易不参加当日清算。
本交易的报文格式同7.2.1
REF _Ref286226343 \h
消费。
7.2.5 预授权撤销
对已成功的预授权交易，在结算前使用预授权撤销交易，通知发卡方取消付款承诺。
预授权撤销交易必须是对原始预授权交易的全额撤销。
本交易不参加清算。
本交易的报文格式7.2.3
REF _Ref286240278 \h
消费撤销。其中其中“原始交易流水号”填写为原始预授权交易的交易流水号。
7.2.6 预授权完成
对已批准的预授权交易，用预授权完成做支付结算。本交易参加当日清算和对账。
本交易的报文格式同7.2.1
REF _Ref286226343 \h
消费。相对于消费交易，预授权完成交易增加“原始交易流水号”，其值为原始预授权交易的交易流水号。
7.2.7 预授权完成撤销
预授权完成撤销交易必须是对原始预授权完成交易的全额撤销。预授权完成撤销交易与原交易必须发生在同一个结算日。本交易参加清算。
本交易的报文格式7.2.3
REF _Ref286240278 \h
消费撤销。其中“原始交易流水号”填写为原始预授权完成交易的交易流水号。
7.2.8 退货
退货指应持卡人要求，对持卡人已经付款消费交易或者预授权完成交易,发起隔日取消并将已扣款项退还持卡人原扣款账户的过程。对已结算的消费交易，可使用退货，以退还持卡人消费的金额。
本交易参加清算和对账。
本交易的报文格式同7.2.1
REF _Ref286226343 \h
消费。相对于消费交易，退货交易增加“原始交易流水号”，其值为原始消费交易或者预授权完成交易的交易流水号。退货交易类似消费撤销交易。
附 录 A
（规范性附录）
报文摘要
商户和银联互联网系统签订接入协议时，由双方共同确定合作密钥串secret_key，该值可以在必要的时候双方重新确定。该串用于商户和银联互联网系统通信时的计算摘要。密钥串的长度为32。
该报文摘要是对关键信息的
对和合作密钥信息对的摘要值。
摘要算法（暂定）为MD5，摘要的结果是长度为32（暂定）的ASCII码。
摘要计算方法如下：
A 关键信息对和合作密钥信息对的拼接方法为：
1）单个对的表示方式为 key=value。如果该key对应的value为空，则表示方式为key=
2）多个对的拼接方式为 key1=value1&key2=&key3=value3
3）合作密钥信息的拼接方式为key1=value1&key2=&key3=value3&md5（secret_key），密钥信息经过MD5计算后拼接在对的尾端。
B 摘要方法
signature = md5(key1=value1&key2=&key3=value3...&keyn=valuen&md5(secret_key))
说明1：将摘要中的对（不包含合作密钥）根据key值作升序排列。其中key应包含报文格式中除“签名方法”和“签名信息”外的所有取值。若对中含有&、@等特殊字符或者中文字符时，要保持原样计算摘要值。发送时HTTP请求时，再进行URL编码。
说明2：若参与摘要的信息串中包含中文，则需要先将中文转化为char_set指定的字符集。否则，银联互联网系统端的验签将不会通过。
附 录 B
（规范性附录）
应答码
应答
终端显示（推荐）
终端操作
适用条件
00
操作成功
成功
01
支付失败。详情请咨询您的发卡行
失败
02
您输入的卡号无效，请确认后输入
失败
03
支付失败，您的发卡银行不支持该商户，请更换其他银行卡
失败
06
您的卡已经过期，请使用其他卡支付
失败
11
您卡上的余额不足
失败
14
您的卡已过期或者是您输入的有效期不正确，支付失败
失败
15
您输入的银行卡密码有误，支付失败
失败
18
交易未通过，请尝试使用其他银联卡支付或联系95516
失败
20
您输入的转入卡卡号有误，支付失败
失败
21
您输入的验证信息有误，支付失败
失败
25
查找原始交易失败
失败
撤销、退货等后续类交易
30
报文错误
失败
31
交易受限
失败
32
系统维护中
失败
36
交易金额超限，支付失败
失败
37
原始金额错误
失败
39
您已连续多次输入错误密码
失败
40
您的银行卡暂不支持在线支付业务，请向您的银行咨询如何加办银联在线支付
失败
41
您的银行不支持认证支付，请选择快捷支付
失败
工行
42
您的银行不支持小额支付，请选择快捷支付
失败
43
您的银行不支持认证支付
失败
56
您的银行卡所能进行的交易受限，详细请致电发卡行进行查询
失败
57
该银行卡未开通银联在线支付业务
失败
60
银行卡未开通认证支付
失败
61
银行卡开通状态查询次数过多
失败
71
交易无效，无法完成，支付失败
失败
72
无此交易
失败
73
扣款成功但交易超时
失败
74
对不起，该操作只能在交易当日进行
失败
80
内部错误
失败
81
可疑报文
失败
82
验签失败
失败
83
超时
失败
84
订单不存在
失败
85
不支持短信发送
失败
86
短信验证码错误
失败
87
您的短信发送过于频繁，请稍候再试
失败
88
您的短信发送累计过于频繁，请在x分钟后重试
失败
89
对不起，短信发送失败，请稍候再试
失败
90
请您登录工商银行网上银行或拨打95588进行后续认证操作
失败
93
请致电您的银行以确定您的个人客户基本信息中的相关信息设置正确
失败
94
重复交易
失败
95
您尚未在邮储银行网点柜面或个人网银签约加办银联无卡支付业务，请去柜面或网银开通
失败
97
请致电您的银行以确定您的用户信息是否设置正确，并咨询是否已经开办银联在线支付
失败
中国银联股份有限公司 发布
2011-2-10实施
2011-2-10发布
互联网商户接入接口规范
Q/CUP 099.1—2011
Q/CUP
中国银联股份有限公司企业标准
II
I
_1359978386.vsd
�
持卡人浏览器
UPOP
商户
1.用户生成订单，选择银联快捷支付方式
2.通过浏览器跳转至UPOP支付页面
3.用户输入身份信息完成支付
4.1通过浏览器跳转，前台返回交易结果给商户
4.2后台返回交易结果给商户
5.商户查询交易结果确认是否支付完成(可选)
6.后台返回交易结果给商户
_1359979653.vsd
�
UPOP
商户
1.商户发起信息查询
2.返回商户信息查询结果
浙公网安备 33021202002483