《互联网商户及收单机构接入接口规范.doc》由会员分享,可在线阅读,更多相关《互联网商户及收单机构接入接口规范.doc(32页珍藏版)》请在三一文库上搜索。
1、Q/ 中国银联股份有限公司 发布2011-2-10实施2011-2-10发布互联网商户及收单机构接入接口规范Q/CUP 099.12011Q/CUP中国银联股份有限公司企业标准iIQ/CUP 099.12011版本修订信息版本号完成日期拟稿和修改人发布日期变更说明1.0.62011-7-16杨惠雄2011-7-17更新自动生成的目录及页码1.0.72011-7-22杨惠雄2011-7-22商户保留域增加担保支付和预授权的标志位系统保留域增加返回支付方式1.0.82011-7-25杨惠雄2011-7-25增加响应码40及41的说明1.0.92011-7-26夏晶晶2011-7-26增加响应码42
2、及37的说明1.1.02011-7-29夏晶晶2011-7-29商户简称长度改为32字节1.1.12011-8-18夏晶晶2011-8-18信息查询应答去掉交易类型1.1.22011-8-22夏晶晶2011-8-22订单号支持-,添加交易币种用法说明1.1.32011-8-24夏晶晶2011-8-24消息域说明修改1.1.42011-8-30夏晶晶2011-8-30添加担保消费交易说明1.1.52011-9-6夏晶晶2011-9-6添加二级商户字段说明1.1.62011-9-16夏晶晶2011-9-16添加收单机构与商户说明1.1.72011-9-19夏晶晶2011-9-19更新响应码目 次版
3、本修订信息I前 言IV1 范围12 规范性引用文件13 术语和定义14 交易处理说明24.1 交易分类说明24.2 金融类业务流程介绍24.3 管理类业务流程介绍35 消息结构46 消息域说明56.1 报文域的属性说明56.2 消息版本号56.3 字符编码66.4 签名方法66.5 签名信息66.6 交易类型66.7 商户名称76.8 商户代码76.9 商户类型76.10 通知URL86.11 返回URL86.12 收单机构代码86.13 交易开始日期时间86.14 交易超时时间96.15 交易完成日期时间96.16 商户订单号96.17 商品名称106.18 商品URL106.19 商品单价
4、106.20 商品数量106.21 运输费用116.22 优惠信息116.23 交易金额116.24 交易币种126.25 持卡人姓名126.26 默认支付方式126.27 持卡人在网站购物时,默认的首选交易支付方式。默认银行编码136.28 持卡人IP136.29 交易流水号136.30 系统跟踪号136.31 系统跟踪时间136.32 原始交易流水号146.33 商户保留域146.34 系统保留域156.35 响应码166.36 响应时间166.37 响应信息176.38 清算金额176.39 清算币种176.40 清算汇率176.41 兑换日期186.42 清算日期186.43 查询结果
5、187 交易报文格式说明197.1 说明197.2 报文接口定义19附录A (规范性附录) 数字签名24附录B (规范性附录) 应答码25参考文献26III前 言本标准规定了机构(商户)接入中国银联互联网系统使用的报文接口,包括交易种类、交易正常处理流程、异常情况的处理流程、消息域说明、消息格式以及交易报文格式说明。本标准由中国银联股份有限公司提出。本标准由中国银联股份有限公司制定。本标准主要起草单位:中国银联互联网业务部。本标准主要起草人:互联网机构(商户)接入接口规范1 范围本标准规定了互联网机构(商户)使用的报文接口,包括交易种类、交易正常处理流程和异常情况的处理流程、消息域说明、消息格
6、式以及交易报文格式说明。本标准的本部分适用于所有加入中国银联互联网系统的机构(商户)。参与方描述:收单机构指加入银联网络,与银联签订银联卡无卡支付业务合作协议开展银联无卡支付收单业务的境内成员机构。商户指加入银联网络,与银联签订银联卡无卡支付业务合作协议开展银联无卡支付业务的商户。 本文档中针对商户且未有特殊说明的同样适用于收单机构;仅针对于收单机构的特殊项则会加以特别描述(一般不适用于商户)。2 规范性引用文件下列文件中的条款通过本标准的引用而成为本标准的条款。凡是注日期的引用文件,其随后所有的修改单(不包括勘误的内容)或修订版均不适用于本标准,然而,鼓励根据本标准达成协议的各方研究是否可使
7、用这些文件的最新版本。凡是不注日期的引用文件,其最新版本适用于本标准。Q/CUP 006 银行卡联网联合技术规范V2.0Q/CUP 001 银行卡信息交换术语3 术语和定义下列术语和定义适用于本标准。表1 术语解释代码含义样例UPOP中国银联互联网交易系统的简称商户代码商户是指与收单机构签订商户协议,代理银行卡的零售商、个人、公司或其他组织,收单机构方为其提供收单服务。商户接入UPOP时,由UPOP分配的全局唯一的id1234567890123456清算日期指处理中心在转接各类交易请求时,在转接信息中增加的处理中心的时间戳。该时间戳作为处理中心对转接信息进行币种转换、清算、收费、对账、查询以及
8、统计的日期依据。清算金额用于清算的资金轧差额。处理中心与入网机构约定清算时,事先指定清算币种,并采用轧差净额清算。对账交易双方之间的交易总额核对,以达到账务一致合作密钥商户和UPOP签订接入协议时,由双方共同确定的密钥串,该值可以在必要的时候双方重新确定。该串用于商户和UPOP通信时的签名。密钥串的长度为32。1234567890abcdef01234567890abcdef签名信息采用特定签名算法对交易过程中的关键信息和合作密钥进行签名,具有防篡改和防抵赖的特性。签名信息的长度暂定位32。商户应严格保密该密钥串,若该密钥串泄露或者长时间密钥更换,建议主动要求更换密钥串。否则造成的损失由商户承
9、担。1234567890abcdef01234567890abcdef4 交易处理说明在互联网电子商务交易中涉及商户、购买者、中间服务方三个角色。交易时,购买者在商户网站上选购一件或者多件商品,形成商品订单。购买者将商品订单提交给中间服务方,中间服务方实现从购买者账户到商户账户的资金转移。其中中国银联互联网系统充当网上交易过程中的中间服务方的角色,帮助买家付款,帮助商家收款。UPOP的接入功能集成在商户网站中,为了更好的为商户提供服务,提供商户的交易支付接口和交易信息查询接口。4.1 交易分类说明按交易的功能分类,可以将交易分为金融类、管理及安全控制类等。金融类包括消费、消费撤销、退货、预授权
10、、预授权撤销、预授权完成、预授权完成撤销。管理及安全控制类包括交易信息查询。4.2 金融类业务流程介绍1) 持卡人浏览商户网站、购买商品、选择使用银联快捷支付方式进行网上支付2) 商户网站将持卡人浏览器页面定向到中国银联互联网系统支付页面3) 用户完成支付相关信息的输入4) 中国银联互联网系统返回交易结果4.1) 通过页面跳转的方式返回交易结果。此种方式是异步交互的4.2) 通过后台通知的方式主动向商户系统发送交易结果5) 商户在收到中国银联互联网交易系统的交易结果通知时,若交易状态为成功,则建议应该立即向UPOP发起交易查询(该步骤可选),查询该交易是否成功,以此来防范第三方伪造交易成功的信
11、息。6) 中国银联互联网交易系统返回查询结果给商户4.2.1 通知重发机制对支持交易结果后台通知的商户,在交易结束后会将交易结果发送给商户。若一次没有发送成功,通过退避策略重新发送后台交易通知。具体方法为2(i-1) 分钟发送后台交易结果通知,在重新发送通知的过程中,只要有一次成功,则中断重发策略。其中i是重新发送的次数,i1, 5。说明:商户端在接收到交易通知时,应该立即确认已经收到,并且丢弃重复的交易结果通知。4.3 管理类业务流程介绍1) 当商户对无法确认交易结果或者对交易处理有异议时,可以主动发起信息查询2) 中国银联互联网交易系统返回查询结果5 消息结构采用HTTP 标准的POST
12、协议。36 消息域说明6.1 报文域的属性说明在银联互联网系统与各商户的报文中,各报文域的数据类型、长度属性及格式如下表所示:表2 报文域数据类型、长度属性及格式含义表字符含义A字母字符,A至Z,a至z,向左靠,右边多余位填空格B数据的二进制表示,后跟数字表示位(bit)的个数B用于表示变长的二进制数,后跟数字表示二进制数据所占字节(Byte)的个数n数值,0至9,右靠,首位有效数字前填零。若表示人民币金额,则最右二位为角、分p填充字符,如空格s特殊符号an字母和数字字符,左靠,右边多余位填空格as字母和特殊字符,左靠,右边多余位填空格cn压缩数字码,即BCD码ns数字和特殊字符,左靠,右边多
13、余位填空格ans字母、数字和特殊字符,左靠,右边多余位填空格ansb字母、数字、特殊字符和二进制数,左靠,右边多余位填空格MM月份,01至12DD日期,01至31YY年份,00至99hh时,00至23mm分,00至59ss秒,00至59VAR可变长度数据元33字符的固定长度.17最大17个字符的可变长度。X借贷符号,贷记为“C”,借记为“D”,并且总是与一个数字型金额数据元相连,例如,净对账金额中X+N16含义为前缀“C”或“D”和净对账金额的16位数字。ZISO 4909和ISO 7813中定义的磁卡第二、三磁道的代码集6.2 消息版本号Message Version Number6.2.1
14、 对应KEY元素version6.2.2 变量属性ns5.8,5到8位数字或字符.6.2.3 域描述用于表示支持的协议版本号。消息版本号必须表示为:*.*. *,其中 “*” 表示1到2个数字6.2.4 用法在所有的消息中,各组件都必须填写自身支持的协议版本号。消息版本号不能低于1.0.0。6.3 字符编码Character Set6.3.1 对应KEY元素charset6.3.2 变量属性 ans1.20,最长20位数字、字母或者特殊符号6.3.3 域描述本域指明了报文中字符的编码规范。6.3.4 用法目前支持的包括GBK、UTF-8等。6.4 签名方法Signing Method6.4.1
15、 对应KEY元素signMethod6.4.2 变量属性 an1.10,最长10位数字、字母6.4.3 域描述本域指明了报文中签名的算法。6.4.4 用法在交易应答中该域内容应与交易请求一致。目前支持的签名算法包括MD5。6.5 签名信息Signing Messages6.5.1 对应KEY元素signature6.5.2 变量属性 an32,32位定长的字母、数字6.5.3 域描述采用特定签名算法对交易过程中的关键信息和合作密钥进行签名,具有防篡改和防抵赖的特性。签名信息的长度暂定位32。商户应严格保密该密钥串,若该密钥串泄露或者长时间密钥更换,建议主动要求更换密钥串。否则造成的损失由商户承
16、担。6.5.4 用法算法请参考(规范性附录)数字签名当交易双方计算出来的签名信息不一致时,则直接拒绝交易。6.6 交易类型Transaction type6.6.1 对应KEY元素transType6.6.2 变量属性 n2,2位定长数字6.6.3 域描述本域指明了交易的种类。交易类型分段区分,具体定义如下表所示:表3 交易类型分段代码含义0130金融类交易3160金融撤销类交易6165收单机构发起的金融通知类交易6670发卡机构发起的金融通知类交易7180不涉及资金的其他交易81-99公共支付类交易6.6.4 用法在交易应答中该域内容应与交易请求一致。具体的用法如下:表4 交易类型用法代码含
17、义01消费31消费撤销02预授权32预授权撤销03预授权完成33预授权完成撤销04退货6.7 商户名称Merchant Name6.7.1 对应KEY元素merAbbr6.7.2 变量属性ans1.32,最大32个字母、数字、空格、符号(包括-_.空格中英文括号)和中文(字符集u4e00-u9fa5)6.7.3 域描述商户代码对应的商户名称。一般出现在显示给持卡人的页面中。6.7.4 用法一般用于请求消息中,表示商户名称。6.8 商户代码Merchant ID6.8.1 对应KEY元素merId6.8.2 变量属性n15.24,长度15到24个数字6.8.3 域描述商户代码。该商户应是已被批准
18、加入银联互联网系统的商户网站的代码。6.8.4 用法由中国银联互联网系统统一分配,不得重复。对所有的请求报文,该域必须出现,且在整个交易周期中保持不变。6.9 商户类型Merchants Type6.9.1 对应KEY元素merCode6.9.2 变量属性n4,4位定长数字字符6.9.3 域描述表示商户分类编码(MCC)。6.9.4 用法商户类型码表示商户的服务范围和属性。取值请参见GB/T 20548-2006金融零售业务 商户类别代码。6.10 通知URLNotify URL6.10.1 对应KEY元素backEndUrl6.10.2 变量属性ans1.256,最大256个(字母、数字和特
19、殊字符)的商户网站URL,URL编码说明参见7.1.3章节6.10.3 域描述商户网站的后台URL。绝对地址,例如:http:/ 用法当完成买家账户向商户账户的支付时,要求商户返回URL收到通知后进行响应。6.11 返回URLReturn URL6.11.1 对应KEY元素frontEndUrl6.11.2 变量属性ans1.256,最大256个(字母、数字和特殊字符)的API地址,URL编码说明参见7.1.3章节6.11.3 域描述商户网站的前台URL。例如:http:/ 6.11.4 用法当完成买家账户向商户账户的支付时,通过商户通知URL进行页面跳转。6.12 收单机构代码Acquire
20、r BIN6.12.1 对应KEY元素acqCode6.12.2 变量属性n.11,最大11位数字的收单机构代码6.12.3 域描述收单机构代码。该收单机构应是已被批准加入银联互联网系统的,能为商户网站提供收单服务的入网机构。6.12.4 用法收单机构代码是关键信息域,在发送方随后发出的与之相关的交易中该域信息也应保持不变。6.13 交易开始日期时间Start Date & Time For Purchase6.13.1 对应KEY元素orderTime6.13.2 变量属性 n14,14位定长数字字符6.13.3 域描述交易开始日期和时间均为北京时间。格式:YYYYMMDDHHMMSS,其中
21、YYYY 4个数字,表示年份MM 01-12,表示月份DD 01-31,表示日期HH 00-23,表示小时MM 00-59,表示分钟SS 00-59,表示秒6.13.4 用法交易发生时的时间日期。6.14 交易超时时间Expiring Time For Purchase6.14.1 对应KEY元素transTimeout6.14.2 变量属性 n.10,10位变长数字字符6.14.3 域描述单位为毫秒。6.14.4 用法交易发生时,该笔交易在银联互联网系统中有效的最长时间。当距离交易开始日期时间超过该时间时,银联互联网系统不再为该笔交易提供支付服务。6.15 交易完成日期时间Finishing
22、 Date & Time For Purchase6.15.1 对应KEY元素respTime6.15.2 变量属性 n14,14位定长数字字符6.15.3 域描述同6.13.3域描述6.15.4 用法该笔交易银联互联网系统收到发卡机构应答时的时间。6.16 商户订单号Merchant Order Number6.16.1 对应KEY元素orderNumber6.16.2 变量属性an8.32,最大32个字母、数字和-6.16.3 域描述用于表示商户的订单号。在商户内部应唯一。6.16.4 用法用于传送商户订单号信息,最大为32个字节的信息。6.17 商品名称Merchant Order In
23、formation6.17.1 对应KEY元素commodityName6.17.2 变量属性ans1.255,最大255个字母、数字、空格、符号(包括-_.空格中英文括号)和中文(字符集u4e00-u9fa5)。其编码格式应与6.3字符编码相一致。6.17.3 域描述用于表示订单的商品信息。6.17.4 用法用于传送商户订单的商品信息,最大为256个字节的信息。6.18 商品URLGoods URL6.18.1 对应KEY元素commodityUrl6.18.2 变量属性ans1.1024,最大1024个字母、数字和特殊字符,URL编码说明参见7.1.3章节6.18.3 域描述商品的URL。
24、与6.17商品名称对应。6.18.4 用法表示商品的URL。6.19 商品单价Goods Price6.19.1 对应KEY元素commodityUnitPrice6.19.2 变量属性n1.12,最长12位数字6.19.3 域描述单件商品的价格。本域中不带小数点,小数位根据6.24交易币种来决定。6.19.4 用法见6.23.4用法6.20 商品数量Goods Amount6.20.1 对应KEY元素commodityQuantity6.20.2 变量属性n1.10,最大10个数字的商品数量6.20.3 域描述商品的总数量。与6.17商品名称对应。6.20.4 用法表示商品的总数量。6.21
25、 运输费用Transportation Expenses6.21.1 对应KEY元素transferFee6.21.2 变量属性n1.12,最长12位数字6.21.3 域描述商品运输时的运费信息。本域中不带小数点,小数位根据6.24交易币种来决定。6.21.4 用法见6.23.4用法6.22 优惠信息Favorable Information6.22.1 对应KEY元素commodityDiscount6.22.2 变量属性n1.12,最长12位数字6.22.3 域描述内容是根据优惠券信息,或者折价数目等等交易折扣的金额。该金额表示原始金额和交易实际金额的差值。本域中不带小数点,小数位根据6.
26、24交易币种来决定。6.22.4 用法见6.23.4用法6.23 交易金额Purchase Amount6.23.1 对应KEY元素orderAmount6.23.2 变量属性 n1.12,最长12位数字6.23.3 域描述交易金额。本域中不带小数点,小数位根据6.24交易币种来决定。6.23.4 用法本域值是交易的总金额,包括商品的价格和运费。且其值在交易的整个过程中保持不变,其币种由交易币种指明,若本域出现,则交易币种必出现。对于参与多币种交易的发卡方,该域反映了收单方提交请求时的币种。当交易币种为人民币时,本域的最右两位应包含人民币的角和分。当交易币种为外币时,如果该币种没有小数位,则该
27、域的值代表实际交易金额;如果该币种有两个小数位,则表示方法同人民币;若有三个小数位,则最后一个小数位必须为零。用法举例如下表所示:表5 交易金额用法币种小数位数实际金额本域值人民币两位小数100002100002外币没有小数位10001000两位小数100002100002三位小数100011210001106.24 交易币种Purchase Currency6.24.1 对应KEY元素orderCurrency6.24.2 变量属性 n3,3位定长数字6.24.3 域描述表示交易货币代码。6.24.4 用法具体的用法如下:表6 交易币种用法代码含义156人民币840美元978欧元392日元7
28、56瑞士法郎036澳大利亚元124加拿大元344港币826英镑446澳门元702新加坡元901新台币360印尼盾6.25 持卡人姓名Cardholder Name6.25.1 对应KEY元素customerName6.25.2 变量属性ans1.20,最长20个字母、数字、空格、符号(包括.空格中英文括号)和中文(字符集u4e00-u9fa5)6.25.3 域描述持卡人真实的姓名。6.25.4 用法如果用户的姓名超过20位,则截取前20个字节。6.26 默认支付方式Default Payment Method6.26.1 对应KEY元素defaultPayType6.26.2 变量属性a120
29、,最长20字母,区分大小写,具体取值范围见表66.26.3 域描述6.27 持卡人在网站购物时,默认的首选交易支付方式。默认银行编码Default issuer Code6.27.1 对应KEY元素defaultBankNumber6.27.2 变量属性n1.11,最长11个位数字6.27.3 域描述持卡人在网站购物时,默认的首选使用的银行卡对应的发卡行编码6.28 持卡人IPCardholder IP6.28.1 对应KEY元素customerIp6.28.2 变量属性ns1.40,最长40个字节的数字或者特殊字符6.28.3 域描述持卡人访问商户网站时的IP地址。6.28.4 用法该地址可
30、以是IPv4格式,也可以是IPv6格式。6.29 交易流水号Serial Number6.29.1 对应KEY元素qid6.29.2 变量属性 n21,21位定长数字 6.29.3 域描述对于每一笔支付交易,银联互联网系统都赋予其一个交易流水号。该流水号不得重复。6.29.4 用法该值在银联互联网交易系统中唯一标识一笔交易,是系统处理的关键域。6.30 系统跟踪号Trace Number6.30.1 对应KEY元素traceNumber6.30.2 变量属性n6,6位定长数字6.30.3 域描述CUPS系统跟踪号,做对账时使用6.30.4 用法对账时使用6.31 系统跟踪时间Trace Tim
31、e6.31.1 对应KEY元素traceTime6.31.2 变量属性n10,10位定长数字 MMDDHHMMSS6.31.3 域描述CUPS系统跟踪时间,做对账时使用6.31.4 用法对账时使用6.32 原始交易流水号Initial Serial Number6.32.1 对应KEY元素origQid6.32.2 变量属性 n21,21位定长数字 6.32.3 域描述上一笔关联交易的交易流水号,以便于银联互联网系统可以准确定位原始交易。6.32.4 用法交易类型为“撤销”、“完成”或者“退货”时必填。6.33 商户保留域Merchant Reserved Field6.33.1 对应KEY元
32、素merReserved6.33.2 变量属性ans1.1024,最长1024个字母、数字或者特殊字符6.33.3 域描述此保留域供商户在请求报文中带给银联。6.33.4 用法(一)消费等前台类交易时,该域用来特殊信息的传递。表1 商户保留域信息定义子域1(商户摘要)1、 子域1(商户摘要)merAbstract0-8位可见字符,包括数字、字母、中文等merReserved= merAbstract =商户摘要(二)区分预授权及担保消费的标志位(注:仅在transType=02 时有用)。表2 商户保留域信息定义子域2(预授权/担保消费 标志位2、 子域2(预授权/担保消费 标志位)isPre
33、Auth布尔型:“true” 或者 “false”transType=02&merReserved=isPreAuth=true(三)交易查询时,该域用来收单机构号的传递收单机构号说明见6.12,以收单机构身份接入时必填merReserved=acqCode=收单机构号(四)二级商户信息的传递表3 商户保留域信息定义子域3(商户接入类型)子域4(二级商户代码)子域5(二级商户全称)子域6(二级商户简称)3、 子域3(商户接入类型)merPlatformType1位数字,1代表平台类, 0代表直连(普通)类若上送的该域是1(平台类),则子域4(二级商户代码)、子域5(二级商户全称)、子域6(二级
34、商户简称)都必填4、 子域4(二级商户代码)secondaryMerIdan5.25,最大25个字母(a-z)、数字5、 子域5(二级商户全称)secondaryMerFullNameans1.32,最大32个字母、数字、空格、符号(包括-_.空格中英文括号)和中文(字符集u4e00-u9fa5)6、 子域6(二级商户简称)secondaryMerAbbrans1.16,最大16个字母、数字、空格、符号(包括-_.空格中英文括号)和中文(字符集u4e00-u9fa5)merReserved=merPlatformType=1&secondaryMerId=12346789000&seconda
35、ryMerFullName=二级商户全称&secondaryMerAbbr=二级商户简称6.34 系统保留域UPOP Reserved Field6.34.1 对应KEY元素cupReseverd6.34.2 变量属性ans1.1024,最长1024个字母、数字或者特殊字符6.34.3 域描述此保留域供银联在应答报文中带给商户系统特殊信息。6.34.4 用法(一)交易查询时,该域用来特殊信息的传递,具体定义如下:表4 系统保留域信息定义子域1(订单金额)子域2(币种)1、 子域1(订单金额)orderAmount0-12位数字, 单位为分2、 子域2(币种)orderCurrency3位定长数
36、字, 交易成功时必填用法: 保留域外加大括号cupReserved=orderAmount=100&orderCurrency=156(二)交易支付方式表5 系统保留域信息定义子域3(交易支付方式)3、 子域3(交易支付方式)payMode可能的值为以下中的一种,括号内为中文解释:LitePay(认证支付),ProPay(快捷支付),CommonPay(普通支付),MicroPay(微支付),ExpressPay(储值卡支付),CSPay(网银支付),DirectPay(后台支付)用法: 保留域外加大括号cupReserved=payMode=LitePay(三)针对预授权完成交易,该域用来传
37、递原始交易流水号origQid该字段具体描述见6.32章节用法:保留域外加大括号cupReserved=origQid=2011061013245612345126.35 响应码Response Code6.35.1 对应KEY元素respCode6.35.2 变量属性 an2,2位定长数字字母6.35.3 域描述表示对其所收到的交易的处理情况,如成功处理、无法处理或拒绝。若无法处理或拒绝该交易,则将在本域包含无法处理或拒绝的理由。6.35.4 用法对每个收到的请求报文,商户都应将本系统处理的结果在本域中返回给发起方。应答码定义详见附录B(规范性附录)应答码。6.36 响应时间Response
38、 Time6.36.1 对应KEY元素respTime6.36.2 变量属性 n14,定长14位的数字6.36.3 域描述格式:yyyyMMddHHmmssMM 01-12dd 01-316.36.4 用法系统的响应时间。6.37 响应信息Response Messages6.37.1 对应KEY元素respMsg6.37.2 变量属性 ans1.1024,最长1024位的数字、字母或者特殊字符6.37.3 域描述对6.35响应码的文字描述6.37.4 用法对于系统错误的文字描述。6.38 清算金额Settle Amount6.38.1 对应KEY元素settleAmount6.38.2 变量
39、属性 n.12,最大12位数字的清算金额6.38.3 域描述用6.39清算币种的最小单位表示的清算金额,其中不包含任何标点。例如:如果清算金额为123.45RMB,则setlAmount元素将包含值12345。6.38.4 用法清算金额交易金额清算汇率,其中不包含任何手续费。本域中不带小数点,小数位由清算币种决定。本域用做商户清算的依据。如果是跨境交易,银联互联网系统在收到请求消息后,将交易金额根据当时的汇率转换成清算金额添加在应答消息中向商户转发。6.39 清算币种Settle Currency6.39.1 对应KEY元素settleCurrency6.39.2 变量属性 n3,3位定长数字
40、6.39.3 域描述表示交易清算货币代码。6.39.4 用法本域主要用于跨境交易,和清算金额配套使用。当清算币种与交易币种不同时,要求在应答报文中标识清算币种。6.40 清算汇率Settlement Conversion Rate6.40.1 对应KEY元素exchangeRate6.40.2 变量属性 n8,8位定长数字6.40.3 域描述银联与入网机构约定的交易币种到清算币种的转换汇率。格式为右对齐,无小数点。小数位数由最左边一位数字表示,第二位至第八位指的是汇率的值。6.40.4 用法本域由银联互联网系统填写,返回的应答报文中,该汇率为交易币种转换为商户清算币种的汇率。当报文中存在交易金
41、额和清算金额时,本域必须存在。若本域出现,则兑换日期、清算币种应同时出现。6.41 兑换日期Conversion Date6.41.1 对应KEY元素exchangeDate6.41.2 变量属性n4,4位定长数字6.41.3 域描述格式:MMDDMM 01-12DD 01-316.41.4 用法从原始交易币种转换成清算币种的转换汇率的有效日期。日期为MMDD格式,其中MM=月份,DD=日期。当交易币种和清算币种不一致时出现。6.42 清算日期Settle Date6.42.1 对应KEY元素settleDate6.42.2 变量属性n4,4位定长数字6.42.3 域描述格式:MMDDMM 01-12DD 01-316.42.4 用法受理方和发卡方之间的交易结算日期。6.43 查询结果Query Result6.43.1 对应KEY元素queryResult6.43.2 变量属性 n1,1位定长数字6.43.3 域描述在查询交易中,表示待查询的金融类交易在银联互联网系统的处理结果。6.43.4 用法具体的用法如下:表6 查询结果用法代码含义商户处理0成功承兑交易1失败拒绝交易2处理中稍后查询或者拒绝交易3无此交易拒绝交易7 交易报文格式说明7.1 说明7.1.1 符号约定表7 符号约定符号含义数据元数值符号M必须填写的域C某条件成
链接地址:https://www.31doc.com/p-2051979.html