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

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

《互联网商户及收单机构接入接口规范Word下载.docx》由会员分享，可在线阅读，更多相关《互联网商户及收单机构接入接口规范Word下载.docx（43页珍藏版）》请在冰豆网上搜索。

2011-9-19

更新响应码

1.1.8

2011-9-27

添加isCustomPay字段 

（牡丹畅通卡）说明

1.1.9

2011-10-11

添加merUserId字段 

（商户端用户ID）说明

1.2.0

2011-10-17

添加响应码73

1.2.1

2011-11-7

添加响应码86

1.2.2

2011-11-8

添加专享支付方式字段说明

1.2.3

2011-11-10

添加customIp域针对防钓鱼说明

1.2.4

2011-11-23

张旭东

用户保留域增加订单超时时间（orderTimeoutDate）说明

1.2.5

2011-11-25

添加对bizType,bizSubType,riskFlag的说明

目次

前言

本标准规定了商户及收单机构接入中国银联互联网系统使用的报文接口，包括交易种类、交易正常处理流程、异常情况的处理流程、消息域说明、消息格式以及交易报文格式说明。

本标准由中国银联股份有限公司提出。

本标准由中国银联股份有限公司制定。

本标准主要起草单位：

中国银联互联网业务部。

本标准主要起草人：

11　范围

本标准规定了互联网商户及收单机构使用的报文接口，包括交易种类、交易正常处理流程和异常情况的处理流程、消息域说明、消息格式以及交易报文格式说明。

本标准的本部分适用于所有加入中国银联互联网系统的商户及收单机构。

参与方描述：

收单机构

指加入银联网络，与银联签订《银联卡无卡支付业务合作协议》开展银联无卡支付收单业务的境内成员机构。

商户

指加入银联网络，与银联签订《银联卡无卡支付业务合作协议》开展银联无卡支付业务的商户。

本文档中针对商户且未有特殊说明的同样适用于收单机构；

仅针对于收单机构的特殊项则会加以特别描述（一般不适用于商户）。

12　规范性引用文件

下列文件中的条款通过本标准的引用而成为本标准的条款。

凡是注日期的引用文件，其随后所有的修改单（不包括勘误的内容）或修订版均不适用于本标准，然而，鼓励根据本标准达成协议的各方研究是否可使用这些文件的最新版本。

凡是不注日期的引用文件，其最新版本适用于本标准。

Q/CUP006《银行卡联网联合技术规范V2.0》

Q/CUP001《银行卡信息交换术语》

13　术语和定义

下列术语和定义适用于本标准。

表1　术语解释

代码

含义

样例

UPOP

中国银联互联网交易系统的简称

商户代码

商户是指与收单机构签订商户协议，代理银行卡的零售商、个人、公司或其他组织，收单机构方为其提供收单服务。

商户接入UPOP时，由UPOP分配的全局唯一的id

1

清算日期

指处理中心在转接各类交易请求时，在转接信息中增加的处理中心的时间戳。

该时间戳作为处理中心对转接信息进行币种转换、清算、收费、对账、查询以及统计的日期依据。

清算金额

用于清算的资金轧差额。

处理中心与入网机构约定清算时，事先指定清算币种，并采用轧差净额清算。

对账

交易双方之间的交易总额核对，以达到账务一致

合作密钥

商户和UPOP签订接入协议时，由双方共同确定的密钥串，该值可以在必要的时候双方重新确定。

该串用于商户和UPOP通信时的签名。

密钥串的长度为32。

90abcdef090abcdef

签名信息

采用特定签名算法对交易过程中的关键信息和合作密钥进行签名，具有防篡改和防抵赖的特性。

签名信息的长度暂定位32。

商户应严格保密该密钥串，若该密钥串泄露或者长时间密钥更换，建议主动要求更换密钥串。

否则造成的损失由商户承担。

14　交易处理说明

在互联网电子商务交易中涉及商户、购买者、中间服务方三个角色。

交易时，购买者在商户网站上选购一件或者多件商品，形成商品订单。

