银联网关支付接口规范

中 国 银 联 股 份 有 限 公 司 企 业 标 准
Q/CUP 071.2.1—2015
全渠道平台产品接口规范
产品 1 互联网支付跳转支付
——网关支付产品
版本号: V2.2
2015-03-31 发布 2015-03-31 实施
发布
中国银联
版权所有
Q/CUP071.2.1—2015
I
中国银联股份有限公司(以下简称“中国银联”)对该规范文档保留全部
知识产权权利,包括但不限于版权、专利、商标、商密等。任何人对该规范
文 档 的 任 何 使 用 都 要 受 限 于 在 中 国 银 联 成 员 机 构 服 务 平 台
(http://member.unionpay.com/)与中国银联签署的协议之规定。中国银联不
对该规范文档的错误或疏漏以及由此导致的任何损失负任何责任。中国银联
针对该规范文档放弃所有明示或暗示的保证,包括但不限于不侵犯第三方知识
产权。
未经中国银联书面同意,您不得将该规范文档用于与中国银联合作事项
之外的用途和目的。未经中国银联书面同意,不得下载、转发、公开或以其
它任何形式向第三方提供该规范文档。如果您通过非法渠道获得该规范文档,
请立即删除,并通过合法渠道向中国银联申请。
中国银联对该规范文档或与其相关的文档是否涉及第三方的知识产权
(如加密算法可能在某些国家受专利保护)不做任何声明和担保,中国银联
对于该规范文档的使用是否侵犯第三方权利不承担任何责任,包括但不限于
对该规范文档的部分或全部使用。
中国银联
版权所有
Q/CUP071.2.1—2015
I
版本控制信息

1.12015-04-30吴潇银行卡验证信息及身份信息的加密方式待系统开
发上线后再修订;姓名字段长度改为 30
1.12015-05-11吴潇数据元说明 checkFlag 的备注中“证件号后 8 位”
改为“证件号”; 分期付款信息域增加子域格式说
明;交易状态查询交易请求报文的 txnTime、
orderId 改为条件上送,并明确其上送的情况,明
确 queryId 上送的情况;文件传输交易产品类型
改为 000000
1.12015-05-19吴潇产品接口规范仅包含商户卷,机构可参考全渠道
平台接入接口规范。
1.22015-06-05吴潇修改消费交易请求报文的发卡机构代码的备注
1.22015-06-12吴潇修改保留域、风控信息域的数据元说明,删除交
易中这两个域的备注
1.32015-06-24吴潇修订 JSON 格式说明中余额 balance 的样例; 修订
certId、 encryptCertId 的取值说明; 删除
vpcTransData 域; accNo、 payCardType、 payType
的返回条件明确为“根据商户配置返回”,
payCardNo、 payCardIssueName 的返回条件明确
为“移动支付交易返回”, bandId 的返回条件明
确为“绑定支付时,根据商户配置返回”; 修改
orderId 长度为 8 到 32; 删除 preAuthId 域; 删除
customerInfo 备注与跨行收单相关的备注; 删除
网关支付产品不涉及的 IC 卡交易; 交易查询的条
件扩展为respCode返03、04、05;补充subMerAbbr
备注,明确其仅支持 8 位字母或汉字或其组合;
补充 subMerAbbr 备注,明确其仅支持 8 位字母
或汉字或其组合; 应用场景说明中删除“app 网
关交易”等字样; 增加卡号、 PIN、有效期、 CVN2、
手机号的加密方案。
1.42015-07-22吴潇规范加密公钥、磁道加密公钥、签名私钥、验签
公钥及相关证书的用法和定义;明确只有成功交
易才会发后台通知,且交易状态未明情况下商户
必须发起交易状态查询。
1.52015-09-06吴潇前期的修订内容已同步更新至商户自助测试平
台,因此接受修订内容并更新版本号。
1.62015-10-29李晨在 5.5 注 6 中风险信息域增加子域银行预留手机
1.62015-11-09李晨全渠道交易查询通知机制,修订 6.5.1 内容


中国银联
版权所有
Q/CUP071.2.1—2015
II

1.62015-11-19赵晓夏将本规范中插入的参考规范更新为最新版
1.72015-12-14赵晓夏第 5.5 章节增加“预付卡通道” 数据元。第 6.2.3
节消费类交易请求报文增加“预付卡通道” 域。
第 5.5 章节,前台交易商户上送并需锁定返显卡
号时,保留域相关子域增加“客户 ID”子域。 第
5.5 章节,删除分期付款信息域相关子域:分期付款
手续费率及商户补贴手续费率 。 第 6.2.3 节消费
类交易请求报文中, defaultPayType 的备注改为
“C 取值参考数据元说明”。
1.82016-03-07赵晓夏5.5 数据元说明注 8 中的载体类型修订为“可选 0:缺省;
1:sd 卡 2:simpass 3:vipos 4:迷你付 5:mPOS 6:AM 7:NFC
8:蓝牙 9:hce 云端支付”
1.82016-03-07赵晓夏6.5.4 交易状态查询类交易应答报文中 txnType 域出现要
求改为 M
1.82016-03-07赵晓夏5.5 exchangeDate 数据元格式从 YYYYMMDD 改为
MMDD
1.92016-05-23赵晓夏“兑换日期 exchangeDate”和“汇率 exchangeRate”数据
源说明修改为“交易成功,交易币种和清算币种不一致的
时候返回”
1.92016-05-24赵晓夏6.5.3 修订交易状态查询接口的“订单发送时间”和“商
户订单号”的出现要求由 C 改为 M,“交易查询流水号”
删除
1.92016-05-26赵晓夏4.1.2、 4.2、 6.5.1 后台类涉及资金类交易,交易失败也会
通知交易处理结果;商户发起交易查询获取交易处理结
果,当天相同的订单号只能发起一次(无论结果成功还是
失败)
1.92016-05-28赵晓夏密钥自动更新:增加“签名公钥证书”、“加密公钥证书”、
“证书类型”数据元;修订“签名方法”数据元的取值说
明;“交易类型”数据元取值新增“95:查询更新加密公
钥证书”,新增“银联加密公钥更新查询交易”;所有交易
应答报文增加“签名公钥证书”域且删除“证书 ID”域;
修订“版本号”说明为“固定填写 5.1.0”。 4.3.1 摘要算法
升级为 SHA-256。
1.92016-05-31赵晓夏后台通知地址“backUrl”备注追加:如需通过专线通知,
需要在通知地址前面加上前缀:专线的首字母加竖线 ZX|
1.92016-06-06谌子奇新增 4.3.2.4, 4.3.3, 4.3.4 密钥更新章节
1.92016-06-07谌子奇4.1.1/4.1.2/4.3.1 新增补充说明
1.92016-06-13谌子奇5.5 修改数据元说明
1.92016-06-14谌子奇5.5 6.2 6.4 增加数据元分账域
accType 字段新增取值【04:对公账户】
1.92016-06-16谌子奇5.5 新增注 8 注 8-1
修改 cardTransData 备注
6.6 请求和应答添加 txnTime, orderId
1.92016-07-20谌子奇增加数据元ctrlRule
billQueryInfo 增加财税库银相关子域
1.92016-07-20谌子奇数据元certType取值删除02:磁道加密公钥


中国银联
版权所有
Q/CUP071.2.1—2015
III

2.02016-07-27谢荣东5.5 channelType 线下POS修改
5.5 修改billNo数据元格式
2.02016-07-27谢荣东全文 “签名公钥证书”出现要求由AN2048改成C
2.02016-08-23谢荣东customerIp 的出现要求由C改为O
2.02016-08-29谢荣东风控域增加子域diskSep、 imei、 macAddr
2.02016-08-29谢荣东1、分期付款信息域增加子域
2、新增数据元districtName
2.02016-09-02谢荣东6.5.3 删除“签名公钥证书”
2.02016-10-17谢荣东1、 billType数据元修改为“代收款项” .
2、 删除应答报文中的 respTime
2.12016-11-17谢荣东1、 数据元 ctrlRule 取值说明修改
2、 证件类型certifTp04的说明文字改成“港澳证”
2.12016-11-17谢荣东1、 风控信息域新增子域: LBS信息、设备通讯号码。
子域diskSep备注说明文字修改
2、 对账文件说明文件类型表格2项
2.12016-11-21谢荣东1、 5.5数据元channelType增加取值说明(16:数字机
顶盒)
2、数据元产品类型 bizType 删除取值:
000101 基金业务之股票基金
000102 基金业务之货币基金
3、风控信息域( riskRateInfo )子域修改 : 1.
addressModifyTim 改成 addressModifyTime; 2. 删
除【银行预留手机号 phoneNo】
2.22017-3-10汪之婴修改数据元ctrlRule数据元取值ctrlRule, 增加分期取值说
2.22017-3-10汪之婴消费请求ctrlRule增加请求要素:控制规则 ctrlRule O
32位01字符串控制位,从左至右第四位取值为1时表示前
台消费交易需要分期处理
2.22017-3-10汪之婴账单支付交易保留域增加营销金额说明, 修改保留域用
法,修改注5
2.22017-3-10汪之婴风控信息域说明中添加设备类型、卡片信息录入方式、设
备sim卡数量、设备名称
2.22017-3-10汪之婴txnType数据元增加取值说明: 76:文件传输
2.22017-3-10汪之婴所有请求要素的frontUrl 出现要求改为O
2.22017-3-10汪之婴银联全渠道支付开通交易,请求报文中,删除一个交易子
类02
2.22017-3-10汪之婴银 联 全 渠 道 支 付 开 通 查 询 交 易 — — 删 除 交 易 子 类
txnSubType取值: 01:手机号查询(只支持商户直连接入
模式)
2.22017-3-13汪之婴发卡机构代码 issInsCode 数据元格式改成AN1..11
2.22017-3-13汪之婴分账域做base64编码:


中国银联
版权所有
Q/CUP071.2.1—2015
IV

1. 在分账域的数据元取值说明格增加说明文字“该域需
整体做Base64编码。”
2. 消费和退货的请求报文分账域的备注增加说明文字
“该域需整体做Base64编码。”
3. 消费和退货商户通知删除分账域这个要素
2.22017-3-13汪之婴消费撤销和退货商户通知增加accNo根据商户配置返回
2.22017-3-20汪之婴改名为产品接口规范,同时相应在数据元和请求要素里增
加机构接口必须上送的4个要素:接入类型、收单机构代
码、商户类别、商户名称/简称


中国银联
版权所有
Q/CUP071.2.1—2015
V
目 次
前 言 ............................................................................. VI
1 范围 ................................................................................ 1
2 规范性引用文件 ...................................................................... 1
3 业务方案说明 ........................................................................ 1
4 总体技术方案 ........................................................................ 2
5 报文数据元说明 ...................................................................... 8
6 交易报文 ........................................................................... 31
7 对账文件 ........................................................................... 61
8 批量文件 ........................................................................... 63
9 附录 ............................................................................... 63
中国银联
版权所有
Q/CUP071.2.1—2015
VI
前 言
本标准对全渠道平台商户侧的跳转产品——网关支付产品接口做具体规定。
本部分为《全渠道平台接入接口规范》的产品分册第一部分:跳转产品——网关支付产品。
本部分由中国银联提出。
本部分由中国银联组织制定和修订。
本部分的主要起草单位:中国银联股份有限公司
本部分的主要起草人:戚跃民、鲁志军、李伟、夏智、谭颖、查骏、齐宁、胡新松、吴潇、李晨、
张旭东、赵晓夏、谢荣东
中国银联
版权所有
Q/CUP071.2.1—2015
1
银联全渠道平台产品接口规范
第一卷 商户卷
第 1 部分 互联网支付跳转支付——网关支付产品
1 范围
本标准规定了商户与中国银联全渠道平台之间的跳转支付——网关支付产品进行联机交易时使用
的报文接口,包括联机交易报文的元素、报文格式以及相关说明。
本标准适用于所有接入中国银联全渠道平台的商户。
本规范对应的全渠道平台产品目录说明内容为: 商户版互联网支付—银联在线支付网关产品及银联
手机支付。
2 规范性引用文件
下列文件中的条款通过本标准的引用而成为本标准的条款。凡是注日期的引用文件,其随后所有的
修改单(不包括勘误的内容)或修订版均不适用于本标准,然而,鼓励根据本标准达成协议的各方研究
是否可使用这些文件的最新版本。凡是不注日期的引用文件,其最新版本适用于本标准。
Q/CUP 006 《银行卡联网联合技术规范V2.1》
Q/CUP 001 《银行卡信息交换术语》
Q/CUP 071.1 《全渠道平台接入接口规范》
3 业务方案说明
3.1 应用场景
网关产品主要适用于持卡人在商户网站 B2C 购物支付场景,持卡通过点击银联在线支付 logo,并在银联
在线支付网关完成支付信息录入,最终完成支付。
从 PC 端发起的交易为 WEB 网关支付交易,从移动端发起的交易为 WAP 网关支付交易。
3.2 业务流程
业务流程如下图所示:
中国银联
版权所有
Q/CUP071.2.1—2015
2
持卡人 商户 银联系统
1、用户选择商品后,进行支付
2、商户组织交易报文信息,通过用户浏览器,发送给银联
3、持卡人在页面上输入相关交易信息
5、银联将交易结果,通过用户浏览器,跳转回商户
6、银联发送后台通知给商户
7、商户若未收到交易结果,则可向银联发起交易查询交易
4、银联完成支付
8、银联同步返回交易查询结果
流程说明:
1、 持卡人在商户网站选定商品并下单,在商户支付页面选择银联图标,进行支付;
2、 商户按照“消费类交易(前台跳转)”接口组织报文,通过用户浏览器,发送给银联在线;
3、 持卡人在银联界面上输入支付信息,提交支付;
4、 银联向银行发起交易,接收银行应答;
5、 银联将支付结果通过用户浏览器跳转回商户;
6、 若支付成功,则银联将交易结果以后台通知方式,发送给商户(后台通知报文同前台跳转应答
报文);
7、 商户若未收到交易结果,则商户按照“交易状态查询接口”向银联发起交易查询交易,以确定
消费交易的状态;
8、 银联收到交易状态查询交易时,将同步返回该笔消费交易的交易结果。
其他:
若持卡人或商户需要进行退款,则商户按照“消费撤销类交易”、“退货类交易”接口发起消费撤销
交易(仅限当日、全额退款)或退货交易(当日、非当日均可发起)。
商户也可通过“文件传输类交易”接口实现对账文件下载的功能。
4 总体技术方案
4.1 交易模式
按交易模式进行分类,全渠道平台支持的交易可分为前台类交易、后台资金类类交易、后台非资金
类交易、查询类交易、批量类交易。
4.1.1 前台类交易
中国银联
版权所有
Q/CUP071.2.1—2015
3
前台类交易是指交易请求方(如商户、收单机构)与全渠道平台之间的交易信息通过用户浏览器进
行传递的交易,是一种异步的、需要持卡人参与完成的交易类型。对于涉及金额的成功的前台类交易(即
交易请求中有金额字段),全渠道平台系统均会给请求方后台通知,请求方也必须实现接收后台通知。
对于交易状态未知的交易请求方必须发起交易状态查询交易。
普通的前台类交易的交易处理流程如下:
持卡人 商户 银联全渠道系统
1.选择商品支付
2.商户组织交易报文,通过浏览器发送给银联全渠道系统
3.持卡人在银联全渠道支付系统页面输入相关交易信息
5.银联全渠道系统,组装交易结果报文,通过浏览器跳转回商户
6.涉及资金类的交易,全渠道系统发送后台通知给商户
7.商户未收到交易结果,可通过往全渠道系统发起交易状态查询处理结果
4.全渠道系统完成
用户的交易处理
交易步骤:
1、 持卡人选择商品进行支付;
2、 商户组织交易报文,通过浏览器发送给银联全渠道系统;
3、 持卡人在银联全渠道支付系统页面中输入相关交易信息;
4、 全渠道系统完成用户的交易处理;
5、 银联全渠道系统,组装交易结果报文,通过浏览器跳转回商户;(非资金类交易流程至此结束)
6、 涉及资金类的成功交易,全渠道系统发送后台通知给商户,商户需要按照“交易状态查询”接
口向银联发起交易查询,以验证是否为银联发来的通知;
7、 如果商户未收到交易结果, 交易状态未明的情况下, 应向全渠道系统发起交易状态查询,查询
交易处理结果。
相关说明:
1、 每个交易需要的报文要素是不一样的,具体每个交易需要的要求,请查看本规范第二部分;
2、 图中第 5 步中的应答仅代表该笔前台请求交易已经受理,不代表全部处理成功;是否处理成功,
需通过接受后台通知或者发起“交易状态查询交易”进行查询;
3、 图中第 5 步前台应答返回的 URL 为请求报文中的“frontUrl”字段指定的 URL;
4、 图中第 6 步后台应答返回的 URL 为请求报文中的“backUrl”字段指定的 URL。
4.1.2 后台资金类交易
后台类资金类交易是指交易请求方(如商户、收单机构),将交易信息(涉及资金清算的交易)直
接通过请求方服务器发送至全渠道平台服务器的交易方式。是一种异步的、不需要持卡人参与完成的交
易类型。 对于已受理的交易, 无论成功或失败, 全渠道平台系统均会给请求方后台通知,请求方也必须
实现接收后台通知。对于交易状态未知的交易请求方必须发起交易状态查询交易。 一般交易状态查询交
易为前端主动发起,可查询 N 次(一般为 5 次),每次时间间隔 2N秒发起。 当天相同的订单号只能发
起一次(无论结果成功还是失败)。
交易处理流程如下:
中国银联
版权所有
Q/CUP071.2.1—2015
4
商户 银联全渠道交易系统
1.商户组织交易报文,发送给银联全渠道系统
3.银联全渠道系统组织受理结果报文,返回给商户
6.商户未收到交易结果,可通过发起交易状态查询,查询处理结果
2.全渠道系统受理
商户的交易处理
5.涉及资金类的成功交易,全渠道系统发送后台通知给商户
4.处理请求交易
交易步骤:
1、 商户组织交易报文,发送给银联全渠道系统;
2、 全渠道系统完成商户的交易处理;
3、 银联全渠道系统组织受理结果报文,返回给商户;
4、 处理请求交易;
5、 涉及资金类的交易,全渠道系统发送后台通知给商户,商户需要按照“交易状态查询”接口向
银联发起交易查询,以验证是否为银联发来的通知;
6、 如果商户没有收到交易结果, 交易状态未明的情况下, 必须向全渠道系统发起交易状态查询交
易,查询交易处理结果。
相关说明:
1、 每个交易需要的报文要素是不一样的,具体每个交易需要的要求,请参阅本规范第二部分对应
交易的请求和应答报文;
2、 图中第 3 步中的应答仅代表该笔后台请求交易已经受理,不代表全部处理成功;是否处理成功,
需通过接受后台通知或者发起“交易状态查询交易”进行查询;
3、 图中第 4 步后台应答返回的 URL 为请求报文中的“backUrl”字段指定的 URL。
4.1.3 后台非资金类交易
后台类非资金类交易是指交易请求方(如商户、收单机构)将交易信息(不涉及资金清算的交易)
直接通过请求方服务器发送至全渠道平台服务器的交易方式。后台非资金类交易均为同步短连接方式,
不需要持卡人参与完成的交易类型。若通讯超时,则交易请求方可以重复发起交易。
交易处理流程如下:
中国银联
版权所有
Q/CUP071.2.1—2015
5
商户 银联全渠道交易系统
1.商户组织交易报文,发送给银联全渠道系统
3.银联全渠道系统组织交易结果报文,同步返回给商户
2.全渠道系统完成
商户的交易处理
交易步骤:
1、 商户组织交易报文,发送给银联全渠道系统;
2、 全渠道系统完成商户的交易处理;
3、 银联全渠道系统组织交易结果报文,同步返回给商户;
4.1.4 查询类交易
查询交易是指交易请求方(如商户、收单机构)将交易查询报文信息直接通过请求方服务器发送至
全渠道平台服务器的交易方式。查询类交易均为同步短连接方式,不需要持卡人参与完成的交易类型。
若通讯超时,则交易请求方可以重复发起交易。
交易处理流程如下:
商户 银联全渠道交易系统
1.商户组织查询交易报文,发送给银联全渠道系统
3.银联全渠道系统组织查询请求结果报文,同步返回给商户
2.全渠道系统完成商户的
交易查询请求处理
交易步骤:
1、 商户组织查询类交易报文,发送给银联全渠道系统;
中国银联
版权所有
Q/CUP071.2.1—2015
6
2、 全渠道系统完成商户的交易查询请求处理;
3、 银联全渠道系统组织查询请求结果报文,同步返回给商户。
4.1.5 批量交易
批量类交易指发起方以批量文件方式向全渠道平台发起批量交易,全渠道平台系统接收到批量交易
请求后再向发卡方进行转发处理的业务。
交易处理流程如下:
商户 银联全渠道系统
1.商户组织好批量文件以报文形式发送给银联全渠道系统
2.全渠道系统受理商户批量文件请求后,返回商户批量请求已受理应答
4.商户发起批量状态查询交易,查询批量文件处理结果
3. 银联全渠道系统
完成批量交易处理
5. 若批量文件处理完成,返回批量文件处理结果,否则返回查询结果
图 1 批量交易交易流程
交易步骤:
1、 商户组织好批量文件,以报文形式发送给银联全渠道系统;
2、 全渠道系统受理商户批量文件请求后,返回商户批量请求已受理应答;
3、 银联全渠道系统完成批量交易处理;
4、 商户发起批量状态查询交易,查询批量文件处理结果;
5、 若批量文件处理完成,返回批量文件处理结果,否则仅返回查询结果。
相关说明:
图中第2步中的应答仅代表该笔批量请求交易已经收到,不代表全部处理成功;是否处理成功,需发起
“批量交易状态查询交易”进行查询。
4.2 通讯方式
所有报文域以key/value的表单方式通过HTTP Post到银联全渠道支付平台。
对于前台类需要持卡人交互的交易,交易通过异步跳转的方式完成,对于涉及资金的成功的前台类
交易,银联全渠道支付平台可通过商户后台通知地址向商户发送后台通知。
对于后台类涉及资金清算类无需持卡人交互的交易,交易结果异步响应给商户,商户通过接受后台
通知或者发起交易查询获取交易处理结果,当天相同的订单号只能发起一次(无论结果成功还是失败)。
对于后台类非资金类无需持卡人交互的交易,交易结果同步响应给商户。
对于交易状态查询类交易,交易结果同步响应给商户。
中国银联
版权所有
Q/CUP071.2.1—2015
7
4.3 安全要求
4.3.1 签名机制
银联需要验证商户上送的签名是否正确;商户收到应答,也需要验证签名是否正确,如果商户未正
确验证签名,存在潜在的风险,商户自行承担因此而产生的所有损失。
4.3.1.1 报文的签名机制
对于报文的签名处理机制如下:
首先,对报文中出现签名域(signature)之外的所有数据元采用key=value的形式按照名称排序,
然后以&作为连接符拼接成待签名串。其次,对待签名串使用 SHA-256算法做摘要,再使用银联颁发给
商户的签名私钥证书中的私钥对摘要做签名操作(签名时算法选择 SHA-256)。最后,对签名做Base64
编码,将编码后的签名串放在签名(signature)表单域里和其他表单域一起通过HTTP Post的方式传输
给银联全渠道支付平台。
4.3.1.2 报文的验签机制
对于报文的验签处理机制如下:
首先,对报文中出现签名域(signature)之外的所有数据元采用key=value的形式按照名称排序,
然后以&作为连接符拼接成待签名串。
其次,对待签名串使用 SHA-256算法做摘要,再使用商户入网时银联提供的验签公钥证书中的公钥
对摘要和报文中的签名信息做签名验证操作。
4.3.2 加密方式
4.3.2.1 敏感账户信息
敏感账户信息包括PIN、磁道信息(含芯片等效磁道信息)、 CVN2和卡片有效期。
——商户或机构应使用加密公钥对符合ANSI X9.8 Format(带主账号信息)格式的PIN1、 CVN2、
卡片有效期加密并做Base64编码后传输,以保障敏感信息的安全性。
——商户或机构应使用磁道加密公钥对磁道信息进行加密后传输,以保障敏感信息的安全性。
4.3.2.2 其他账户信息
对于需加密的其他账户信息(如卡号、手机号码等),商户或机构应使用加密公钥加密并做Base64
编码处理后传输;如应答时需返回,则应使用签名私钥进行解密。
4.3.2.3 文件内容
对于文件内容,使用DEFLATE压缩算法压缩后, Base64编码的方式传输,压缩编码后的内容参与
签名摘要运算。
4.3.2.4 散列方式验证
散列方式验证是对报文关键信息<key, value>对和合作密钥串使用散列算法生成消息摘要值的一种
验证方式。运算形式如下:
消息摘要= HASH(key1=value1&key2=&key3=value3&HASH(secret_key))
1、合作密钥串secret_key,由商户接入全渠道平台时约定,双方可以在必要的时候重新确定。密钥串
的长度最大为32字节 。
2、消息摘要结果为长度32字节的ASCII码。
3、 HASH表示散列算法,可选择SHA-256或SM3, Hash后hex编码,值转小写
4、消息摘要计算方法 如下:
A 关键信息<key, value>对和合作密钥信息对的拼接方法为:
注 1
PIN BLOCK 格式等于 PIN 按位异或主账号(PAN)。
中国银联
版权所有
Q/CUP071.2.1—2015
8
1)单个<key, value>对的表示方式为 key=value。如果该key对应的value为空,则表示方式为key=;
多个<key,value>对按照key值的ascii码升序排列 (从左到右,同一位置ascii一致的情况需参考后一位的
ascii码),拼接方式为key1=value1&key2=&key3=value3。
2)参与摘要运算的key应包含报文格式中除 “签名信息”外的所有取值。
3)合作密钥信息经过与消息摘要相同的散列算法运算后,拼接在<key,value>串尾端,形成如下数
据串: key1=value1&key2=&key3=value3&HASH( secret_key)。
B 摘要方法
将上述步骤1-3生成的数据串采用SHA-256算法或SM3算法进行运算处理,得到的输出结果即为所
需消息摘要。
说明1:若<key, value>对中含有&、 @等特殊字符或者中文字符时,保持原样计算摘要值。发送时
HTTP请求时,再进行URL编码。
说明2:若参与摘要的信息串中包含中文,则需要先将中文转化为encoding指定的字符集。
4.3.3 证书更新机制
4.3.3.1 公钥证书更新机制
签名公钥证书:采用PKCS7的签名方式进行签名,交易应答报文中携带签名公钥信息。
加密公钥证书:商户定期( 1天1次)向银联全渠道系统发起获取加密公钥信息交易。在加密公钥证
书更新期间,全渠道系统支持新老证书的共同使用,新老证书并行期为1个月。全渠道系统向商户返回
最新的加密公钥证书,由商户服务器替换本地证书。
4.3.3.2 私钥证书更新机制
商户登录商户服务平台,网站提示商户私钥证书到期,并向商户管理员发送短信提醒。商户管理员
确认更新证书,在商户服务平台一键式更新证书。
4.3.4 公钥验证机制
4.3.4.1 商户的公钥验证机制
商户获取到银联签名公钥证书、加密公钥证书时,需对证书进行验证:
1、验证证书使用者是否为“中国银联股份有限公司”;
2、根据根公钥CFCA CS CA、二级公钥CFCA OCA1,验证证书链。
4.3.4.2 银联的公钥验证机制
银联获取到商户签名公钥证书时,需对证书进行验证:
1、根据根公钥CFCA CS CA、二级公钥CFCA OCA1,验证证书链;
2、验证证书链中商户编号是否与实际商户一致或与实际商户存在共享关系。
5 报文数据元说明
5.1 符号约定
表 1 符号约定

