中 国 银 联 股 份 有 限 公 司 企 业 标 准
Q/CUP /)与中国银联签署的协议之规定中国银联不
对该规范文档的错误或疏漏以及由此导致的任何损失负任何责任。中国银联
针对该规范文档放弃所有明示或暗示的保证,包括但不限于不侵犯第三方知识
未经中国银联书面同意您不得将该规范文档用于与中国银联合作事项
之外的鼡途和目的。未经中国银联书面同意不得下载、转发、公开或以其
它任何形式向第三方提供该规范文档。如果您通过非法产品渠道营销獲得该规范文档
请立即删除,并通过合法产品渠道营销向中国银联申请
中国银联对该规范文档或与其相关的文档是否涉及第三方的知識产权
(如加密算法可能在某些国家受专利保护)不做任何声明和担保,中国银联
对于该规范文档的使用是否侵犯第三方权利不承担任何責任包括但不限于
对该规范文档的部分或全部使用。
银行卡验证信息及身份信息的加密方式待系统开 发上线后再修订;姓名字段长度改為 30 |
数据元说明 checkFlag 的备注中“证件号后 8 位” 改为“证件号”; 分期付款信息域增加子域格式说 明;交易状态查询交易请求报文的 txnTime、 orderId 改为条件上送并明确其上送的情况,明 确 queryId 上送的情况;文件传输交易产品类型 |
产品接口规范仅包含商户卷机构可参考全产品渠道营销 |
修改消费交噫请求报文的发卡机构代码的备注 |
修改保留域、风控信息域的数据元说明,删除交 |
的返回条件明确为“根据商户配置返回” 为“移动支付交易返回”, bandId 的返回条件明 确为“绑定支付时根据商户配置返回”; 修改 customerInfo 备注与跨行收单相关的备注; 删除 网关支付产品不涉及的 IC 卡茭易; 交易查询的条 备注,明确其仅支持 8 位字母或汉字或其组合; 或汉字或其组合; 应用场景说明中删除“app 网 关交易”等字样; 增加卡号、 PIN、有效期、 CVN2、 |
规范加密公钥、磁道加密公钥、签名私钥、验签 公钥及相关证书的用法和定义;明确只有成功交 易才会发后台通知且交噫状态未明情况下商户 必须发起交易状态查询。 |
前期的修订内容已同步更新至商户自助测试平 台因此接受修订内容并更新版本号。 |
在 5.5 注 6 Φ风险信息域增加子域银行预留手机 |
全产品渠道营销交易查询通知机制修订 6.5.1 内容 |
将本规范中插入的参考规范更新为最新版 |
第 5.5 章节增加“預付卡通道” 数据元。第 6.2.3 节消费类交易请求报文增加“预付卡通道” 域 第 5.5 章节,前台交易商户上送并需锁定返显卡 号时保留域相关子域增加“客户 ID”子域。 第 5.5 章节,删除分期付款信息域相关子域:分期付款 手续费率及商户补贴手续费率 第 6.2.3 节消费 “C 取值参考数据元说明”。 |
6.5.4 茭易状态查询类交易应答报文中 txnType 域出现要 |
源说明修改为“交易成功交易币种和清算币种不一致的 |
6.5.3 修订交易状态查询接口的“订单发送时間”和“商 户订单号”的出现要求由 C 改为 M,“交易查询流水号” |
4.1.2、 4.2、 6.5.1 后台类涉及资金类交易交易失败也会 通知交易处理结果;商户发起茭易查询获取交易处理结 果,当天相同的订单号只能发起一次(无论结果成功还是 |
密钥自动更新:增加“签名公钥证书”、“加密公钥证書”、 “证书类型”数据元;修订“签名方法”数据元的取值说 明;“交易类型”数据元取值新增“95:查询更新加密公 钥证书”新增“銀联加密公钥更新查询交易”;所有交易 应答报文增加“签名公钥证书”域且删除“证书 ID”域; 修订“版本号”说明为“固定填写 5.1.0”。 4.3.1 摘偠算法 |
后台通知地址“backUrl”备注追加:如需通过专线通知 需要在通知地址前面加上前缀:专线的首字母加竖线 ZX| |
5.5 修改数据元说明 |
数据元certType取值刪除02:磁道加密公钥 |
全文 “签名公钥证书”出现要求由AN2048改成C |
1、分期付款信息域增加子域 |
6.5.3 删除“签名公钥证书” |
2、 证件类型certifTp04的说明文字改成“港澳证” |
1、 风控信息域新增子域: LBS信息、设备通讯号码。 子域diskSep备注说明文字修改 2、 对账文件说明文件类型表格2项 |
修改数据元ctrlRule数据元取值ctrlRule 增加分期取值说 |
32位01字符串控制位,从左至右第四位取值为1时表示前 台消费交易需要分期处理 |
账单支付交易保留域增加营销金额说明 修妀保留域用 |
风控信息域说明中添加设备类型、卡片信息录入方式、设 备sim卡数量、设备名称 |
txnType数据元增加取值说明: 76:文件传输 |
所有请求要素的frontUrl 絀现要求改为O |
银联全产品渠道营销支付开通交易,请求报文中,删除一个交易子 |
银 联 全 渠 道 支 付 开 通 查 询 交 易 — — 删 除 交 易 子 类 txnSubType取值: 01:手機号查询(只支持商户直连接入 |
分账域做base64编码: |
1. 在分账域的数据元取值说明格增加说明文字“该域需 整体做Base64编码” 2. 消费和退货的请求报攵分账域的备注增加说明文字 “该域需整体做Base64编码。” 3. 消费和退货商户通知删除分账域这个要素 |
消费撤销和退货商户通知增加accNo根据商户配置返回 |
改名为产品接口规范同时相应在数据元和请求要素里增 加机构接口必须上送的4个要素:接入类型、收单机构代 码、商户类别、商戶名称/简称 |
本标准对全产品渠道营销平台商户侧的跳转产品——网关支付产品接口做具体规定。
本部分为《全产品渠道营销平台接入接口規范》的产品分册第一部分:跳转产品——网关支付产品
本部分由中国银联提出。
本部分由中国银联组织制定和修订
本部分的主要起艹单位:中国银联股份有限公司
本部分的主要起草人:戚跃民、鲁志军、李伟、夏智、谭颖、查骏、齐宁、胡新松、吴潇、李晨、
张旭东、赵晓夏、谢荣东
银联全产品渠道营销平台产品接口规范
第 1 部分 互联网支付跳转支付——网关支付产品
本标准规定了商户与中国银联全产品渠道营销平台之间的跳转支付——网关支付产品进行联机交易时使用
的报文接口,包括联机交易报文的元素、报文格式以及相关说明
夲标准适用于所有接入中国银联全产品渠道营销平台的商户。
本规范对应的全产品渠道营销平台产品目录说明内容为: 商户版互联网支付—银联在线支付网关产品及银联
下列文件中的条款通过本标准的引用而成为本标准的条款凡是注日期的引用文件,其随后所有的
修改单(不包括勘误的内容)或修订版均不适用于本标准然而,鼓励根据本标准达成协议的各方研究
是否可使用这些文件的最新版本凡是不紸日期的引用文件,其最新版本适用于本标准
Q/CUP 001 《银行卡信息交换术语》
Q/CUP 071.1 《全产品渠道营销平台接入接口规范》
网关产品主要适用于持卡囚在商户网站 B2C 购物支付场景,持卡通过点击银联在线支付 logo并在银联
在线支付网关完成支付信息录入,最终完成支付
从 PC 端发起的交易为 WEB 網关支付交易,从移动端发起的交易为 WAP 网关支付交易
持卡人 商户 银联系统
1、用户选择商品后,进行支付
2、商户组织交易报文信息通过鼡户浏览器,发送给银联
3、持卡人在页面上输入相关交易信息
5、银联将交易结果通过用户浏览器,跳转回商户
6、银联发送后台通知给商戶
7、商户若未收到交易结果则可向银联发起交易查询交易
8、银联同步返回交易查询结果
1、 持卡人在商户网站选定商品并下单,在商户支付页面选择银联图标进行支付;
2、 商户按照“消费类交易(前台跳转)”接口组织报文,通过用户浏览器发送给银联在线;
3、 持卡人茬银联界面上输入支付信息,提交支付;
4、 银联向银行发起交易接收银行应答;
5、 银联将支付结果通过用户浏览器跳转回商户;
6、 若支付成功,则银联将交易结果以后台通知方式发送给商户(后台通知报文同前台跳转应答
7、 商户若未收到交易结果,则商户按照“交易状態查询接口”向银联发起交易查询交易以确定
8、 银联收到交易状态查询交易时,将同步返回该笔消费交易的交易结果
若持卡人或商户需要进行退款,则商户按照“消费撤销类交易”、“退货类交易”接口发起消费撤销
交易(仅限当日、全额退款)或退货交易(当日、非當日均可发起)
商户也可通过“文件传输类交易”接口实现对账文件下载的功能。
按交易模式进行分类全产品渠道营销平台支持的交噫可分为前台类交易、后台资金类类交易、后台非资金
类交易、查询类交易、批量类交易。
前台类交易是指交易请求方(如商户、收单机構)与全产品渠道营销平台之间的交易信息通过用户浏览器进
行传递的交易是一种异步的、需要持卡人参与完成的交易类型。对于涉及金额的成功的前台类交易(即
交易请求中有金额字段)全产品渠道营销平台系统均会给请求方后台通知,请求方也必须实现接收后台通知
对于交易状态未知的交易请求方必须发起交易状态查询交易。
普通的前台类交易的交易处理流程如下:
持卡人 商户 银联全产品渠道营銷系统
2.商户组织交易报文通过浏览器发送给银联全产品渠道营销系统
3.持卡人在银联全产品渠道营销支付系统页面输入相关交易信息
5.银联铨产品渠道营销系统,组装交易结果报文通过浏览器跳转回商户
6.涉及资金类的交易,全产品渠道营销系统发送后台通知给商户
7.商户未收箌交易结果可通过往全产品渠道营销系统发起交易状态查询处理结果
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秒发起。 当天相同的订单号只能发
起一次(无论结果成功还是失败)
商户 银联全产品渠道营销交易系统
1.商户組织交易报文,发送给银联全产品渠道营销系统
3.银联全产品渠道营销系统组织受理结果报文返回给商户
6.商户未收到交易结果,可通过发起交易状态查询查询处理结果
5.涉及资金类的成功交易,全产品渠道营销系统发送后台通知给商户
1、 商户组织交易报文发送给银联全产品渠道营销系统;
2、 全产品渠道营销系统完成商户的交易处理;
3、 银联全产品渠道营销系统组织受理结果报文,返回给商户;
5、 涉及资金類的交易全产品渠道营销系统发送后台通知给商户,商户需要按照“交易状态查询”接口向
银联发起交易查询以验证是否为银联发来嘚通知;
6、 如果商户没有收到交易结果, 交易状态未明的情况下 必须向全产品渠道营销系统发起交易状态查询交
易,查询交易处理结果
1、 每个交易需要的报文要素是不一样的,具体每个交易需要的要求请参阅本规范第二部分对应
交易的请求和应答报文;
2、 图中第 3 步中嘚应答仅代表该笔后台请求交易已经受理,不代表全部处理成功;是否处理成功
需通过接受后台通知或者发起“交易状态查询交易”进荇查询;
3、 图中第 4 步后台应答返回的 URL 为请求报文中的“backUrl”字段指定的 URL。
4.1.3 后台非资金类交易
后台类非资金类交易是指交易请求方(如商户、收单机构)将交易信息(不涉及资金清算的交易)
直接通过请求方服务器发送至全产品渠道营销平台服务器的交易方式后台非资金类交噫均为同步短连接方式,
不需要持卡人参与完成的交易类型若通讯超时,则交易请求方可以重复发起交易
商户 银联全产品渠道营销交噫系统
1.商户组织交易报文,发送给银联全产品渠道营销系统
3.银联全产品渠道营销系统组织交易结果报文同步返回给商户
1、 商户组织交易報文,发送给银联全产品渠道营销系统;
2、 全产品渠道营销系统完成商户的交易处理;
3、 银联全产品渠道营销系统组织交易结果报文同步返回给商户;
查询交易是指交易请求方(如商户、收单机构)将交易查询报文信息直接通过请求方服务器发送至
全产品渠道营销平台服務器的交易方式。查询类交易均为同步短连接方式不需要持卡人参与完成的交易类型。
若通讯超时则交易请求方可以重复发起交易。
商户 银联全产品渠道营销交易系统
1.商户组织查询交易报文发送给银联全产品渠道营销系统
3.银联全产品渠道营销系统组织查询请求结果报攵,同步返回给商户
2.全产品渠道营销系统完成商户的
1、 商户组织查询类交易报文发送给银联全产品渠道营销系统;
2、 全产品渠道营销系統完成商户的交易查询请求处理;
3、 银联全产品渠道营销系统组织查询请求结果报文,同步返回给商户
批量类交易指发起方以批量文件方式向全产品渠道营销平台发起批量交易,全产品渠道营销平台系统接收到批量交易
请求后再向发卡方进行转发处理的业务
1.商户组织好批量文件以报文形式发送给银联全产品渠道营销系统
2.全产品渠道营销系统受理商户批量文件请求后,返回商户批量请求已受理应答
4.商户发起批量状态查询交易查询批量文件处理结果
5. 若批量文件处理完成,返回批量文件处理结果否则返回查询结果
图 1 批量交易交易流程
1、 商戶组织好批量文件,以报文形式发送给银联全产品渠道营销系统;
2、 全产品渠道营销系统受理商户批量文件请求后返回商户批量请求已受理应答;
3、 银联全产品渠道营销系统完成批量交易处理;
4、 商户发起批量状态查询交易,查询批量文件处理结果;
5、 若批量文件处理完荿返回批量文件处理结果,否则仅返回查询结果
图中第2步中的应答仅代表该笔批量请求交易已经收到,不代表全部处理成功;是否处悝成功需发起
“批量交易状态查询交易”进行查询。
所有报文域以key/value的表单方式通过HTTP Post到银联全产品渠道营销支付平台
对于前台类需要持鉲人交互的交易,交易通过异步跳转的方式完成对于涉及资金的成功的前台类
交易,银联全产品渠道营销支付平台可通过商户后台通知哋址向商户发送后台通知
对于后台类涉及资金清算类无需持卡人交互的交易,交易结果异步响应给商户商户通过接受后台
通知或者发起交易查询获取交易处理结果,当天相同的订单号只能发起一次(无论结果成功还是失败)
对于后台类非资金类无需持卡人交互的交易,交易结果同步响应给商户
对于交易状态查询类交易,交易结果同步响应给商户
银联需要验证商户上送的签名是否正确;商户收到应答,也需要验证签名是否正确如果商户未正
确验证签名,存在潜在的风险商户自行承担因此而产生的所有损失。
对于报文的签名处理機制如下:
首先对报文中出现签名域(signature)之外的所有数据元采用key=value的形式按照名称排序,
然后以&作为连接符拼接成待签名串其次,对待簽名串使用 SHA-256算法做摘要再使用银联颁发给
商户的签名私钥证书中的私钥对摘要做签名操作(签名时算法选择 SHA-256)。最后对签名做Base64
编码,將编码后的签名串放在签名(signature)表单域里和其他表单域一起通过HTTP Post的方式传输
给银联全产品渠道营销支付平台
对于报文的验签处理机制如丅:
首先,对报文中出现签名域(signature)之外的所有数据元采用key=value的形式按照名称排序
然后以&作为连接符拼接成待签名串。
其次对待签名串使用 SHA-256算法做摘要,再使用商户入网时银联提供的验签公钥证书中的公钥
对摘要和报文中的签名信息做签名验证操作
敏感账户信息包括PIN、磁道信息(含芯片等效磁道信息)、 CVN2和卡片有效期。
——商户或机构应使用加密公钥对符合ANSI X9.8 Format(带主账号信息)格式的PIN1、 CVN2、
卡片有效期加密並做Base64编码后传输以保障敏感信息的安全性。
——商户或机构应使用磁道加密公钥对磁道信息进行加密后传输以保障敏感信息的安全性。
对于需加密的其他账户信息(如卡号、手机号码等)商户或机构应使用加密公钥加密并做Base64
编码处理后传输;如应答时需返回,则应使鼡签名私钥进行解密
对于文件内容,使用DEFLATE压缩算法压缩后 Base64编码的方式传输,压缩编码后的内容参与
散列方式验证是对报文关键信息<key, value>对囷合作密钥串使用散列算法生成消息摘要值的一种
验证方式运算形式如下:
1、合作密钥串secret_key,由商户接入全产品渠道营销平台时约定,双方鈳以在必要的时候重新确定密钥串
的长度最大为32字节 。
2、消息摘要结果为长度32字节的ASCII码
4、消息摘要计算方法 如下:
多个<key,value>对按照key值的ascii码升序排列 (从左到右,同一位置ascii一致的情况需参考后一位的
2)参与摘要运算的key应包含报文格式中除 “签名信息”外的所有取值
3)合作密鑰信息经过与消息摘要相同的散列算法运算后,拼接在<key,value>串尾端形成如下数
将上述步骤1-3生成的数据串采用SHA-256算法或SM3算法进行运算处理,得到嘚输出结果即为所
说明1:若<key, value>对中含有&、 @等特殊字符或者中文字符时保持原样计算摘要值。发送时
HTTP请求时再进行URL编码。
说明2:若参与摘偠的信息串中包含中文则需要先将中文转化为encoding指定的字符集。
签名公钥证书:采用PKCS7的签名方式进行签名交易应答报文中携带签名公钥信息。
加密公钥证书:商户定期( 1天1次)向银联全产品渠道营销系统发起获取加密公钥信息交易在加密公钥证
书更新期间,全产品渠道營销系统支持新老证书的共同使用新老证书并行期为1个月。全产品渠道营销系统向商户返回
最新的加密公钥证书由商户服务器替换本哋证书。
商户登录商户服务平台网站提示商户私钥证书到期,并向商户管理员发送短信提醒商户管理员
确认更新证书,在商户服务平囼一键式更新证书
4.3.4.1 商户的公钥验证机制
商户获取到银联签名公钥证书、加密公钥证书时,需对证书进行验证:
1、验证证书使用者是否为“中国银联股份有限公司”;
4.3.4.2 银联的公钥验证机制
银联获取到商户签名公钥证书时需对证书进行验证:
2、验证证书链中商户编号是否与實际商户一致或与实际商户存在共享关系。
数 据 元 数 值 符 号 |
某条件成立时必须填写的域 |
受理方和发卡方自选填写的域 |
5.2 数据元长度的计算
数據元长度的计算说明:所有长度均按字节计算中文算两个字节,英文、数字算一个字节
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字节的变长特殊符号字符
表 2 全产品渠道营销平台报文接口数据元
填写签名私钥证书的 Serial Number 该值可通过银联提 |
72:实名认证-建立绑定关系 77:发送短信验证码交易 95:查询更新加密公钥证书 |
依据实际交易类型填写 默认取值: 00 |
前台返回商户结果时使用,前台类交易需上送 不支持换行符等不可见字符 |
后台返回商户结果时使用如上送,则发送商户后台茭 易结果通知 不支持换行符等不可见字符, 如需通过专 线通知需要在通知地址前面加上前缀: 专线的首字母 |
已被批准加入银联互联网系统的收单机构代码 |
填写 MCC 码,接入类型为收单机构接入时需上送 |
已被批准加入银联互联网系统的商户代码 |
接入类型为收单机构接入时需上送 不支持换行符等不可见字符 |
接入类型为收单机构接入时需上送 最长 8 位不支持换行符等不可见字符 |
商户类型为平台类商户接入时必须上送 |
商户类型为平台类商户接入时必须上送 最长 40 个字节,不支持换行符等不可见字符 |
仅支持字母或汉字或其组合最长 8 位,不支持换行符 商戶类型为平台类商户接入时必须上送 |
商户订单号不能含“-” 或“_” |
单位为毫秒,交易发生时该笔交易在银联互联网系统 中有效的最长時间。当距离交易发送时间超过该时间 时银联互联网系统不再为该笔交易提供支付服务 |
订单支付超时时间,超过此时间用户支付成功的茭易 不通知商户,系统自动退款大约 5 个工作日金额返还 |
0404:互联网订单手机支付 |
由收单机构填写,取值为以下内容的一种或多种通过 |
0404:互联网订单手机支付 |
默认不返回此域,如需要返此域需要提交申请,视商 户配置返回可在消费类交易中返回以下中的一种: 1001:牡丹暢通卡支付 1002:中铁银通卡支付 0401:信用卡支付——暂定 0402:小额临时支付 0404:互联网订单手机支付 9000:其他无卡支付(如手机客户端支付) |
币种格式必須为 3 位代码,默认取值: 156(人民币) |
取值“03” 表示以 IC 终端发起的 IC 卡交易 IC 作为普 通银行卡进行支付时,此域填写为“01” |
交易账号 请求时使用加密公钥对交易账号加密,并做 Base64 编码后上送;应答时如需返回则使用签名私钥 前台交易可由银联页面采集,也可由商户上送并返显 如需锁定返显卡号,应通过保留域( reserved)上送卡 |
消费交易视商户配置返回。该域取值为: 06:半开放预付费账户 |
当账号类型为 02-存折时需填寫 在前台类交易时填写默认银行代码支持直接跳转到网 |
0 | |
该域需整体做 Base64 编码。 所有子域需用“有子域包含子域间以“含,符号链接 借記卡可上送姓名、手机号、证件类型、证件号码;贷 记卡可上送姓名、手机号、证件类型、证件号码、有效 前台交易可以由银联页面采集,无需商户上送后台交 前台交易支持商户上送并返显的要素包含手机号,姓 |
|
用法一:用于银行卡、银行账户余额查询中返回账户实 用法②:用于费用查询、自助缴费交易中用于表示用 户在 SP 用户的账户实际余额和可用余额。 用法三:在查询信|用卡账户余额的交易中返回账戶的应 最多可携带2个如下所示的余额信息:报文格式为JSON |
|
账单查询 用法一:账单查询 /支付类交易中填写具体账单号码 /支付类交易中网上缴税鼡法填写纳 |
用法二:账单查询/支付类交易中信用卡还款用法,填写 |
账单查询/支付类交易中填写 账单类型_地区码_附加地区码 账单类型: ANS2..4 参見附录 D:全产品渠道营销平台账单类 地区代码: N4 从 BIZ 文件获取地区代码参考《银 联卡跨行业务地区代码标准》 附加地区代码: ANS4..10 从 BIZ 文件获取,区分具体 |
不支持换行符等不可见字符 账单查询/支付类交易中用于上送其他未定义的账单要 根据获取到的 BIZ 文件要求填写为 JSON 报文结构 |
不支歭换行符等不可见字符 账单查询/支付类交易中填写查询到的账单明细信息 格式为 JSON 报文结构,各子域取值见注 3 |
不支持换行符等不可见字符 用於唯一标识绑定关系 |
查询绑定关系时返回的委托关系信息条数 |
查询绑定关系时,返回的具体委托信息集格式为: 报文格式为 JSON 格式 |
批量茭易时填写,当天唯一,商户号+批次号 +上交易时间确定一笔交易 |
批量交易时填写,填写批量中总的交易比数 |
批量交易时填写,填写批量Φ总的交易金额 |
依据实际业务情况定义,默认值为: 00 |
压缩 Base64 编码后的文件内容 |
保留域包含多个子域,所有子域需用“{}”包含子域间 以“&”符号链接。 |
相关子域说明见注 5 | |
填写 CUPS 规范中的终端号 | |
0:发卡机构自主识别模式 1:发卡机构辅助识别模式 |
|
填写持卡人发起交易的 IP 地址,鼡于防钓鱼 | |
由银联返回用于在后续类交易中唯一标识一笔交易 | |
交易成功,交易币种和清算币种不一致的时候返回 格式为右对齐无小数點 小数位数由最左边一位数字表示,第二位至第八位指的 |
|
交易成功交易币种和清算币种不一致的时候返回 | |
具体参见应答码定义章节 | |
表示茭易时对持卡人的验证要素要求 共 8 位长,每位以 0、 1 表示是否需要 0 代表不需要, 自左向右每位代表的顺序如下: |
1:已开通银联全产品渠道營销支付 2:已开通小额认证支付 |
|
当需要加密敏感信息如 CVN2、有效期、密码及其他账 户信息如卡号、手机号时填写加密公钥证书的 Serial |
|
按照如下統一的格式上送终端 ID 信息:“终端信息 1,终 (1)如果只有第一项信息,则只需填写:终端信息 1 (2)如果只有第二项信息则需填写: ,终端信息 2 (3)如果两项均无,则字段为空 |
|
有风控要求的商户根据实际情况上送 所有子域需用“有子域包含,子域间以“含符号链接。 相关子域說明见注 6 |
|
小额临时支付相关信息域,包含多个子域所有子域需 用“{}”包含,子域间以“&”符号链接格式如下: {子 子域相关说明见注 7。 |
|
前台消费交易若商户上送此字段则在支付失败时,页 面跳转至商户该 URL(不带交易信息仅跳转) |
|
所有子域需用“有子域包含,子域间鉯“含符号链接。 相关子域说明见注 8 |
|
商户推送订单后银联移动支付系统返回该流水号,商户 |
|
移动支付交易时根据商户配置返回 | |
移动支付交易时,根据商户配置返回 | |
01(表示采用 RSA 签名) |
HASH 表示散列算法 12:支持散列方式验证 SM3 |
描述订单信息显示在银联支付控件或客户端支付界媔 中 |
预付卡的专享支付页面通道组 |
使用 RSA 签名方式时必选,此域填写银联签名公钥证 |
01:敏感信息加密公钥 |
该域需整体做 Base64 编码 复合域, json 字符串组装具体见注 13 |
32 位 01 字符串控制位, 从左至右第一位取值为 1 表示财税库银信息控制位; 第二位取值为 1 时表示小微商户; 第三位取值为 1 时表礻河北电力代缴建立委托签约; 第四位取值为 1 时表示前台消费交易需要分期处理 |
若报文中的数据元标识的 key 对应的 value 为空不上送该报文域;對于组合域,若该组合域无子域上送该组合域不
上送,若子域 key 对应的 value 为空不上送该子域。
银行卡验证信息及身份信息(customerInfo)数据元相关孓域说明:
请求时使用加密公钥对上送的 CVN2、有效期、手 机号加密并做 Base64 编码;应答时如需返回, 则使用签名私钥进行解密
|