购买者将商品订单提交给中间服务方，中间服务方实现从购买者账户到商户账户的资金转移。

其中中国银联互联网系统充当网上交易过程中的中间服务方的角色，帮助买家付款，帮助商家收款。

UPOP的接入功能集成在商户网站中，为了更好的为商户提供服务，提供商户的交易支付接口和交易信息查询接口。

14.1　交易分类说明

按交易的功能分类，可以将交易分为金融类、管理及安全控制类等。

金融类包括消费、消费撤销、退货、预授权、预授权撤销、预授权完成、预授权完成撤销。

管理及安全控制类包括交易信息查询。

14.2　金融类业务流程介绍

1）持卡人浏览商户网站、购买商品、选择使用银联快捷支付方式进行网上支付

2）商户网站将持卡人浏览器页面定向到中国银联互联网系统支付页面

3）用户完成支付相关信息的输入

4）中国银联互联网系统返回交易结果

4.1）通过页面跳转的方式返回交易结果。

此种方式是异步交互的

4.2）通过后台通知的方式主动向商户系统发送交易结果

5）商户在收到中国银联互联网交易系统的交易结果通知时，若交易状态为成功，则建议应该立即向UPOP发起交易查询（该步骤可选），查询该交易是否成功，以此来防范第三方伪造交易成功的信息。

6）中国银联互联网交易系统返回查询结果给商户

通知重发机制

对支持交易结果后台通知的商户，在交易结束后会将交易结果发送给商户。

若一次没有发送成功，通过退避策略重新发送后台交易通知。

具体方法为2（i-1）分钟发送后台交易结果通知，在重新发送通知的过程中，只要有一次成功，则中断重发策略。

其中i是重新发送的次数，i∈[1,5]。

说明：

商户端在接收到交易通知时，应该立即确认已经收到，并且丢弃重复的交易结果通知。

14.3　管理类业务流程介绍

1）当商户对无法确认交易结果或者对交易处理有异议时，可以主动发起信息查询

2）中国银联互联网交易系统返回查询结果

15　消息结构

采用HTTP标准的POST协议。

16　消息域说明

16.1　报文域的属性说明

在银联互联网系统与各商户的报文中，各报文域的数据类型、长度属性及格式如下表所示：

表2　报文域数据类型、长度属性及格式含义表

字符

A

字母字符，A至Z，a至z，向左靠，右边多余位填空格

B

数据的二进制表示，后跟数字表示位（bit）的个数

用于表示变长的二进制数，后跟数字表示二进制数据所占字节（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

ISO4909和ISO7813中定义的磁卡第二、三磁道的代码集

16.2　消息版本号

MessageVersionNumber

对应KEY元素

version

变量属性

ns5..8，5到8位数字或字符.

域描述

用于表示支持的协议版本号。

消息版本号必须表示为：

*.*.*，其中

“*”表示1到2个数字

用法

在所有的消息中，各组件都必须填写自身支持的协议版本号。

消息版本号不能低于1.0.0。

16.3　字符编码

CharacterSet

charset

ans1..20，最长20位数字、字母或者特殊符号

本域指明了报文中字符的编码规范。

目前支持的包括GBK、UTF-8等。

16.4　签名方法

SigningMethod

signMethod

an1..10，最长10位数字、字母

本域指明了报文中签名的算法。

在交易应答中该域内容应与交易请求一致。

目前支持的签名算法包括MD5。

16.5　签名信息

SigningMessages

signature

an32，32位定长的字母、数字

算法请参考（规范性附录）数字签名

当交易双方计算出来的签名信息不一致时，则直接拒绝交易。

16.6　交易类型

Transactiontype

transType

n2，2位定长数字

本域指明了交易的种类。

交易类型分段区分，具体定义如下表所示：

表3　交易类型分段

01—30

金融类交易

31—60

金融撤销类交易

61—65

收单机构发起的金融通知类交易

66—70

发卡机构发起的金融通知类交易

71—80

不涉及资金的其他交易

81--99

公共支付类交易