符号含 义
数 据 元 数 值 符 号M必须填写的域
C某条件成立时必须填写的域
C-某条件成立时删除的域
M+必须增加的域
O受理方和发卡方自选填写的域
转发域


中国银联
版权所有
Q/CUP071.2.1—2015
9

R必须与先前报文中对应域的值相同的域


5.2 数据元长度的计算
数据元长度的计算说明:所有长度均按字节计算,中文算两个字节,英文、数字算一个字节。
5.3 URL 的编码
URL参数中中文等特殊字符需编码。
5.4 数据元类型定义
Ax x字节定长的字母字符
Ax..y 长度为x-y字节的变长字母字符
ANx x字节定长的字母和/或数字字符
Anx..y 长度为x-y字节的变长字母和/或数字字符
ANSx x字节定长的字母、数字和/或特殊符号字符
ANSx..y 长度为x-y字节的变长字母、数字和/或特殊符号字符
Asx x字节定长的字母和/或特殊符号字符
Asx..y 长度为x-y字节的变长字母和/或特殊符号字符
Nx x字节定长的整型数值,若表示金额,则以分为单位
Nx..y 长度为x-y字节的整型数值,若表示金额,则以分为单位
NSx x字节定长的数字符和/或特殊字符
NSx..y 长度为x-y字节的数字字符和/或特殊字符
Sx x字节定长的特殊符号字符
Sx..y 长度为x-y字节的变长特殊符号字符
ss 秒
DD 日
hh 时
MM 月
mm 分
YY 年(2字节)
YYYY 年(4字节)
5.5 数据元说明
表 2 全渠道平台报文接口数据元

1.版本号versionNS5固定填写 5.1.0
2.证书 IDcertIdN1..128填写签名私钥证书的 Serial Number, 该值可通过银联提
供的 SDK 获取
3.签名signatureANS1..1
024
填写对报文摘要的签名
4.编码方
encodingANS1..2
0
填写报文使用的字符编码
UTF-8|GBK|GB2312|GB18030
若不填写,默认取值: UTF-8
5.交易类txnTypeN2取值:


中国银联
版权所有
Q/CUP071.2.1—2015
10

