互联网商户及收单机构接入接口规范Word下载.docx

1、2011-9-19更新响应码1.1.82011-9-27添加isCustomPay字段（牡丹畅通卡）说明1.1.92011-10-11添加merUserId字段（商户端用户ID）说明1.2.02011-10-17添加响应码731.2.12011-11-7添加响应码861.2.22011-11-8添加专享支付方式字段说明1.2.32011-11-10添加customIp域针对防钓鱼说明1.2.42011-11-23张旭东用户保留域增加订单超时时间（orderTimeoutDate）说明1.2.52011-11-25添加对bizType,bizSubType,riskFlag的说明目 次前 言本标

2、准规定了商户及收单机构接入中国银联互联网系统使用的报文接口，包括交易种类、交易正常处理流程、异常情况的处理流程、消息域说明、消息格式以及交易报文格式说明。本标准由中国银联股份有限公司提出。本标准由中国银联股份有限公司制定。本标准主要起草单位：中国银联互联网业务部。本标准主要起草人：11范围本标准规定了互联网商户及收单机构使用的报文接口，包括交易种类、交易正常处理流程和异常情况的处理流程、消息域说明、消息格式以及交易报文格式说明。本标准的本部分适用于所有加入中国银联互联网系统的商户及收单机构。参与方描述：收单机构指加入银联网络，与银联签订银联卡无卡支付业务合作协议开展银联无卡支付收单业务的境内成

3、员机构。商户指加入银联网络，与银联签订银联卡无卡支付业务合作协议开展银联无卡支付业务的商户。 本文档中针对商户且未有特殊说明的同样适用于收单机构；仅针对于收单机构的特殊项则会加以特别描述（一般不适用于商户）。12规范性引用文件下列文件中的条款通过本标准的引用而成为本标准的条款。凡是注日期的引用文件，其随后所有的修改单（不包括勘误的内容）或修订版均不适用于本标准，然而，鼓励根据本标准达成协议的各方研究是否可使用这些文件的最新版本。凡是不注日期的引用文件，其最新版本适用于本标准。Q/CUP 006 银行卡联网联合技术规范V2.0Q/CUP 001 银行卡信息交换术语13术语和定义下列术语和定义适用

4、于本标准。表1术语解释代码含义样例UPOP中国银联互联网交易系统的简称商户代码商户是指与收单机构签订商户协议，代理银行卡的零售商、个人、公司或其他组织，收单机构方为其提供收单服务。商户接入UPOP时，由UPOP分配的全局唯一的id1清算日期指处理中心在转接各类交易请求时，在转接信息中增加的处理中心的时间戳。该时间戳作为处理中心对转接信息进行币种转换、清算、收费、对账、查询以及统计的日期依据。清算金额用于清算的资金轧差额。处理中心与入网机构约定清算时，事先指定清算币种，并采用轧差净额清算。对账交易双方之间的交易总额核对，以达到账务一致合作密钥商户和UPOP签订接入协议时，由双方共同确定的密钥串，

5、该值可以在必要的时候双方重新确定。该串用于商户和UPOP通信时的签名。密钥串的长度为32。90abcdef090abcdef签名信息采用特定签名算法对交易过程中的关键信息和合作密钥进行签名，具有防篡改和防抵赖的特性。签名信息的长度暂定位32。商户应严格保密该密钥串，若该密钥串泄露或者长时间密钥更换，建议主动要求更换密钥串。否则造成的损失由商户承担。14交易处理说明在互联网电子商务交易中涉及商户、购买者、中间服务方三个角色。交易时，购买者在商户网站上选购一件或者多件商品，形成商品订单。购买者将商品订单提交给中间服务方，中间服务方实现从购买者账户到商户账户的资金转移。其中中国银联互联网系统充当网上