具体的用法如下：

表4　交易类型用法

01

消费

31

消费撤销

02

预授权

32

预授权撤销

03

预授权完成

33

预授权完成撤销

04

退货

16.7　商户名称

MerchantName

merAbbr

ans1..32，最大32个字母、数字、空格、符号（包括-_.空格中英文括号）和中文（字符集u4e00-u9fa5）

商户代码对应的商户名称。

一般出现在显示给持卡人的页面中。

一般用于请求消息中，表示商户名称。

16.8　商户代码

MerchantID

merId

n15..24，长度15到24个数字

商户代码。

该商户应是已被批准加入银联互联网系统的商户网站的代码。

由中国银联互联网系统统一分配，不得重复。

对所有的请求报文，该域必须出现，且在整个交易周期中保持不变。

16.9　商户类型

Merchant'

sType

merCode

n4，4位定长数字字符

表示商户分类编码（MCC）。

商户类型码表示商户的服务范围和属性。

取值请参见GB/T20548-2006《金融零售业务商户类别代码》。

16.10　通知URL

NotifyURL

backEndUrl

ans1..256，最大256个（字母、数字和特殊字符）的商户网站URL，URL编码说明参见7.1.3章节

商户网站的后台URL。

绝对地址，例如：

当完成买家账户向商户账户的支付时,要求商户返回URL收到通知后进行响应。

16.11　返回URL

ReturnURL

frontEndUrl

ans1..256，最大256个（字母、数字和特殊字符）的API地址，URL编码说明参见7.1.3章节

商户网站的前台URL。

例如：

当完成买家账户向商户账户的支付时,通过商户通知URL进行页面跳转。

16.12　收单机构代码

AcquirerBIN

acqCode

n..11，最大11位数字的收单机构代码

收单机构代码。

该收单机构应是已被批准加入银联互联网系统的，能为商户网站提供收单服务的入网机构。

收单机构代码是关键信息域，在发送方随后发出的与之相关的交易中该域信息也应保持不变。

16.13　交易开始日期时间

StartDate&

TimeForPurchase

orderTime

n14，14位定长数字字符

交易开始日期和时间均为北京时间。

格式：

YYYYMMDDHHMMSS，其中

YYYY4个数字，表示年份

MM01-12，表示月份

DD01-31，表示日期

HH00-23，表示小时

MM00-59，表示分钟

SS00-59，表示秒

交易发生时的时间日期。

16.14　交易超时时间

ExpiringTimeForPurchase

transTimeout

n..10，10位变长数字字符

单位为毫秒。

交易发生时，该笔交易在银联互联网系统中有效的最长时间。

当距离交易开始日期时间超过该时间时，银联互联网系统不再为该笔交易提供支付服务。

16.15　交易完成日期时间

FinishingDate&

respTime

同6.13.3　域描述

该笔交易银联互联网系统收到发卡机构应答时的时间。

16.16　商户订单号

MerchantOrderNumber

orderNumber

an8..32，最大32个字母、数字和-

用于表示商户的订单号。

在商户内部应唯一。

用于传送商户订单号信息，最大为32个字节的信息。

16.17　商品名称

MerchantOrderInformation

commodityName

ans1..255，最大255个字母、数字、空格、符号（包括-_.空格中英文括号）和中文（字符集u4e00-u9fa5）。

其编码格式应与6.3　字符编码相一致。

用于表示订单的商品信息。

用于传送商户订单的商品信息，最大为256个字节的信息。

16.18　商品URL

GoodsURL

commodityUrl

ans1..1024，最大1024个字母、数字和特殊字符，URL编码说明参见7.1.3章节

商品的URL。

与6.17　商品名称对应。

表示商品的URL。

16.19　商品单价

GoodsPrice

commodityUnitPrice

n1..12，最长12位数字

单件商品的价格。

本域中不带小数点，小数位根据6.24　交易币种来决定。

见6.23.4　用法

16.20　商品数量

GoodsAmount

commodityQuantity

n1..10，最大10个数字的商品数量

商品的总数量。