00: 查询交易
01:消费
02:预授权
03:预授权完成
04:退货
05: 圈存
11:代收
12:代付
13:账单支付
14:转账(保留)
21:批量交易
22:批量查询
31:消费撤销
32:预授权撤销
33:预授权完成撤销
71:余额查询
72:实名认证-建立绑定关系
73:账单查询
74:解除绑定关系
75:查询绑定关系
76:文件传输
77:发送短信验证码交易
78:开通查询交易
79:开通交易
94: IC 卡脚本通知
95:查询更新加密公钥证书
6.交易子
txnSubTypeN2依据实际交易类型填写 默认取值: 00
7.产品类
bizTypeN6依据实际业务场景填写(目前仅使用后 4 位, 前面 2 位
默认为 00)
默认取值: 000000
具体取值范围:
000201: B2C 网关支付
000301: 认证支付 2.0
000302: 评级支付
000401: 代付
000501: 代收
000601: 账单支付
000801: 跨行收单
000901: 绑定支付
001001: 订购
000202: B2B
8.前台通
知地址
frontUrlANS1..2
56
前台返回商户结果时使用,前台类交易需上送
不支持换行符等不可见字符
9.后台通
知地址
backUrlANS1..2
56
后台返回商户结果时使用,如上送,则发送商户后台交
易结果通知, 不支持换行符等不可见字符, 如需通过专
线通知,需要在通知地址前面加上前缀: 专线的首字母


中国银联
版权所有
Q/CUP071.2.1—2015
11

加竖线 ZX|
10.接入类
accessTypeN10:商户直连接入
1:收单机构接入
2:平台商户接入
11.收单机
构代码
acqInsCodeAN8..11已被批准加入银联互联网系统的收单机构代码
12.商户类
merCatCodeN4填写 MCC 码,接入类型为收单机构接入时需上送
13.商户代
merIdAN15已被批准加入银联互联网系统的商户代码
14.商户名
merNameANS1..4
0
接入类型为收单机构接入时需上送
不支持换行符等不可见字符
15.商户简
merAbbrANS1..8接入类型为收单机构接入时需上送 最长 8 位,不支持换行符等不可见字符
16.二级商
户代码
subMerIdAN5..15商户类型为平台类商户接入时必须上送
17.二级商
户名称
subMerNameANS1..4
0
商户类型为平台类商户接入时必须上送
最长 40 个字节,不支持换行符等不可见字符
18.二级商
户简称
subMerAbbrANS1..8仅支持字母或汉字或其组合,最长 8 位,不支持换行符
等不可见字符。
商户类型为平台类商户接入时必须上送
19.商户订
单号
orderIdAN8..40商户订单号,不能含“-” 或“_”
20.订单发
送时间
txnTimeYYYY
MMDD
hhmmss
商户发送交易时间
21.订单接
收超时
时间
orderTimeoutN1..10单位为毫秒,交易发生时,该笔交易在银联互联网系统
中有效的最长时间。当距离交易发送时间超过该时间
时,银联互联网系统不再为该笔交易提供支付服务
22.支付超
时时间
payTimeoutYYYY
MMDD
hhmmss
订单支付超时时间,超过此时间用户支付成功的交易,
不通知商户,系统自动退款,大约 5 个工作日金额返还
到用户账户
23.默认支
付方式
defaultPayTypeN4取值如下:
0001:认证支付
0004:储值卡支付
0005: IC 卡支付
0201:网银支付
0404:互联网订单手机支付
24.支持支
付方式
supPayTypeAN1..12
8
由收单机构填写,取值为以下内容的一种或多种,通过
逗号(,)分割。
0001:认证支付
0004:储值卡支付
0005: IC 卡支付


中国银联
版权所有
Q/CUP071.2.1—2015
12

0201:网银支付
0404:互联网订单手机支付
25.支付方
payTypeN4默认不返回此域,如需要返此域,需要提交申请,视商
户配置返回,可在消费类交易中返回以下中的一种:
0001:认证支付
0002:快捷支付
0004:储值卡支付
0005: IC 卡支付
0201:网银支付
1001:牡丹畅通卡支付
1002:中铁银通卡支付
0401:信用卡支付——暂定
0402:小额临时支付
0403:认证支付 2.0
0404:互联网订单手机支付
9000:其他无卡支付(如手机客户端支付)
26.交易币
currencyCodeAN3币种格式必须为 3 位代码,默认取值: 156(人民币)
27.账号类
型(卡介
质)
accTypeN201: 银行卡
02: 存折
03: IC 卡
04:对公账户
默认取值: 01
取值“03” 表示以 IC 终端发起的 IC 卡交易, IC 作为普
通银行卡进行支付时,此域填写为“01”
28.账号accNoAN1..10
24
交易账号。 请求时使用加密公钥对交易账号加密,并做
Base64 编码后上送;应答时如需返回,则使用签名私钥
进行解密。
前台交易可由银联页面采集,也可由商户上送并返显。
如需锁定返显卡号,应通过保留域( reserved)上送卡
号锁定标识。
29.支付卡
类型
payCardTypeN2消费交易,视商户配置返回。该域取值为:
00:未知
01:借记账户
02:贷记账户
03:准贷记账户
04:借贷合一账户
05:预付费账户
06:半开放预付费账户
30.发卡机
构代码
issInsCodeAN1..11当账号类型为 02-存折时需填写
在前台类交易时填写默认银行代码,支持直接跳转到网
31.开户行
issInsProvinceANS1..3
0
代付交易时可选上传
32.开户行issInsCityANS1..3代付交易时可选上传


中国银联
版权所有
Q/CUP071.2.1—2015
13

0
33.开户行
名称
issInsNameANS1..6
0
代付交易时可选上传
34.银行卡
验证信
息及身
份信息
customerInfoANS1..1
024
该域需整体做 Base64 编码。
所有子域需用“有子域包含,子域间以“含,符号链接。
格式如下: {子域名 1=值&子域名 2=值&子域名 3=值}
各子域取值见注 1。
借记卡可上送姓名、手机号、证件类型、证件号码;贷
记卡可上送姓名、手机号、证件类型、证件号码、有效
期、 CVN2。
前台交易可以由银联页面采集,无需商户上送,后台交
易必须由商户上送。
前台交易支持商户上送并返显的要素包含手机号,姓
名,证件号。
35.交 易 金
txnAmtN1..12单位为分
36.余额balanceAN1..25
6
用法一:用于银行卡、银行账户余额查询中返回账户实
际余额和可用余额。
用法二:用于费用查询、自助缴费交易中,用于表示用
户在 SP 用户的账户实际余额和可用余额。
用法三:在查询信|用卡账户余额的交易中返回账户的应
还金额和最低还款额。
最多可携带2个如下所示的余额信息:报文格式为JSON
格式
各子域取值见注 2。
37.代 收 款
billTypeANS201 移动电话
02 固定电话
03 水费
04 电费
05 煤气费
06 社保
07 小灵通
08 信用卡还款
09 烟草
10 信用卡中心
11 有线和付费电视
12 保险
13 税务
14 证券公司
15 金融机构
16 贷款还款
CS 财税库银
RZ 商户实时入账
OT 其他
38.账 单 号
billNoAN 4 S1..6账单查询 用法一:账单查询 /支付类交易中填写具体账单号码 /支付类交易中网上缴税用法,填写纳


中国银联
版权所有
Q/CUP071.2.1—2015
14

税人编码
用法二:账单查询/支付类交易中信用卡还款用法,填写
信用卡卡号
39.业 务 代
bussCodeA 0 NS4..2账单查询/支付类交易中填写
账单类型_地区码_附加地区码
示例: D1_3300_0000
账单类型: ANS2..4 参见附录 D:全渠道平台账单类

地区代码: N4 从 BIZ 文件获取,地区代码参考《银
联卡跨行业务地区代码标准》
附加地区代码: ANS4..10 从 BIZ 文件获取,区分具体
子业务 默认值 0000
40.账 单 周
billPeriodANS17格式为: yyyyMMdd-yyyyMMdd
41.账 单 要
billQueryInfoANS1..1 024不支持换行符等不可见字符
账单查询/支付类交易中用于上送其他未定义的账单要

根据获取到的 BIZ 文件要求填写,为 JSON 报文结构
各子域取值见注 3
42.账 单 明
billDetailInfoANS1..2 048不支持换行符等不可见字符
账单查询/支付类交易中填写查询到的账单明细信息
格式为 JSON 报文结构,各子域取值见注 3
43.绑 定 标
识号
bindIdANS1..1 28不支持换行符等不可见字符 用于唯一标识绑定关系
44.绑 定 信
息条数
bindInfoQtyN1..2查询绑定关系时,返回的委托关系信息条数
45.绑 定 信
息集
bindInfoListANS 048 1..2查询绑定关系时,返回的具体委托信息集,格式为:
报文格式为 JSON 格式
各子域取值见注 4。
46.批次号batchNoN4批量交易时填写,当天唯一,0001-9999,商户号+批次号
+上交易时间确定一笔交易
47.总笔数totalQtyN1..6批量交易时填写,填写批量中,总的交易比数
48.总金额totalAmtN1..12批量交易时填写,填写批量中,总的交易金额
49.文 件 类
fileTypeN2依据实际业务情况定义,默认值为: 00
50.文件名fileNameANS1..6
4
填写文件名称
51.批 量 文
件内容
fileContent压缩, Base64 编码后的文件内容
52.请 求 方
自 定 义
reqReservedANS1..1
024
53.保留域reservedANS1..2
048
保留域包含多个子域,所有子域需用“{}”包含,子域间
以“&”符号链接。
格式如下: {子域名 1=值&子域名 2=值&子域名 3=值}。


中国银联
版权所有
Q/CUP071.2.1—2015
15

相关子域说明见注 5。
54.终端号termIdAN8填写 CUPS 规范中的终端号
55.发 卡 机
构 识 别
模式
issuerIdentifyM
ode
N10:发卡机构自主识别模式
1:发卡机构辅助识别模式
56.持 卡 人
IP
customerIpNS7..40填写持卡人发起交易的 IP 地址,用于防钓鱼
57.查 询 流
水号
queryIdAN21由银联返回,用于在后续类交易中唯一标识一笔交易
58.原 交 易
查 询 流
水号
origQryIdAN21
59.系 统 跟
踪号
traceNoN6
60.交 易 传
输时间
traceTimeMMDD hhmmss
61.清 算 日
settleDateMMDD
62.清 算 币
settleCurrency
Code
AN3
63.清 算 金
settleAmtN1..12
64.清 算 汇
exchangeRateN8交易成功,交易币种和清算币种不一致的时候返回
格式为右对齐,无小数点
小数位数由最左边一位数字表示,第二位至第八位指的
是汇率的值
65.兑 换 日
exchangeDateMMDD交易成功,交易币种和清算币种不一致的时候返回
66.原 交 易
应答码
origRespCodeAN2
67.原 交 易
应 答 信
origRespMsgANS1..2
56
68.应答码respCodeAN2具体参见应答码定义章节
69.应 答 信
respMsgANS1..2 56填写具体的应答信息
70.验 证 标
checkFlagN8表示交易时对持卡人的验证要素要求
共 8 位长,每位以 0、 1 表示是否需要, 0 代表不需要,
1 代表需要;
自左向右每位代表的顺序如下:
位 1:证件类型
位 2:证件号
位 3:动态密码
位 4: CVN2
位 5:有效期
位 6:账户密码


中国银联
版权所有
Q/CUP071.2.1—2015
16

位 7:姓名
位 8:手机号
71.开 通 状
activateStatusN10:未开通业务
1:已开通银联全渠道支付
2:已开通小额认证支付
3:评级开通
72.加 密 证
书 ID
encryptCertIdN1..128当需要加密敏感信息如 CVN2、有效期、密码及其他账
户信息如卡号、手机号时,填写加密公钥证书的 Serial
Number
73.终 端 信
息域
userMacans80按照如下统一的格式上送终端 ID 信息:“终端信息 1,终
端信息 2”。
(1)如果只有第一项信息,则只需填写:终端信息 1
(2)如果只有第二项信息,则需填写: ,终端信息 2
(3)如果两项均无,则字段为空。
74.风 控 信
息域
riskRateInfoANS 1…2048有风控要求的商户根据实际情况上送
所有子域需用“有子域包含,子域间以“含,符号链接。
格式如下: {子域名 1=值&子域名 2=值&子域名 3=值}
相关子域说明见注 6。
75.小 额 临
时 支 付
信息域
temporaryPayIn
fo
AN100小额临时支付相关信息域,包含多个子域,所有子域需
用“{}”包含,子域间以“&”符号链接。格式如下: {子
域名 1=值&子域名 2=值&子域名 3=值}
子域相关说明见注 7。
76.失 败 交
易 前 台
跳 转 地
frontFailUrlANS1..2
56
前台消费交易若商户上送此字段,则在支付失败时,页
面跳转至商户该 URL(不带交易信息,仅跳转)
77.有 卡 交
易 信 息
cardTransDataANS1Tr
ans
IC 卡交易上送
所有子域需用“有子域包含,子域间以“含,符号链接。
格式如下: {子域名 1=值&子域名 2=值&子域名 3=值}
相关子域说明见注 8。
78.银 联 受
理 订 单
tnN21商户推送订单后银联移动支付系统返回该流水号,商户
调用支付控件时使用
79.支 付 卡
标识
payCardNoANS1..1 9移动支付交易时,根据商户配置返回
80.支 付 卡
名称
payCardIssueN
ame
ANS1..6
4
移动支付交易时,根据商户配置返回
81.渠 道 类
channelTypeN205:语音
07:互联网
08:移动
16:数字机顶盒
82.签 名 方
signMethodN2非对称签名:
01(表示采用 RSA 签名)


中国银联
版权所有
Q/CUP071.2.1—2015
17

HASH 表示散列算法
11:支持散列方式验证 SHA-256
12:支持散列方式验证 SM3
83.分 期 付
款 信 息
instalTransInfoANS1..1
28
格式如下: {子域名 1=值&子域名 2=值&子域名 3=值}
相关子域见注 10。
84.订 单 描
orderDescANS1..3 2描述订单信息,显示在银联支付控件或客户端支付界面 中
85.转 入 账
bookedAccNoAN1..60转账交易转入账号
86.预 付 卡
通道
accountPayCha
nnel
ANS1..2
0
预付卡的专享支付页面通道组
87.签 名 公
钥证书
signPubKeyCer
t
AN2048使用 RSA 签名方式时必选,此域填写银联签名公钥证
书。
88.加 密 公
钥证书
encryptPubKey
Cert
AN2048加密公钥证书
89.证 书 类
certTypeN201:敏感信息加密公钥
90.分账域accSplitDataANS1..5
12
该域需整体做 Base64 编码。
复合域, json 字符串组装,具体见注 13
91.控 制 规
ctrlRuleN3232 位 01 字符串控制位,
从左至右第一位取值为 1 表示财税库银信息控制位;
第二位取值为 1 时表示小微商户;
第三位取值为 1 时表示河北电力代缴建立委托签约;
第四位取值为 1 时表示前台消费交易需要分期处理
92.地 区 名
districtNameANS64支持汉字


注 0:
若报文中的数据元标识的 key 对应的 value 为空,不上送该报文域;对于组合域,若该组合域无子域上送,该组合域不
上送,若子域 key 对应的 value 为空,不上送该子域。
注 1:
银行卡验证信息及身份信息(customerInfo)数据元相关子域说明:

序号子域名标 识子域格式说 明
1.证件类型certifTpN201:身份证
02:军官证
03:护照
04: 港澳证
05:台胞证
06:警官证
07:士兵证
99:其它证件
2.证件号码certifIdANS1..20
3.姓名customerNmANS1..30支持汉字


中国银联
版权所有
Q/CUP071.2.1—2015
18

4.短信验证码smsCodeN6
5.持卡人密码pinANS1..256使用敏感信息加密证书对 ANSI X9.8 格式的 PIN
加密,并做 Base64 编码
6.加密信息域encryptedInfoANS1..1024请求时使用加密公钥对上送的 CVN2、有效期、手
机号加密,并做 Base64 编码;应答时如需返回,
则使用签名私钥进行解密。
其中:
子域名标识子域格式
CVN2cvn2n3
有效期expiredYYMM
手机号phoneNoN1..20
格式如下:
encryptedInfo=BASE64( 加 密 后
(cvn2=nnn&expired=YYMM&phoneNo=xxxxxxxx))


注 2:
余额(balance)数据元相关子域说明:

序号子域名标 识子域格式说 明
1.账号类型accTypeN200-缺省账户
10-储蓄账户(只适用于银行账
户)
30-信用卡账户(只适用于银行
账户)
2.余额类型balanceTypeN201-账面余额(银行账户)
02-可用余额(银行账户)
11-信用卡账户应还金额
12-信用卡账户最低还款额
16-账面余额(SP 用户账户)
17-可用余额(SP 用户账户)
3.货币代码currencyCodeAN3默认值 156
4.余额符号balanceSignAN1欠费状态: D
非欠费状态: C
5.余额balanceN1..12以分为单位
余额符号为 D 时,本域表示欠费
金额
余额符号为 C 时,本域表示实际
余额


注 3:
账单要素(billQueryInfo)、账单明细(billDetailInfo)数据元相关子域说明:

序号子域名标 识子域格式说 明
1.用户号码 (AC)usr_numAN1..40账单编号
2.查询/缴费年月(AF)query_monthN6格式 YYYYMM
当本子域填写“000000”时,用于查询/
缴费当前用户号码所有欠费
3.关联查询交易键值
(AG)
rel_inq_keyAN31
4.支付订单号(AH)pay_bill_noAN1..100
5.查询/缴费终止年月
(AI)
inq_end_monthN6格式 YYYYMM,如果查询/缴费没有区
间,终止年月同查询/缴费年月(AF)
6.条形码/标识号 (BB)bar_cdANS1..100


中国银联
版权所有
Q/CUP071.2.1—2015
19

7.姓名 (BC)usr_nmANS1..40
8.通讯号码 (BD)phone_numANS1..20
9.证件类型 (BE)id_tpANS2
10.证件号码 (BF)id_numANS1..20
11.户号 (BG)household_numANS1..40
12.地址 (BH)addressANS1..140
13.城市代码 (BI)city_cdANS1..10
14.银行代码 (BJ)bank_cdANS1..20
15.执收单位 (BK)collect_unitANS1..80
16.出账日期 (BL)bill_gen_dateN8格式 YYYYMMDD
17.计费起始日期 (BM)bill_begin_dateN8格式 YYYYMMDD
18.计费终止日期 (BN)bill_end_dateN8格式 YYYYMMDD
19.缴费截止日期 (BO)pay_deadlineN8格式 YYYYMMDD
20.费用索引 (BP)charge_idxAN1..10
21.上期欠款 (BQ)last_owe_amtN12金额不带小数点。小数位根据交易币种
来决定。
交易金额的币种由交易币种表示,若表
示人民币则单位为分。例如:终端交易
金 额 为 1000 元 , 则 交 易 金 额 =
“000000100000”
22.上期余额 (BR)last_balance_amtN12格式同上
23.本期账单金额 (BS)curr_amtN12格式同上
24.滞纳金 (BT)late_amtN12格式同上
25.项目名称 (BU)buss_nmANS1..80
26.明细信息 (BV)detailANS1..582
27.发票信息 (BW)rcpt_dtlANS1..582
28.费用缴清标志 (BX)payup_flgN10:未缴清
1:已缴清
29.是否生成发票 (BY)rcpt_gen_flgN10:不需要发票
1:需要发票
30.缴费流水号 (CA)pay_trans_numAN1..40用于打印发票的受理端流水或行业商
户流水
31.缴费日期 (CB)pay_dateN1..14YYYYMMDDHHMMSS,用于打印发
票的受理端交易日期或行业商户交易
日期
32.用户信息 (CC)usr_infoANS1..60用于识别用户的相关信息,如姓名、车
牌等
33.缴费月数 (CD)pay_month_numN1...3缴费的总月数
34.产品类别 (CE)product_tpAN1..10
35.缴费方式 (CF)pay_modeAN1..2
36.数量 (CG)quantityANS1..20
37.单价 (CH)unit_priceANS1..12
38.总价 (CI)total_priceANS1..20
39.车辆识别代码 (CM)car_id_cdANS1..30
40.车辆发动机号 (CN)car_engine_idANS1..30
41.支付明细名称项 (DA)pay_dtl_nmANS1..250以„|‟进行格式化分隔的支付明细各子
项项目名称。以„|‟开头并以„|‟结尾,第
一个固定为“欠费金额”(以分为单位,


中国银联
版权所有
Q/CUP071.2.1—2015
20

最大 12 位)。
TAG[pay_dtl_1]~TAG[pay_dtl_12]各条
明细的子项项目名称由本 TAG 指定
42.支付明细 1 (DB)pay_dtl_1ANS1..250以„|‟进行格式化分隔的明细信息,只包
括明细数据,不包括明细数据的项目名
称 , 各 项 目 其 对 应 项 目 名 称 通 过
TAG[pay_dtl_nm ]进行标识。第一个固
定为该条明细的欠费总金额,每条明细
均以„|‟开头并以„|‟结尾。如多渠道有返
回 TAG[pay_dtl_1]~TAG[pay_dtl_12],
则受理端可以将各明细单独显示,由用
户选择需进行支付的明细,对应支付位
图 TAG[pay_dtl_bmp]的第 1 位
43.支付明细 2 (DC)pay_dtl_2ANS1..250同 pay_dtl_1 , 对 应 支 付 位 图
TAG[pay_dtl_bmp]的第 2 位
44.支付明细 3 (DD)pay_dtl_3ANS1..250同 pay_dtl_1 , 对 应 支 付 位 图
TAG[pay_dtl_bmp]的第 3 位
45.支付明细 4 (DE)pay_dtl_4ANS1..250同 pay_dtl_1 , 对 应 支 付 位 图
TAG[pay_dtl_bmp]的第 4 位
46.支付明细 5 (DF)pay_dtl_5ANS1..250同 pay_dtl_1 , 对 应 支 付 位 图
TAG[pay_dtl_bmp]的第 5 位
47.支付明细 6 (DG)pay_dtl_6ANS1..250同 pay_dtl_1 , 对 应 支 付 位 图
TAG[pay_dtl_bmp]的第 6 位
48.支付明细 7 (DH)pay_dtl_7ANS1..250同 pay_dtl_1 , 对 应 支 付 位 图
TAG[pay_dtl_bmp]的第 7 位
49.支付明细 8 (DI)pay_dtl_8ANS1..250同 pay_dtl_1 , 对 应 支 付 位 图
TAG[pay_dtl_bmp]的第 8 位
50.支付明细 9 (DJ)pay_dtl_9ANS1..250同 pay_dtl_1 , 对 应 支 付 位 图
TAG[pay_dtl_bmp]的第 9 位
51.支付明细 10 (DK)pay_dtl_10ANS1..250同 pay_dtl_1 , 对 应 支 付 位 图
TAG[pay_dtl_bmp]的第 10 位
52.支付明细 11 (DL)pay_dtl_11ANS1..250同 pay_dtl_1 , 对 应 支 付 位 图
TAG[pay_dtl_bmp]的第 11 位
53.支付明细 12 (DM)pay_dtl_12ANS1..250同 pay_dtl_1 , 对 应 支 付 位 图
TAG[pay_dtl_bmp]的第 12 位
54.支付位图 (DN)pay_dtl_bmpN1..12C1:支付位图:在先查后缴模式下,查
询 返 回 支 付 明 细
( TAG[pay_dtl_1]~TAG[pay_dtl_12] )
后,如 TAG[pay_dtl_cnt]标识该业务需
由用户进行选择支付,则需在支付时上
送 TAG[pay_dtl_bmp],将用户选择的支
付明细对应序号位置„1‟,未选择支付明
细对应序号位置„0‟。并将用户选择进行
支付的相关明细的欠费金额进行汇总
后作为 4 域上送
55.支付明细总条数 (DO)pay_dtl_cntN1..2C2:明细缴纳状态位图:应答时,用于
返 回 每 个 明 细
( TAG[pay_dtl_1]~TAG[pay_dtl_12] )
的费用状态,取值: 0-未缴纳, 1-已缴
56.选择支付标志 (DP)pay_sel_tagN1标 识 存 在 的 支 付 明 细 数 , 指 明
TAG[pay_dtl_1]~TAG[DM]具体的存在
个数
57.起始量表值 (DQ)meter_begin_valueAN1..20用于返回年度、月度等费用量表起始值
58.截止量表值 (DR)meter_end_valueAN1..20用于返回年度、月度等费用量表截止值
59.已使用量表值 (DS)meter_use_valueAN1..10用于返回年度、月度等费用量表已使用


中国银联
版权所有
Q/CUP071.2.1—2015
21

60.行业应答码信息 (DT)trade_rsp_cd_infoAN1..100用于返回行业商户的行业应答码信息
61.费用可缴标志 (DU)charge_pay_flgN10:不可支付,查询应答时,如果为此
值,表明不可发起后续支付交易
1:可支付,查询应答时,如果为此值,
表明可发起后续支付交易
62.本期余额 (DV)curr_balanceN12格式同本期账单金额
63.通知单编号列表
(DW)
ntf_num_listANS1..100
64.面额 (DX)noteN12
65.充值状态 (DY)maps_trans_statusANS1..10
66.订单号 (DZ)buss_order_idANS1..40
67.手机区域 (EA)caller_locANS1…100
68.证件信息 (EB)cert_infoANS1..60
69.入账商户号 (EG)mchnt_cd_inAN1..20
70.报备终端号 (EH)report_term_idAN1..20
71.销账应答流水号 (EI)wof_rsp_seq_numAN1..40
72.原交易应答码信息
(EJ)
orig_rsp_infoANS1..100
73.总罚单数 (EK)tckt_numN2
74.可代办的罚单数 (EL)agent_tckt_numN2
75.不可代办的罚单数
(EM)
un_agent_tckt_numN2
76.页面显示可以代办的
罚单数 (EN)
disp_agent_tckt_numN2
77.用户状态(EO)usr_statusAN1..2
78.用户状态描述(EP)usr_status_descANS1…64
79.行业信息扩展域(XX)trade_info_resvAN1..300
80.征收机关代码col_organ_cdN1..12财税库银子域, 支付开通时必上送
81.纳税人名称tax_drawee_nmANS1..200财税库银子域, 支付开通时必上送
82.纳税人编码tax_payer_idAN1..20财税库银子域, 支付开通时必上送
83.付款开户行行号deposit_bank_cdN1..121. 财税库银子域, 支付开通时必上送
2. 纳税人、参保人开户行行号, TIPS
不做控制和校验
【银联参与的三方协议,银行卡账户填
为 905290000008, 非银行卡账户据实
填写】
84.付款行行号pay_bank_cdN1..121. 财税库银子域, 支付开通时必上送
2. 【即税库银规范中的三方协议“清
算行行号” ;银联参与的三方协议固定
填 905290000008】
85.付款账户pay_acctAN1..321. 财税库银子域, 支付开通时必上送


中国银联
版权所有
Q/CUP071.2.1—2015
22

2. “三方委托缴款协议书”中纳税人、
参保人的缴款户账号
【银行卡或非银行卡账户】
86.缴款单位名称pay_unit_nmANS1..2001. 财税库银子域, 支付开通时必上送
2. 即付款账户在银行的户名,若为银
行卡是指持卡人姓名
87.协议书号agreement_noANS1..601. 财税库银子域, 支付开通时必上送
2. 征收机关、商业银行/银联、纳税人
三方签订的委托协议书号;社保机构、
商业银行/银联、参保单位三方签订的
委托协议书号
88.三方协议保存状态trip_agree_statusN21. 财税库银子域, 支付开通时必上送
2. 00-已开通; 01-未开通


注 4:绑定关系信息集( bindInfoQty)数据元相关子域说明:

序号子域名标 识子域格式说 明
1.绑定关系标识号userIdAN1...100返回该匹配定制标识号
2.绑定关系信息bindinfoANS1..100
3.风险级别riskLevlN1应答时:返回风险标志
4.账号panAN11..19请求时:卡号后 4 位或全卡号(若
仅卡号为查询条件,则需输入全
卡号);应答时返回该匹配的已绑
定卡号的后 4 位
5.余额balanceN1..12以分为单位
余额符号为 D 时,本域表示欠费
金额
余额符号为 C 时,本域表示实际
余额
6.卡属性cardAttrN200--未知; 01--借记卡; 02--贷记

应答时返回卡属性
7.发卡机构代码issBinAN8..11应答时:返回发卡机构代码
8.建立绑定关系日期orgTranDateYYYYMMDD应答时返回建立绑定的日期
9.终端号termIdANS1..32应答时:返回终端号,若有多个,
以“,”进行分割
10.持卡人是否同意商户协
isAccecptedN1
11.证件类型certifTpN2取值如下: 01:身份证; 02:军
官证; 03:护照; 04: 港澳证;
05:台胞证; 06:警官证; 07:
士兵证; 99:其它证件


中国银联
版权所有
Q/CUP071.2.1—2015
23

12.证件号码certifIdANS1..20
13.姓名customerNmANS1..30支持汉字
14.手机号phoneNoN1..20
15.短信验证码smsCodeN6
16.持卡人密码pinANS1..256使用加密公钥对 ANSI X9.8 格
式的 PIN 加密,并做 Base64 编码
17.CVN2cvn2N3
18.有效期expiredYYMM


注 5:
1-前台交易商户上送并需锁定返显卡号时,保留域(reserved)相关子域说明如下:

序号子域名标 识子域格式说 明
1.卡号锁定标识cardNumberLockN1取值为“1”时,表示锁定卡号,
样例如下:
reserved={ cardNumberLock=1}
否则不锁定
2.客户 IDcustomerIdANS1..32渠道商户采用全渠道前台跳转
模式进行还款、缴费、支付时,
通过 ID 标识号(渠道商户 ID+
客户 ID)记忆客户常用卡号功


2-消费、账单支付的商户通知和交易状态查询的保留域(reserved)相关子域说明如下:

序号子域名标 识子域格式说 明
1立减金额discountAmtN1..12银联的立减金额
消费、账单支付的商户通知和交易状态查询返回
2商户优惠金额mchtDiscountAmtN1..12商户出资金额
消费、账单支付的商户通知和交易状态查询返回


注 6:
风控信息域(riskRateInfo)相关子域说明:

序号子域名标 识子域格式说 明
1.商品风险类别标识shippingFlagN3111:虚拟高风险类(无物流、
非实名登记、易变现如:游
戏点卡、游戏装备、手机充
值、礼品卡、虚拟账户充值)
110:虚拟低风险类(无物流、
非实名登记、不易变现如:
电影票、信息咨询)
100:虚拟实名类(无物流、
实名登记、不易变现如:航
空售票、酒店预订、旅游产
品、学费、行政费用(税费、
车船使用费)、汽车、房产)


中国银联
版权所有
Q/CUP071.2.1—2015
24

001:实物高风险类(有物流、
易变现如:数码家电、黄金、
珠宝首饰等)
000:实物低风险类(有物流、
不易变现如:服饰、食品、
日用品等)
2.收货地址-国家shippingCountryCodeAN6
3.收货地址-省shippingProvinceCodeAN6
4.收货地址-市shippingCityCodeAN6
5.收货地址-地区shippingDistrictCodeAN6
6.收货地址-详细shippingStreetANS1..256
7.商品种类commodityCategoryN4区分商品类别
8.商品名称commodityNameANS1..256
9.商品 URLcommodityUrlANS1..1024
10.商品单价commodityUnitPriceN1..12
11.商品数量commodityQtyN1..10
12.收货/订单手机号shippingMobileAN8-20
13.订单地址最后修改时
addressModifyTimeYYYYMMDDhhmmss
14.用户注册时间userRegisterTimeYYYYMMDDhhmmss
15.收货(订单)姓名的
最后修改时间
orderNameModifyTimeYYYYMMDDhhmmss
16.账户 IDuserIdANS1..128
17.收货/订单姓名orderNameANS1..32
18.优质用户标识码userFlagN10:普通用户
1:优质用户
19.订单手机号最后修改
时间
mobileModifyTimeYYYYMMDDhhmmss
20.风险级别riskLevelN1基于绑定关系的支付交易时
使用:
0:无风险业务
1:有风险业务
21.商户端用户 IDmerUserIdANS1..64
22.商户端用户注册时间merUserRegDtYYYYMMDD
23.商户端用户注册邮箱merUserEmailANS1..256
24.硬盘序列号diskSepAN641.持卡人支付时的存储设备
的硬盘序列号
2.终端硬件序列号
25.IMEIimeiAN64持卡人支付时手机设备的
IMEI
26.MAC 地址macAddrANS17持卡人支付时使用设备的
MAC 地址
27.LBS 信息lbsANS32空中发卡时的位置信息,经
纬度,格式为纬度/经度, +


中国银联
版权所有
Q/CUP071.2.1—2015
25

表示北纬、东经, -表示南纬、
西经。举例: +37.12/-121.23
或者+37/-121
28.设备通讯号码deviceNumberANS321.终端拨号号码
2.单个手机号,可能包含前缀
(发起交易的手机号码,不
是接收验证码的手机号)
29.设备类型deviceTypeN1设备类型:
1.Phone
2. Pad
3. iWatch
4.PC
30.卡片信息录入方式captureMethodN1卡号录入方式,例如:
1. 摄像头拍摄实体卡片
2. 手工输入
31.设备 sim 卡数量simCardCountN1
32.设备名称deviceNameANS128


注 7:
小额临时支付信息域(temporaryPayInfo)数据元相关子域说明:

序号子域名标 识子域格式说 明
1.小额临时支付有效期expiryN8yyyyMMdd
2.小额临时支付总限额sumLimitN1..12以分为单位
3.小额临时支付单笔限额transLimitN1..12以分为单位


注 8:
有卡交易信息域(cardTransData)数据元相关子域说明:

序 号子域名标 识子域格式说 明
IC 卡数据ICCardDataANS1...102
4
该域用于传输基于 PBOC 借贷记标准的 IC 卡数据,将
透传至 CUPS 的 55 域(基于 PBOC 借贷记标准的 IC
卡数据域)
请求返回时均需要 BASE64 编码
IC 卡的序
列号
ICCardSeqNum
ber
N3IC 卡的序列号,将透传至 CUPS 的 23 域 域 23 卡序
列号
第二磁道
数据
track2DataANS1 „
1024
第二磁数据需用磁道敏感信息加密证书(同敏感信息
加密证书)加密后给全渠道平台,由平台解密后传给
CUPS 的 35 域。加密格式如下:
商户代码|商户订单号|交易开始时间|交易金额|第二磁
道数据
merId|orderId|txnTime|txnAmt|track2Data
余额查询接口中 txnAmt 送 0
第三磁道track3DataANS1 „第三磁数据需用磁道敏感信息加密证书(同敏感信息


中国银联
版权所有
Q/CUP071.2.1—2015
26

数据1024加密证书)加密后给全渠道平台,由平台解密后传给
CUPS 的 36 域。加密格式如下:
商户代码|商户订单号|交易开始时间|交易金额|第三磁
道数据
merId|orderId|txnTime|txnAmt|track3Data
余额查询接口中 txnAmt 送 0
服务点输
入方式码
POSentryMode
Code
N2服务点输入方式码,即持卡人数据(如 PAN)的输入方

服务点(Point Of Service)是指各种交易始发场合,透
传至 CUPS22 域(服务点输入方式码)前两位
 
00未指明
01手工
02接触式读取磁条
03条形码
04光学字符阅读
05接触式读取集成电路(IC)卡,且
信息可靠
06ISO 保留使用
07非接触式读取集成电路(IC)卡,
且为 qPBOC 应用
08-60ISO 保留使用
61-94国家保留使用
90接触式读取磁条,且读入信息可
靠,第二磁道信息必须出现
91非接触式读取集成电路(IC)卡中
的磁条信息(即 MSD 应用)
95接触式读取集成电路(IC)卡,且
信息不可靠
96非接触式读取 CUPMobile 移动支
付中的集成在手机中的 IC 卡(适
用于 CUPMobile 的现场支付模式)
97接触式读取 CUPMobile 移动支付
中的集成在手机中的 IC 卡(适用
于 CUPMobile 的远程支付模式)
98非接触式读取集成电路(IC)卡,
且为 PBOC 借贷记应用
99私有保留使用
交易发起
方式
transSendModeANS1透传到 CUPS 的 F60.3.5:交易发起方式
F60 自定义域


中国银联
版权所有
Q/CUP071.2.1—2015
27

F60.3 交易发生附加信息
F60.3.5 交易发起方式
0未知。
该方式用于表示未知支付方式或不关心
此交易的具体发起方式下的缺省表示。
1现场。该方式用于表示确定的现场支付,
持卡人商户收银员或银行柜面人员面对
面、由受理方发起交易的方式,如现场消
费、惠农代理点取现,现金充值等交易
2自助。包括有卡自助和无卡自助的各类支
付,指金融受理终端无人值守,持卡人操
作终端并确认发起交易,包括多媒体终
端、电话支付终端等。例如 ATM 取现、
自助存款,语音、手机支付,基于委托关
系的自助汇款/存款等交易
3联机代理。
各类代理支付,指持卡人不在商户现场,
由商户收集交易信息,商户操作交易终端
并发起的非面对面交易。例如订购、实时
代收等交易
4批量代理。
各类代理支付,指持卡人不在现场,商户
代为通过批量方式发起。例如批量代收、
批量代付
终端读取
能力
termEntryCapANS1透传到 CUPS 的 F60.2.2/Position 2: Terminal Entry
Capability:终端读取能力
F60 自定义域
F60.2 服务点附加信息
F60.2.2 终端读取能力
0终端读取能力不可知
2只能接触式读取磁条卡
5具备接触方式读取集成电路(IC)卡的
能力,可选具备接触方式读取磁条卡的
能力,但不具备非接触式读取集成电路
(IC)卡的能力。
61)至少具备非接触式读取读取集成电路
(IC)卡的能力,可选具备接触式读取
读取集成电路(IC)卡、读取磁条卡的
能力。
IC 卡条件
代码
chipCondCodeANS1透传到 CUPS 的 F 60.2.3/Position 3: Chip Condition
Code: IC 卡条件代码


中国银联
版权所有
Q/CUP071.2.1—2015
28

F60 自定义域
F60.2 服务点附加信息
F60.2.3 IC 卡条件代码
0未使用或后续子域存在
1终端对卡片的上一次读取动作发现不是
IC卡交易或者发现是一笔成功的IC卡交
易。
填 1,表示不插卡,直接刷卡时, IC 卡
交易为降级处理,同时当 1 大量存在的
话,表示商户操作不规范,有更大的欺
诈嫌疑。
2终端对卡片的上一次读取动作发现交易
虽是 IC 卡交易但失败。例如,持卡人拿
IC 卡来做交易,但插 IC 卡以后,终端无
法读取应用,改为刷卡,那么这笔刷卡
交易对应的上一次读取,就是开始读 IC
卡芯片失败的那次读取,因为 IC 卡芯片
读取失败,所以是一个失败的 IC 卡交易,
此时该域应该填 2
填 2,表示当终端或卡片有问题时, IC
卡交易为降级处理,同时当 2 大量存在
的话,也表示商户可能有欺诈嫌疑
载体类型carrierTpN1..2可选
5:mPOS 6: Apple Pay 11:线下 pos
载体应用
类型
carrierAppTpN1可选
0:缺省; 1: upcard; 2: pboc, 3: instcard


注 8-1:各产品取值上送说明

域名子域名标 识ApplePay线下 POSMPOS
有 卡 交 易 信
息 域
cardTransDat
a
IC 卡数据ICCardData必上送
Apple Pay 填 写
ICCardData
( PassKitApi 中 的
paymentData->data->
paymentData->
emvData)
IC 卡必上送IC 卡必上送
IC 卡的序列
ICCardSeqNumb
er
不上送当为 IC 卡交易且
终端能够获得时
上送
当为 IC 卡交易且
终端能够获 得时
上送
第 二 磁 道 数
track2Data不上送当终端能从卡片
中读取信息时上
当终端能从 卡片
中读取信息 时上


中国银联
版权所有
Q/CUP071.2.1—2015
29

第 三 磁 道 数
track3Data不上送当终端能从卡片
中读取信息时上
当终端能从 卡片
中读取信息 时上
服 务 点 输 入
方式码
POSentryModeC
ode
不上送根据数据元子域
取值说明上送
根据数据元 子域
取值说明上送
交 易 发 起 方
transSendMode不上送固定值: 1根据数据元 子域
取值说明上送
终 端 读 取 能
termEntryCap不上送终端能获得时上
终端能获得 时上
IC 卡条件代
chipCondCode不上送终端能获得时上
终端能获得 时上
载体类型carrierTp固定值: 6固定值: 11固定值: 5
载 体 应 用 类
carrierAppTp固定值: 2固定值: 3固定值: 3
渠道类型channelType08carrierTp=11 时,
根据数据元取值
说明上送,默认值
03
08


注 10:
分期付款信息域(instalTransInfo)数据元相关子域说明:

序号子域名标 识子域格式说 明
1.分期付款期数numberOfInstallmentsN2分期付款期数
2.分期付款手续费率instalRatesN6仅在商户与发卡机构存在个性化
分期全手续费协定的情况下进行
填写,对于适用发卡机构提供的
标准分期全手续费率的交易,该
域为空。
该字段取值为:分期付款手续费
率*100000。例如分期付款手续费
率为 4.5%,则该域取之为 004500
3.商户补贴手续费率mchntFeeSubsidyN6在商户确有补贴时,由受理侧据
实填写,如为持卡人全额支付手
续费模式,则为零
该字段取值为:商户补贴手续费
率*100000。例如商户补贴手续费
率为 1%,则该字段取值为 001000


注 11:
JSON 格式说明(以余额 balance 为例):
中国银联
版权所有
Q/CUP071.2.1—2015
30

[
{ “accType”:”10” , “balanceType”:”01”, “currencyCode”:”156” , “balanceSign”:”C” , “balance”:”300” },
{ “accType”:”30” , “balanceType”:”02”, “currencyCode”:”156” , “balanceSign”:”D” , “balance”:”100” }
]



13:
分账域(accSplitData)数据元相关子域说明:

序号子域名标 识子域格式说 明
1.分账类型accSplitTypeN11 - 表示按照商户列表分账,联机带入
分账入账金额
2 - 表示按照分账规则 ID 分账,联机带
分账决定要素
2.分账规则 IDaccSplitRuleIdAN15分账类型为 2 时才出现,
15 位字母或数字
3.分账对象组accSplitMchtsAN256分账类型为 1 时才出现,
accSplitMcht 数组,最多支持 5 个分账
对象 accSplitMcht


注 13-1
分账对象(accSplitMcht)子域说明:

序号子域名标 识子域格式说 明
1.分账二级商户代码accSplitMerIdAN1515 位字母或数字
2.分账入账金额accSplitAmtN1..9分账入账金额,最大支持
9 位长度(精确到分,不
带小数点),如 300 表示分
账入账金额为 3 元。


注 13-2
accSplitData 的 JSON 格式说明, accSplitType=1 时:

{
"accSplitType": "1",
"accSplitMchts": [
{
"accSplitMerId": "123456789012341",
"accSplitAmt": "100"
},
{
"accSplitMerId": "123456789012342",
"accSplitAmt": "200"
}
]
}



13-3
中国银联
版权所有
Q/CUP071.2.1—2015
31
accSplitData 的 JSON 格式说明, accSplitType=2 时:

{
"accSplitType": "2",
"accSplitRuleId": "123456789012345"
}


6
交易报文
6.1 交易概览
跳转支付——网关支付产品包括以下交易类型:

接口名称功能说明交易模式
消费类交易持卡人进支付时, 在浏览器输入相关支付信息, 由商户或
收单机构组织相关报文, 发送至银联完成支付。
前台交易
消费撤销类交易指因人为原因而撤销已完成的消费;消费撤销必须是撤销
CUPS 当日当批的消费
后台交易
退货类交易对于已结算的消费交易,通过该交易发起退款交易。后台交易
交易状态查询交易对未收到应答的或交易状态未知的交易, 应通过该交易进
行查询。
后台交易
预授权类交易包括预授权、 预授权完成、预授权撤销、预授权完成撤销预授权:后台交易/
前台交易
预授权撤销、预授权
完成撤销、预授权完
成:后台交易
文件传输类交易联机下载对账文件等文件下载类交易后台交易


6.2 消费类交易
6.2.1 概述
消费是指境内外持卡人在境内外商户网站进行购物等消费时用银行卡结算的交易,经批准的消费额
将即时地反映到该持卡人的账户余额上。
6.2.2 交易流程
相关交易流程如下:
中国银联
版权所有
Q/CUP071.2.1—2015
32
持卡人 商户 银联全渠道系统
1.选择消费交易
2.商户组织交易报文,通过浏览器发送给银联全渠道系统
3.持卡人在银联全渠道支付系统页面输入相关交易信息
5.银联全渠道系统,将交易受理结果返回给商户
6.因消费交易涉及资金清算,银联系统发送后台通知(交易结果)给商户
4.全渠道系统完成
用户的交易处理
交易步骤:
1、 持卡人/企业浏览商户网页,选择消费交易;
2、 商户组织交易报文,通过浏览器跳转至银联全渠道系统的支付页面;
3、 持卡人/企业在银联全渠道系统支付页面输入相关交易信息;
4、 全渠道系统完成用户的交易处理;
5、 银联全渠道系统,将交易受理结果返回给商户;
6、 因消费交易涉及资金清算,银联系统发送后台通知(交易结果)给商户。
6.2.3 请求报文