6、交易过程中的中间服务方的角色，帮助买家付款，帮助商家收款。UPOP的接入功能集成在商户网站中，为了更好的为商户提供服务，提供商户的交易支付接口和交易信息查询接口。14.1交易分类说明 按交易的功能分类，可以将交易分为金融类、管理及安全控制类等。金融类包括消费、消费撤销、退货、预授权、预授权撤销、预授权完成、预授权完成撤销。管理及安全控制类包括交易信息查询。14.2金融类业务流程介绍1） 持卡人浏览商户网站、购买商品、选择使用银联快捷支付方式进行网上支付2） 商户网站将持卡人浏览器页面定向到中国银联互联网系统支付页面3） 用户完成支付相关信息的输入4） 中国银联互联网系统返回交易结果4.1） 通

7、过页面跳转的方式返回交易结果。此种方式是异步交互的4.2） 通过后台通知的方式主动向商户系统发送交易结果5） 商户在收到中国银联互联网交易系统的交易结果通知时，若交易状态为成功，则建议应该立即向UPOP发起交易查询（该步骤可选），查询该交易是否成功，以此来防范第三方伪造交易成功的信息。6） 中国银联互联网交易系统返回查询结果给商户通知重发机制对支持交易结果后台通知的商户，在交易结束后会将交易结果发送给商户。若一次没有发送成功，通过退避策略重新发送后台交易通知。具体方法为2（i-1） 分钟发送后台交易结果通知，在重新发送通知的过程中，只要有一次成功，则中断重发策略。其中i是重新发送的次数，i1,

8、 5。说明：商户端在接收到交易通知时，应该立即确认已经收到，并且丢弃重复的交易结果通知。14.3管理类业务流程介绍1） 当商户对无法确认交易结果或者对交易处理有异议时，可以主动发起信息查询2） 中国银联互联网交易系统返回查询结果15消息结构采用HTTP 标准的POST 协议。16消息域说明16.1报文域的属性说明在银联互联网系统与各商户的报文中，各报文域的数据类型、长度属性及格式如下表所示：表2报文域数据类型、长度属性及格式含义表字符A字母字符，A至Z，a至z，向左靠，右边多余位填空格B数据的二进制表示，后跟数字表示位（bit）的个数用于表示变长的二进制数，后跟数字表示二进制数据所占字节（By

9、te）的个数n数值，0至9，右靠，首位有效数字前填零。若表示人民币金额，则最右二位为角、分p填充字符，如空格s特殊符号an字母和数字字符，左靠，右边多余位填空格as字母和特殊字符，左靠，右边多余位填空格cn压缩数字码，即BCD码ns数字和特殊字符，左靠，右边多余位填空格ans字母、数字和特殊字符，左靠，右边多余位填空格ansb字母、数字、特殊字符和二进制数，左靠，右边多余位填空格MM月份，01至12DD日期，01至31YY年份，00至99hh时，00至23mm分，00至59ss秒，00至59VAR可变长度数据元33字符的固定长度.17最大17个字符的可变长度。X借贷符号，贷记为“C”，借记为“

10、D”，并且总是与一个数字型金额数据元相连，例如，净对账金额中X+N16含义为前缀“C”或“D”和净对账金额的16位数字。ZISO 4909和ISO 7813中定义的磁卡第二、三磁道的代码集16.2消息版本号Message Version Number对应KEY元素version变量属性ns5.8，5到8位数字或字符.域描述用于表示支持的协议版本号。消息版本号必须表示为：*.*. *，其中 “*” 表示1到2个数字用法在所有的消息中，各组件都必须填写自身支持的协议版本号。消息版本号不能低于1.0.0。16.3字符编码Character Setcharset ans1.20，最长20位数字、字母或

11、者特殊符号本域指明了报文中字符的编码规范。目前支持的包括GBK、UTF-8等。16.4签名方法Signing MethodsignMethod an1.10，最长10位数字、字母本域指明了报文中签名的算法。在交易应答中该域内容应与交易请求一致。目前支持的签名算法包括MD5。16.5签名信息Signing Messagessignature an32，32位定长的字母、数字算法请参考（规范性附录）数字签名当交易双方计算出来的签名信息不一致时，则直接拒绝交易。16.6交易类型Transaction typetransType n2，2位定长数字本域指明了交易的种类。交易类型分段区分，具体定义如下表

