互联网商户及收单机构接入接口规范

中国银联互联网商户接入接口规范 i 版本修订信息 版本号 完成日期 拟稿和修改人 发布日期 变更说明 1.0.6 2011-7-16 杨惠雄 2011-7-17 更新自动生成的目录及页码 1.0.7 2011-7-22 杨惠雄 2011-7-22 商户保留域增加担保支付和预授权的标志位 系统保留域增加返回支付方式 1.0.8 2011-7-25 杨惠雄 2011-7-25 增加响应码40及41的说明 1.0.9 2011-7-26 夏晶晶 2011-7-26 增加响应码42及37的说明 1.1.0 2011-7-29 夏晶晶 2011-7-29 商户简称长度改为32字节 1.1.1 2011-8-18 夏晶晶 2011-8-18 信息查询应答去掉交易类型 1.1.2 2011-8-22 夏晶晶 2011-8-22 订单号支持-，添加交易币种用法说明 1.1.3 2011-8-24 夏晶晶 2011-8-24 消息域说明修改 1.1.4 2011-8-30 夏晶晶 2011-8-30 添加担保消费交易说明 1.1.5 2011-9-6 夏晶晶 2011-9-6 添加二级商户字段说明 1.1.6 2011-9-16 夏晶晶 2011-9-16 添加收单机构与商户说明 1.1.7 2011-9-19 夏晶晶 2011-9-19 更新响应码 目 次 TOC \f \h \t "前言、引言标题,附录标识,参考文献、索引标题,章标题,附录章标题,一级条标题,附录一级条标题" 版本修订信息 I 前 言 IV 1 范围 1 2 规范性引用文件 1 3 术语和定义 1 4 交易处理说明 2 4.1 交易分类说明 2 4.2 金融类业务流程介绍 2 4.3 管理类业务流程介绍 3 5 消息结构 4 6 消息域说明 5 6.1 报文域的属性说明 5 6.2 消息版本号 5 6.3 字符编码 6 6.4 签名方法 6 6.5 签名信息 6 6.6 交易类型 6 6.7 商户名称 7 6.8 商户代码 7 6.9 商户类型 7 6.10 通知URL 8 6.11 返回URL 8 6.12 收单机构代码 8 6.13 交易开始日期时间 8 6.14 交易超时时间 9 6.15 交易完成日期时间 9 6.16 商户订单号 9 6.17 商品名称 10 6.18 商品URL 10 6.19 商品单价 10 6.20 商品数量 10 6.21 运输费用 11 6.22 优惠信息 11 6.23 交易金额 11 6.24 交易币种 12 6.25 持卡人姓名 12 6.26 默认支付方式 12 6.27 持卡人在网站购物时，默认的首选交易支付方式。默认银行编码 13 6.28 持卡人IP 13 6.29 交易流水号 13 6.30 系统跟踪号 13 6.31 系统跟踪时间 13 6.32 原始交易流水号 14 6.33 商户保留域 14 6.34 系统保留域 15 6.35 响应码 16 6.36 响应时间 16 6.37 响应信息 17 6.38 清算金额 17 6.39 清算币种 17 6.40 清算汇率 17 6.41 兑换日期 18 6.42 清算日期 18 6.43 查询结果 18 7 交易报文格式说明 19 7.1 说明 19 7.2 报文接口定义 19 附　录　A （规范性附录） 数字签名 24 附　录　B （规范性附录） 应答码 25 参考文献 26 前 言 本规定了机构（商户）接入中国银联互联网系统使用的报文接口，包括交易种类、交易正常处理流程、异常情况的处理流程、消息域说明、消息格式以及交易报文格式说明。 本标准由中国银联股份有限公司提出。 本标准由中国银联股份有限公司制定。 本标准主要起草单位：中国银联互联网业务部。 本标准主要起草人： 互联网机构（商户）接入接口规范 21范围 本标准规定了互联网机构（商户）使用的报文接口，包括交易种类、交易正常处理流程和异常情况的处理流程、消息域说明、消息格式以及交易报文格式说明。 本标准的本部分适用于所有加入中国银联互联网系统的机构（商户）。 参与方描述： 收单机构 指加入银联网络，与银联签订《银联卡无卡支付业务合作》开展银联无卡支付收单业务的境内成员机构。 商户 指加入银联网络，与银联签订《银联卡无卡支付业务》开展银联无卡支付业务的商户。 本文档中针对商户且未有特殊说明的同样适用于收单机构；仅针对于收单机构的特殊项则会加以特别描述（一般不适用于商户）。 22规范性引用文件 下列文件中的条款通过本标准的引用而成为本标准的条款。凡是注日期的引用文件，其随后所有的修改单（不包括勘误的内容）或修订版均不适用于本标准，然而，鼓励根据本标准达成协议的各方研究是否可使用这些文件的最新版本。凡是不注日期的引用文件，其最新版本适用于本标准。 Q/CUP 006 《银行卡联网联合技术规范V2.0》 Q/CUP 001 《银行卡信息交换术语》 23术语和定义 下列术语和定义适用于本标准。 表1术语解释 代码 含义 样例 UPOP 中国银联互联网交易系统的简称 商户代码 商户是指与收单机构签订商户协议，代理银行卡的零售商、个人、公司或其他组织，收单机构方为其提供收单服务。 商户接入UPOP时，由UPOP分配的全局唯一的id 1234567890123456 清算日期 指处理中心在转接各类交易请求时，在转接信息中增加的处理中心的时间戳。该时间戳作为处理中心对转接信息进行币种转换、清算、收费、对账、查询以及统计的日期依据。 清算金额 用于清算的资金轧差额。处理中心与入网机构约定清算时，事先指定清算币种，并采用轧差净额清算。 对账 交易双方之间的交易总额核对，以达到账务一致 合作密钥 商户和UPOP签订接入协议时，由双方共同确定的密钥串，该值可以在必要的时候双方重新确定。该串用于商户和UPOP通信时的签名。密钥串的长度为32。 1234567890abcdef01234567890abcdef 签名信息 采用特定签名算法对交易过程中的关键信息和合作密钥进行签名，具有防篡改和防抵赖的特性。签名信息的长度暂定位32。商户应严格保密该密钥串，若该密钥串泄露或者长时间密钥更换，建议主动要求更换密钥串。否则造成的损失由商户承担。 1234567890abcdef01234567890abcdef 24交易处理说明 在互联网电子商务交易中涉及商户、购买者、中间服务方三个角色。交易时，购买者在商户网站上选购一件或者多件商品，形成商品订单。购买者将商品订单提交给中间服务方，中间服务方实现从购买者账户到商户账户的资金转移。其中中国银联互联网系统充当网上交易过程中的中间服务方的角色，帮助买家付款，帮助商家收款。 UPOP的接入功能集成在商户网站中，为了更好的为商户提供服务，提供商户的交易支付接口和交易信息查询接口。 24.1交易分类说明 按交易的功能分类，可以将交易分为金融类、管理及安全控制类等。 金融类包括消费、消费撤销、退货、预授权、预授权撤销、预授权完成、预授权完成撤销。 管理及安全控制类包括交易信息查询。 24.2金融类业务流程介绍 1)​ 持卡人浏览商户网站、购买商品、选择使用银联快捷支付方式进行网上支付 2)​ 商户网站将持卡人浏览器页面定向到中国银联互联网系统支付页面 3)​ 用户完成支付相关信息的输入 4)​ 中国银联互联网系统返回交易结果 4.1）​ 通过页面跳转的方式返回交易结果。此种方式是异步交互的 4.2）​ 通过后台通知的方式主动向商户系统发送交易结果 5)​ 商户在收到中国银联互联网交易系统的交易结果通知时，若交易状态为成功，则建议应该立即向UPOP发起交易查询（该步骤可选），查询该交易是否成功，以此来防范第三方伪造交易成功的信息。 6)​ 中国银联互联网交易系统返回查询结果给商户 24.2.1通知重发机制 对支持交易结果后台通知的商户，在交易结束后会将交易结果发送给商户。若一次没有发送成功，通过退避策略重新发送后台交易通知。具体方法为2(i-1) 分钟发送后台交易结果通知，在重新发送通知的过程中，只要有一次成功，则中断重发策略。其中i是重新发送的次数，i∈[1, 5]。 说明：商户端在接收到交易通知时，应该立即确认已经收到，并且丢弃重复的交易结果通知。 24.3管理类业务流程介绍 1)​ 当商户对无法确认交易结果或者对交易处理有异议时，可以主动发起信息查询 2)​ 中国银联互联网交易系统返回查询结果 25消息结构 采用HTTP 标准的POST 协议。 26消息域说明 26.1报文域的属性说明 在银联互联网系统与各商户的报文中，各报文域的数据类型、长度属性及格式如下表所示： 表2报文域数据类型、长度属性及格式含义表 字符 含义 A 字母字符，A至Z，a至z，向左靠，右边多余位填空格 B 数据的二进制表示，后跟数字表示位（bit）的个数 B 用于表示变长的二进制数，后跟数字表示二进制数据所占字节（Byte）的个数 n 数值，0至9，右靠，首位有效数字前填零。若表示人民币金额，则最右二位为角、分 p 填充字符，如空格 s 特殊符号 an 字母和数字字符，左靠，右边多余位填空格 as 字母和特殊字符，左靠，右边多余位填空格 cn 压缩数字码，即BCD码 ns 数字和特殊字符，左靠，右边多余位填空格 ans 字母、数字和特殊字符，左靠，右边多余位填空格 ansb 字母、数字、特殊字符和二进制数，左靠，右边多余位填空格 MM 月份，01至12 DD 日期，01至31 YY 年份，00至99 hh 时，00至23 mm 分，00至59 ss 秒，00至59 VAR 可变长度数据元 3 3字符的固定长度 ..17 最大17个字符的可变长度。 X 借贷符号，贷记为“C”，借记为“D”，并且总是与一个数字型金额数据元相连，例如， 净对账金额中X+N16含义为前缀“C”或“D”和净对账金额的16位数字。 Z ISO 4909和ISO 7813中定义的磁卡第二、三磁道的代码集 26.2消息版本号 Message Version Number 26.2.1对应KEY元素 version 26.2.2变量属性 ns5..8，5到8位数字或字符. 26.2.3域描述 用于表示支持的协议版本号。 消息版本号必须表示为：*.*. *，其中 “*” 表示1到2个数字 26.2.4用法 在所有的消息中，各组件都必须填写自身支持的协议版本号。 消息版本号不能低于1.0.0。 26.3字符编码 Character Set 26.3.1对应KEY元素 charset 26.3.2变量属性 ans1..20，最长20位数字、字母或者特殊符号 26.3.3域描述 本域指明了报文中字符的编码规范。 26.3.4用法 目前支持的包括GBK、UTF-8等。 26.4签名方法 Signing Method 26.4.1对应KEY元素 signMethod 26.4.2变量属性 an1..10，最长10位数字、字母 26.4.3域描述 本域指明了报文中签名的算法。 26.4.4用法 在交易应答中该域内容应与交易请求一致。 目前支持的签名算法包括MD5。 26.5签名信息 Signing Messages 26.5.1对应KEY元素 signature 26.5.2变量属性 an32，32位定长的字母、数字 26.5.3域描述 采用特定签名算法对交易过程中的关键信息和合作密钥进行签名，具有防篡改和防抵赖的特性。签名信息的长度暂定位32。商户应严格保密该密钥串，若该密钥串泄露或者长时间密钥更换，建议主动要求更换密钥串。否则造成的损失由商户承担。 26.5.4用法 算法请参考（规范性附录）数字签名 当交易双方计算出来的签名信息不一致时，则直接拒绝交易。 26.6交易类型 Transaction type 26.6.1对应KEY元素 transType 26.6.2变量属性 n2，2位定长数字 26.6.3域描述 本域指明了交易的种类。交易类型分段区分，具体定义如下表所示： 表3交易类型分段 代码 含义 01—30 金融类交易 31—60 金融撤销类交易 61—65 收单机构发起的金融通知类交易 66—70 发卡机构发起的金融通知类交易 71—80 不涉及资金的其他交易 81--99 公共支付类交易 26.6.4用法 在交易应答中该域内容应与交易请求一致。 具体的用法如下： 表4交易类型用法 代码 含义 01 消费 31 消费撤销 02 预授权 32 预授权撤销 03 预授权完成 33 预授权完成撤销 04 退货 26.7商户名称 Merchant Name 26.7.1对应KEY元素 merAbbr 26.7.2变量属性 ans1..32，最大32个字母、数字、空格、符号（包括-_.空格中英文括号）和中文（字符集u4e00-u9fa5） 26.7.3域描述 商户代码对应的商户名称。一般出现在显示给持卡人的页面中。 26.7.4用法 一般用于请求消息中，表示商户名称。 26.8商户代码 Merchant ID 26.8.1对应KEY元素 merId 26.8.2变量属性 n15..24，长度15到24个数字 26.8.3域描述 商户代码。该商户应是已被批准加入银联互联网系统的商户网站的代码。 26.8.4用法 由中国银联互联网系统统一分配，不得重复。 对所有的请求报文，该域必须出现，且在整个交易周期中保持不变。 26.9商户类型 Merchant's Type 26.9.1对应KEY元素 merCode 26.9.2变量属性 n4，4位定长数字字符 26.9.3域描述 表示商户分类编码(MCC)。 26.9.4用法 商户类型码表示商户的服务范围和属性。取值请参见GB/T 20548-2006《金融零售业务 商户类别代码》。 26.10通知URL Notify URL 26.10.1对应KEY元素 backEndUrl 26.10.2变量属性 ans1..256，最大256个（字母、数字和特殊字符）的商户网站URL，URL编码说明参见7.1.3章节 26.10.3域描述 商户网站的后台URL。绝对地址，例如：http://www.unionpay.com/main.jsp 26.10.4用法 当完成买家账户向商户账户的支付时,要求商户返回URL收到通知后进行响应。 26.11返回URL Return URL 26.11.1对应KEY元素 frontEndUrl 26.11.2变量属性 ans1..256，最大256个（字母、数字和特殊字符）的API地址，URL编码说明参见7.1.3章节 26.11.3域描述 商户网站的前台URL。例如：http://www.unionpay.com/main.jsp 26.11.4用法 当完成买家账户向商户账户的支付时,通过商户通知URL进行页面跳转。 26.12收单机构代码 Acquirer BIN 26.12.1对应KEY元素 acqCode 26.12.2变量属性 n..11，最大11位数字的收单机构代码 26.12.3域描述 收单机构代码。该收单机构应是已被批准加入银联互联网系统的，能为商户网站提供收单服务的入网机构。 26.12.4用法 收单机构代码是关键信息域，在发送方随后发出的与之相关的交易中该域信息也应保持不变。 26.13交易开始日期时间 Start Date & Time For Purchase 26.13.1对应KEY元素 orderTime 26.13.2变量属性 n14，14位定长数字字符 26.13.3域描述 交易开始日期和时间均为北京时间。 格式： YYYYMMDDHHMMSS，其中 YYYY 4个数字，表示年份 MM 01-12，表示月份 DD 01-31，表示日期 HH 00-23，表示小时 MM 00-59，表示分钟 SS 00-59，表示秒 26.13.4用法 交易发生时的时间日期。 26.14交易超时时间 Expiring Time For Purchase 26.14.1对应KEY元素 transTimeout 26.14.2变量属性 n..10，10位变长数字字符 26.14.3域描述 单位为毫秒。 26.14.4用法 交易发生时，该笔交易在银联互联网系统中有效的最长时间。当距离交易开始日期时间超过该时间时，银联互联网系统不再为该笔交易提供支付服务。 26.15交易完成日期时间 Finishing Date & Time For Purchase 26.15.1对应KEY元素 respTime 26.15.2变量属性 n14，14位定长数字字符 26.15.3域描述 同6.13.3　域描述 26.15.4用法 该笔交易银联互联网系统收到发卡机构应答时的时间。 26.16商户订单号 Merchant Order Number 26.16.1对应KEY元素 orderNumber 26.16.2变量属性 an8..32，最大32个字母、数字和- 26.16.3域描述 用于表示商户的订单号。在商户内部应唯一。 26.16.4用法 用于传送商户订单号信息，最大为32个字节的信息。 26.17商品名称 Merchant Order Information 26.17.1对应KEY元素 commodityName 26.17.2变量属性 ans1..255，最大255个字母、数字、空格、符号（包括-_.空格中英文括号）和中文（字符集u4e00-u9fa5）。其编码格式应与6.3　字符编码相一致。 26.17.3域描述 用于表示订单的商品信息。 26.17.4用法 用于传送商户订单的商品信息，最大为256个字节的信息。 26.18商品URL Goods URL 26.18.1对应KEY元素 commodityUrl 26.18.2变量属性 ans1..1024，最大1024个字母、数字和特殊字符，URL编码说明参见7.1.3章节 26.18.3域描述 商品的URL。与6.17　商品名称对应。 26.18.4用法 表示商品的URL。 26.19商品单价 Goods Price 26.19.1对应KEY元素 commodityUnitPrice 26.19.2变量属性 n1..12，最长12位数字 26.19.3域描述 单件商品的价格。本域中不带小数点，小数位根据6.24　交易币种来决定。 26.19.4用法 见6.23.4　用法 26.20商品数量 Goods Amount 26.20.1对应KEY元素 commodityQuantity 26.20.2变量属性 n1..10，最大10个数字的商品数量 26.20.3域描述 商品的总数量。与6.17　商品名称对应。 26.20.4用法 表示商品的总数量。 26.21运输费用 Transportation Expenses 26.21.1对应KEY元素 transferFee 26.21.2变量属性 n1..12，最长12位数字 26.21.3域描述 商品运输时的运费信息。本域中不带小数点，小数位根据6.24　交易币种来决定。 26.21.4用法 见6.23.4　用法 26.22优惠信息 Favorable Information 26.22.1对应KEY元素 commodityDiscount 26.22.2变量属性 n1..12，最长12位数字 26.22.3域描述 内容是根据优惠券信息，或者折价数目等等交易折扣的金额。该金额表示原始金额和交易实际金额的差值。本域中不带小数点，小数位根据6.24　交易币种来决定。 26.22.4用法 见6.23.4　用法 26.23交易金额 Purchase Amount 26.23.1对应KEY元素 orderAmount 26.23.2变量属性 n1..12，最长12位数字 26.23.3域描述 交易金额。本域中不带小数点，小数位根据6.24　交易币种来决定。 26.23.4用法 本域值是交易的总金额，包括商品的价格和运费。且其值在交易的整个过程中保持不变，其币种由交易币种指明，若本域出现，则交易币种必出现。对于参与多币种交易的发卡方，该域反映了收单方提交请求时的币种。 当交易币种为人民币时，本域的最右两位应包含人民币的角和分。 当交易币种为外币时，如果该币种没有小数位，则该域的值代表实际交易金额；如果该币种有两个小数位，则表示方法同人民币；若有三个小数位，则最后一个小数位必须为零。用法举例如下表所示： 表5交易金额用法 币种 小数位数 实际金额 本域值 人民币 两位小数 1000．02 100002 外币 没有小数位 1000 1000 两位小数 1000．02 100002 三位小数 1000．112 1000110 26.24交易币种 Purchase Currency 26.24.1对应KEY元素 orderCurrency 26.24.2变量属性 n3，3位定长数字 26.24.3域描述 表示交易货币代码。 26.24.4用法 具体的用法如下： 表6交易币种用法 代码 含义 156 人民币 840 美元 978 欧元 392 日元 756 瑞士法郎 036 澳大利亚元 124 加拿大元 344 港币 826 英镑 446 澳门元 702 新加坡元 901 新台币 360 印尼盾 26.25持卡人姓名 Cardholder Name 26.25.1对应KEY元素 customerName 26.25.2变量属性 ans1..20，最长20个字母、数字、空格、符号（包括.空格中英文括号）和中文（字符集u4e00-u9fa5） 26.25.3域描述 持卡人真实的姓名。 26.25.4用法 如果用户的姓名超过20位，则截取前20个字节。 26.26默认支付方式 Default Payment Method 26.26.1对应KEY元素 defaultPayType 26.26.2变量属性 a1…20，最长20字母，区分大小写，具体取值范围见表6 26.26.3域描述 26.27持卡人在网站购物时，默认的首选交易支付方式。默认银行编码 Default issuer Code 26.27.1对应KEY元素 defaultBankNumber 26.27.2变量属性 n1..11，最长11个位数字 26.27.3域描述 持卡人在网站购物时，默认的首选使用的银行卡对应的发卡行编码 26.28持卡人IP Cardholder IP 26.28.1对应KEY元素 customerIp 26.28.2变量属性 ns1..40，最长40个字节的数字或者特殊字符 26.28.3域描述 持卡人访问商户网站时的IP地址。 26.28.4用法 该地址可以是IPv4格式，也可以是IPv6格式。 26.29交易流水号 Serial Number 26.29.1对应KEY元素 qid 26.29.2变量属性 n21，21位定长数字 26.29.3域描述 对于每一笔支付交易，银联互联网系统都赋予其一个交易流水号。该流水号不得重复。 26.29.4用法 该值在银联互联网交易系统中唯一标识一笔交易，是系统处理的关键域。 26.30系统跟踪号 Trace Number 26.30.1对应KEY元素 traceNumber 26.30.2变量属性 n6，6位定长数字 26.30.3域描述 CUPS系统跟踪号，做对账时使用 26.30.4用法 对账时使用 26.31系统跟踪时间 Trace Time 26.31.1对应KEY元素 traceTime 26.31.2变量属性 n10，10位定长数字 MMDDHHMMSS 26.31.3域描述 CUPS系统跟踪时间，做对账时使用 26.31.4用法 对账时使用 26.32原始交易流水号 Initial Serial Number 26.32.1对应KEY元素 origQid 26.32.2变量属性 n21，21位定长数字 26.32.3域描述 上一笔关联交易的交易流水号，以便于银联互联网系统可以准确定位原始交易。 26.32.4用法 交易类型为“撤销”、“完成”或者“退货”时必填。 26.33商户保留域 Merchant Reserved Field 26.33.1对应KEY元素 merReserved 26.33.2变量属性 ans1..1024，最长1024个字母、数字或者特殊字符 26.33.3域描述 此保留域供商户在请求报文中带给银联。 26.33.4用法 (一)消费等前台类交易时，该域用来特殊信息的传递。 表1商户保留域信息定义 子域1（商户摘要） 1、​ 子域1（商户摘要） merAbstract 0-8位可见字符，包括数字、字母、中文等 merReserved={ merAbstract =商户摘要} (二)区分预授权及担保消费的标志位（注：仅在transType=02 时有用）。 表1商户保留域信息定义 子域2（预授权/担保消费 标志位 1、​ 子域2（预授权/担保消费 标志位） isPreAuth 布尔型：“true” 或者 “false” transType=02&merReserved={isPreAuth=true} (三)交易查询时，该域用来收单机构号的传递收单机构号说明见6.12,以收单机构身份接入时必填merReserved={acqCode=收单机构号} (四)二级商户信息的传递 表1商户保留域信息定义 子域3（商户接入类型） 子域4（二级商户代码） 子域5（二级商户全称） 子域6（二级商户简称） 1、​ 子域3（商户接入类型） merPlatformType 1位数字，1代表平台类， 0代表直连（普通）类 若上送的该域是1（平台类），则子域4（二级商户代码）、子域5（二级商户全称）、子域6（二级商户简称）都必填 1、​ 子域4（二级商户代码） secondaryMerId an5..25，最大25个字母（a-z）、数字 1、​ 子域5（二级商户全称） secondaryMerFullName ans1..32，最大32个字母、数字、空格、符号（包括-_.空格中英文括号）和中文（字符集u4e00-u9fa5） 1、​ 子域6（二级商户简称） secondaryMerAbbr ans1..16，最大16个字母、数字、空格、符号（包括-_.空格中英文括号）和中文（字符集u4e00-u9fa5） merReserved={merPlatformType=1&secondaryMerId=12346789000&secondaryMerFullName=二级商户全称&secondaryMerAbbr=二级商户简称} 26.34系统保留域 UPOP Reserved Field 26.34.1对应KEY元素 cupReseverd 26.34.2变量属性 ans1..1024，最长1024个字母、数字或者特殊字符 26.34.3域描述 此保留域供银联在应答报文中带给商户系统特殊信息。 26.34.4用法 （一）交易查询时，该域用来特殊信息的传递，具体定义如下： 表1系统保留域信息定义 子域1（订单金额） 子域2（币种） 1、​ 子域1（订单金额） orderAmount 0-12位数字, 单位为分 2、​ 子域2（币种） orderCurrency 3位定长数字, 交易成功时必填 用法： 保留域外加大括号 cupReserved={orderAmount=100&orderCurrency=156} （二）交易支付方式 表1系统保留域信息定义 子域3（交易支付方式） 3、​ 子域3（交易支付方式） payMode 可能的值为以下中的一种，括号内为中文解释：LitePay（认证支付）,ProPay（快捷支付）,CommonPay（普通支付）,MicroPay（微支付）,ExpressPay（储值卡支付）,CSPay（网银支付）,DirectPay（后台支付） 用法： 保留域外加大括号 cupReserved={payMode=LitePay} （三）针对预授权完成交易，该域用来传递原始交易流水号 origQid 该字段具体描述见6.32章节 用法：保留域外加大括号 cupReserved={origQid=201106101324561234512} 26.35响应码 Response Code 26.35.1对应KEY元素 respCode 26.35.2变量属性 an2，2位定长数字字母 26.35.3域描述 表示对其所收到的交易的处理情况，如成功处理、无法处理或拒绝。若无法处理或拒绝该交易，则将在本域包含无法处理或拒绝的理由。 26.35.4用法 对每个收到的请求报文，商户都应将本系统处理的结果在本域中返回给发起方。应答码定义详见附　录　B（规范性附录）应答码。 26.36响应时间 Response Time 26.36.1对应KEY元素 respTime 26.36.2变量属性 n14，定长14位的数字 26.36.3域描述 格式：yyyyMMddHHmmss MM 01-12 dd 01-31 26.36.4用法 系统的响应时间。 26.37响应信息 Response Messages 26.37.1对应KEY元素 respMsg 26.37.2变量属性 ans1..1024，最长1024位的数字、字母或者特殊字符 26.37.3域描述 对6.35　响应码的文字描述 26.37.4用法 对于系统错误的文字描述。 26.38清算金额 Settle Amount 26.38.1对应KEY元素 settleAmount 26.38.2变量属性 n..12，最大12位数字的清算金额 26.38.3域描述 用6.36　清算币种的最小单位表示的清算金额，其中不包含任何标点。 例如：如果清算金额为123.45RMB，则setlAmount元素将包含值12345。 26.38.4用法 清算金额＝交易金额×清算汇率，其中不包含任何手续费。本域中不带小数点，小数位由清算币种决定。 本域用做商户清算的依据。 如果是跨境交易，银联互联网系统在收到请求消息后，将交易金额根据当时的汇率转换成清算金额添加在应答消息中向商户转发。 26.39清算币种 Settle Currency 26.39.1对应KEY元素 settleCurrency 26.39.2变量属性 n3，3位定长数字 26.39.3域描述 表示交易清算货币代码。 26.39.4用法 本域主要用于跨境交易，和清算金额配套使用。 当清算币种与交易币种不同时，要求在应答报文中标识清算币种。 26.40清算汇率 Settlement Conversion Rate 26.40.1对应KEY元素 exchangeRate 26.40.2变量属性 n8，8位定长数字 26.40.3域描述 银联与入网机构约定的交易币种到清算币种的转换汇率。格式为右对齐，无小数点。小数位数由最左边一位数字表示，第二位至第八位指的是汇率的值。 26.40.4用法 本域由银联互联网系统填写，返回的应答报文中，该汇率为交易币种转换为商户清算币种的汇率。 当报文中存在交易金额和清算金额时，本域必须存在。若本域出现，则兑换日期、清算币种应同时出现。 26.41兑换日期 Conversion Date 26.41.1对应KEY元素 exchangeDate 26.41.2变量属性 n4，4位定长数字 26.41.3域描述 格式：MMDD MM 01-12 DD 01-31 26.41.4用法 从原始交易币种转换成清算币种的转换汇率的有效日期。日期为MMDD格式，其中MM=月份，DD=日期。 当交易币种和清算币种不一致时出现。 26.42清算日期 Settle Date 26.42.1对应KEY元素 settleDate 26.42.2变量属性 n4，4位定长数字 26.42.3域描述 格式：MMDD MM 01-12 DD 01-31 26.42.4用法 受理方和发卡方之间的交易结算日期。 26.43查询结果 Query Result 26.43.1对应KEY元素 queryResult 26.43.2变量属性 n1，1位定长数字 26.43.3域描述 在查询交易中，表示待查询的金融类交易在银联互联网系统的处理结果。 26.43.4用法 具体的用法如下： 表2查询结果用法 代码 含义 商户处理 0 成功 承兑交易 1 失败 拒绝交易 2 处理中 稍后查询或者拒绝交易 3 无此交易 拒绝交易 27交易报文格式说明 27.1说明 27.1.1符号约定 表3符号约定 符号 含义 数 据 元 数 值 符 号 M 必须填写的域 C 某条件成立时必须填写的域 C+ 某条件成立时增加的域 C- 某条件成立时删除的域 M+ 必须增加的域 O 受理方和发卡方自选填写的域 转发域 必须与先前报文中对应域的值相同的域 27.1.2域长度计算说明 长度计算说明：所有长度均按字节计算，中文算两个字节，英文、数字算一个字节。 27.1.3URL编码说明 URL参数中中文等特殊字符需编码。 27.2报文接口定义 27.2.1消费 消费指持卡人在特约商户购买商品或服务时，通过终端联机付款。持卡人在购买商品或服务时请求发卡方批准该交易。 本交易参与清算和对账。 通过POST的方式向银行互联网系统发起交易。 在金融类业务中，商户代码、商户订单号和交易开始日期时间是交易的关键信息域，银联互联网系统将用以上三个域的取值唯一确定一笔交易。 27.2.1.1消费交易请求 表4消费交易请求消息 报文域 KEY 处理要求 说明 消息版本号 version M 字符编码 charset M 全大写 签名方法 signMethod M 签名信息 signature M 交易类型 transType M 商户名称 merAbbr M 商户代码 merId M 商户类型 merCode C 当收单机构代码出现时，则该域必须出现 通知URL backEndUrl M 返回URL frontEndUrl M 收单机构代码 acqCode C 当商户直接与银联互联网系统相连时，该域可不出现 当商户通过其他系统间接与银联互联网系统相连时，该域必须出现 交易开始日期时间 orderTime M 商户订单号 orderNumber M 商品名称 commodityName O 商户可自行选择是否提交订单中包含的商品信息 如果订单中包含多个商品，则商品相关的域可重复出现 商品URL commodityUrl O 商品单价 commodityUnitPrice O 商品数量 commodityQuantity O 运输费用 transferFee O 商户可自行选择 优惠信息 commodityDiscount O 商户可自行选择 交易金额 orderAmount M 交易币种 orderCurrency M 持卡人姓名 customerName O 建议商户提交。出现在支付信息采集页面中 默认支付方式 defaultPayType O 默认银行编码 defaultBankNumber O 交易超时时间 transTimeout O 建议商户提交，以防止钓鱼网站的问题 持卡人IP customerIp M 原始交易流水号 origQid C 当交易类型是撤销或者退货时，该域必须出现。 其他交易该域不可出现 商户保留域 merReserved O 部分已启用，参见6.33.4 27.2.1.2消费交易应答 银联互联网系统通过POST的方式反馈结果。 其中给前台用于页面跳转的使用请求交易报文中的“返回URL”进行；给后台通知商户处理结果的使用请求交易报文中的“通知URL”进行。 二者的格式相同。 表5消费交易应答消息 报文域 KEY 处理要求 说明 消息版本号 version M 字符编码 charset M 签名方法 signMethod M 签名信息 signature M 交易类型 transType M 响应码 respCode M+ 响应信息 respMsg M+ 该域是对响应码的文字说明，商户可以显示在页面上方便持卡人分析交易失败的结果 商户名称 merAbbr M 商户代码 merId M 商户订单号 orderNumber M 系统跟踪号 traceNumber M+ 系统跟踪时间 traceTime M+ 交易流水号 qid M+ 该域是银联互联网系统给予每笔交易的唯一标识 交易金额 orderAmount M 交易币种 orderCurrency M 交易完成时间 respTime M+ 清算金额 settleAmount M+ 清算币种 settleCurrency M+ 清算日期 settleDate M+ 清算汇率 exchangeRate M+ 兑换日期 exchangeDate M+ 系统保留域 cupReserved O 部分已启用，见6.34 27.2.2交易信息查询 商户查询特定交易在中国银联互联网系统中的支付处理情况。一般可用于商户对交易处理状态的查询或者订单支付情况的查询。 本交易不参与清算和对账。 通过POST的方式向银行互联网系统发起交易。 27.2.2.1信息查询请求 表6信息查询请求消息 报文域 KEY 处理要求 说明 消息版本号 version M 字符编码 charset M 全大写 签名方法 signMethod M 签名信息 signature M 交易类型 transType M 同待查询交易的交易类型。例如查询消费交易的处理状态，则该域填写01 商户代码 merId M 商户订单号 orderNumber M 交易开始日期时间 orderTime M 同待查询交易的交易开始日期时间 商户保留域 merReserved O 见6.33 27.2.2.2信息查询应答 本应答信息的格式同7.2.1.2　消费交易应答完全一样，但是处理要求存在差异，具体见下面的消息描述。 商户需同步等待中国银联互联网系统的应答。查询结果以英文连字符（&）连接起来作为纯文本字符串返回。 表7信息查询应答消息 报文域 KEY 处理要求 说明 消息版本号 version M 字符编码 charset M 签名方法 signMethod M 签名信息 signature M 响应码 respCode M+ 两位数字，queryResult=0或者2时为00，其余情况下为非全零的两位错误码 响应时间 respTime M+ yyyyMMddHHmmss 查询结果 queryResult M+ 0：成功 1：失败 2：处理中 3：无此交易 交易流水号 qid M+ 返回待查询交易在银联互联网系统中的流水号 如果针对该笔交易发起撤销、退货等后续交易，则在“原始交易流水号”内填入此值 系统跟踪号 traceNumber M+ 系统跟踪时间 traceTime M+ 清算金额 settleAmount M+ 清算币种 settleCurrency M+ 清算日期 settleDate M+ 清算汇率 exchangeRate M+ 兑换日期 exchangeDate M+ 系统保留域 cupReserved O 部分已启用，见6.34 27.2.3消费撤销 消费撤销指特约商户由于自身的原因对持卡人已经通过的联机付款的交易，于当日主动发起的对消费交易的取消。消费撤销交易必须是对原始金融交易的全额撤销。 消费撤销交易与原交易必须发生在同一个结算日。 本交易参与清算和对账。 本交易的报文格式同7.2.1　消费。相对于消费交易，消费撤销交易增加“原始交易流水号”，其值为原始消费交易的系统跟踪号。 27.2.4预授权/担保消费 预授权与担保消费的报文差别在于merReserved保留域字段中是否上送isPreAuth标志位，默认不送代表担保消费，上送isPreAuth=true代表预授权交易。预授权交易冻结超过交易金额的100%，担保消费则冻结交易金额的100%。具体merReserved保留域字段用法请参见6.33。以下由预授权代表预授权/担保消费。 预授权交易用于商户向持卡人的发卡方确认交易许可。商户将预估的消费金额作为预授权金额，发送给持卡人的发卡方。 预授权交易只控制持卡人的可用余额的额度。由预授权完成交易来完成资金结算。一个被批准的预授权交易，仅在有限的时间内有效。 本交易不参加当日清算。 本交易的报文格式同7.2.1　消费。 27.2.5预授权撤销 对已成功的预授权交易，在结算前使用预授权撤销交易，通知发卡方取消付款承诺。 预授权撤销交易必须是对原始预授权交易的全额撤销。 本交易不参加清算。 本交易的报文格式7.2.3　消费撤销。其中其中“原始交易流水号”填写为原始预授权交易的系统跟踪号。 27.2.6预授权完成 对已批准的预授权交易，用预授权完成做支付结算。本交易参加当日清算和对账。 本交易的报文格式同7.2.1　消费。相对于消费交易，预授权完成交易增加“原始交易流水号”，其值为原始预授权交易的系统跟踪号。 27.2.7预授权完成撤销 预授权完成撤销交易必须是对原始预授权完成交易的全额撤销。预授权完成撤销后的预授权仍然有效。 预授权完成撤销交易与原交易必须发生在同一个结算日。本交易参加清算。 本交易的报文格式7.2.3　消费撤销。其中“原始交易流水号”填写为原始预授权完成交易的系统跟踪号。 27.2.8退货（全额） 退货指应持卡人要求，对持卡人已经付款消费交易或者预授权完成交易,发起隔日取消并将已扣款项退还持卡人原扣款账户的过程。对已结算的消费交易，可使用退货，以退还持卡人消费的金额。 本交易参加清算和对账。 本交易的报文格式同7.2.1　消费。相对于消费交易，退货交易增加“原始交易流水号”，其值为原始消费交易或者预授权完成交易的系统跟踪号。退货交易类似消费撤销交易。 附　录　 （规范性附录） 数字签名 商户和银联互联网系统签订接入协议时，由双方共同确定合作密钥串secret_key，该值可以在必要的时候双方重新确定。该串用于商户和银联互联网系统通信时的签名。密钥串的长度为32。 签名是对关键信息的对和合作密钥信息对的摘要值。 摘要算法（暂定）为MD5，摘要的结果是长度为32（暂定）的ASCII码。 签名方法如下： A 关键信息对和合作密钥信息对的拼接方法为： 1）单个对的表示方式为 key=value。如果该key对应的value为空，则表示方式为key= 2）多个对的拼接方式为 key1=value1&key2=&key3=value3 3）合作密钥信息的拼接方式为key1=value1&key2=&key3=value3&md5（secret_key），密钥信息经过MD5计算后拼接在对的尾端。 B 签名方法 signature = md5(key1=value1&key2=&key3=value3...&keyn=valuen&md5(secret_key)) 说明1：将签名中的对（不包含合作密钥）根据key值作升序排列。其中key应包含报文格式中除“签名方法”和“签名信息”外的所有取值。若对中含有&、@等特殊字符或者中文字符时，要保持原样计算摘要值。发送时HTTP请求时，再进行URL编码。 说明2：若参与签名的信息串中包含中文，则需要先将中文转化为char_set指定的字符集。否则，银联互联网系统端的验签将不会通过。 附　录　 （规范性附录） 应答码 应答 终端显示（推荐） 终端操作 适用条件 00 支付成功 成功 01 交易异常，支付失败。详情请咨询95516 失败 02 您输入的卡号无效，请确认后输入 失败 03 发卡银行不支持，支付失败 失败 06 您的卡已经过期，请使用其他卡支付 失败 11 您卡上的余额不足 失败 14 您的卡已过期或者是您输入的有效期不正确，支付失败 失败 15 您输入的银行卡密码有误，支付失败 失败 20 您输入的转入卡卡号有误，支付失败 失败 21 您输入的手机号或CVN2有误，支付失败 失败 25 查找原始交易失败 失败 撤销、退货等后续类交易 30 报文格式错误 失败 36 交易金额超过网上银行交易金额限制，支付失败 失败 37 原始金额错误 失败 39 您已连续多次输入错误密码 失败 40 请与您的银行联系 失败 41 您的银行不支持认证支付，请选择快捷支付 失败 工行 42 您的银行不支持普通支付，请选择快捷支付 失败 56 交易受限 失败 71 交易无效，无法完成，支付失败 失败 72 无此交易 失败 80 内部错误 失败 81 可疑报文 失败 82 签名验证失败 失败 83 操作超时 失败 84 订单不存在 失败 85 银行通道暂时关闭 失败 94 重复交易 失败 参考文献