1.版本号versionM固定填写
2.编码方式encodingM默认取值: UTF-8
3.证书 IDcertIdM
4.签名signatureM填写对报文摘要的签名
5.签名方法signMethodM非对称签名:
01(表示采用 RSA 签名)
HASH 表示散列算法
11:支持散列方式验证 SHA-256
12:支持散列方式验证 SM3
6.交易类型txnTypeM取值: 01
7.交易子类txnSubTypeM01:自助消费,通过地址的方式区
分前台消费和后台消费(含无跳转
支付)
03:分期付款
8.产品类型bizTypeM000201
9.渠道类型channelTypeM
10.前台通知地址frontUrlO前台返回商户结果时使用,前台类
交易需上送
11.后台通知地址backUrlM后台返回商户结果时使用,如上
送,则发送商户后台交易结果通
知,如需通过专线通知,需要在通


中国银联
版权所有
Q/CUP071.2.1—2015
33

知地址前面加上前缀: 专线的首字
母加竖线 ZX|
12.接入类型accessTypeM0:普通商户直连接入
1: 收单机构接入
2:平台类商户接入
13.收单机构代码acqInsCodeC接入类型为收单机构接入时需上
14.商户类别merCatCodeC接入类型为收单机构接入时需上
15.商户代码merIdM
16.商户名称merNameC接入类型为收单机构接入时需上
17.商户简称merAbbrC接入类型为收单机构接入时需上
18.二级商户代码subMerIdC商户类型为平台类商户接入时必
须上送
19.二级商户全称subMerNameC商户类型为平台类商户接入时必
须上送
20.二级商户简称subMerAbbrC商户类型为平台类商户接入时必
须上送
21.商户订单号orderIdM商户端生成
22.订单发送时间txnTimeM商户发送交易时间
23.账号类型accTypeC后台类交易且卡号上送;
跨行收单且收单机构收集银行卡
信息时上送
01:银行卡
02:存折
03: IC 卡
默认取值: 01
取值“03”表示以 IC 终端发起的 IC
卡交易, IC 作为普通银行卡进行支
付时,此域填写为“01”
24.账号accNoC1、 后台类消费交易时上送全卡号
或卡号后 4 位
2、 跨行收单且收单机构收集银行
卡信息时上送、
3、前台类交易可通过配置后返回,
卡号可选上送
25.交易金额txnAmtM单位为分
26.交易币种currencyCodeM默认为 156
27.银行卡验证信
息及身份信息
customerInfoC1、后台类消费交易时上送
2、认证支付 2.0,后台交易时可选
Key=value 格式
(具体填写参考数据元说明)
28.订单接收超时
时间(防钓鱼使
用)
orderTimeoutO1、前台类消费交易时上送
2、认证支付 2.0,后台交易时可选


中国银联
版权所有
Q/CUP071.2.1—2015
34

29.订单支付超时
时间
payTimeoutO超过此时间用户支付成功的交易,
不通知商户,系统自动退款,大约
5 个工作日金额返还到用户账户
30.终端号termIdO
31.请求方保留域reqReservedO商户自定义保留域,交易应答时会
原样返回
32.保留域reservedO
33.风险信息域riskRateInfoO
34.加密证书 IDencryptCertIdC
35.失败交易前台
跳转地址
frontFailUrlO前台消费交易若商户上送此字段,
则在支付失败时,页面跳转至商户
该 URL(不带交易信息,仅跳转)
36.分期付款信息
instalTransInfoC分期付款交易,商户端选择分期信
息时,需上送组合域,填法见数据
元说明
37.默认支付方式defaultPayTypeOC 取值参考数据元说明
38.发卡机构代码issInsCodeC1、 当账号类型为 02-存折时需填写
2、 在前台类交易时填写默认银行
代码,支持直接跳转到网银。 银行
简码列表参考附录: C.1、 C.2, 其
中 C.2 银行列表仅支持借记卡
39.支持支付方式supPayTypeO仅仅 pc 使用,使用哪种支付方式
由收单机构填写,取值为以下内容
的一种或多种,通过逗号(,)分
割。取值参考数据字典
40.终端信息域userMacO移动支付业务需要上送
41.持卡人 IPcustomerIpO前台交易,有 IP 防钓鱼要求的商户
上送
42.有卡交易信息
cardTransDataC有卡交易必填,有卡交易信息域
(组合域,用法详见数据元说明)
43.订单描述orderDescC移动支付上送
44.预付卡通道accountPayChannelC预付卡的专享支付页面
45.分账域accSplitDataO分账域,用法参见注 13
该域需整体做 Base64 编码。
46.控制规则ctrlRuleO32 位 01 字符串控制位,从左至右
第四位取值为 1 时表示前台消费交
易需要分期处理


6.2.4 应答报文(同步应答)

1.版本号versionR
2.编码方式encodingR
3.签名signatureM
4.签名方法signMethodM
5.交易类型txnTypeR


中国银联
版权所有
Q/CUP071.2.1—2015
35

6.交易子类txnSubTypeR
7.产品类型bizTypeR
8.接入类型accessTypeR
9.收单机构代码acqInsCodeC接入类型为收单机构接入时需
返回
10.商户代码merIdR
11.商户订单号orderIdR
12.订单发送时间txnTimeR
13.交易金额txnAmtR
14.交易币种currencyCodeR默认为 156
15.请求方保留域reqReservedR
16.保留域reservedO
17.交易查询流水号queryIdM消费交易的流水号,供后续查询
18.响应码respCodeM
19.应答信息respMsgM
20.账号accNoC根据商户配置返回
21.支付卡类型payCardTypeC根据商户配置返回
22.支付方式payTypeC根据商户配置返回
23.银联订单号tnC商户推送订单后银联移动支付
系统返回该流水号,商户调用支
付控件时使用
24.签名公钥证书signPubKeyCertC使用 RSA 签名方式时必选,此
域填写银联签名公钥证书。


6.2.5 商户通知(异步应答)

1.版本号versionR
2.编码方式encodingR
3.签名signatureM
4.签名方法signMethodM
5.交易类型txnTypeR
6.交易子类txnSubTypeR
7.产品类型bizTypeR
8.接入类型accessTypeR
9.收单机构代码acqInsCodeC接入类型为收单机构接入时需
返回
10.商户代码merIdR
11.商户订单号orderIdR
12.订单发送时间txnTimeR
13.交易金额txnAmtR


中国银联
版权所有
Q/CUP071.2.1—2015
36

14.交易币种currencyCodeM默认为 156
15.请求方保留域reqReservedR
16.保留域reservedO
17.交易查询流水号queryIdM消费交易的流水号,供后续查询
18.响应码respCodeM
19.响应信息respMsgM
20.清算金额settleAmtM
21.清算币种settleCurrencyCodeM
22.清算日期settleDateM
23.系统跟踪号traceNoM
24.交易传输时间traceTimeM
25.兑换日期exchangeDateC交易成功,交易币种和清算币种
不一致的时候返回
26.汇率exchangeRateC交易成功,交易币种和清算币种
不一致的时候返回
27.账号accNoC根据商户配置返回
28.支付卡类型payCardTypeC根据商户配置返回
29.支付方式payTypeC根据商户配置返回
30.支付卡标识payCardNoC移动支付交易时,根据商户配置
返回
31.支付卡名称payCardIssueNameC移动支付交易时,根据商户配置
返回
32.绑定标识号bindIdR绑定支付时,根据商户配置返回
33.签名公钥证书signPubKeyCertC使用 RSA 签名方式时必选,此
域填写银联签名公钥证书。


6.3 消费撤销类交易
6.3.1 概述
是指因人为原因而撤销已完成的消费,商户可以通过SDK向银联全渠道支付平台发起消费撤销交易,
消费撤销必须是撤销CUPS当日当批的消费。发卡行批准的消费撤销金额将即时地反映到该持卡人的账户
上。完成交易的过程不需要同持卡人交互,属于后台交易。
6.3.2 交易流程
相关交易流程如下:
中国银联
版权所有
Q/CUP071.2.1—2015
37
商户 银联全渠道交易系统
1.商户组织消费撤销交易报文,发送给银联全渠道系统
3.银联全渠道系统组织受理结果报文,返回给商户
2.全渠道系统完成
商户的交易处理
4.因消费撤销交易涉及资金清算,全渠道系统
发送后台通知(交易结果)给商户
图 2 消费撤销—后台类
交易步骤:
1、 商户发起交易,商户组织消费撤销交易报文,发送报文给全渠道系统;
2、 全渠道系统完成商户的交易处理;
3、 全渠道系统组织受理结果报文,返回给商户;
4、 因消费撤销交易涉及资金清算,全渠道系统发送后台通知(交易结果)给商户。
6.3.3 请求报文

1.版本号versionM固定填写
2.编码方式encodingM默认取值: UTF-8
3.证书 IDcertIdM
4.签名signatureM填写对报文摘要的签名
5.签名方法signMethodM非对称签名:
01(表示采用 RSA 签名)
HASH 表示散列算法
11:支持散列方式验证 SHA-256
12:支持散列方式验证 SM3
6.交易类型txnTypeM取值: 31
7.交易子类txnSubTypeM默认: 00
8.产品类型bizTypeM000201
9.渠道类型channelTypeM
10.后台通知地址backUrlM后台返回商户结果时使用,如上
送,则发送商户后台交易结果通
知,如需通过专线通知,需要在
通知地址前面加上前缀: 专线的
首字母加竖线 ZX|


中国银联
版权所有
Q/CUP071.2.1—2015
38

11.接入类型accessTypeM0:普通商户直连接入
1:收单机构接入
2:平台类商户接入
12.收单机构代码acqInsCodeC接入类型为收单机构接入时需
上送
13.商户类别merCatCodeC接入类型为收单机构接入时需
上送
14.商户代码merIdM
15.商户名称merNameC接入类型为收单机构接入时需
上送
16.商户简称merAbbrC接入类型为收单机构接入时需
上送
17.二级商户代码subMerIdC商户类型为平台类商户接入时
必须上送
18.二级商户全称subMerNameC商户类型为平台类商户接入时
必须上送
19.二级商户简称subMerAbbrC商户类型为平台类商户接入时
必须上送
20.商户订单号orderIdM消费撤销的订单号,由商户生成
21.原始交易流水号origQryIdM原始消费交易的 queryId
22.订单发送时间txnTimeM
23.交易金额txnAmtM与原消费交易一致
24.终端号termIdO
25.请求方保留域reqReservedO商户自定义保留域,交易应答时
会原样返回
26.保留域reservedO


6.3.4 应答报文(同步应答)

1.版本号versionR
2.编码方式encodingR
3.签名signatureM
4.签名方法signMethodM
5.交易类型txnTypeR
6.交易子类txnSubTypeR
7.产品类型bizTypeR
8.接入类型accessTypeR
9.收单机构代码acqInsCodeC接入类型为收单机构接入时需返
10.商户代码merIdR
11.商户订单号orderIdR


中国银联
版权所有
Q/CUP071.2.1—2015
39

12.原始交易流水号origQryIdR原始消费交易的 queryId
13.订单发送时间txnTimeR
14.交易金额txnAmtR
15.请求方保留域reqReservedR
16.保留域reservedO
17.银联交易流水号queryIdM消费撤销交易的交易流水号 供
查询用
18.响应码respCodeM
19.应答信息respMsgM
20.签名公钥证书signPubKeyCertC使用 RSA 签名方式时必选,此域
填写银联签名公钥证书。


6.3.5 商户通知(异步应答)
中国银联
版权所有
Q/CUP071.2.1—2015
40
6.4 退货类交易
6.4.1 概述
对于跨清算日或者当清算日的消费交易,商户可以通过调用SDK向银联全渠道支付平台发起退货交
易,从而实现客户的退款需求,支持部分退货、多次退货。该交易参加资金清算,为后台交易。
6.4.2 交易流程
相关交易流程如下:
商户 银联全渠道交易系统
1.商户组织退货交易报文,发送给银联全渠道系统
3.银联全渠道系统组织受理结果报文,返回给商户
2.全渠道系统完成
商户的交易处理
4.因退货交易涉及资金清算,全渠道系统
发送后台通知(交易结果)给商户
图 3 消费撤销—后台类
交易步骤:
1、 商户发起交易,商户组织退货交易报文,发送报文给全渠道系统;
2、 全渠道系统完成商户的交易处理;
3、 全渠道系统组织受理结果报文,返回给商户;
4、 因退货交易涉及资金清算,全渠道系统发送后台通知(交易结果)给商户。
6.4.3 请求报文

1.版本号versionM固定填写
2.编码方式encodingM默认取值: UTF-8
3.证书 IDcertIdM
4.签名signatureM填写对报文摘要的签名


中国银联
版权所有
Q/CUP071.2.1—2015
41

5.签名方法signMethodM非对称签名:
01(表示采用 RSA 签名)
HASH 表示散列算法
11:支持散列方式验证 SHA-256
12:支持散列方式验证 SM3
6.交易类型txnTypeM取值: 04
7.交易子类txnSubTypeM默认: 00
8.产品类型bizTypeM000201
9.渠道类型channelTypeM
10.后台通知地址backUrlM后台返回商户结果时使用,如上
送,则发送商户后台交易结果通
知,如需通过专线通知,需要在
通知地址前面加上前缀: 专线的
首字母加竖线 ZX|
11.接入类型accessTypeM0:普通商户直连接入
1:收单机构接入 2:平台类商
户接入
12.收单机构代码acqInsCodeC接入类型为收单机构接入时需
上送
13.商户类别merCatCodeC接入类型为收单机构接入时需
上送
14.商户代码merIdM
15.商户名称merNameC接入类型为收单机构接入时需
上送
16.商户简称merAbbrC接入类型为收单机构接入时需
上送
17.二级商户代码subMerIdC商户类型为平台类商户接入时
必须上送
18.二级商户全称subMerNameC商户类型为平台类商户接入时
必须上送
19.二级商户简称subMerAbbrC商户类型为平台类商户接入时
必须上送
20.商户订单号orderIdM退货交易的订单号,由商户生成
21.原始交易流水号origQryIdM原始消费交易的 queryId
22.订单发送时间txnTimeM
23.交易金额txnAmtM
24.终端号termIdO
25.请求方保留域reqReservedO商户自定义保留域,交易应答时
会原样返回
26.保留域reservedO
27.分账域accSplitDataO分账域,用法参见注 13
该域需整体做 Base64 编码。


中国银联
版权所有
Q/CUP071.2.1—2015
42
6.4.4 应答报文(同步应答)

1.版本号versionR
2.编码方式encodingR
3.签名signatureM
4.签名方法signMethodM
5.交易类型txnTypeR取值: 04
6.交易子类txnSubTypeR默认: 00
7.产品类型bizTypeR
8.接入类型accessTypeR
9.收单机构代码acqInsCodeC接入类型为收单机构接入时需返
10.商户代码merIdR
11.商户订单号orderIdR
12.原始交易流水号origQryIdR原始消费交易的 queryId
13.订单发送时间txnTimeR
14.交易金额txnAmtR
15.请求方保留域reqReservedR
16.保留域reservedO
17.银联交易流水号queryIdM退货交易的交易流水号 供查询
18.响应码respCodeM
19.应答信息respMsgM
20.签名公钥证书signPubKeyCertC使用 RSA 签名方式时必选,此域
填写银联签名公钥证书。