表示商品的总数量。

16.21　运输费用

TransportationExpenses

transferFee

商品运输时的运费信息。

16.22　优惠信息

FavorableInformation

commodityDiscount

内容是根据优惠券信息，或者折价数目等等交易折扣的金额。

该金额表示原始金额和交易实际金额的差值。

16.23　交易金额

PurchaseAmount

orderAmount

n1..12，最长12位数字

交易金额。

本域值是交易的总金额，包括商品的价格和运费。

且其值在交易的整个过程中保持不变，其币种由交易币种指明，若本域出现，则交易币种必出现。

对于参与多币种交易的发卡方，该域反映了收单方提交请求时的币种。

当交易币种为人民币时，本域的最右两位应包含人民币的角和分。

当交易币种为外币时，如果该币种没有小数位，则该域的值代表实际交易金额；

如果该币种有两个小数位，则表示方法同人民币；

若有三个小数位，则最后一个小数位必须为零。

用法举例如下表所示：

表5　交易金额用法

币种

小数位数

实际金额

本域值

人民币

两位小数

1000．02

100002

外币

没有小数位

1000

三位小数

1000．112

1000110

16.24　交易币种

PurchaseCurrency

orderCurrency

n3，3位定长数字

表示交易货币代码。

表6　交易币种用法

156

840

美元

978

欧元

392

日元

756

瑞士法郎

036

澳大利亚元

124

加拿大元

344

港币

826

英镑

446

澳门元

702

新加坡元

901

新台币

360

印尼盾

16.25　持卡人姓名

CardholderName

customerName

ans1..20，最长20个字母、数字、空格、符号（包括.空格中英文括号）和中文（字符集u4e00-u9fa5）

持卡人真实的姓名。

如果用户的姓名超过20位，则截取前20个字节。

16.26　默认支付方式

DefaultPaymentMethod

defaultPayType

a1…20，最长20字母，区分大小写。

持卡人在网站购物时，默认的首选交易支付方式。

可能的值为以下中的一种，括号内为中文解释：

LitePay（认证支付）,ProPay（快捷支付）,CommonPay（普通支付）,MicroPay（微支付）,ExpressPay（储值卡支付）,CSPay（网银支付）,DirectPay（后台支付）

16.27　默认银行编码

DefaultissuerCode

defaultBankNumber

a1..5，最长5个字母

持卡人在网站购物时，默认跳往的银行

16.28　持卡人IP

CardholderIP

customerIp

ns1..40，最长40个字节的数字或者特殊字符

持卡人访问商户网站时的IP地址。

若开启IP防钓鱼功能，则需上送持卡人真实IP。

该地址可以是IPv4格式，也可以是IPv6格式。

16.29　交易流水号

SerialNumber

qid

n21，21位定长数字

对于每一笔支付交易，银联互联网系统都赋予其一个交易流水号。

该流水号不得重复。

该值在银联互联网交易系统中唯一标识一笔交易，是系统处理的关键域。

16.30　系统跟踪号

TraceNumber

traceNumber

n6，6位定长数字

CUPS系统跟踪号，做对账时使用

对账时使用

16.31　系统跟踪时间

TraceTime

traceTime

n10，10位定长数字MMDDHHMMSS

CUPS系统跟踪时间，做对账时使用

16.32　原始交易流水号

InitialSerialNumber

origQid

上一笔关联交易的交易流水号，以便于银联互联网系统可以准确定位原始交易。

交易类型为“撤销”、“完成”或者“退货”时必填。

16.33　商户保留域

MerchantReservedField

merReserved

ans1..1024，最长1024个字母、数字或者特殊字符

此保留域供商户在请求报文中带给银联。

（一）消费等前台类交易时，该域用来特殊信息的传递。

表7　商户保留域信息定义

子域1（商户摘要）

1、子域1（商户摘要）

merAbstract

0-8位可见字符，包括数字、字母、中文等

merReserved={merAbstract=商户摘要}

（二）区分预授权及担保消费的标志位（注：

仅在transType=