中 国 银 联 股 份 有 限 公 司 企 业 标 准
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.1 | 2015-04-30 | 吴潇 | 银行卡验证信息及身份信息的加密方式待系统开 发上线后再修订；姓名字段长度改为 30 |
| 1.1 | 2015-05-11 | 吴潇 | 数据元说明 checkFlag 的备注中“证件号后 8 位” 改为“证件号”； 分期付款信息域增加子域格式说 明；交易状态查询交易请求报文的 txnTime、 orderId 改为条件上送，并明确其上送的情况，明 确 queryId 上送的情况；文件传输交易产品类型 改为 000000 |
| 1.1 | 2015-05-19 | 吴潇 | 产品接口规范仅包含商户卷，机构可参考全渠道 平台接入接口规范。 |
| 1.2 | 2015-06-05 | 吴潇 | 修改消费交易请求报文的发卡机构代码的备注 |
| 1.2 | 2015-06-12 | 吴潇 | 修改保留域、风控信息域的数据元说明，删除交 易中这两个域的备注 |
| 1.3 | 2015-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.4 | 2015-07-22 | 吴潇 | 规范加密公钥、磁道加密公钥、签名私钥、验签 公钥及相关证书的用法和定义；明确只有成功交 易才会发后台通知，且交易状态未明情况下商户 必须发起交易状态查询。 |
| 1.5 | 2015-09-06 | 吴潇 | 前期的修订内容已同步更新至商户自助测试平 台，因此接受修订内容并更新版本号。 |
| 1.6 | 2015-10-29 | 李晨 | 在 5.5 注 6 中风险信息域增加子域银行预留手机 号 |
| 1.6 | 2015-11-09 | 李晨 | 全渠道交易查询通知机制，修订 6.5.1 内容 |
中国银联
版权所有
Q/CUP071.2.1—2015
II
| 1.6 | 2015-11-19 | 赵晓夏 | 将本规范中插入的参考规范更新为最新版 |
| 1.7 | 2015-12-14 | 赵晓夏 | 第 5.5 章节增加“预付卡通道” 数据元。第 6.2.3 节消费类交易请求报文增加“预付卡通道” 域。 第 5.5 章节，前台交易商户上送并需锁定返显卡 号时，保留域相关子域增加“客户 ID”子域。 第 5.5 章节,删除分期付款信息域相关子域:分期付款 手续费率及商户补贴手续费率 。 第 6.2.3 节消费 类交易请求报文中， defaultPayType 的备注改为 “C 取值参考数据元说明”。 |
| 1.8 | 2016-03-07 | 赵晓夏 | 5.5 数据元说明注 8 中的载体类型修订为“可选 0：缺省； 1:sd 卡 2:simpass 3:vipos 4:迷你付 5:mPOS 6:AM 7:NFC 8:蓝牙 9:hce 云端支付” |
| 1.8 | 2016-03-07 | 赵晓夏 | 6.5.4 交易状态查询类交易应答报文中 txnType 域出现要 求改为 M |
| 1.8 | 2016-03-07 | 赵晓夏 | 5.5 exchangeDate 数据元格式从 YYYYMMDD 改为 MMDD |
| 1.9 | 2016-05-23 | 赵晓夏 | “兑换日期 exchangeDate”和“汇率 exchangeRate”数据 源说明修改为“交易成功，交易币种和清算币种不一致的 时候返回” |
| 1.9 | 2016-05-24 | 赵晓夏 | 6.5.3 修订交易状态查询接口的“订单发送时间”和“商 户订单号”的出现要求由 C 改为 M，“交易查询流水号” 删除 |
| 1.9 | 2016-05-26 | 赵晓夏 | 4.1.2、 4.2、 6.5.1 后台类涉及资金类交易，交易失败也会 通知交易处理结果；商户发起交易查询获取交易处理结 果，当天相同的订单号只能发起一次（无论结果成功还是 失败） |
| 1.9 | 2016-05-28 | 赵晓夏 | 密钥自动更新：增加“签名公钥证书”、“加密公钥证书”、 “证书类型”数据元；修订“签名方法”数据元的取值说 明；“交易类型”数据元取值新增“95：查询更新加密公 钥证书”，新增“银联加密公钥更新查询交易”；所有交易 应答报文增加“签名公钥证书”域且删除“证书 ID”域； 修订“版本号”说明为“固定填写 5.1.0”。 4.3.1 摘要算法 升级为 SHA-256。 |
| 1.9 | 2016-05-31 | 赵晓夏 | 后台通知地址“backUrl”备注追加：如需通过专线通知， 需要在通知地址前面加上前缀：专线的首字母加竖线 ZX| |
| 1.9 | 2016-06-06 | 谌子奇 | 新增 4.3.2.4， 4.3.3， 4.3.4 密钥更新章节 |
| 1.9 | 2016-06-07 | 谌子奇 | 4.1.1/4.1.2/4.3.1 新增补充说明 |
| 1.9 | 2016-06-13 | 谌子奇 | 5.5 修改数据元说明 |
| 1.9 | 2016-06-14 | 谌子奇 | 5.5 6.2 6.4 增加数据元分账域 accType 字段新增取值【04：对公账户】 |
| 1.9 | 2016-06-16 | 谌子奇 | 5.5 新增注 8 注 8-1 修改 cardTransData 备注 6.6 请求和应答添加 txnTime， orderId |
| 1.9 | 2016-07-20 | 谌子奇 | 增加数据元ctrlRule billQueryInfo 增加财税库银相关子域 |
| 1.9 | 2016-07-20 | 谌子奇 | 数据元certType取值删除02：磁道加密公钥 |
中国银联
版权所有
Q/CUP071.2.1—2015
III
| 2.0 | 2016-07-27 | 谢荣东 | 5.5 channelType 线下POS修改 5.5 修改billNo数据元格式 |
| 2.0 | 2016-07-27 | 谢荣东 | 全文 “签名公钥证书”出现要求由AN2048改成C |
| 2.0 | 2016-08-23 | 谢荣东 | customerIp 的出现要求由C改为O |
| 2.0 | 2016-08-29 | 谢荣东 | 风控域增加子域diskSep、 imei、 macAddr |
| 2.0 | 2016-08-29 | 谢荣东 | 1、分期付款信息域增加子域 2、新增数据元districtName |
| 2.0 | 2016-09-02 | 谢荣东 | 6.5.3 删除“签名公钥证书” |
| 2.0 | 2016-10-17 | 谢荣东 | 1、 billType数据元修改为“代收款项” . 2、 删除应答报文中的 respTime |
| 2.1 | 2016-11-17 | 谢荣东 | 1、 数据元 ctrlRule 取值说明修改 2、 证件类型certifTp04的说明文字改成“港澳证” |
| 2.1 | 2016-11-17 | 谢荣东 | 1、 风控信息域新增子域： LBS信息、设备通讯号码。 子域diskSep备注说明文字修改 2、 对账文件说明文件类型表格2项 |
| 2.1 | 2016-11-21 | 谢荣东 | 1、 5.5数据元channelType增加取值说明（16：数字机 顶盒） 2、数据元产品类型 bizType 删除取值： 000101 基金业务之股票基金 000102 基金业务之货币基金 3、风控信息域（ riskRateInfo ）子域修改 ： 1. addressModifyTim 改成 addressModifyTime； 2. 删 除【银行预留手机号 phoneNo】 |
| 2.2 | 2017-3-10 | 汪之婴 | 修改数据元ctrlRule数据元取值ctrlRule， 增加分期取值说 明 |
| 2.2 | 2017-3-10 | 汪之婴 | 消费请求ctrlRule增加请求要素：控制规则 ctrlRule O 32位01字符串控制位，从左至右第四位取值为1时表示前 台消费交易需要分期处理 |
| 2.2 | 2017-3-10 | 汪之婴 | 账单支付交易保留域增加营销金额说明， 修改保留域用 法，修改注5 |
| 2.2 | 2017-3-10 | 汪之婴 | 风控信息域说明中添加设备类型、卡片信息录入方式、设 备sim卡数量、设备名称 |
| 2.2 | 2017-3-10 | 汪之婴 | txnType数据元增加取值说明： 76:文件传输 |
| 2.2 | 2017-3-10 | 汪之婴 | 所有请求要素的frontUrl 出现要求改为O |
| 2.2 | 2017-3-10 | 汪之婴 | 银联全渠道支付开通交易,请求报文中，删除一个交易子 类02 |
| 2.2 | 2017-3-10 | 汪之婴 | 银 联 全 渠 道 支 付 开 通 查 询 交 易 — — 删 除 交 易 子 类 txnSubType取值： 01：手机号查询（只支持商户直连接入 模式） |
| 2.2 | 2017-3-13 | 汪之婴 | 发卡机构代码 issInsCode 数据元格式改成AN1..11 |
| 2.2 | 2017-3-13 | 汪之婴 | 分账域做base64编码： |
中国银联
版权所有
Q/CUP071.2.1—2015
IV
| 1. 在分账域的数据元取值说明格增加说明文字“该域需 整体做Base64编码。” 2. 消费和退货的请求报文分账域的备注增加说明文字 “该域需整体做Base64编码。” 3. 消费和退货商户通知删除分账域这个要素 |
|||
| 2.2 | 2017-3-13 | 汪之婴 | 消费撤销和退货商户通知增加accNo根据商户配置返回 |
| 2.2 | 2017-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. | 版本号 | version | NS5 | 固定填写 5.1.0 |
| 2. | 证书 ID | certId | N1..128 | 填写签名私钥证书的 Serial Number， 该值可通过银联提 供的 SDK 获取 |
| 3. | 签名 | signature | ANS1..1 024 |
填写对报文摘要的签名 |
| 4. | 编码方 式 |
encoding | ANS1..2 0 |
填写报文使用的字符编码 UTF-8|GBK|GB2312|GB18030 若不填写，默认取值： UTF-8 |
| 5. | 交易类 | txnType | N2 | 取值： |
中国银联
版权所有
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. | 交易子 类 |
txnSubType | N2 | 依据实际交易类型填写 默认取值： 00 |
| 7. | 产品类 型 |
bizType | N6 | 依据实际业务场景填写(目前仅使用后 4 位， 前面 2 位 默认为 00) 默认取值： 000000 具体取值范围： 000201： B2C 网关支付 000301： 认证支付 2.0 000302： 评级支付 000401： 代付 000501： 代收 000601： 账单支付 000801： 跨行收单 000901： 绑定支付 001001： 订购 000202： B2B |
| 8. | 前台通 知地址 |
frontUrl | ANS1..2 56 |
前台返回商户结果时使用，前台类交易需上送 不支持换行符等不可见字符 |
| 9. | 后台通 知地址 |
backUrl | ANS1..2 56 |
后台返回商户结果时使用，如上送，则发送商户后台交 易结果通知， 不支持换行符等不可见字符， 如需通过专 线通知，需要在通知地址前面加上前缀： 专线的首字母 |
中国银联
版权所有
Q/CUP071.2.1—2015
11
| 加竖线 ZX| | ||||
| 10. | 接入类 型 |
accessType | N1 | 0：商户直连接入 1：收单机构接入 2：平台商户接入 |
| 11. | 收单机 构代码 |
acqInsCode | AN8..11 | 已被批准加入银联互联网系统的收单机构代码 |
| 12. | 商户类 别 |
merCatCode | N4 | 填写 MCC 码，接入类型为收单机构接入时需上送 |
| 13. | 商户代 码 |
merId | AN15 | 已被批准加入银联互联网系统的商户代码 |
| 14. | 商户名 称 |
merName | ANS1..4 0 |
接入类型为收单机构接入时需上送 不支持换行符等不可见字符 |
| 15. | 商户简 称 |
merAbbr | ANS1..8 | 接入类型为收单机构接入时需上送 最长 8 位，不支持换行符等不可见字符 |
| 16. | 二级商 户代码 |
subMerId | AN5..15 | 商户类型为平台类商户接入时必须上送 |
| 17. | 二级商 户名称 |
subMerName | ANS1..4 0 |
商户类型为平台类商户接入时必须上送 最长 40 个字节，不支持换行符等不可见字符 |
| 18. | 二级商 户简称 |
subMerAbbr | ANS1..8 | 仅支持字母或汉字或其组合，最长 8 位，不支持换行符 等不可见字符。 商户类型为平台类商户接入时必须上送 |
| 19. | 商户订 单号 |
orderId | AN8..40 | 商户订单号，不能含“-” 或“_” |
| 20. | 订单发 送时间 |
txnTime | YYYY MMDD hhmmss |
商户发送交易时间 |
| 21. | 订单接 收超时 时间 |
orderTimeout | N1..10 | 单位为毫秒，交易发生时，该笔交易在银联互联网系统 中有效的最长时间。当距离交易发送时间超过该时间 时，银联互联网系统不再为该笔交易提供支付服务 |
| 22. | 支付超 时时间 |
payTimeout | YYYY MMDD hhmmss |
订单支付超时时间，超过此时间用户支付成功的交易， 不通知商户，系统自动退款，大约 5 个工作日金额返还 到用户账户 |
| 23. | 默认支 付方式 |
defaultPayType | N4 | 取值如下： 0001：认证支付 0004：储值卡支付 0005： IC 卡支付 0201：网银支付 0404：互联网订单手机支付 |
| 24. | 支持支 付方式 |
supPayType | AN1..12 8 |
由收单机构填写，取值为以下内容的一种或多种，通过 逗号（，）分割。 0001：认证支付 0004：储值卡支付 0005： IC 卡支付 |
中国银联
版权所有
Q/CUP071.2.1—2015
12
| 0201：网银支付 0404：互联网订单手机支付 |
||||
| 25. | 支付方 式 |
payType | N4 | 默认不返回此域，如需要返此域，需要提交申请，视商 户配置返回，可在消费类交易中返回以下中的一种： 0001：认证支付 0002：快捷支付 0004：储值卡支付 0005： IC 卡支付 0201：网银支付 1001：牡丹畅通卡支付 1002：中铁银通卡支付 0401：信用卡支付——暂定 0402：小额临时支付 0403：认证支付 2.0 0404：互联网订单手机支付 9000：其他无卡支付(如手机客户端支付) |
| 26. | 交易币 种 |
currencyCode | AN3 | 币种格式必须为 3 位代码，默认取值： 156（人民币） |
| 27. | 账号类 型(卡介 质) |
accType | N2 | 01： 银行卡 02： 存折 03： IC 卡 04：对公账户 默认取值： 01 取值“03” 表示以 IC 终端发起的 IC 卡交易， IC 作为普 通银行卡进行支付时，此域填写为“01” |
| 28. | 账号 | accNo | AN1..10 24 |
交易账号。 请求时使用加密公钥对交易账号加密，并做 Base64 编码后上送；应答时如需返回，则使用签名私钥 进行解密。 前台交易可由银联页面采集，也可由商户上送并返显。 如需锁定返显卡号，应通过保留域（ reserved）上送卡 号锁定标识。 |
| 29. | 支付卡 类型 |
payCardType | N2 | 消费交易，视商户配置返回。该域取值为： 00：未知 01：借记账户 02：贷记账户 03：准贷记账户 04：借贷合一账户 05：预付费账户 06：半开放预付费账户 |
| 30. | 发卡机 构代码 |
issInsCode | AN1..11 | 当账号类型为 02-存折时需填写 在前台类交易时填写默认银行代码，支持直接跳转到网 银 |
| 31. | 开户行 省 |
issInsProvince | ANS1..3 0 |
代付交易时可选上传 |
| 32. | 开户行 | issInsCity | ANS1..3 | 代付交易时可选上传 |
中国银联
版权所有
Q/CUP071.2.1—2015
13
| 市 | 0 | |||
| 33. | 开户行 名称 |
issInsName | ANS1..6 0 |
代付交易时可选上传 |
| 34. | 银行卡 验证信 息及身 份信息 |
customerInfo | ANS1..1 024 |
该域需整体做 Base64 编码。 所有子域需用“有子域包含，子域间以“含，符号链接。 格式如下： {子域名 1=值&子域名 2=值&子域名 3=值} 各子域取值见注 1。 借记卡可上送姓名、手机号、证件类型、证件号码；贷 记卡可上送姓名、手机号、证件类型、证件号码、有效 期、 CVN2。 前台交易可以由银联页面采集，无需商户上送，后台交 易必须由商户上送。 前台交易支持商户上送并返显的要素包含手机号，姓 名，证件号。 |
| 35. | 交 易 金 额 |
txnAmt | N1..12 | 单位为分 |
| 36. | 余额 | balance | AN1..25 6 |
用法一：用于银行卡、银行账户余额查询中返回账户实 际余额和可用余额。 用法二：用于费用查询、自助缴费交易中，用于表示用 户在 SP 用户的账户实际余额和可用余额。 用法三：在查询信|用卡账户余额的交易中返回账户的应 还金额和最低还款额。 最多可携带2个如下所示的余额信息：报文格式为JSON 格式 各子域取值见注 2。 |
| 37. | 代 收 款 项 |
billType | ANS2 | 01 移动电话 02 固定电话 03 水费 04 电费 05 煤气费 06 社保 07 小灵通 08 信用卡还款 09 烟草 10 信用卡中心 11 有线和付费电视 12 保险 13 税务 14 证券公司 15 金融机构 16 贷款还款 CS 财税库银 RZ 商户实时入账 OT 其他 |
| 38. | 账 单 号 码 |
billNo | AN 4 S1..6 | 账单查询 用法一：账单查询 /支付类交易中填写具体账单号码 /支付类交易中网上缴税用法，填写纳 |
中国银联
版权所有
Q/CUP071.2.1—2015
14
| 税人编码 用法二：账单查询/支付类交易中信用卡还款用法，填写 信用卡卡号 |
||||
| 39. | 业 务 代 码 |
bussCode | A 0 NS4..2 | 账单查询/支付类交易中填写 账单类型_地区码_附加地区码 示例： D1_3300_0000 账单类型： ANS2..4 参见附录 D：全渠道平台账单类 型 地区代码： N4 从 BIZ 文件获取，地区代码参考《银 联卡跨行业务地区代码标准》 附加地区代码： ANS4..10 从 BIZ 文件获取，区分具体 子业务 默认值 0000 |
| 40. | 账 单 周 期 |
billPeriod | ANS17 | 格式为： yyyyMMdd-yyyyMMdd |
| 41. | 账 单 要 素 |
billQueryInfo | ANS1..1 024 | 不支持换行符等不可见字符 账单查询/支付类交易中用于上送其他未定义的账单要 素 根据获取到的 BIZ 文件要求填写，为 JSON 报文结构 各子域取值见注 3 |
| 42. | 账 单 明 细 |
billDetailInfo | ANS1..2 048 | 不支持换行符等不可见字符 账单查询/支付类交易中填写查询到的账单明细信息 格式为 JSON 报文结构，各子域取值见注 3 |
| 43. | 绑 定 标 识号 |
bindId | ANS1..1 28 | 不支持换行符等不可见字符 用于唯一标识绑定关系 |
| 44. | 绑 定 信 息条数 |
bindInfoQty | N1..2 | 查询绑定关系时，返回的委托关系信息条数 |
| 45. | 绑 定 信 息集 |
bindInfoList | ANS 048 1..2 | 查询绑定关系时，返回的具体委托信息集，格式为： 报文格式为 JSON 格式 各子域取值见注 4。 |
| 46. | 批次号 | batchNo | N4 | 批量交易时填写，当天唯一,0001-9999，商户号+批次号 +上交易时间确定一笔交易 |
| 47. | 总笔数 | totalQty | N1..6 | 批量交易时填写，填写批量中，总的交易比数 |
| 48. | 总金额 | totalAmt | N1..12 | 批量交易时填写，填写批量中，总的交易金额 |
| 49. | 文 件 类 型 |
fileType | N2 | 依据实际业务情况定义，默认值为： 00 |
| 50. | 文件名 | fileName | ANS1..6 4 |
填写文件名称 |
| 51. | 批 量 文 件内容 |
fileContent | 压缩， Base64 编码后的文件内容 | |
| 52. | 请 求 方 自 定 义 域 |
reqReserved | ANS1..1 024 |
|
| 53. | 保留域 | reserved | ANS1..2 048 |
保留域包含多个子域，所有子域需用“{}”包含，子域间 以“&”符号链接。 格式如下： {子域名 1=值&子域名 2=值&子域名 3=值}。 |
中国银联
版权所有
Q/CUP071.2.1—2015
15
| 相关子域说明见注 5。 | ||||
| 54. | 终端号 | termId | AN8 | 填写 CUPS 规范中的终端号 |
| 55. | 发 卡 机 构 识 别 模式 |
issuerIdentifyM ode |
N1 | 0：发卡机构自主识别模式 1：发卡机构辅助识别模式 |
| 56. | 持 卡 人 IP |
customerIp | NS7..40 | 填写持卡人发起交易的 IP 地址，用于防钓鱼 |
| 57. | 查 询 流 水号 |
queryId | AN21 | 由银联返回，用于在后续类交易中唯一标识一笔交易 |
| 58. | 原 交 易 查 询 流 水号 |
origQryId | AN21 | |
| 59. | 系 统 跟 踪号 |
traceNo | N6 | |
| 60. | 交 易 传 输时间 |
traceTime | MMDD hhmmss | |
| 61. | 清 算 日 期 |
settleDate | MMDD | |
| 62. | 清 算 币 种 |
settleCurrency Code |
AN3 | |
| 63. | 清 算 金 额 |
settleAmt | N1..12 | |
| 64. | 清 算 汇 率 |
exchangeRate | N8 | 交易成功，交易币种和清算币种不一致的时候返回 格式为右对齐，无小数点 小数位数由最左边一位数字表示，第二位至第八位指的 是汇率的值 |
| 65. | 兑 换 日 期 |
exchangeDate | MMDD | 交易成功，交易币种和清算币种不一致的时候返回 |
| 66. | 原 交 易 应答码 |
origRespCode | AN2 | |
| 67. | 原 交 易 应 答 信 息 |
origRespMsg | ANS1..2 56 |
|
| 68. | 应答码 | respCode | AN2 | 具体参见应答码定义章节 |
| 69. | 应 答 信 息 |
respMsg | ANS1..2 56 | 填写具体的应答信息 |
| 70. | 验 证 标 识 |
checkFlag | N8 | 表示交易时对持卡人的验证要素要求 共 8 位长，每位以 0、 1 表示是否需要， 0 代表不需要， 1 代表需要； 自左向右每位代表的顺序如下： 位 1：证件类型 位 2：证件号 位 3：动态密码 位 4： CVN2 位 5：有效期 位 6：账户密码 |
中国银联
版权所有
Q/CUP071.2.1—2015
16
| 位 7：姓名 位 8：手机号 |
||||
| 71. | 开 通 状 态 |
activateStatus | N1 | 0：未开通业务 1：已开通银联全渠道支付 2：已开通小额认证支付 3：评级开通 |
| 72. | 加 密 证 书 ID |
encryptCertId | N1..128 | 当需要加密敏感信息如 CVN2、有效期、密码及其他账 户信息如卡号、手机号时，填写加密公钥证书的 Serial Number |
| 73. | 终 端 信 息域 |
userMac | ans80 | 按照如下统一的格式上送终端 ID 信息:“终端信息 1,终 端信息 2”。 （1）如果只有第一项信息，则只需填写：终端信息 1 （2）如果只有第二项信息，则需填写： ,终端信息 2 （3）如果两项均无，则字段为空。 |
| 74. | 风 控 信 息域 |
riskRateInfo | ANS 1…2048 | 有风控要求的商户根据实际情况上送 所有子域需用“有子域包含，子域间以“含，符号链接。 格式如下： {子域名 1=值&子域名 2=值&子域名 3=值} 相关子域说明见注 6。 |
| 75. | 小 额 临 时 支 付 信息域 |
temporaryPayIn fo |
AN100 | 小额临时支付相关信息域，包含多个子域，所有子域需 用“{}”包含，子域间以“&”符号链接。格式如下： {子 域名 1=值&子域名 2=值&子域名 3=值} 子域相关说明见注 7。 |
| 76. | 失 败 交 易 前 台 跳 转 地 址 |
frontFailUrl | ANS1..2 56 |
前台消费交易若商户上送此字段，则在支付失败时，页 面跳转至商户该 URL（不带交易信息，仅跳转） |
| 77. | 有 卡 交 易 信 息 域 |
cardTransData | ANS1Tr ans |
IC 卡交易上送 所有子域需用“有子域包含，子域间以“含，符号链接。 格式如下： {子域名 1=值&子域名 2=值&子域名 3=值} 相关子域说明见注 8。 |
| 78. | 银 联 受 理 订 单 号 |
tn | N21 | 商户推送订单后银联移动支付系统返回该流水号，商户 调用支付控件时使用 |
| 79. | 支 付 卡 标识 |
payCardNo | ANS1..1 9 | 移动支付交易时，根据商户配置返回 |
| 80. | 支 付 卡 名称 |
payCardIssueN ame |
ANS1..6 4 |
移动支付交易时，根据商户配置返回 |
| 81. | 渠 道 类 型 |
channelType | N2 | 05：语音 07：互联网 08：移动 16：数字机顶盒 |
| 82. | 签 名 方 法 |
signMethod | N2 | 非对称签名： 01（表示采用 RSA 签名） |
中国银联
版权所有
Q/CUP071.2.1—2015
17
| HASH 表示散列算法 11：支持散列方式验证 SHA-256 12：支持散列方式验证 SM3 |
||||
| 83. | 分 期 付 款 信 息 域 |
instalTransInfo | ANS1..1 28 |
格式如下： {子域名 1=值&子域名 2=值&子域名 3=值} 相关子域见注 10。 |
| 84. | 订 单 描 述 |
orderDesc | ANS1..3 2 | 描述订单信息，显示在银联支付控件或客户端支付界面 中 |
| 85. | 转 入 账 号 |
bookedAccNo | AN1..60 | 转账交易转入账号 |
| 86. | 预 付 卡 通道 |
accountPayCha nnel |
ANS1..2 0 |
预付卡的专享支付页面通道组 |
| 87. | 签 名 公 钥证书 |
signPubKeyCer t |
AN2048 | 使用 RSA 签名方式时必选，此域填写银联签名公钥证 书。 |
| 88. | 加 密 公 钥证书 |
encryptPubKey Cert |
AN2048 | 加密公钥证书 |
| 89. | 证 书 类 型 |
certType | N2 | 01：敏感信息加密公钥 |
| 90. | 分账域 | accSplitData | ANS1..5 12 |
该域需整体做 Base64 编码。 复合域， json 字符串组装，具体见注 13 |
| 91. | 控 制 规 则 |
ctrlRule | N32 | 32 位 01 字符串控制位， 从左至右第一位取值为 1 表示财税库银信息控制位； 第二位取值为 1 时表示小微商户； 第三位取值为 1 时表示河北电力代缴建立委托签约； 第四位取值为 1 时表示前台消费交易需要分期处理 |
| 92. | 地 区 名 称 |
districtName | ANS64 | 支持汉字 |
注 0：
若报文中的数据元标识的 key 对应的 value 为空，不上送该报文域；对于组合域，若该组合域无子域上送，该组合域不
上送，若子域 key 对应的 value 为空，不上送该子域。
注 1：
银行卡验证信息及身份信息（customerInfo）数据元相关子域说明：
| 序号 | 子域名 | 标 识 | 子域格式 | 说 明 |
| 1. | 证件类型 | certifTp | N2 | 01：身份证 02：军官证 03：护照 04： 港澳证 05：台胞证 06：警官证 07：士兵证 99：其它证件 |
| 2. | 证件号码 | certifId | ANS1..20 | |
| 3. | 姓名 | customerNm | ANS1..30 | 支持汉字 |
中国银联
版权所有
Q/CUP071.2.1—2015
18
| 4. | 短信验证码 | smsCode | N6 | |||||||||||||
| 5. | 持卡人密码 | pin | ANS1..256 | 使用敏感信息加密证书对 ANSI X9.8 格式的 PIN 加密，并做 Base64 编码 |
||||||||||||
| 6. | 加密信息域 | encryptedInfo | ANS1..1024 | 请求时使用加密公钥对上送的 CVN2、有效期、手 机号加密，并做 Base64 编码；应答时如需返回， 则使用签名私钥进行解密。 其中：
encryptedInfo=BASE64( 加 密 后 (cvn2=nnn&expired=YYMM&phoneNo=xxxxxxxx)) |
注 2：
余额（balance）数据元相关子域说明：
| 序号 | 子域名 | 标 识 | 子域格式 | 说 明 |
| 1. | 账号类型 | accType | N2 | 00－缺省账户 10－储蓄账户（只适用于银行账 户） 30－信用卡账户（只适用于银行 账户） |
| 2. | 余额类型 | balanceType | N2 | 01－账面余额（银行账户） 02－可用余额（银行账户） 11－信用卡账户应还金额 12－信用卡账户最低还款额 16－账面余额（SP 用户账户） 17－可用余额（SP 用户账户） |
| 3. | 货币代码 | currencyCode | AN3 | 默认值 156 |
| 4. | 余额符号 | balanceSign | AN1 | 欠费状态： D 非欠费状态： C |
| 5. | 余额 | balance | N1..12 | 以分为单位 余额符号为 D 时，本域表示欠费 金额 余额符号为 C 时，本域表示实际 余额 |
注 3：
账单要素（billQueryInfo）、账单明细（billDetailInfo）数据元相关子域说明：
| 序号 | 子域名 | 标 识 | 子域格式 | 说 明 |
| 1. | 用户号码 (AC) | usr_num | AN1..40 | 账单编号 |
| 2. | 查询/缴费年月(AF) | query_month | N6 | 格式 YYYYMM 当本子域填写“000000”时，用于查询/ 缴费当前用户号码所有欠费 |
| 3. | 关联查询交易键值 (AG) |
rel_inq_key | AN31 | |
| 4. | 支付订单号(AH) | pay_bill_no | AN1..100 | |
| 5. | 查询/缴费终止年月 （AI） |
inq_end_month | N6 | 格式 YYYYMM，如果查询/缴费没有区 间，终止年月同查询/缴费年月(AF) |
| 6. | 条形码/标识号 (BB) | bar_cd | ANS1..100 |
中国银联
版权所有
Q/CUP071.2.1—2015
19
| 7. | 姓名 (BC) | usr_nm | ANS1..40 | |
| 8. | 通讯号码 (BD) | phone_num | ANS1..20 | |
| 9. | 证件类型 (BE) | id_tp | ANS2 | |
| 10. | 证件号码 (BF) | id_num | ANS1..20 | |
| 11. | 户号 (BG) | household_num | ANS1..40 | |
| 12. | 地址 (BH) | address | ANS1..140 | |
| 13. | 城市代码 (BI) | city_cd | ANS1..10 | |
| 14. | 银行代码 (BJ) | bank_cd | ANS1..20 | |
| 15. | 执收单位 (BK) | collect_unit | ANS1..80 | |
| 16. | 出账日期 (BL) | bill_gen_date | N8 | 格式 YYYYMMDD |
| 17. | 计费起始日期 (BM) | bill_begin_date | N8 | 格式 YYYYMMDD |
| 18. | 计费终止日期 (BN) | bill_end_date | N8 | 格式 YYYYMMDD |
| 19. | 缴费截止日期 (BO) | pay_deadline | N8 | 格式 YYYYMMDD |
| 20. | 费用索引 (BP) | charge_idx | AN1..10 | |
| 21. | 上期欠款 (BQ) | last_owe_amt | N12 | 金额不带小数点。小数位根据交易币种 来决定。 交易金额的币种由交易币种表示，若表 示人民币则单位为分。例如：终端交易 金 额 为 1000 元 ， 则 交 易 金 额 ＝ “000000100000” |
| 22. | 上期余额 (BR) | last_balance_amt | N12 | 格式同上 |
| 23. | 本期账单金额 (BS) | curr_amt | N12 | 格式同上 |
| 24. | 滞纳金 (BT) | late_amt | N12 | 格式同上 |
| 25. | 项目名称 (BU) | buss_nm | ANS1..80 | |
| 26. | 明细信息 (BV) | detail | ANS1..582 | |
| 27. | 发票信息 (BW) | rcpt_dtl | ANS1..582 | |
| 28. | 费用缴清标志 (BX) | payup_flg | N1 | 0：未缴清 1：已缴清 |
| 29. | 是否生成发票 (BY) | rcpt_gen_flg | N1 | 0：不需要发票 1：需要发票 |
| 30. | 缴费流水号 (CA) | pay_trans_num | AN1..40 | 用于打印发票的受理端流水或行业商 户流水 |
| 31. | 缴费日期 (CB) | pay_date | N1..14 | YYYYMMDDHHMMSS，用于打印发 票的受理端交易日期或行业商户交易 日期 |
| 32. | 用户信息 (CC) | usr_info | ANS1..60 | 用于识别用户的相关信息，如姓名、车 牌等 |
| 33. | 缴费月数 (CD) | pay_month_num | N1...3 | 缴费的总月数 |
| 34. | 产品类别 (CE) | product_tp | AN1..10 | |
| 35. | 缴费方式 （CF） | pay_mode | AN1..2 | |
| 36. | 数量 (CG) | quantity | ANS1..20 | |
| 37. | 单价 (CH) | unit_price | ANS1..12 | |
| 38. | 总价 (CI) | total_price | ANS1..20 | |
| 39. | 车辆识别代码 (CM) | car_id_cd | ANS1..30 | |
| 40. | 车辆发动机号 (CN) | car_engine_id | ANS1..30 | |
| 41. | 支付明细名称项 (DA) | pay_dtl_nm | ANS1..250 | 以„|‟进行格式化分隔的支付明细各子 项项目名称。以„|‟开头并以„|‟结尾，第 一个固定为“欠费金额”（以分为单位， |
中国银联
版权所有
Q/CUP071.2.1—2015
20
| 最大 12 位）。 TAG[pay_dtl_1]~TAG[pay_dtl_12]各条 明细的子项项目名称由本 TAG 指定 |
||||
| 42. | 支付明细 1 (DB) | pay_dtl_1 | ANS1..250 | 以„|‟进行格式化分隔的明细信息，只包 括明细数据，不包括明细数据的项目名 称 ， 各 项 目 其 对 应 项 目 名 称 通 过 TAG[pay_dtl_nm ]进行标识。第一个固 定为该条明细的欠费总金额，每条明细 均以„|‟开头并以„|‟结尾。如多渠道有返 回 TAG[pay_dtl_1]~TAG[pay_dtl_12]， 则受理端可以将各明细单独显示，由用 户选择需进行支付的明细，对应支付位 图 TAG[pay_dtl_bmp]的第 1 位 |
| 43. | 支付明细 2 (DC) | pay_dtl_2 | ANS1..250 | 同 pay_dtl_1 ， 对 应 支 付 位 图 TAG[pay_dtl_bmp]的第 2 位 |
| 44. | 支付明细 3 (DD) | pay_dtl_3 | ANS1..250 | 同 pay_dtl_1 ， 对 应 支 付 位 图 TAG[pay_dtl_bmp]的第 3 位 |
| 45. | 支付明细 4 (DE) | pay_dtl_4 | ANS1..250 | 同 pay_dtl_1 ， 对 应 支 付 位 图 TAG[pay_dtl_bmp]的第 4 位 |
| 46. | 支付明细 5 (DF) | pay_dtl_5 | ANS1..250 | 同 pay_dtl_1 ， 对 应 支 付 位 图 TAG[pay_dtl_bmp]的第 5 位 |
| 47. | 支付明细 6 (DG) | pay_dtl_6 | ANS1..250 | 同 pay_dtl_1 ， 对 应 支 付 位 图 TAG[pay_dtl_bmp]的第 6 位 |
| 48. | 支付明细 7 (DH) | pay_dtl_7 | ANS1..250 | 同 pay_dtl_1 ， 对 应 支 付 位 图 TAG[pay_dtl_bmp]的第 7 位 |
| 49. | 支付明细 8 (DI) | pay_dtl_8 | ANS1..250 | 同 pay_dtl_1 ， 对 应 支 付 位 图 TAG[pay_dtl_bmp]的第 8 位 |
| 50. | 支付明细 9 (DJ) | pay_dtl_9 | ANS1..250 | 同 pay_dtl_1 ， 对 应 支 付 位 图 TAG[pay_dtl_bmp]的第 9 位 |
| 51. | 支付明细 10 (DK) | pay_dtl_10 | ANS1..250 | 同 pay_dtl_1 ， 对 应 支 付 位 图 TAG[pay_dtl_bmp]的第 10 位 |
| 52. | 支付明细 11 (DL) | pay_dtl_11 | ANS1..250 | 同 pay_dtl_1 ， 对 应 支 付 位 图 TAG[pay_dtl_bmp]的第 11 位 |
| 53. | 支付明细 12 (DM) | pay_dtl_12 | ANS1..250 | 同 pay_dtl_1 ， 对 应 支 付 位 图 TAG[pay_dtl_bmp]的第 12 位 |
| 54. | 支付位图 (DN) | pay_dtl_bmp | N1..12 | C1：支付位图：在先查后缴模式下，查 询 返 回 支 付 明 细 （ TAG[pay_dtl_1]~TAG[pay_dtl_12] ） 后，如 TAG[pay_dtl_cnt]标识该业务需 由用户进行选择支付，则需在支付时上 送 TAG[pay_dtl_bmp]，将用户选择的支 付明细对应序号位置„1‟，未选择支付明 细对应序号位置„0‟。并将用户选择进行 支付的相关明细的欠费金额进行汇总 后作为 4 域上送 |
| 55. | 支付明细总条数 (DO) | pay_dtl_cnt | N1..2 | C2：明细缴纳状态位图：应答时，用于 返 回 每 个 明 细 （ TAG[pay_dtl_1]~TAG[pay_dtl_12] ） 的费用状态，取值： 0-未缴纳， 1-已缴 纳 |
| 56. | 选择支付标志 (DP) | pay_sel_tag | N1 | 标 识 存 在 的 支 付 明 细 数 ， 指 明 TAG[pay_dtl_1]~TAG[DM]具体的存在 个数 |
| 57. | 起始量表值 (DQ) | meter_begin_value | AN1..20 | 用于返回年度、月度等费用量表起始值 |
| 58. | 截止量表值 (DR) | meter_end_value | AN1..20 | 用于返回年度、月度等费用量表截止值 |
| 59. | 已使用量表值 (DS) | meter_use_value | AN1..10 | 用于返回年度、月度等费用量表已使用 值 |
中国银联
版权所有
Q/CUP071.2.1—2015
21
| 60. | 行业应答码信息 (DT) | trade_rsp_cd_info | AN1..100 | 用于返回行业商户的行业应答码信息 |
| 61. | 费用可缴标志 (DU) | charge_pay_flg | N1 | 0：不可支付，查询应答时，如果为此 值，表明不可发起后续支付交易 1：可支付，查询应答时，如果为此值， 表明可发起后续支付交易 |
| 62. | 本期余额 (DV) | curr_balance | N12 | 格式同本期账单金额 |
| 63. | 通知单编号列表 (DW) |
ntf_num_list | ANS1..100 | |
| 64. | 面额 (DX) | note | N12 | |
| 65. | 充值状态 (DY) | maps_trans_status | ANS1..10 | |
| 66. | 订单号 (DZ) | buss_order_id | ANS1..40 | |
| 67. | 手机区域 (EA) | caller_loc | ANS1…100 | |
| 68. | 证件信息 (EB) | cert_info | ANS1..60 | |
| 69. | 入账商户号 (EG) | mchnt_cd_in | AN1..20 | |
| 70. | 报备终端号 (EH) | report_term_id | AN1..20 | |
| 71. | 销账应答流水号 (EI) | wof_rsp_seq_num | AN1..40 | |
| 72. | 原交易应答码信息 (EJ) |
orig_rsp_info | ANS1..100 | |
| 73. | 总罚单数 (EK) | tckt_num | N2 | |
| 74. | 可代办的罚单数 (EL) | agent_tckt_num | N2 | |
| 75. | 不可代办的罚单数 (EM) |
un_agent_tckt_num | N2 | |
| 76. | 页面显示可以代办的 罚单数 (EN) |
disp_agent_tckt_num | N2 | |
| 77. | 用户状态（EO） | usr_status | AN1..2 | |
| 78. | 用户状态描述(EP) | usr_status_desc | ANS1…64 | |
| 79. | 行业信息扩展域(XX) | trade_info_resv | AN1..300 | |
| 80. | 征收机关代码 | col_organ_cd | N1..12 | 财税库银子域， 支付开通时必上送 |
| 81. | 纳税人名称 | tax_drawee_nm | ANS1..200 | 财税库银子域， 支付开通时必上送 |
| 82. | 纳税人编码 | tax_payer_id | AN1..20 | 财税库银子域， 支付开通时必上送 |
| 83. | 付款开户行行号 | deposit_bank_cd | N1..12 | 1. 财税库银子域， 支付开通时必上送 2. 纳税人、参保人开户行行号， TIPS 不做控制和校验 【银联参与的三方协议，银行卡账户填 为 905290000008， 非银行卡账户据实 填写】 |
| 84. | 付款行行号 | pay_bank_cd | N1..12 | 1. 财税库银子域， 支付开通时必上送 2. 【即税库银规范中的三方协议“清 算行行号” ；银联参与的三方协议固定 填 905290000008】 |
| 85. | 付款账户 | pay_acct | AN1..32 | 1. 财税库银子域， 支付开通时必上送 |
中国银联
版权所有
Q/CUP071.2.1—2015
22
| 2. “三方委托缴款协议书”中纳税人、 参保人的缴款户账号 【银行卡或非银行卡账户】 |
||||
| 86. | 缴款单位名称 | pay_unit_nm | ANS1..200 | 1. 财税库银子域， 支付开通时必上送 2. 即付款账户在银行的户名，若为银 行卡是指持卡人姓名 |
| 87. | 协议书号 | agreement_no | ANS1..60 | 1. 财税库银子域， 支付开通时必上送 2. 征收机关、商业银行/银联、纳税人 三方签订的委托协议书号；社保机构、 商业银行/银联、参保单位三方签订的 委托协议书号 |
| 88. | 三方协议保存状态 | trip_agree_status | N2 | 1. 财税库银子域， 支付开通时必上送 2. 00-已开通； 01-未开通 |
注 4：绑定关系信息集（ bindInfoQty）数据元相关子域说明：
| 序号 | 子域名 | 标 识 | 子域格式 | 说 明 |
| 1. | 绑定关系标识号 | userId | AN1...100 | 返回该匹配定制标识号 |
| 2. | 绑定关系信息 | bindinfo | ANS1..100 | |
| 3. | 风险级别 | riskLevl | N1 | 应答时：返回风险标志 |
| 4. | 账号 | pan | AN11..19 | 请求时：卡号后 4 位或全卡号（若 仅卡号为查询条件，则需输入全 卡号）；应答时返回该匹配的已绑 定卡号的后 4 位 |
| 5. | 余额 | balance | N1..12 | 以分为单位 余额符号为 D 时，本域表示欠费 金额 余额符号为 C 时，本域表示实际 余额 |
| 6. | 卡属性 | cardAttr | N2 | 00--未知； 01--借记卡； 02--贷记 卡 应答时返回卡属性 |
| 7. | 发卡机构代码 | issBin | AN8..11 | 应答时：返回发卡机构代码 |
| 8. | 建立绑定关系日期 | orgTranDate | YYYYMMDD | 应答时返回建立绑定的日期 |
| 9. | 终端号 | termId | ANS1..32 | 应答时：返回终端号，若有多个， 以“，”进行分割 |
| 10. | 持卡人是否同意商户协 议 |
isAccecpted | N1 | |
| 11. | 证件类型 | certifTp | N2 | 取值如下： 01：身份证； 02：军 官证； 03：护照； 04： 港澳证； 05：台胞证； 06：警官证； 07： 士兵证； 99：其它证件 |
中国银联
版权所有
Q/CUP071.2.1—2015
23
| 12. | 证件号码 | certifId | ANS1..20 | |
| 13. | 姓名 | customerNm | ANS1..30 | 支持汉字 |
| 14. | 手机号 | phoneNo | N1..20 | |
| 15. | 短信验证码 | smsCode | N6 | |
| 16. | 持卡人密码 | pin | ANS1..256 | 使用加密公钥对 ANSI X9.8 格 式的 PIN 加密，并做 Base64 编码 |
| 17. | CVN2 | cvn2 | N3 | |
| 18. | 有效期 | expired | YYMM |
注 5：
1-前台交易商户上送并需锁定返显卡号时，保留域（reserved）相关子域说明如下：
| 序号 | 子域名 | 标 识 | 子域格式 | 说 明 |
| 1. | 卡号锁定标识 | cardNumberLock | N1 | 取值为“1”时，表示锁定卡号， 样例如下： reserved={ cardNumberLock=1} 否则不锁定 |
| 2. | 客户 ID | customerId | ANS1..32 | 渠道商户采用全渠道前台跳转 模式进行还款、缴费、支付时， 通过 ID 标识号（渠道商户 ID+ 客户 ID）记忆客户常用卡号功 能 |
2-消费、账单支付的商户通知和交易状态查询的保留域（reserved）相关子域说明如下：
| 序号 | 子域名 | 标 识 | 子域格式 | 说 明 |
| 1 | 立减金额 | discountAmt | N1..12 | 银联的立减金额 消费、账单支付的商户通知和交易状态查询返回 |
| 2 | 商户优惠金额 | mchtDiscountAmt | N1..12 | 商户出资金额 消费、账单支付的商户通知和交易状态查询返回 |
注 6：
风控信息域（riskRateInfo）相关子域说明：
| 序号 | 子域名 | 标 识 | 子域格式 | 说 明 |
| 1. | 商品风险类别标识 | shippingFlag | N3 | 111：虚拟高风险类（无物流、 非实名登记、易变现如：游 戏点卡、游戏装备、手机充 值、礼品卡、虚拟账户充值） 110：虚拟低风险类（无物流、 非实名登记、不易变现如： 电影票、信息咨询） 100：虚拟实名类（无物流、 实名登记、不易变现如：航 空售票、酒店预订、旅游产 品、学费、行政费用（税费、 车船使用费）、汽车、房产） |
中国银联
版权所有
Q/CUP071.2.1—2015
24
| 001：实物高风险类（有物流、 易变现如：数码家电、黄金、 珠宝首饰等） 000：实物低风险类（有物流、 不易变现如：服饰、食品、 日用品等） |
||||
| 2. | 收货地址-国家 | shippingCountryCode | AN6 | |
| 3. | 收货地址-省 | shippingProvinceCode | AN6 | |
| 4. | 收货地址-市 | shippingCityCode | AN6 | |
| 5. | 收货地址-地区 | shippingDistrictCode | AN6 | |
| 6. | 收货地址-详细 | shippingStreet | ANS1..256 | |
| 7. | 商品种类 | commodityCategory | N4 | 区分商品类别 |
| 8. | 商品名称 | commodityName | ANS1..256 | |
| 9. | 商品 URL | commodityUrl | ANS1..1024 | |
| 10. | 商品单价 | commodityUnitPrice | N1..12 | |
| 11. | 商品数量 | commodityQty | N1..10 | |
| 12. | 收货/订单手机号 | shippingMobile | AN8-20 | |
| 13. | 订单地址最后修改时 间 |
addressModifyTime | YYYYMMDDhhmmss | |
| 14. | 用户注册时间 | userRegisterTime | YYYYMMDDhhmmss | |
| 15. | 收货（订单）姓名的 最后修改时间 |
orderNameModifyTime | YYYYMMDDhhmmss | |
| 16. | 账户 ID | userId | ANS1..128 | |
| 17. | 收货/订单姓名 | orderName | ANS1..32 | |
| 18. | 优质用户标识码 | userFlag | N1 | 0：普通用户 1：优质用户 |
| 19. | 订单手机号最后修改 时间 |
mobileModifyTime | YYYYMMDDhhmmss | |
| 20. | 风险级别 | riskLevel | N1 | 基于绑定关系的支付交易时 使用： 0：无风险业务 1：有风险业务 |
| 21. | 商户端用户 ID | merUserId | ANS1..64 | |
| 22. | 商户端用户注册时间 | merUserRegDt | YYYYMMDD | |
| 23. | 商户端用户注册邮箱 | merUserEmail | ANS1..256 | |
| 24. | 硬盘序列号 | diskSep | AN64 | 1.持卡人支付时的存储设备 的硬盘序列号 2.终端硬件序列号 |
| 25. | IMEI | imei | AN64 | 持卡人支付时手机设备的 IMEI |
| 26. | MAC 地址 | macAddr | ANS17 | 持卡人支付时使用设备的 MAC 地址 |
| 27. | LBS 信息 | lbs | ANS32 | 空中发卡时的位置信息，经 纬度，格式为纬度/经度， + |
中国银联
版权所有
Q/CUP071.2.1—2015
25
| 表示北纬、东经， -表示南纬、 西经。举例： +37.12/-121.23 或者+37/-121 |
||||
| 28. | 设备通讯号码 | deviceNumber | ANS32 | 1.终端拨号号码 2.单个手机号,可能包含前缀 （发起交易的手机号码，不 是接收验证码的手机号） |
| 29. | 设备类型 | deviceType | N1 | 设备类型： 1.Phone 2. Pad 3. iWatch 4.PC |
| 30. | 卡片信息录入方式 | captureMethod | N1 | 卡号录入方式，例如： 1. 摄像头拍摄实体卡片 2. 手工输入 |
| 31. | 设备 sim 卡数量 | simCardCount | N1 | |
| 32. | 设备名称 | deviceName | ANS128 |
注 7：
小额临时支付信息域（temporaryPayInfo）数据元相关子域说明：
| 序号 | 子域名 | 标 识 | 子域格式 | 说 明 |
| 1. | 小额临时支付有效期 | expiry | N8 | yyyyMMdd |
| 2. | 小额临时支付总限额 | sumLimit | N1..12 | 以分为单位 |
| 3. | 小额临时支付单笔限额 | transLimit | N1..12 | 以分为单位 |
注 8：
有卡交易信息域（cardTransData）数据元相关子域说明：
| 序 号 | 子域名 | 标 识 | 子域格式 | 说 明 |
| IC 卡数据 | ICCardData | ANS1...102 4 |
该域用于传输基于 PBOC 借贷记标准的 IC 卡数据，将 透传至 CUPS 的 55 域（基于 PBOC 借贷记标准的 IC 卡数据域） 请求返回时均需要 BASE64 编码 |
|
| IC 卡的序 列号 |
ICCardSeqNum ber |
N3 | IC 卡的序列号，将透传至 CUPS 的 23 域 域 23 卡序 列号 |
|
| 第二磁道 数据 |
track2Data | ANS1 „ 1024 |
第二磁数据需用磁道敏感信息加密证书（同敏感信息 加密证书）加密后给全渠道平台，由平台解密后传给 CUPS 的 35 域。加密格式如下： 商户代码|商户订单号|交易开始时间|交易金额|第二磁 道数据 merId|orderId|txnTime|txnAmt|track2Data 余额查询接口中 txnAmt 送 0 |
|
| 第三磁道 | track3Data | ANS1 „ | 第三磁数据需用磁道敏感信息加密证书（同敏感信息 |
中国银联
版权所有
Q/CUP071.2.1—2015
26
| 数据 | 1024 | 加密证书）加密后给全渠道平台，由平台解密后传给 CUPS 的 36 域。加密格式如下： 商户代码|商户订单号|交易开始时间|交易金额|第三磁 道数据 merId|orderId|txnTime|txnAmt|track3Data 余额查询接口中 txnAmt 送 0 |
|||||||||||||||||||||||||||||||||||
| 服务点输 入方式码 |
POSentryMode Code |
N2 | 服务点输入方式码,即持卡人数据（如 PAN）的输入方 式 服务点（Point Of Service）是指各种交易始发场合，透 传至 CUPS22 域（服务点输入方式码）前两位
|
||||||||||||||||||||||||||||||||||
| 交易发起 方式 |
transSendMode | ANS1 | 透传到 CUPS 的 F60.3.5：交易发起方式 F60 自定义域 |
中国银联
版权所有
Q/CUP071.2.1—2015
27
| F60.3 交易发生附加信息 F60.3.5 交易发起方式
|
|||||||||||
| 终端读取 能力 |
termEntryCap | ANS1 | 透传到 CUPS 的 F60.2.2/Position 2: Terminal Entry Capability：终端读取能力 F60 自定义域 F60.2 服务点附加信息 F60.2.2 终端读取能力
|
||||||||
| IC 卡条件 代码 |
chipCondCode | ANS1 | 透传到 CUPS 的 F 60.2.3/Position 3: Chip Condition Code： IC 卡条件代码 |
中国银联
版权所有
Q/CUP071.2.1—2015
28
| F60 自定义域 F60.2 服务点附加信息 F60.2.3 IC 卡条件代码
|
||||||
| 载体类型 | carrierTp | N1..2 | 可选 5:mPOS 6: Apple Pay 11:线下 pos |
|||
| 载体应用 类型 |
carrierAppTp | N1 | 可选 0：缺省； 1： upcard； 2： pboc， 3： instcard |
注 8-1：各产品取值上送说明
| 域名 | 子域名 | 标 识 | ApplePay | 线下 POS | MPOS |
| 有 卡 交 易 信 息 域 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 |
| 渠道类型 | channelType | 08 | carrierTp=11 时， 根据数据元取值 说明上送，默认值 03 |
08 |
注 10：
分期付款信息域（instalTransInfo）数据元相关子域说明：
| 序号 | 子域名 | 标 识 | 子域格式 | 说 明 |
| 1. | 分期付款期数 | numberOfInstallments | N2 | 分期付款期数 |
| 2. | 分期付款手续费率 | instalRates | N6 | 仅在商户与发卡机构存在个性化 分期全手续费协定的情况下进行 填写，对于适用发卡机构提供的 标准分期全手续费率的交易，该 域为空。 该字段取值为：分期付款手续费 率*100000。例如分期付款手续费 率为 4.5%，则该域取之为 004500 |
| 3. | 商户补贴手续费率 | mchntFeeSubsidy | N6 | 在商户确有补贴时，由受理侧据 实填写，如为持卡人全额支付手 续费模式，则为零 该字段取值为：商户补贴手续费 率*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. | 分账类型 | accSplitType | N1 | 1 - 表示按照商户列表分账，联机带入 分账入账金额 2 - 表示按照分账规则 ID 分账，联机带 分账决定要素 |
| 2. | 分账规则 ID | accSplitRuleId | AN15 | 分账类型为 2 时才出现， 15 位字母或数字 |
| 3. | 分账对象组 | accSplitMchts | AN256 | 分账类型为 1 时才出现， accSplitMcht 数组，最多支持 5 个分账 对象 accSplitMcht |
注 13-1
分账对象（accSplitMcht）子域说明：
| 序号 | 子域名 | 标 识 | 子域格式 | 说 明 |
| 1. | 分账二级商户代码 | accSplitMerId | AN15 | 15 位字母或数字 |
| 2. | 分账入账金额 | accSplitAmt | N1..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. | 版本号 | version | M | 固定填写 |
| 2. | 编码方式 | encoding | M | 默认取值： UTF-8 |
| 3. | 证书 ID | certId | M | |
| 4. | 签名 | signature | M | 填写对报文摘要的签名 |
| 5. | 签名方法 | signMethod | M | 非对称签名： 01（表示采用 RSA 签名） HASH 表示散列算法 11：支持散列方式验证 SHA-256 12：支持散列方式验证 SM3 |
| 6. | 交易类型 | txnType | M | 取值： 01 |
| 7. | 交易子类 | txnSubType | M | 01：自助消费，通过地址的方式区 分前台消费和后台消费（含无跳转 支付） 03：分期付款 |
| 8. | 产品类型 | bizType | M | 000201 |
| 9. | 渠道类型 | channelType | M | |
| 10. | 前台通知地址 | frontUrl | O | 前台返回商户结果时使用，前台类 交易需上送 |
| 11. | 后台通知地址 | backUrl | M | 后台返回商户结果时使用，如上 送，则发送商户后台交易结果通 知，如需通过专线通知，需要在通 |
中国银联
版权所有
Q/CUP071.2.1—2015
33
| 知地址前面加上前缀： 专线的首字 母加竖线 ZX| |
||||
| 12. | 接入类型 | accessType | M | 0：普通商户直连接入 1： 收单机构接入 2：平台类商户接入 |
| 13. | 收单机构代码 | acqInsCode | C | 接入类型为收单机构接入时需上 送 |
| 14. | 商户类别 | merCatCode | C | 接入类型为收单机构接入时需上 送 |
| 15. | 商户代码 | merId | M | |
| 16. | 商户名称 | merName | C | 接入类型为收单机构接入时需上 送 |
| 17. | 商户简称 | merAbbr | C | 接入类型为收单机构接入时需上 送 |
| 18. | 二级商户代码 | subMerId | C | 商户类型为平台类商户接入时必 须上送 |
| 19. | 二级商户全称 | subMerName | C | 商户类型为平台类商户接入时必 须上送 |
| 20. | 二级商户简称 | subMerAbbr | C | 商户类型为平台类商户接入时必 须上送 |
| 21. | 商户订单号 | orderId | M | 商户端生成 |
| 22. | 订单发送时间 | txnTime | M | 商户发送交易时间 |
| 23. | 账号类型 | accType | C | 后台类交易且卡号上送； 跨行收单且收单机构收集银行卡 信息时上送 01：银行卡 02：存折 03： IC 卡 默认取值： 01 取值“03”表示以 IC 终端发起的 IC 卡交易， IC 作为普通银行卡进行支 付时，此域填写为“01” |
| 24. | 账号 | accNo | C | 1、 后台类消费交易时上送全卡号 或卡号后 4 位 2、 跨行收单且收单机构收集银行 卡信息时上送、 3、前台类交易可通过配置后返回， 卡号可选上送 |
| 25. | 交易金额 | txnAmt | M | 单位为分 |
| 26. | 交易币种 | currencyCode | M | 默认为 156 |
| 27. | 银行卡验证信 息及身份信息 |
customerInfo | C | 1、后台类消费交易时上送 2、认证支付 2.0，后台交易时可选 Key=value 格式 （具体填写参考数据元说明） |
| 28. | 订单接收超时 时间（防钓鱼使 用） |
orderTimeout | O | 1、前台类消费交易时上送 2、认证支付 2.0，后台交易时可选 |
中国银联
版权所有
Q/CUP071.2.1—2015
34
| 29. | 订单支付超时 时间 |
payTimeout | O | 超过此时间用户支付成功的交易， 不通知商户，系统自动退款，大约 5 个工作日金额返还到用户账户 |
| 30. | 终端号 | termId | O | |
| 31. | 请求方保留域 | reqReserved | O | 商户自定义保留域，交易应答时会 原样返回 |
| 32. | 保留域 | reserved | O | |
| 33. | 风险信息域 | riskRateInfo | O | |
| 34. | 加密证书 ID | encryptCertId | C | |
| 35. | 失败交易前台 跳转地址 |
frontFailUrl | O | 前台消费交易若商户上送此字段， 则在支付失败时，页面跳转至商户 该 URL（不带交易信息，仅跳转） |
| 36. | 分期付款信息 域 |
instalTransInfo | C | 分期付款交易，商户端选择分期信 息时，需上送组合域，填法见数据 元说明 |
| 37. | 默认支付方式 | defaultPayType | O | C 取值参考数据元说明 |
| 38. | 发卡机构代码 | issInsCode | C | 1、 当账号类型为 02-存折时需填写 2、 在前台类交易时填写默认银行 代码，支持直接跳转到网银。 银行 简码列表参考附录： C.1、 C.2， 其 中 C.2 银行列表仅支持借记卡 |
| 39. | 支持支付方式 | supPayType | O | 仅仅 pc 使用，使用哪种支付方式 由收单机构填写，取值为以下内容 的一种或多种，通过逗号（，）分 割。取值参考数据字典 |
| 40. | 终端信息域 | userMac | O | 移动支付业务需要上送 |
| 41. | 持卡人 IP | customerIp | O | 前台交易，有 IP 防钓鱼要求的商户 上送 |
| 42. | 有卡交易信息 域 |
cardTransData | C | 有卡交易必填，有卡交易信息域 （组合域，用法详见数据元说明） |
| 43. | 订单描述 | orderDesc | C | 移动支付上送 |
| 44. | 预付卡通道 | accountPayChannel | C | 预付卡的专享支付页面 |
| 45. | 分账域 | accSplitData | O | 分账域，用法参见注 13 该域需整体做 Base64 编码。 |
| 46. | 控制规则 | ctrlRule | O | 32 位 01 字符串控制位，从左至右 第四位取值为 1 时表示前台消费交 易需要分期处理 |
6.2.4 应答报文（同步应答）
| 1. | 版本号 | version | R |
| 2. | 编码方式 | encoding | R |
| 3. | 签名 | signature | M |
| 4. | 签名方法 | signMethod | M |
| 5. | 交易类型 | txnType | R |
中国银联
版权所有
Q/CUP071.2.1—2015
35
| 6. | 交易子类 | txnSubType | R | |
| 7. | 产品类型 | bizType | R | |
| 8. | 接入类型 | accessType | R | |
| 9. | 收单机构代码 | acqInsCode | C | 接入类型为收单机构接入时需 返回 |
| 10. | 商户代码 | merId | R | |
| 11. | 商户订单号 | orderId | R | |
| 12. | 订单发送时间 | txnTime | R | |
| 13. | 交易金额 | txnAmt | R | |
| 14. | 交易币种 | currencyCode | R | 默认为 156 |
| 15. | 请求方保留域 | reqReserved | R | |
| 16. | 保留域 | reserved | O | |
| 17. | 交易查询流水号 | queryId | M | 消费交易的流水号，供后续查询 用 |
| 18. | 响应码 | respCode | M | |
| 19. | 应答信息 | respMsg | M | |
| 20. | 账号 | accNo | C | 根据商户配置返回 |
| 21. | 支付卡类型 | payCardType | C | 根据商户配置返回 |
| 22. | 支付方式 | payType | C | 根据商户配置返回 |
| 23. | 银联订单号 | tn | C | 商户推送订单后银联移动支付 系统返回该流水号，商户调用支 付控件时使用 |
| 24. | 签名公钥证书 | signPubKeyCert | C | 使用 RSA 签名方式时必选，此 域填写银联签名公钥证书。 |
6.2.5 商户通知（异步应答）
| 1. | 版本号 | version | R | |
| 2. | 编码方式 | encoding | R | |
| 3. | 签名 | signature | M | |
| 4. | 签名方法 | signMethod | M | |
| 5. | 交易类型 | txnType | R | |
| 6. | 交易子类 | txnSubType | R | |
| 7. | 产品类型 | bizType | R | |
| 8. | 接入类型 | accessType | R | |
| 9. | 收单机构代码 | acqInsCode | C | 接入类型为收单机构接入时需 返回 |
| 10. | 商户代码 | merId | R | |
| 11. | 商户订单号 | orderId | R | |
| 12. | 订单发送时间 | txnTime | R | |
| 13. | 交易金额 | txnAmt | R |
中国银联
版权所有
Q/CUP071.2.1—2015
36
| 14. | 交易币种 | currencyCode | M | 默认为 156 |
| 15. | 请求方保留域 | reqReserved | R | |
| 16. | 保留域 | reserved | O | |
| 17. | 交易查询流水号 | queryId | M | 消费交易的流水号，供后续查询 用 |
| 18. | 响应码 | respCode | M | |
| 19. | 响应信息 | respMsg | M | |
| 20. | 清算金额 | settleAmt | M | |
| 21. | 清算币种 | settleCurrencyCode | M | |
| 22. | 清算日期 | settleDate | M | |
| 23. | 系统跟踪号 | traceNo | M | |
| 24. | 交易传输时间 | traceTime | M | |
| 25. | 兑换日期 | exchangeDate | C | 交易成功，交易币种和清算币种 不一致的时候返回 |
| 26. | 汇率 | exchangeRate | C | 交易成功，交易币种和清算币种 不一致的时候返回 |
| 27. | 账号 | accNo | C | 根据商户配置返回 |
| 28. | 支付卡类型 | payCardType | C | 根据商户配置返回 |
| 29. | 支付方式 | payType | C | 根据商户配置返回 |
| 30. | 支付卡标识 | payCardNo | C | 移动支付交易时，根据商户配置 返回 |
| 31. | 支付卡名称 | payCardIssueName | C | 移动支付交易时，根据商户配置 返回 |
| 32. | 绑定标识号 | bindId | R | 绑定支付时，根据商户配置返回 |
| 33. | 签名公钥证书 | signPubKeyCert | C | 使用 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. | 版本号 | version | M | 固定填写 |
| 2. | 编码方式 | encoding | M | 默认取值： UTF-8 |
| 3. | 证书 ID | certId | M | |
| 4. | 签名 | signature | M | 填写对报文摘要的签名 |
| 5. | 签名方法 | signMethod | M | 非对称签名： 01（表示采用 RSA 签名） HASH 表示散列算法 11：支持散列方式验证 SHA-256 12：支持散列方式验证 SM3 |
| 6. | 交易类型 | txnType | M | 取值： 31 |
| 7. | 交易子类 | txnSubType | M | 默认： 00 |
| 8. | 产品类型 | bizType | M | 000201 |
| 9. | 渠道类型 | channelType | M | |
| 10. | 后台通知地址 | backUrl | M | 后台返回商户结果时使用，如上 送，则发送商户后台交易结果通 知，如需通过专线通知，需要在 通知地址前面加上前缀： 专线的 首字母加竖线 ZX| |
中国银联
版权所有
Q/CUP071.2.1—2015
38
| 11. | 接入类型 | accessType | M | 0：普通商户直连接入 1：收单机构接入 2：平台类商户接入 |
| 12. | 收单机构代码 | acqInsCode | C | 接入类型为收单机构接入时需 上送 |
| 13. | 商户类别 | merCatCode | C | 接入类型为收单机构接入时需 上送 |
| 14. | 商户代码 | merId | M | |
| 15. | 商户名称 | merName | C | 接入类型为收单机构接入时需 上送 |
| 16. | 商户简称 | merAbbr | C | 接入类型为收单机构接入时需 上送 |
| 17. | 二级商户代码 | subMerId | C | 商户类型为平台类商户接入时 必须上送 |
| 18. | 二级商户全称 | subMerName | C | 商户类型为平台类商户接入时 必须上送 |
| 19. | 二级商户简称 | subMerAbbr | C | 商户类型为平台类商户接入时 必须上送 |
| 20. | 商户订单号 | orderId | M | 消费撤销的订单号，由商户生成 |
| 21. | 原始交易流水号 | origQryId | M | 原始消费交易的 queryId |
| 22. | 订单发送时间 | txnTime | M | |
| 23. | 交易金额 | txnAmt | M | 与原消费交易一致 |
| 24. | 终端号 | termId | O | |
| 25. | 请求方保留域 | reqReserved | O | 商户自定义保留域，交易应答时 会原样返回 |
| 26. | 保留域 | reserved | O |
6.3.4 应答报文（同步应答）
| 1. | 版本号 | version | R | |
| 2. | 编码方式 | encoding | R | |
| 3. | 签名 | signature | M | |
| 4. | 签名方法 | signMethod | M | |
| 5. | 交易类型 | txnType | R | |
| 6. | 交易子类 | txnSubType | R | |
| 7. | 产品类型 | bizType | R | |
| 8. | 接入类型 | accessType | R | |
| 9. | 收单机构代码 | acqInsCode | C | 接入类型为收单机构接入时需返 回 |
| 10. | 商户代码 | merId | R | |
| 11. | 商户订单号 | orderId | R |
中国银联
版权所有
Q/CUP071.2.1—2015
39
| 12. | 原始交易流水号 | origQryId | R | 原始消费交易的 queryId |
| 13. | 订单发送时间 | txnTime | R | |
| 14. | 交易金额 | txnAmt | R | |
| 15. | 请求方保留域 | reqReserved | R | |
| 16. | 保留域 | reserved | O | |
| 17. | 银联交易流水号 | queryId | M | 消费撤销交易的交易流水号 供 查询用 |
| 18. | 响应码 | respCode | M | |
| 19. | 应答信息 | respMsg | M | |
| 20. | 签名公钥证书 | signPubKeyCert | C | 使用 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. | 版本号 | version | M | 固定填写 |
| 2. | 编码方式 | encoding | M | 默认取值： UTF-8 |
| 3. | 证书 ID | certId | M | |
| 4. | 签名 | signature | M | 填写对报文摘要的签名 |
中国银联
版权所有
Q/CUP071.2.1—2015
41
| 5. | 签名方法 | signMethod | M | 非对称签名： 01（表示采用 RSA 签名） HASH 表示散列算法 11：支持散列方式验证 SHA-256 12：支持散列方式验证 SM3 |
| 6. | 交易类型 | txnType | M | 取值： 04 |
| 7. | 交易子类 | txnSubType | M | 默认： 00 |
| 8. | 产品类型 | bizType | M | 000201 |
| 9. | 渠道类型 | channelType | M | |
| 10. | 后台通知地址 | backUrl | M | 后台返回商户结果时使用，如上 送，则发送商户后台交易结果通 知，如需通过专线通知，需要在 通知地址前面加上前缀： 专线的 首字母加竖线 ZX| |
| 11. | 接入类型 | accessType | M | 0：普通商户直连接入 1：收单机构接入 2：平台类商 户接入 |
| 12. | 收单机构代码 | acqInsCode | C | 接入类型为收单机构接入时需 上送 |
| 13. | 商户类别 | merCatCode | C | 接入类型为收单机构接入时需 上送 |
| 14. | 商户代码 | merId | M | |
| 15. | 商户名称 | merName | C | 接入类型为收单机构接入时需 上送 |
| 16. | 商户简称 | merAbbr | C | 接入类型为收单机构接入时需 上送 |
| 17. | 二级商户代码 | subMerId | C | 商户类型为平台类商户接入时 必须上送 |
| 18. | 二级商户全称 | subMerName | C | 商户类型为平台类商户接入时 必须上送 |
| 19. | 二级商户简称 | subMerAbbr | C | 商户类型为平台类商户接入时 必须上送 |
| 20. | 商户订单号 | orderId | M | 退货交易的订单号，由商户生成 |
| 21. | 原始交易流水号 | origQryId | M | 原始消费交易的 queryId |
| 22. | 订单发送时间 | txnTime | M | |
| 23. | 交易金额 | txnAmt | M | |
| 24. | 终端号 | termId | O | |
| 25. | 请求方保留域 | reqReserved | O | 商户自定义保留域，交易应答时 会原样返回 |
| 26. | 保留域 | reserved | O | |
| 27. | 分账域 | accSplitData | O | 分账域，用法参见注 13 该域需整体做 Base64 编码。 |
中国银联
版权所有
Q/CUP071.2.1—2015
42
6.4.4 应答报文（同步应答）
| 1. | 版本号 | version | R | |
| 2. | 编码方式 | encoding | R | |
| 3. | 签名 | signature | M | |
| 4. | 签名方法 | signMethod | M | |
| 5. | 交易类型 | txnType | R | 取值： 04 |
| 6. | 交易子类 | txnSubType | R | 默认： 00 |
| 7. | 产品类型 | bizType | R | |
| 8. | 接入类型 | accessType | R | |
| 9. | 收单机构代码 | acqInsCode | C | 接入类型为收单机构接入时需返 回 |
| 10. | 商户代码 | merId | R | |
| 11. | 商户订单号 | orderId | R | |
| 12. | 原始交易流水号 | origQryId | R | 原始消费交易的 queryId |
| 13. | 订单发送时间 | txnTime | R | |
| 14. | 交易金额 | txnAmt | R | |
| 15. | 请求方保留域 | reqReserved | R | |
| 16. | 保留域 | reserved | O | |
| 17. | 银联交易流水号 | queryId | M | 退货交易的交易流水号 供查询 用 |
| 18. | 响应码 | respCode | M | |
| 19. | 应答信息 | respMsg | M | |
| 20. | 签名公钥证书 | signPubKeyCert | C | 使用 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. | 版本号 | version | M | 固定填写 |
| 2. | 编码方式 | encoding | M | 默认取值： UTF-8 |
| 3. | 证书 ID | certId | M | |
| 4. | 签名 | signature | M | 填写对报文摘要的签名 |
| 5. | 签名方法 | signMethod | M | 非对称签名： 01（表示采用 RSA 签名） HASH 表示散列算法 11：支持散列方式验证 SHA-256 12：支持散列方式验证 SM3 |
| 6. | 交易类型 | txnType | M | 交易类型： 00 |
| 7. | 交易子类 | txnSubType | M | 默认： 00 |
| 8. | 产品类型 | bizType | M | 000201 |
| 9. | 接入类型 | accessType | M | 0：普通商户直连接入 1：收单机构接入 |
中国银联
版权所有
Q/CUP071.2.1—2015
45
| 2：平台类商户接入 | ||||
| 10. | 收单机构代码 | acqInsCode | C | 接入类型为收单机构接入时 需上送 |
| 11. | 商户代码 | merId | M | |
| 12. | 订单发送时间 | txnTime | M | |
| 13. | 商户订单号 | orderId | M | |
| 14. | 保留域 | reserved | O |
6.5.4 应答报文
| 1. | 版本号 | version | R | |
| 2. | 签名 | signature | M | |
| 3. | 编码方式 | encoding | R | |
| 4. | 签名方法 | signMethod | M | |
| 5. | 交易类型 | txnType | M | 同被查询交易 |
| 6. | 交易子类 | txnSubType | M | 同被查询交易 |
| 7. | 收单机构代码 | acqInsCode | C | 接入类型为收单机构接入时需 上送 |
| 8. | 接入类型 | accessType | R | |
| 9. | 商户代码 | merId | R | |
| 10. | 订单发送时间 | txnTime | R | 被查询交易的交易时间 |
| 11. | 商户订单号 | orderId | R | 被查询交易的订单号 |
| 12. | 请求方保留域 | reqReserved | O | 返回被查询交易的请求方保留 域 |
| 13. | 保留域 | reserved | O | |
| 14. | 交易查询流水号 | queryId | M | 被查询交易查询流水号 |
| 15. | 系统跟踪号 | traceNo | M | 统一返回 |
| 16. | 交易传输时间 | traceTime | M | 统一返回 |
| 17. | 清算日期 | settleDate | M | 资金类交易统一返回 |
| 18. | 清算币种 | settleCurrencyCode | M | 资金类交易统一返回 |
| 19. | 清算金额 | settleAmt | M | 资金类交易统一返回 |
| 20. | 清算汇率 | exchangeRate | C | 交易成功，交易币种和清算币 种不一致的时候返回 |
| 21. | 兑换日期 | exchangeDate | C | 交易成功，交易币种和清算币 种不一致的时候返回 |
| 22. | 交易币种 | currencyCode | C | |
| 23. | 交易金额 | txnAmt | C | |
| 24. | 原交易应答码 | origRespCode | C | 查询交易成功时返回 |
| 25. | 原交易应答信息 | origRespMsg | C | |
| 26. | 应答码 | respCode | M | |
| 27. | 应答信息 | respMsg | M |
中国银联
版权所有
Q/CUP071.2.1—2015
46
| 28. | 账号 | accNo | C | 根据商户配置返回 |
| 29. | 支付卡类型 | payCardType | C | （消费、预授权） 根据商户配 置返回 |
| 30. | 支付方式 | payType | C | （消费、预授权） 根据商户配 置返回 |
| 31. | 支付卡标识 | payCardNo | C | （移动支付消费） 根据商户配 置返回 |
| 32. | 支付卡名称 | payCardIssueName | C | （移动支付消费） 根据商户配 置返回 |
| 33. | 有卡交易信息域 | cardTransData | C | 有卡交易必填，有卡交易信息 域（组合域，用法详见数据元 说明），返回报文只返回子域： IC 卡数据 ICCardData |
| 34. | 发卡机构识别模式 | issuerIdentifyMode | C | 消费、预授权交易返回 |
| 35. | 委托关系标识号 | bindId | C | 绑定支付时，根据商户配置返 回 |
| 36. | 签名公钥证书 | signPubKeyCert | C | 使用 RSA 签名方式时必选，此 域填写银联签名公钥证书。 |
注：
应答报文中，“应答码”即respCode字段，表示的是查询交易本身的应答，即查询这个动作是否成
功，不代表被查询交易的状态；
若查询动作成功，即应答码为“00“，则根据“原交易应答码”即origRespCode来判断被查询交易
是否成功。此时若origRespCode为00，则表示被查询交易成功。
6.6 银联加密公钥更新查询交易
6.6.1 概述
商户定期（1天1次）向银联全渠道系统发起获取加密公钥信息交易。在加密公钥证书更新期间，全
渠道系统支持新老证书的共同使用，新老证书并行期为1个月。全渠道系统向商户返回最新的加密公钥
证书，由商户服务器替换本地证书。
6.6.2 请求报文
| 1 | 版本号 | version | M | 固定填写 |
| 2 | 编码方式 | encoding | M | 默认取值： UTF-8 |
| 3 | 证书 ID | certId | O | 签名方式 01 需要上送 |
| 4 | 签名 | signature | M | 填写对报文摘要的签名 |
| 5 | 签名方法 | signMethod | M | 取值： 非对称签名： 01（表示采用 RSA 签名） HASH 表示散列算法 11：支持散列方式验证 SHA-256 |
中国银联
版权所有
Q/CUP071.2.1—2015
47
| 12：支持散列方式验证 SM3 | ||||
| 6 | 交易类型 | txnType | M | 取值： 95 |
| 7 | 交易子类 | txnSubType | M | 默认： 00 |
| 8 | 产品类型 | bizType | M | |
| 9 | 渠道类型 | channelType | M | |
| 10 | 证书类型 | certType | M | 01：敏感信息加密公钥 |
| 11 | 接入类型 | accessType | M | 0：普通商户直连接入 1：收单机构接入 2：平台类商户接入 |
| 12 | 收单机构代码 | acqInsCode | C | 接入类型为收单机构接入时需 上送 |
| 13 | 商户代码 | merId | M | |
| 14 | 商户类别 | merCatCode | C | 接入类型为收单机构接入时需 上送 |
| 15 | 商户名称 | merName | C | 接入类型为收单机构接入时需 上送 |
| 16 | 商户简称 | merAbbr | C | 接入类型为收单机构接入时需 上送 |
| 17 | 二级商户代码 | subMerId | C | 商户类型为平台类商户接入时 必须上送 |
| 18 | 二级商户名称 | subMerName | C | 商户类型为平台类商户接入时 必须上送 |
| 19 | 二级商户简称 | subMerAbbr | C | 商户类型为平台类商户接入时 必须上送 |
| 20 | 请求方保留域 | reqReserved | O | 商户自定义保留域，交易应答时 会原样返回 |
| 21 | 保留域 | reserved | O | |
| 22 | 商户订单号 | orderId | M | 商户端生成 |
| 23 | 订单发送时间 | txnTime | M | 商户发送交易时间 |
6.6.3 应答报文
| 1 | 版本号 | version | R | |
| 2 | 签名 | signature | M | |
| 3 | 编码方式 | encoding | R | |
| 4 | 签名方法 | signMethod | M | |
| 5 | 交易类型 | txnType | R | 取值:95 |
| 6 | 交易子类 | txnSubType | R | |
| 7 | 产品类型 | bizType | R | |
| 8 | 接入类型 | accessType | R | |
| 9 | 收单机构代码 | acqInsCode | C | 接入类型为收单机构接入时需 |
中国银联
版权所有
Q/CUP071.2.1—2015
48
| 上送 | ||||
| 10 | 商户代码 | merId | R | |
| 11 | 请求方保留域 | reqReserved | R | |
| 12 | 保留域 | reserved | O | |
| 13 | 签名公钥证书 | signPubKeyCert | O | 使用 RSA 签名方式时必选，此 域填写银联签名公钥证书。 |
| 14 | 加密公钥证书 | encryptPubKeyCert | C | 加密公钥证书 |
| 15 | 应答码 | respCode | M | |
| 16 | 应答信息 | respMsg | M | |
| 17 | 商户订单号 | orderId | R | |
| 18 | 订单发送时间 | txnTime | R | |
| 19 | 证书类型 | certType | R |
6.7 预授权类交易
6.7.1 预授权
6.7.1.1 概述
预授权交易用于受理方向持卡人的发卡方确认交易许可。受理方将预估的消费金额作为预授权金额，
发送给持卡人的发卡方。
6.7.1.2 交易流程
相关交易流程可参考消费类交易。
6.7.1.3 请求报文
报文同消费类交易，交易类型和交易子类取值不同。
| 1. | 版本号 | version | M | 固定填写 |
| 2. | 编码方式 | encoding | M | 默认取值： UTF-8 |
| 3. | 证书 ID | certId | M | |
| 4. | 签名 | signature | M | 填写对报文摘要的签名 |
| 5. | 签名方法 | signMethod | M | 非对称签名： 01（表示采用 RSA 签名） HASH 表示散列算法 11：支持散列方式验证 SHA-256 12：支持散列方式验证 SM3 |
| 6. | 交易类型 | txnType | M | 取值： 02 |
| 7. | 交易子类 | txnSubType | M | 01：预授权 03：担保消费 通过地址区分前台与后台交易 |
| 8. | 产品类型 | bizType | M | 000201 |
| 9. | 渠道类型 | channelType | M | |
| 10. | 后台通知地址 | backUrl | M | 后台返回商户结果时使用，如上 |
中国银联
版权所有
Q/CUP071.2.1—2015
49
| 送，则发送商户后台交易结果通 知，如需通过专线通知，需要在 通知地址前面加上前缀： 专线的 首字母加竖线 ZX| |
||||
| 11. | 接入类型 | accessType | M | 0：普通商户直连接入 1：收单机构接入 2：平台类商户接入 |
| 12. | 收单机构代码 | acqInsCode | C | 接入类型为收单机构接入时需 上送 |
| 13. | 商户类别 | merCatCode | C | 接入类型为收单机构接入时需 上送 |
| 14. | 商户代码 | merId | M | |
| 15. | 商户名称 | merName | C | 接入类型为收单机构接入时需 上送 |
| 16. | 商户简称 | merAbbr | C | 接入类型为收单机构接入时需 上送 |
| 17. | 二级商户代码 | subMerId | C | 商户类型为平台类商户接入时 必须上送 |
| 18. | 二级商户全称 | subMerName | C | 商户类型为平台类商户接入时 必须上送 |
| 19. | 二级商户简称 | subMerAbbr | C | 商户类型为平台类商户接入时 必须上送 |
| 20. | 商户订单号 | orderId | M | 预授权的订单号，由商户生成 |
| 21. | 订单发送时间 | txnTime | M | |
| 22. | 账号类型 | accType | C | 跨行收单且收单机构收集银行 卡信息时上送 01：银行卡 02：存折 03： C 卡 默认取值： 01 取值“03” 表示以 IC 终端发起 的 IC 卡交易， IC 作为普通银行 卡进行支付时，此域填写为“01” |
| 23. | 账号 | accNo | C | 1、 后台类消费交易时上送全 卡号或卡号后 4 位 2、 跨行收单且收单机构收集 银行卡信息时上送、 3、前台类交易可通过配置后返 回，卡号可选上送 |
| 24. | 交易金额 | txnAmt | M | |
| 25. | 交易币种 | currencyCode | M | 默认为 156 |
| 26. | 银行卡验证信息 及身份信息 |
customerInfo | C | 1、后台类消费交易时上送 2、认证支付 2.0，后台交易时可 选 |
中国银联
版权所有
Q/CUP071.2.1—2015
50
| Key=value 格式 （具体填写参考数据元说明） |
||||
| 27. | 终端号 | termId | O | |
| 28. | 请求方保留域 | reqReserved | O | 商户自定义保留域，交易应答时 会原样返回 |
| 29. | 保留域 | reserved | O | |
| 30. | 风险信息域 | riskRateInfo | O | |
| 31. | 加密证书 ID | encryptCertId | C | |
| 32. | 分期付款信息域 | instalTransInfo | C | 分期付款交易，商户端选择分期 信息时，需上送 组合域，填法 见数据元说明 |
| 33. | 发卡机构代码 | issInsCode | O | C 当账号类型为 02-存折时需填写 在前台类交易时填写默认银行 代码，支持直接跳转到网银 商户发卡银行控制 系统应答返回 |
| 34. | 终端信息域 | userMac | O | 移动支付业务需要上送 |
| 35. | 持卡人 IP | customerIp | O | 前台交易，有 IP 防钓鱼要求的 商户上送 |
| 36. | 绑定标识号 | bindId | O | 绑定消费 需做绑定时填写 用 于唯一标识绑定关系 |
| 37. | 支付卡类型 | payCardType | C | 绑定消费 特殊商户交易控制用（如借贷分 离） |
| 38. | 有卡交易信息域 | cardTransData | C | 有卡交易必填，有卡交易信息域 （组合域，用法详见数据元说 明） |
| 39. | 订单描述 | orderDesc | C | 移动支付上送 |
6.7.1.4 应答报文（同步应答）
| 1. | 版本号 | version | R | |
| 2. | 编码方式 | encoding | R | |
| 3. | 签名 | signature | M | |
| 4. | 签名方法 | signMethod | M | |
| 5. | 交易类型 | txnType | R | |
| 6. | 交易子类 | txnSubType | R | |
| 7. | 产品类型 | bizType | R | |
| 8. | 接入类型 | accessType | R | |
| 9. | 收单机构代码 | acqInsCode | C | 接入类型为收单机构接入时需 上送 |
中国银联
版权所有
Q/CUP071.2.1—2015
51
| 10. | 商户代码 | merId | R | |
| 11. | 商户订单号 | orderId | R | |
| 12. | 订单发送时间 | txnTime | R | |
| 13. | 账号 | accNo | C | 根据商户配置返回 |
| 14. | 交易金额 | txnAmt | R | |
| 15. | 交易币种 | currencyCode | M | 默认为 156 |
| 16. | 请求方保留域 | reqReserved | R | |
| 17. | 保留域 | reserved | O | |
| 18. | 交易查询流水号 | queryId | M | 预授权交易的流水号，供后续查 询用 |
| 19. | 响应码 | respCode | M | |
| 20. | 应答信息 | respMsg | M | |
| 21. | 支付卡类型 | payCardType | C | 根据商户配置返回 |
| 22. | 支付方式 | payType | C | 根据商户配置返回 |
| 23. | 银联订单号 | tn | C | 商户推送订单后银联移动支付 系统返回该流水号，商户调用支 付控件时使用 |
| 24. | 签名公钥证书 | signPubKeyCert | C | 使用 RSA 签名方式时必选，此 域填写银联签名公钥证书。 |
6.7.1.5 商户通知（异步应答）
| 1. | 版本号 | version | R | |
| 2. | 编码方式 | encoding | R | |
| 3. | 签名 | signature | M | |
| 4. | 签名方法 | signMethod | M | |
| 5. | 交易类型 | txnType | R | |
| 6. | 交易子类 | txnSubType | R | |
| 7. | 产品类型 | bizType | R | |
| 8. | 接入类型 | accessType | R | |
| 9. | 收单机构代码 | acqInsCode | C | 接入类型为收单机构接入时需 上送 |
| 10. | 商户代码 | merId | R | |
| 11. | 商户订单号 | orderId | R | |
| 12. | 订单发送时间 | txnTime | R | |
| 13. | 交易金额 | txnAmt | R | |
| 14. | 交易币种 | currencyCode | M | 默认为 156 |
| 15. | 请求方保留域 | reqReserved | R | |
| 16. | 保留域 | reserved | O | |
| 17. | 交易查询流水号 | queryId | M | 预授权交易的流水号，供后续查 询用 |
中国银联
版权所有
Q/CUP071.2.1—2015
52
| 18. | 响应码 | respCode | M | |
| 19. | 响应信息 | respMsg | M | |
| 20. | 清算金额 | settleAmt | M | |
| 21. | 清算币种 | settleCurrencyCode | M | |
| 22. | 清算日期 | settleDate | M | |
| 23. | 系统跟踪号 | traceNo | M | |
| 24. | 交易传输时间 | traceTime | M | |
| 25. | 兑换日期 | exchangeDate | C | 交易成功，交易币种和清算币种 不一致的时候返回 |
| 26. | 汇率 | exchangeRate | C | 交易成功，交易币种和清算币种 不一致的时候返回 |
| 27. | 账号 | accNo | C | 根据商户配置返回 |
| 28. | 支付卡类型 | payCardType | C | 根据商户配置返回 |
| 29. | 支付方式 | payType | C | 根据商户配置返回 |
| 30. | 有卡交易信息域 | cardTransData | C | 有卡交易必填，有卡交易信息域 （组合域，用法详见数据元说 明），返回报文只返回子域： IC 卡数据 ICCardData |
| 31. | 支付卡标识 | payCardNo | C | 移动支付交易时，根据商户配置 返回 |
| 32. | 支付卡名称 | payCardIssueName | C | 移动支付交易时，根据商户配置 返回 |
| 33. | 绑定标识号 | bindId | R | 绑定支付时，根据商户配置返回 |
| 34. | 签名公钥证书 | signPubKeyCert | C | 使用 RSA 签名方式时必选，此 域填写银联签名公钥证书。 |
6.7.2 预授权撤销
6.7.2.1 概述
对已成功的POS预授权交易，在结算前使用预授权撤销交易，通知发卡方取消付款承诺。预授权撤
销交易必须是对原始预授权交易或追加预授权交易最终承兑金额的全额撤销。
6.7.2.2 交易流程
相关交易流程可参考消费撤销类交易。
6.7.2.3 请求报文
同消费撤销类交易，交易类型取值不同。
| 1. | 版本号 | version | M | 固定填写 |
| 2. | 编码方式 | encoding | M | 默认取值： UTF-8 |
| 3. | 证书 ID | certId | M | |
| 4. | 签名 | signature | M | 填写对报文摘要的签名 |
| 5. | 签名方法 | signMethod | M | 非对称签名： |
中国银联
版权所有
Q/CUP071.2.1—2015
53
| 01（表示采用 RSA 签名） HASH 表示散列算法 11：支持散列方式验证 SHA-256 12：支持散列方式验证 SM3 |
||||
| 6. | 交易类型 | txnType | M | 取值： 32 |
| 7. | 交易子类 | txnSubType | M | 默认： 00 |
| 8. | 产品类型 | bizType | M | 000201 |
| 9. | 渠道类型 | channelType | M | |
| 10. | 后台通知地址 | backUrl | M | 后台返回商户结果时使用，如上 送，则发送商户后台交易结果通 知，如需通过专线通知，需要在 通知地址前面加上前缀： 专线的 首字母加竖线 ZX| |
| 11. | 接入类型 | accessType | M | 0：普通商户直连接入 1：收单机构接入 2：平台类商户接入 |
| 12. | 收单机构代码 | acqInsCode | C | 接入类型为收单机构接入时需 上送 |
| 13. | 商户类别 | merCatCode | C | 接入类型为收单机构接入时需 上送 |
| 14. | 商户代码 | merId | M | |
| 15. | 商户名称 | merName | C | 接入类型为收单机构接入时需 上送 |
| 16. | 商户简称 | merAbbr | C | 接入类型为收单机构接入时需 上送 |
| 17. | 二级商户代码 | subMerId | C | 商户类型为平台类商户接入时 必须上送 |
| 18. | 二级商户全称 | subMerName | C | 商户类型为平台类商户接入时 必须上送 |
| 19. | 二级商户简称 | subMerAbbr | C | 商户类型为平台类商户接入时 必须上送 |
| 20. | 商户订单号 | orderId | M | 预授权撤销的订单号，由商户生 成 |
| 21. | 原始交易流水号 | origQryId | M | 原始预授权交易的 queryId |
| 22. | 订单发送时间 | txnTime | M | |
| 23. | 交易金额 | txnAmt | M | 与原始预授权交易一致 |
| 24. | 终端号 | termId | O | |
| 25. | 请求方保留域 | reqReserved | O | 商户自定义保留域，交易应答时 会原样返回 |
| 26. | 保留域 | reserved | O |
6.7.2.4 应答报文（同步应答）
中国银联
版权所有
Q/CUP071.2.1—2015
54
同消费撤销类交易同步应答报文。
| 1. | 版本号 | version | R | |
| 2. | 编码方式 | encoding | R | |
| 3. | 签名 | signature | M | |
| 4. | 签名方法 | signMethod | M | |
| 5. | 交易类型 | txnType | R | |
| 6. | 交易子类 | txnSubType | R | |
| 7. | 产品类型 | bizType | R | |
| 8. | 接入类型 | accessType | R | |
| 9. | 收单机构代码 | acqInsCode | C | 接入类型为收单机构接入时需上 送 |
| 10. | 商户代码 | merId | R | |
| 11. | 商户订单号 | orderId | R | |
| 12. | 原始交易流水号 | origQryId | R | 原始预授权交易的 queryId |
| 13. | 订单发送时间 | txnTime | R | |
| 14. | 交易金额 | txnAmt | R | |
| 15. | 请求方保留域 | reqReserved | R | |
| 16. | 保留域 | reserved | O | |
| 17. | 银联交易流水号 | queryId | M | 预授权撤销交易的交易流水号 供查询用 |
| 18. | 响应码 | respCode | M | |
| 19. | 应答信息 | respMsg | M | |
| 20. | 签名公钥证书 | signPubKeyCert | C | 使用 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. | 版本号 | version | M | 固定填写 |
| 2. | 编码方式 | encoding | M | 默认取值： UTF-8 |
| 3. | 证书 ID | certId | M | |
| 4. | 签名 | signature | M | 填写对报文摘要的签名 |
| 5. | 签名方法 | signMethod | M | 非对称签名： 01（表示采用 RSA 签名） HASH 表示散列算法 11：支持散列方式验证 SHA-256 12：支持散列方式验证 SM3 |
| 6. | 交易类型 | txnType | M | 取值： 03 |
| 7. | 交易子类 | txnSubType | M | 默认： 00 |
| 8. | 产品类型 | bizType | M | 000201 |
| 9. | 渠道类型 | channelType | M |
中国银联
版权所有
Q/CUP071.2.1—2015
56
| 10. | 后台通知地址 | backUrl | M | 后台返回商户结果时使用，如上 送，则发送商户后台交易结果通 知，如需通过专线通知，需要在 通知地址前面加上前缀： 专线的 首字母加竖线 ZX| |
| 11. | 接入类型 | accessType | M | 0：普通商户直连接入 1：收单机构接入 2：平台类商户接入 |
| 12. | 收单机构代码 | acqInsCode | C | 接入类型为收单机构接入时需 上送 |
| 13. | 商户类别 | merCatCode | C | 接入类型为收单机构接入时需 上送 |
| 14. | 商户代码 | merId | M | |
| 15. | 商户名称 | merName | C | 接入类型为收单机构接入时需 上送 |
| 16. | 商户简称 | merAbbr | C | 接入类型为收单机构接入时需 上送 |
| 17. | 二级商户代码 | subMerId | C | 商户类型为平台类商户接入时 必须上送 |
| 18. | 二级商户全称 | subMerName | C | 商户类型为平台类商户接入时 必须上送 |
| 19. | 二级商户简称 | subMerAbbr | C | 商户类型为平台类商户接入时 必须上送 |
| 20. | 商户订单号 | orderId | M | 预授权完成的订单号，由商户生 成 |
| 21. | 原始交易流水号 | origQryId | M | 原始预授权交易的 queryId |
| 22. | 订单发送时间 | txnTime | M | |
| 23. | 交易金额 | txnAmt | M | |
| 24. | 终端号 | termId | O | |
| 25. | 请求方保留域 | reqReserved | O | 商户自定义保留域，交易应答时 会原样返回 |
| 26. | 保留域 | reserved | O |
6.7.3.4 应答报文（同步应答）
同消费撤销类交易同步应答报文。
| 1. | 版本号 | version | R |
| 2. | 编码方式 | encoding | R |
| 3. | 签名 | signature | M |
| 4. | 签名方法 | signMethod | M |
| 5. | 交易类型 | txnType | R |
| 6. | 交易子类 | txnSubType | R |
中国银联
版权所有
Q/CUP071.2.1—2015
57
| 7. | 产品类型 | bizType | R | |
| 8. | 接入类型 | accessType | R | |
| 9. | 收单机构代码 | acqInsCode | C | 接入类型为收单机构接入时需上 送 |
| 10. | 商户代码 | merId | R | |
| 11. | 商户订单号 | orderId | R | |
| 12. | 原始交易流水号 | origQryId | R | 原始预授权交易的 queryId |
| 13. | 订单发送时间 | txnTime | R | |
| 14. | 交易金额 | txnAmt | R | |
| 15. | 请求方保留域 | reqReserved | R | |
| 16. | 保留域 | reserved | O | |
| 17. | 银联交易流水号 | queryId | M | 预授权完成交易的交易流水号 供查询用 |
| 18. | 响应码 | respCode | M | |
| 19. | 应答信息 | respMsg | M | |
| 20. | 签名公钥证书 | signPubKeyCert | C | 使用 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. | 版本号 | version | M | 固定填写 |
| 2. | 编码方式 | encoding | M | 默认取值： UTF-8 |
| 3. | 证书 ID | certId | M | |
| 4. | 签名 | signature | M | 填写对报文摘要的签名 |
| 5. | 签名方法 | signMethod | M | 非对称签名： 01（表示采用 RSA 签名） HASH 表示散列算法 11：支持散列方式验证 SHA-256 12：支持散列方式验证 SM3 |
| 6. | 交易类型 | txnType | M | 取值： 33 |
| 7. | 交易子类 | txnSubType | M | 默认： 00 |
| 8. | 产品类型 | bizType | M | 000201 |
| 9. | 渠道类型 | channelType | M | |
| 10. | 后台通知地址 | backUrl | M | 后台返回商户结果时使用，如上 送，则发送商户后台交易结果通 知，如需通过专线通知，需要在 通知地址前面加上前缀： 专线的 首字母加竖线 ZX| |
| 11. | 接入类型 | accessType | M | 0：普通商户直连接入 |
中国银联
版权所有
Q/CUP071.2.1—2015
59
| 1：收单机构接入 2：平台类商户接入 |
||||
| 12. | 收单机构代码 | acqInsCode | C | 接入类型为收单机构接入时需 上送 |
| 13. | 商户类别 | merCatCode | C | 接入类型为收单机构接入时需 上送 |
| 14. | 商户代码 | merId | M | |
| 15. | 商户名称 | merName | C | 接入类型为收单机构接入时需 上送 |
| 16. | 商户简称 | merAbbr | C | 接入类型为收单机构接入时需 上送 |
| 17. | 二级商户代码 | subMerId | C | 商户类型为平台类商户接入时 必须上送 |
| 18. | 二级商户全称 | subMerName | C | 商户类型为平台类商户接入时 必须上送 |
| 19. | 二级商户简称 | subMerAbbr | C | 商户类型为平台类商户接入时 必须上送 |
| 20. | 商户订单号 | orderId | M | 预授权完成撤销的订单号，由商 户生成 |
| 21. | 原始交易流水号 | origQryId | M | 原始预授权完成交易的 queryId |
| 22. | 订单发送时间 | txnTime | M | |
| 23. | 交易金额 | txnAmt | M | 与原始预授权完成交易一致 |
| 24. | 终端号 | termId | O | |
| 25. | 请求方保留域 | reqReserved | O | 商户自定义保留域，交易应答时 会原样返回 |
| 26. | 保留域 | reserved | O |
6.7.4.4 应答报文（同步应答）
同消费撤销类交易同步应答报文。
| 1. | 版本号 | version | R | |
| 2. | 编码方式 | encoding | R | |
| 3. | 签名 | signature | M | |
| 4. | 签名方法 | signMethod | M | |
| 5. | 交易类型 | txnType | R | |
| 6. | 交易子类 | txnSubType | R | |
| 7. | 产品类型 | bizType | R | |
| 8. | 接入类型 | accessType | R | |
| 9. | 收单机构代码 | acqInsCode | C | 接入类型为收单机构接入时需上 送 |
| 10. | 商户代码 | merId | R | |
| 11. | 商户订单号 | orderId | R |
中国银联
版权所有
Q/CUP071.2.1—2015
60
| 12. | 原始交易流水号 | origQryId | R | 原始预授权完成交易的 queryId |
| 13. | 订单发送时间 | txnTime | R | |
| 14. | 交易金额 | txnAmt | R | |
| 15. | 请求方保留域 | reqReserved | R | |
| 16. | 保留域 | reserved | O | |
| 17. | 银联交易流水号 | queryId | M | 预授权完成撤销交易的交易流水 号， 供查询用 |
| 18. | 响应码 | respCode | M | |
| 19. | 应答信息 | respMsg | M | |
| 20. | 签名公钥证书 | signPubKeyCert | C | 使用 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).zip | 00 |
| CUPMBCC_Remittance_Daily_Report_日期(YYYYMMDD).csv | 81 |
| CUPMBCC_Settlement_Daily_Report_日期(YYYYMMDD).csv | 82 |
| CUPMBCC_Settlement_Monthly_Report_月份(YYYYMM)01.csv | 83 |
| CUPMBCC_Chargeback_Daily_Report_日期(YYYYMMDD).csv | 84 |
| 收单机构号（8 位） _商户号(15 位)_out.tar.gz | 85 |
| CUPS_商户号（15 位） _清算日期(YYYYMMDD) | 87 |
| MC 商户号(后 8 位)清算日期(YYMMDD)_GRP | 88 |
| MC 商户号(后 8 位)清算日期(YYMMDD) | 89 |
| MC 商户号(后 8 位)清算日期(YYMMDD)_GNETE | 90 |
| WKDS 商户号（15 位）清算日期（YYMMDD） | 91 |
| SETTLE_M0000141_$$$$$$$$ | 94 |
| BOC_Bank_Statement_Data_********.csv | 95 |
7.2 文件传输类交易接口
中国银联
版权所有
Q/CUP071.2.1—2015
62
7.2.1 交易流程
商户需开发“文件传输类交易”接口获取对账文件。相关交易流程如下：
商户 银联全渠道系统
1.商户将文件发送给银联全渠道系统
3.全渠道将文件处理结果返回给商户
2.全渠道处理文件请求
图 5 文件传输交易
交易步骤：
1、 商户发起文件传输类交易；
2、 银联全渠道系统完成文件交易处理；
3、 全渠道系统将文件的处理结果返回给商户。
7.2.2 请求报文
| 1. | 版本号 | version | M | 固定填写 |
| 2. | 编码方式 | encoding | M | 默认取值： UTF-8 |
| 3. | 证书 ID | certId | M | |
| 4. | 签名 | signature | M | 填写对报文摘要的签名 |
| 5. | 签名方法 | signMethod | M | 非对称签名： 01（表示采用 RSA 签名） HASH 表示散列算法 11：支持散列方式验证 SHA-256 12：支持散列方式验证 SM3 |
| 6. | 交易类型 | txnType | M | 取值： 76 |
| 7. | 交易子类 | txnSubType | M | 01：对账文件下载 |
| 8. | 产品类型 | bizType | M | 000000 |
| 9. | 接入类型 | accessType | M | 0：普通商户直连接入 |
| 10. | 商户代码 | merId | M | |
| 11. | 收单机构代码 | acqInsCode | C | 接入类型为收单机构接入时需 上送 |
| 12. | 清算日期 | settleDate | M | |
| 13. | 订单发送时间 | txnTime | M | |
| 14. | 文件类型 | fileType | M | 依据实际业务情况定义 参考 7.1：商户索取的文件类型 约定 |
| 15. | 请求方保留域 | reqReserved | O | 商户自定义保留域，交易应答时 |
中国银联
版权所有
Q/CUP071.2.1—2015
63
| 会原样返回 |
7.2.3 应答报文
| 1. | 版本号 | version | R | |
| 2. | 证书 ID | certId | M | |
| 3. | 签名 | signature | M | |
| 4. | 编码方式 | encoding | R | |
| 5. | 签名方法 | signMethod | M | |
| 6. | 交易类型 | txnType | R | 取值： 76 |
| 7. | 交易子类 | txnSubType | R | 01：对账文件下载 |
| 8. | 产品类型 | bizType | R | |
| 9. | 接入类型 | accessType | R | |
| 10. | 商户代码 | merId | R | |
| 11. | 收单机构代码 | acqInsCode | C | |
| 12. | 清算日期 | settleDate | R | |
| 13. | 订单发送时间 | txnTime | R | |
| 14. | 文件类型 | fileType | R | |
| 15. | 文件名 | fileName | M | |
| 16. | 文件内容 | fileContent | M | 文件流方式 |
| 17. | 请求方保留域 | reqReserved | R | |
| 18. | 应答码 | respCode | M | |
| 19. | 应答信息 | respMsg | M |
7.3 对账文件格式
请参考《全渠道平台接入接口规范 第三部分 文件接口》
8 批量文件
请参考《全渠道平台接入接口规范 第三部分 文件接口》
9 附录
请参考《全渠道平台接入接口规范 第五部分 附录》
中国银联
版权所有