6.4.5 商户通知(异步应答)
中国银联
版权所有
Q/CUP071.2.1—2015
43
6.5 交易状态查询交易
6.5.1 概述
对于未收到交易结果的联机交易,商户应向银联全渠道支付平台发起交易状态查询交易,查询交易
结果。完成交易的过程不需要同持卡人交互,属于后台交易。交易查询类交易可由商户通过SDK向银联
全渠道支付交易平台发起交易。
 前台类交易查询机制:
前台类交易,如标准网关的前台消费、预授权等交易;对于交易状态未知的交易请求方必须发起交
易状态查询交易。
前台类交易建议间隔(5分、 10分、 30分、 60分、 120分)发起交易查询,如果查询到结果成功,则
不用再查询。(失败,处理中,查询不到订单均可能为中间状态)。
可建议商户使用payTimeout(支付超时时间),超过这个时间点查询,得到的结果为最终结果。
查询5次以上,仍获取不到明确状态的交易,后续可以间隔更长时间发起查询,最终结果以对账文
件为准。
 后台类交易查询机制:
后台类交易:如代收,代付,后台消费,退货,消费撤销;对于交易状态未知的交易请求方必须发
起交易状态查询交易。
后台类资金类交易同步返回00 银联已受理,交易完成银联有后台通知,商户也可以发起 查询交易,
可查询N次(不超过6次),每次时间间隔2的N次秒发起,即间隔1、 2、 4、 8、 16、 32秒查询;代付交易
建议3分钟后查询。 当天相同的订单号只能发起一次(无论结果成功还是失败)。
中国银联
版权所有
Q/CUP071.2.1—2015
44
查询5次以上, 仍获取不到明确状态的交易,后续可以间隔更长时间发起查询,最终结果以对账文
件为准。
批量单笔交易状态不明确,也请参考后台类交易查询处理机制。
6.5.2 交易流程
相关交易流程如下:
商户 银联全渠道交易系统
1.商户组织交易状态查询的交易报文,发送
至全渠道平台
3.银联全渠道系统组织交易结果报文,返回给商户
2.全渠道系统完成
商户的交易处理
图 4 银联全渠道支付开通交易—后台类
交易步骤:
1、 商户发起交易状态查询交易;
2、 全渠道系统完成商户的交易处理;
3、 银联全渠道系统组织交易报文,返回给商户。
6.5.3 请求报文

1.版本号versionM固定填写
2.编码方式encodingM默认取值: UTF-8
3.证书 IDcertIdM
4.签名signatureM填写对报文摘要的签名
5.签名方法signMethodM非对称签名:
01(表示采用 RSA 签名)
HASH 表示散列算法
11:支持散列方式验证
SHA-256
12:支持散列方式验证 SM3
6.交易类型txnTypeM交易类型: 00
7.交易子类txnSubTypeM默认: 00
8.产品类型bizTypeM000201
9.接入类型accessTypeM0:普通商户直连接入
1:收单机构接入


中国银联
版权所有
Q/CUP071.2.1—2015
45

2:平台类商户接入
10.收单机构代码acqInsCodeC接入类型为收单机构接入时
需上送
11.商户代码merIdM
12.订单发送时间txnTimeM
13.商户订单号orderIdM
14.保留域reservedO


6.5.4 应答报文

1.版本号versionR
2.签名signatureM
3.编码方式encodingR
4.签名方法signMethodM
5.交易类型txnTypeM同被查询交易
6.交易子类txnSubTypeM同被查询交易
7.收单机构代码acqInsCodeC接入类型为收单机构接入时需
上送
8.接入类型accessTypeR
9.商户代码merIdR
10.订单发送时间txnTimeR被查询交易的交易时间
11.商户订单号orderIdR被查询交易的订单号
12.请求方保留域reqReservedO返回被查询交易的请求方保留
13.保留域reservedO
14.交易查询流水号queryIdM被查询交易查询流水号
15.系统跟踪号traceNoM统一返回
16.交易传输时间traceTimeM统一返回
17.清算日期settleDateM资金类交易统一返回
18.清算币种settleCurrencyCodeM资金类交易统一返回
19.清算金额settleAmtM资金类交易统一返回
20.清算汇率exchangeRateC交易成功,交易币种和清算币
种不一致的时候返回
21.兑换日期exchangeDateC交易成功,交易币种和清算币
种不一致的时候返回
22.交易币种currencyCodeC
23.交易金额txnAmtC
24.原交易应答码origRespCodeC查询交易成功时返回
25.原交易应答信息origRespMsgC
26.应答码respCodeM
27.应答信息respMsgM


中国银联
版权所有
Q/CUP071.2.1—2015
46

28.账号accNoC根据商户配置返回
29.支付卡类型payCardTypeC(消费、预授权) 根据商户配
置返回
30.支付方式payTypeC(消费、预授权) 根据商户配
置返回
31.支付卡标识payCardNoC(移动支付消费) 根据商户配
置返回
32.支付卡名称payCardIssueNameC(移动支付消费) 根据商户配
置返回
33.有卡交易信息域cardTransDataC有卡交易必填,有卡交易信息
域(组合域,用法详见数据元
说明),返回报文只返回子域:
IC 卡数据 ICCardData
34.发卡机构识别模式issuerIdentifyModeC消费、预授权交易返回
35.委托关系标识号bindIdC绑定支付时,根据商户配置返
36.签名公钥证书signPubKeyCertC使用 RSA 签名方式时必选,此
域填写银联签名公钥证书。


注:
应答报文中,“应答码”即respCode字段,表示的是查询交易本身的应答,即查询这个动作是否成
功,不代表被查询交易的状态;
若查询动作成功,即应答码为“00“,则根据“原交易应答码”即origRespCode来判断被查询交易
是否成功。此时若origRespCode为00,则表示被查询交易成功。
6.6 银联加密公钥更新查询交易
6.6.1 概述
商户定期(1天1次)向银联全渠道系统发起获取加密公钥信息交易。在加密公钥证书更新期间,全
渠道系统支持新老证书的共同使用,新老证书并行期为1个月。全渠道系统向商户返回最新的加密公钥
证书,由商户服务器替换本地证书。
6.6.2 请求报文

1版本号versionM固定填写
2编码方式encodingM默认取值: UTF-8
3证书 IDcertIdO签名方式 01 需要上送
4签名signatureM填写对报文摘要的签名
5签名方法signMethodM取值:
非对称签名:
01(表示采用 RSA 签名)
HASH 表示散列算法
11:支持散列方式验证 SHA-256


中国银联
版权所有
Q/CUP071.2.1—2015
47

12:支持散列方式验证 SM3
6交易类型txnTypeM取值: 95
7交易子类txnSubTypeM默认: 00
8产品类型bizTypeM
9渠道类型channelTypeM
10证书类型certTypeM01:敏感信息加密公钥
11接入类型accessTypeM0:普通商户直连接入
1:收单机构接入
2:平台类商户接入
12收单机构代码acqInsCodeC接入类型为收单机构接入时需
上送
13商户代码merIdM
14商户类别merCatCodeC接入类型为收单机构接入时需
上送
15商户名称merNameC接入类型为收单机构接入时需
上送
16商户简称merAbbrC接入类型为收单机构接入时需
上送
17二级商户代码subMerIdC商户类型为平台类商户接入时
必须上送
18二级商户名称subMerNameC商户类型为平台类商户接入时
必须上送
19二级商户简称subMerAbbrC商户类型为平台类商户接入时
必须上送
20请求方保留域reqReservedO商户自定义保留域,交易应答时
会原样返回
21保留域reservedO
22商户订单号orderIdM商户端生成
23订单发送时间txnTimeM商户发送交易时间


6.6.3 应答报文

1版本号versionR
2签名signatureM
3编码方式encodingR
4签名方法signMethodM
5交易类型txnTypeR取值:95
6交易子类txnSubTypeR
7产品类型bizTypeR
8接入类型accessTypeR
9收单机构代码acqInsCodeC接入类型为收单机构接入时需


中国银联
版权所有
Q/CUP071.2.1—2015
48

上送
10商户代码merIdR
11请求方保留域reqReservedR
12保留域reservedO
13签名公钥证书signPubKeyCertO使用 RSA 签名方式时必选,此
域填写银联签名公钥证书。
14加密公钥证书encryptPubKeyCertC加密公钥证书
15应答码respCodeM
16应答信息respMsgM
17商户订单号orderIdR
18订单发送时间txnTimeR
19证书类型certTypeR


6.7 预授权类交易
6.7.1 预授权
6.7.1.1 概述
预授权交易用于受理方向持卡人的发卡方确认交易许可。受理方将预估的消费金额作为预授权金额,
发送给持卡人的发卡方。
6.7.1.2 交易流程
相关交易流程可参考消费类交易。
6.7.1.3 请求报文
报文同消费类交易,交易类型和交易子类取值不同。

1.版本号versionM固定填写
2.编码方式encodingM默认取值: UTF-8
3.证书 IDcertIdM
4.签名signatureM填写对报文摘要的签名
5.签名方法signMethodM非对称签名:
01(表示采用 RSA 签名)
HASH 表示散列算法
11:支持散列方式验证 SHA-256
12:支持散列方式验证 SM3
6.交易类型txnTypeM取值: 02
7.交易子类txnSubTypeM01:预授权
03:担保消费
通过地址区分前台与后台交易
8.产品类型bizTypeM000201
9.渠道类型channelTypeM
10.后台通知地址backUrlM后台返回商户结果时使用,如上


中国银联
版权所有
Q/CUP071.2.1—2015
49

送,则发送商户后台交易结果通
知,如需通过专线通知,需要在
通知地址前面加上前缀: 专线的
首字母加竖线 ZX|
11.接入类型accessTypeM0:普通商户直连接入
1:收单机构接入
2:平台类商户接入
12.收单机构代码acqInsCodeC接入类型为收单机构接入时需
上送
13.商户类别merCatCodeC接入类型为收单机构接入时需
上送
14.商户代码merIdM
15.商户名称merNameC接入类型为收单机构接入时需
上送
16.商户简称merAbbrC接入类型为收单机构接入时需
上送
17.二级商户代码subMerIdC商户类型为平台类商户接入时
必须上送
18.二级商户全称subMerNameC商户类型为平台类商户接入时
必须上送
19.二级商户简称subMerAbbrC商户类型为平台类商户接入时
必须上送
20.商户订单号orderIdM预授权的订单号,由商户生成
21.订单发送时间txnTimeM
22.账号类型accTypeC跨行收单且收单机构收集银行
卡信息时上送
01:银行卡
02:存折
03: C 卡
默认取值: 01
取值“03” 表示以 IC 终端发起
的 IC 卡交易, IC 作为普通银行
卡进行支付时,此域填写为“01”
23.账号accNoC1、 后台类消费交易时上送全
卡号或卡号后 4 位
2、 跨行收单且收单机构收集
银行卡信息时上送、
3、前台类交易可通过配置后返
回,卡号可选上送
24.交易金额txnAmtM
25.交易币种currencyCodeM默认为 156
26.银行卡验证信息
及身份信息
customerInfoC1、后台类消费交易时上送
2、认证支付 2.0,后台交易时可


中国银联
版权所有
Q/CUP071.2.1—2015
50

Key=value 格式
(具体填写参考数据元说明)
27.终端号termIdO
28.请求方保留域reqReservedO商户自定义保留域,交易应答时
会原样返回
29.保留域reservedO
30.风险信息域riskRateInfoO
31.加密证书 IDencryptCertIdC
32.分期付款信息域instalTransInfoC分期付款交易,商户端选择分期
信息时,需上送 组合域,填法
见数据元说明
33.发卡机构代码issInsCodeOC
当账号类型为 02-存折时需填写
在前台类交易时填写默认银行
代码,支持直接跳转到网银
商户发卡银行控制
系统应答返回
34.终端信息域userMacO移动支付业务需要上送
35.持卡人 IPcustomerIpO前台交易,有 IP 防钓鱼要求的
商户上送
36.绑定标识号bindIdO绑定消费 需做绑定时填写 用
于唯一标识绑定关系
37.支付卡类型payCardTypeC绑定消费
特殊商户交易控制用(如借贷分
离)
38.有卡交易信息域cardTransDataC有卡交易必填,有卡交易信息域
(组合域,用法详见数据元说
明)
39.订单描述orderDescC移动支付上送


6.7.1.4 应答报文(同步应答)

1.版本号versionR
2.编码方式encodingR
3.签名signatureM
4.签名方法signMethodM
5.交易类型txnTypeR
6.交易子类txnSubTypeR
7.产品类型bizTypeR
8.接入类型accessTypeR
9.收单机构代码acqInsCodeC接入类型为收单机构接入时需
上送


中国银联
版权所有
Q/CUP071.2.1—2015
51

10.商户代码merIdR
11.商户订单号orderIdR
12.订单发送时间txnTimeR
13.账号accNoC根据商户配置返回
14.交易金额txnAmtR
15.交易币种currencyCodeM默认为 156
16.请求方保留域reqReservedR
17.保留域reservedO
18.交易查询流水号queryIdM预授权交易的流水号,供后续查
询用
19.响应码respCodeM
20.应答信息respMsgM
21.支付卡类型payCardTypeC根据商户配置返回
22.支付方式payTypeC根据商户配置返回
23.银联订单号tnC商户推送订单后银联移动支付
系统返回该流水号,商户调用支
付控件时使用
24.签名公钥证书signPubKeyCertC使用 RSA 签名方式时必选,此
域填写银联签名公钥证书。


6.7.1.5 商户通知(异步应答)

1.版本号versionR
2.编码方式encodingR
3.签名signatureM
4.签名方法signMethodM
5.交易类型txnTypeR
6.交易子类txnSubTypeR
7.产品类型bizTypeR
8.接入类型accessTypeR
9.收单机构代码acqInsCodeC接入类型为收单机构接入时需
上送
10.商户代码merIdR
11.商户订单号orderIdR
12.订单发送时间txnTimeR
13.交易金额txnAmtR
14.交易币种currencyCodeM默认为 156
15.请求方保留域reqReservedR
16.保留域reservedO
17.交易查询流水号queryIdM预授权交易的流水号,供后续查
询用


中国银联
版权所有
Q/CUP071.2.1—2015
52

18.响应码respCodeM
19.响应信息respMsgM
20.清算金额settleAmtM
21.清算币种settleCurrencyCodeM
22.清算日期settleDateM
23.系统跟踪号traceNoM
24.交易传输时间traceTimeM
25.兑换日期exchangeDateC交易成功,交易币种和清算币种
不一致的时候返回
26.汇率exchangeRateC交易成功,交易币种和清算币种
不一致的时候返回
27.账号accNoC根据商户配置返回
28.支付卡类型payCardTypeC根据商户配置返回
29.支付方式payTypeC根据商户配置返回
30.有卡交易信息域cardTransDataC有卡交易必填,有卡交易信息域
(组合域,用法详见数据元说
明),返回报文只返回子域: IC
卡数据 ICCardData
31.支付卡标识payCardNoC移动支付交易时,根据商户配置
返回
32.支付卡名称payCardIssueNameC移动支付交易时,根据商户配置
返回
33.绑定标识号bindIdR绑定支付时,根据商户配置返回
34.签名公钥证书signPubKeyCertC使用 RSA 签名方式时必选,此
域填写银联签名公钥证书。