12、所示：表3交易类型分段0130金融类交易3160金融撤销类交易6165收单机构发起的金融通知类交易6670发卡机构发起的金融通知类交易7180不涉及资金的其他交易81-99公共支付类交易具体的用法如下：表4交易类型用法01消费31消费撤销02预授权32预授权撤销03预授权完成33预授权完成撤销04退货16.7商户名称Merchant NamemerAbbrans1.32，最大32个字母、数字、空格、符号（包括-_.空格中英文括号）和中文（字符集u4e00-u9fa5）商户代码对应的商户名称。一般出现在显示给持卡人的页面中。一般用于请求消息中，表示商户名称。16.8商户代码Merchant ID

13、merIdn15.24，长度15到24个数字商户代码。该商户应是已被批准加入银联互联网系统的商户网站的代码。由中国银联互联网系统统一分配，不得重复。对所有的请求报文，该域必须出现，且在整个交易周期中保持不变。16.9商户类型Merchants TypemerCoden4，4位定长数字字符表示商户分类编码（MCC）。商户类型码表示商户的服务范围和属性。取值请参见GB/T 20548-2006金融零售业务 商户类别代码。16.10通知URLNotify URLbackEndUrlans1.256，最大256个（字母、数字和特殊字符）的商户网站URL，URL编码说明参见7.1.3章节商户网站的后台U

14、RL。绝对地址，例如：当完成买家账户向商户账户的支付时,要求商户返回URL收到通知后进行响应。16.11返回URLReturn URLfrontEndUrlans1.256，最大256个（字母、数字和特殊字符）的API地址，URL编码说明参见7.1.3章节商户网站的前台URL。例如：当完成买家账户向商户账户的支付时,通过商户通知URL进行页面跳转。16.12收单机构代码Acquirer BINacqCoden.11，最大11位数字的收单机构代码收单机构代码。该收单机构应是已被批准加入银联互联网系统的，能为商户网站提供收单服务的入网机构。收单机构代码是关键信息域，在发送方随后发出的与之相关的交易

15、中该域信息也应保持不变。16.13交易开始日期时间Start Date & Time For PurchaseorderTime n14，14位定长数字字符交易开始日期和时间均为北京时间。格式：YYYYMMDDHHMMSS，其中YYYY 4个数字，表示年份MM 01-12，表示月份DD 01-31，表示日期HH 00-23，表示小时MM 00-59，表示分钟SS 00-59，表示秒交易发生时的时间日期。16.14交易超时时间Expiring Time For PurchasetransTimeout n.10，10位变长数字字符单位为毫秒。交易发生时，该笔交易在银联互联网系统中有效的最长时间。

16、当距离交易开始日期时间超过该时间时，银联互联网系统不再为该笔交易提供支付服务。16.15交易完成日期时间Finishing Date &respTime同6.13.3域描述该笔交易银联互联网系统收到发卡机构应答时的时间。16.16商户订单号Merchant Order NumberorderNumberan8.32，最大32个字母、数字和-用于表示商户的订单号。在商户内部应唯一。用于传送商户订单号信息，最大为32个字节的信息。16.17商品名称Merchant Order InformationcommodityNameans1.255，最大255个字母、数字、空格、符号（包括-_.空格中英文

17、括号）和中文（字符集u4e00-u9fa5）。其编码格式应与6.3字符编码相一致。用于表示订单的商品信息。用于传送商户订单的商品信息，最大为256个字节的信息。16.18商品URLGoods URLcommodityUrlans1.1024，最大1024个字母、数字和特殊字符，URL编码说明参见7.1.3章节商品的URL。与6.17商品名称对应。表示商品的URL。16.19商品单价Goods PricecommodityUnitPricen1.12，最长12位数字单件商品的价格。本域中不带小数点，小数位根据6.24交易币种来决定。见6.23.4用法16.20商品数量Goods Amountco

18、mmodityQuantityn1.10，最大10个数字的商品数量商品的总数量。表示商品的总数量。16.21运输费用Transportation ExpensestransferFee商品运输时的运费信息。16.22优惠信息Favorable InformationcommodityDiscount内容是根据优惠券信息，或者折价数目等等交易折扣的金额。该金额表示原始金额和交易实际金额的差值。16.23交易金额Purchase AmountorderAmount n1.12，最长12位数字交易金额。本域值是交易的总金额，包括商品的价格和运费。且其值在交易的整个过程中保持不变，其币种由交易币种指明

19、，若本域出现，则交易币种必出现。对于参与多币种交易的发卡方，该域反映了收单方提交请求时的币种。当交易币种为人民币时，本域的最右两位应包含人民币的角和分。当交易币种为外币时，如果该币种没有小数位，则该域的值代表实际交易金额；如果该币种有两个小数位，则表示方法同人民币；若有三个小数位，则最后一个小数位必须为零。用法举例如下表所示：表5交易金额用法币种小数位数实际金额本域值人民币两位小数100002100002外币没有小数位1000三位小数1000112100011016.24交易币种Purchase CurrencyorderCurrency n3，3位定长数字表示交易货币代码。表6交易币种用法1

20、56840美元978欧元392日元756瑞士法郎036澳大利亚元124加拿大元344港币826英镑446澳门元702新加坡元901新台币360印尼盾16.25持卡人姓名Cardholder NamecustomerNameans1.20，最长20个字母、数字、空格、符号（包括.空格中英文括号）和中文（字符集u4e00-u9fa5）持卡人真实的姓名。如果用户的姓名超过20位，则截取前20个字节。16.26默认支付方式Default Payment MethoddefaultPayTypea120，最长20字母，区分大小写。持卡人在网站购物时，默认的首选交易支付方式。可能的值为以下中的一种，括号内

21、为中文解释：LitePay（认证支付）,ProPay（快捷支付）,CommonPay（普通支付）,MicroPay（微支付）,ExpressPay（储值卡支付）,CSPay（网银支付）,DirectPay（后台支付）16.27默认银行编码Default issuer CodedefaultBankNumbera1.5，最长5个字母持卡人在网站购物时，默认跳往的银行16.28持卡人IPCardholder IPcustomerIpns1.40，最长40个字节的数字或者特殊字符持卡人访问商户网站时的IP地址。若开启IP防钓鱼功能，则需上送持卡人真实IP。该地址可以是IPv4格式，也可以是IPv6格

22、式。16.29交易流水号Serial Numberqid n21，21位定长数字 对于每一笔支付交易，银联互联网系统都赋予其一个交易流水号。该流水号不得重复。该值在银联互联网交易系统中唯一标识一笔交易，是系统处理的关键域。16.30系统跟踪号Trace NumbertraceNumbern6，6位定长数字CUPS系统跟踪号，做对账时使用对账时使用16.31系统跟踪时间Trace TimetraceTimen10，10位定长数字 MMDDHHMMSSCUPS系统跟踪时间，做对账时使用16.32原始交易流水号Initial Serial NumberorigQid上一笔关联交易的交易流水号，以便于银联互联网系统可以准确定位原始交易。交易类型为“撤销”、“完成”或者“退货”时必填。16.33商户保留域Merchant Reserved FieldmerReservedans1.1024，最长1024个字母、数字或者特殊字符此保留域供商户在请求报文中带给银联。（一） 消费等前台类交易时，该域用来特殊信息的传递。表7商户保留域信息定义子域1（商户摘要）1、 子域1（商户摘要）merAbstract0-8位可见字符，包括数字、字母、中文等merReserved= merAbstract =商户摘要（二） 区分预授权及担保消费的标志位（注：仅在transType=