6.7.2 预授权撤销
6.7.2.1 概述
对已成功的POS预授权交易,在结算前使用预授权撤销交易,通知发卡方取消付款承诺。预授权撤
销交易必须是对原始预授权交易或追加预授权交易最终承兑金额的全额撤销。
6.7.2.2 交易流程
相关交易流程可参考消费撤销类交易。
6.7.2.3 请求报文
同消费撤销类交易,交易类型取值不同。

1.版本号versionM固定填写
2.编码方式encodingM默认取值: UTF-8
3.证书 IDcertIdM
4.签名signatureM填写对报文摘要的签名
5.签名方法signMethodM非对称签名:


中国银联
版权所有
Q/CUP071.2.1—2015
53

01(表示采用 RSA 签名)
HASH 表示散列算法
11:支持散列方式验证 SHA-256
12:支持散列方式验证 SM3
6.交易类型txnTypeM取值: 32
7.交易子类txnSubTypeM默认: 00
8.产品类型bizTypeM000201
9.渠道类型channelTypeM
10.后台通知地址backUrlM后台返回商户结果时使用,如上
送,则发送商户后台交易结果通
知,如需通过专线通知,需要在
通知地址前面加上前缀: 专线的
首字母加竖线 ZX|
11.接入类型accessTypeM0:普通商户直连接入
1:收单机构接入
2:平台类商户接入
12.收单机构代码acqInsCodeC接入类型为收单机构接入时需
上送
13.商户类别merCatCodeC接入类型为收单机构接入时需
上送
14.商户代码merIdM
15.商户名称merNameC接入类型为收单机构接入时需
上送
16.商户简称merAbbrC接入类型为收单机构接入时需
上送
17.二级商户代码subMerIdC商户类型为平台类商户接入时
必须上送
18.二级商户全称subMerNameC商户类型为平台类商户接入时
必须上送
19.二级商户简称subMerAbbrC商户类型为平台类商户接入时
必须上送
20.商户订单号orderIdM预授权撤销的订单号,由商户生
21.原始交易流水号origQryIdM原始预授权交易的 queryId
22.订单发送时间txnTimeM
23.交易金额txnAmtM与原始预授权交易一致
24.终端号termIdO
25.请求方保留域reqReservedO商户自定义保留域,交易应答时
会原样返回
26.保留域reservedO


6.7.2.4 应答报文(同步应答)
中国银联
版权所有
Q/CUP071.2.1—2015
54
同消费撤销类交易同步应答报文。

1.版本号versionR
2.编码方式encodingR
3.签名signatureM
4.签名方法signMethodM
5.交易类型txnTypeR
6.交易子类txnSubTypeR
7.产品类型bizTypeR
8.接入类型accessTypeR
9.收单机构代码acqInsCodeC接入类型为收单机构接入时需上
10.商户代码merIdR
11.商户订单号orderIdR
12.原始交易流水号origQryIdR原始预授权交易的 queryId
13.订单发送时间txnTimeR
14.交易金额txnAmtR
15.请求方保留域reqReservedR
16.保留域reservedO
17.银联交易流水号queryIdM预授权撤销交易的交易流水号
供查询用
18.响应码respCodeM
19.应答信息respMsgM
20.签名公钥证书signPubKeyCertC使用 RSA 签名方式时必选,此域
填写银联签名公钥证书。


6.7.2.5 商户通知(异步应答)
同消费撤销类交易异步应答报文。
中国银联
版权所有
Q/CUP071.2.1—2015
55
6.7.3 预授权完成交易
6.7.3.1 概述
对已批准的预授权交易,用预授权完成做支付结算。
6.7.3.2 交易流程
相关交易流程可参考消费类交易。
6.7.3.3 请求报文
同消费撤销类交易请求报文,交易类型取值不同。

1.版本号versionM固定填写
2.编码方式encodingM默认取值: UTF-8
3.证书 IDcertIdM
4.签名signatureM填写对报文摘要的签名
5.签名方法signMethodM非对称签名:
01(表示采用 RSA 签名)
HASH 表示散列算法
11:支持散列方式验证 SHA-256
12:支持散列方式验证 SM3
6.交易类型txnTypeM取值: 03
7.交易子类txnSubTypeM默认: 00
8.产品类型bizTypeM000201
9.渠道类型channelTypeM


中国银联
版权所有
Q/CUP071.2.1—2015
56

10.后台通知地址backUrlM后台返回商户结果时使用,如上
送,则发送商户后台交易结果通
知,如需通过专线通知,需要在
通知地址前面加上前缀: 专线的
首字母加竖线 ZX|
11.接入类型accessTypeM0:普通商户直连接入
1:收单机构接入
2:平台类商户接入
12.收单机构代码acqInsCodeC接入类型为收单机构接入时需
上送
13.商户类别merCatCodeC接入类型为收单机构接入时需
上送
14.商户代码merIdM
15.商户名称merNameC接入类型为收单机构接入时需
上送
16.商户简称merAbbrC接入类型为收单机构接入时需
上送
17.二级商户代码subMerIdC商户类型为平台类商户接入时
必须上送
18.二级商户全称subMerNameC商户类型为平台类商户接入时
必须上送
19.二级商户简称subMerAbbrC商户类型为平台类商户接入时
必须上送
20.商户订单号orderIdM预授权完成的订单号,由商户生
21.原始交易流水号origQryIdM原始预授权交易的 queryId
22.订单发送时间txnTimeM
23.交易金额txnAmtM
24.终端号termIdO
25.请求方保留域reqReservedO商户自定义保留域,交易应答时
会原样返回
26.保留域reservedO


6.7.3.4 应答报文(同步应答)
同消费撤销类交易同步应答报文。

1.版本号versionR
2.编码方式encodingR
3.签名signatureM
4.签名方法signMethodM
5.交易类型txnTypeR
6.交易子类txnSubTypeR


中国银联
版权所有
Q/CUP071.2.1—2015
57

7.产品类型bizTypeR
8.接入类型accessTypeR
9.收单机构代码acqInsCodeC接入类型为收单机构接入时需上
10.商户代码merIdR
11.商户订单号orderIdR
12.原始交易流水号origQryIdR原始预授权交易的 queryId
13.订单发送时间txnTimeR
14.交易金额txnAmtR
15.请求方保留域reqReservedR
16.保留域reservedO
17.银联交易流水号queryIdM预授权完成交易的交易流水号
供查询用
18.响应码respCodeM
19.应答信息respMsgM
20.签名公钥证书signPubKeyCertC使用 RSA 签名方式时必选,此域
填写银联签名公钥证书。


6.7.3.5 商户通知(异步应答)
同消费撤销类交易异步应答报文。
中国银联
版权所有
Q/CUP071.2.1—2015
58
6.7.4 预授权完成撤销
6.7.4.1 概述
预授权完成撤销交易必须是对原始预授权完成交易的全额撤销。预授权完成撤销后的预授权仍然有
效。
6.7.4.2 交易流程
相关交易流程可参考消费撤销类交易。
6.7.4.3 请求报文
同消费撤销类交易请求报文,交易类型取值不同。

1.版本号versionM固定填写
2.编码方式encodingM默认取值: UTF-8
3.证书 IDcertIdM
4.签名signatureM填写对报文摘要的签名
5.签名方法signMethodM非对称签名:
01(表示采用 RSA 签名)
HASH 表示散列算法
11:支持散列方式验证 SHA-256
12:支持散列方式验证 SM3
6.交易类型txnTypeM取值: 33
7.交易子类txnSubTypeM默认: 00
8.产品类型bizTypeM000201
9.渠道类型channelTypeM
10.后台通知地址backUrlM后台返回商户结果时使用,如上
送,则发送商户后台交易结果通
知,如需通过专线通知,需要在
通知地址前面加上前缀: 专线的
首字母加竖线 ZX|
11.接入类型accessTypeM0:普通商户直连接入


中国银联
版权所有
Q/CUP071.2.1—2015
59

1:收单机构接入
2:平台类商户接入
12.收单机构代码acqInsCodeC接入类型为收单机构接入时需
上送
13.商户类别merCatCodeC接入类型为收单机构接入时需
上送
14.商户代码merIdM
15.商户名称merNameC接入类型为收单机构接入时需
上送
16.商户简称merAbbrC接入类型为收单机构接入时需
上送
17.二级商户代码subMerIdC商户类型为平台类商户接入时
必须上送
18.二级商户全称subMerNameC商户类型为平台类商户接入时
必须上送
19.二级商户简称subMerAbbrC商户类型为平台类商户接入时
必须上送
20.商户订单号orderIdM预授权完成撤销的订单号,由商
户生成
21.原始交易流水号origQryIdM原始预授权完成交易的 queryId
22.订单发送时间txnTimeM
23.交易金额txnAmtM与原始预授权完成交易一致
24.终端号termIdO
25.请求方保留域reqReservedO商户自定义保留域,交易应答时
会原样返回
26.保留域reservedO


6.7.4.4 应答报文(同步应答)
同消费撤销类交易同步应答报文。

1.版本号versionR
2.编码方式encodingR
3.签名signatureM
4.签名方法signMethodM
5.交易类型txnTypeR
6.交易子类txnSubTypeR
7.产品类型bizTypeR
8.接入类型accessTypeR
9.收单机构代码acqInsCodeC接入类型为收单机构接入时需上
10.商户代码merIdR
11.商户订单号orderIdR


中国银联
版权所有
Q/CUP071.2.1—2015
60

12.原始交易流水号origQryIdR原始预授权完成交易的 queryId
13.订单发送时间txnTimeR
14.交易金额txnAmtR
15.请求方保留域reqReservedR
16.保留域reservedO
17.银联交易流水号queryIdM预授权完成撤销交易的交易流水
号, 供查询用
18.响应码respCodeM
19.应答信息respMsgM
20.签名公钥证书signPubKeyCertC使用 RSA 签名方式时必选,此域
填写银联签名公钥证书。


6.7.4.5 商户通知(异步应答)
同消费撤销类交易异步应答报文。
中国银联
版权所有
Q/CUP071.2.1—2015
61
7 对账文件
7.1 对账文件说明
相关约定如下:
1. 全渠道文件联机下载报文中除签名域外所有域参与签名运算,对多域的情况不做控制
2. 大于20M的文件不允许联机下载,通过商户服务平台下载
3. 请求报文最大长度不得大于5M,单个key 最大长度不得大于 100,单个value 最大长度不得大
于1M,下载文件不得大于20M。对UPOP/EBPP转换的全渠道联机报文,通过特殊域标记,统一文件对这种
报文通过双方约定的验签方式验签或免验.
特殊域: <key,value>=<msgType,internal>
<key,value>=<interInsCode, xxxxxxxx>
xxxxxxxx是为全渠道分配的特殊机构代码
这两个特殊域不对外公开。
4. 只能下载以系统当前清算日期为准一年内的文件
5. 原UPOP/EBPP的需联机下载所有文件类型,对应转换后的全渠道联机下载报文中新的文件类型,
每种文件类型对应一个文件,全渠道转换后的联机下载报文须带报文头。
商户索取的文件类型约定:

商户号(15 位) _日期(YYYYMMDD).zip00
CUPMBCC_Remittance_Daily_Report_日期(YYYYMMDD).csv81
CUPMBCC_Settlement_Daily_Report_日期(YYYYMMDD).csv82
CUPMBCC_Settlement_Monthly_Report_月份(YYYYMM)01.csv83
CUPMBCC_Chargeback_Daily_Report_日期(YYYYMMDD).csv84
收单机构号(8 位) _商户号(15 位)_out.tar.gz85
CUPS_商户号(15 位) _清算日期(YYYYMMDD)87
MC 商户号(后 8 位)清算日期(YYMMDD)_GRP88
MC 商户号(后 8 位)清算日期(YYMMDD)89
MC 商户号(后 8 位)清算日期(YYMMDD)_GNETE90
WKDS 商户号(15 位)清算日期(YYMMDD)91
SETTLE_M0000141_$$$$$$$$94
BOC_Bank_Statement_Data_********.csv95


7.2 文件传输类交易接口
中国银联
版权所有
Q/CUP071.2.1—2015
62
7.2.1 交易流程
商户需开发“文件传输类交易”接口获取对账文件。相关交易流程如下:
商户 银联全渠道系统
1.商户将文件发送给银联全渠道系统
3.全渠道将文件处理结果返回给商户
2.全渠道处理文件请求
图 5 文件传输交易
交易步骤:
1、 商户发起文件传输类交易;
2、 银联全渠道系统完成文件交易处理;
3、 全渠道系统将文件的处理结果返回给商户。
7.2.2 请求报文

1.版本号versionM固定填写
2.编码方式encodingM默认取值: UTF-8
3.证书 IDcertIdM
4.签名signatureM填写对报文摘要的签名
5.签名方法signMethodM非对称签名:
01(表示采用 RSA 签名)
HASH 表示散列算法
11:支持散列方式验证 SHA-256
12:支持散列方式验证 SM3
6.交易类型txnTypeM取值: 76
7.交易子类txnSubTypeM01:对账文件下载
8.产品类型bizTypeM000000
9.接入类型accessTypeM0:普通商户直连接入
10.商户代码merIdM
11.收单机构代码acqInsCodeC接入类型为收单机构接入时需
上送
12.清算日期settleDateM
13.订单发送时间txnTimeM
14.文件类型fileTypeM依据实际业务情况定义
参考 7.1:商户索取的文件类型
约定
15.请求方保留域reqReservedO商户自定义保留域,交易应答时


中国银联
版权所有
Q/CUP071.2.1—2015
63

会原样返回


7.2.3 应答报文

1.版本号versionR
2.证书 IDcertIdM
3.签名signatureM
4.编码方式encodingR
5.签名方法signMethodM
6.交易类型txnTypeR取值: 76
7.交易子类txnSubTypeR01:对账文件下载
8.产品类型bizTypeR
9.接入类型accessTypeR
10.商户代码merIdR
11.收单机构代码acqInsCodeC
12.清算日期settleDateR
13.订单发送时间txnTimeR
14.文件类型fileTypeR
15.文件名fileNameM
16.文件内容fileContentM文件流方式
17.请求方保留域reqReservedR
18.应答码respCodeM
19.应答信息respMsgM


7.3 对账文件格式
请参考《全渠道平台接入接口规范 第三部分 文件接口》
8 批量文件
请参考《全渠道平台接入接口规范 第三部分 文件接口》
9 附录
请参考《全渠道平台接入接口规范 第五部分 附录》
中国银联
版权所有

  • 0
    点赞
  • 6
    收藏
  • 0
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
©️2022 CSDN 皮肤主题:书香水墨 设计师:CSDN官方博客 返回首页
评论
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、C币套餐、付费专栏及课程。

余额充值