热门搜索: 物流跟踪 自定义URL oauth2.0 银联
本站推荐
详细内容

shopex集成中国银联在线支付!

时间:2013-01-22 12:20 来源:未知 作者:admin 点击:

中国银联快捷支付业务机构(商户)接入指南

1 文档说明

1.1 功能描述

中国银联互联网快捷支付系统,为机构(商户)和持卡人提供安全、方便、快捷的支付渠道,通过银联快捷支付渠道,付款者可以直接通过银行卡进行网上支付。

1.2 阅读对象

《中国银联快捷支付业务机构(商户)接入指南》文档是面向具有一定的网站开发能力,了解PHPJAVA 等开发语言中的一种的网站开发、维护和管理人员。

 

1.3 业务术语

1.4 技术服务

 

在开发或使用银联快捷支付接口时,产生疑问或出现问题:

银联客服热线:95516

2 功能演示

步骤1 挑选商品并使用快捷支付平台付款。

商品结算选择银联在线支付方式

步骤2 跳转到快捷支付系统支付页面


步骤3 付款结束提示完成信息,并可以返回机构(商户)页面

 


3 功能演示数据交互

 

3.1 交易流程

(1)构造请求数据

机构(商户)根据快捷支付系统提供的接口规则,通过程序生成得到签名结果及报文信息传给快捷支付的数据集合。

(2)发送请求数据

把构造完成的数据集合,通过页面表单提交(POST)的方式传递给快捷支付。

(3)快捷支付系统对请求数据进行处理

快捷支付得到这些集合后,会先进行安全校验等验证,一系列验证通过后便会处理这次发送过来的数据请求。

(4)返回处理的结果数据

 对于处理完成的交易,快捷支付会以两种方式把数据反馈给机构(商户)网站。

1:前台通知 交易结束后,无卡支付系统自动进行重新构造URL 地址链接,在用户当前页面上通过用户点击方式跳回机构(商户)在请求时设定好的页面路径地址(参数frontEndUrl

2:后台通知 服务器主动发起通知,调用机构(商户)在请求时设定好的后台通知地址路径(参数backEndUrl

 (5)机构(商户)对获取的返回结果数据进行处理。

机构(商户)在前台通知处理页面(参数frontEndUrl指定页面)或服务器后台通知页面(参数backEndUrl指定页面)获取快捷支付返回的结果数据后,可以结合自身网站的业务逻辑进行数据处理(如:订单更新等操作)。以后台通知为准。

 

注意:

1:以上步骤第3步与第4步之间的操作是异步的。

2:机构(商户)应该以后台通知为准。

3:机构(商户)不一定每笔交易均收到前台应答。

 

3.2 查询流程

(1)构造查询请求数据

机构(商户)根据快捷支付系统提供的查询接口规则,通过程序生成得到签名结果及报文信息传输给快捷支付的数据集合。

(2)发送请求数据

把构造完成的数据集合,通过页面表单提交的方式传递给快捷支付。

(3)快捷支付系统对查询请求数据进行处理

快捷支付得到这些集合后,会先进行安全校验等验证,一系列验证通过后便会处理这次发送过来的数据请求。

(4)返回处理的结果数据

(5)机构(商户)对获取的返回结果数据进行处理。

 

4 交易请求参数说明

4.1 含义

交易请求参数是机构(商户)在与快捷支付进行数据交互时,提供给快捷支付的请求数据,以便快捷支付根据这些数据进一步处理。

4.2 列表

前台交易请求接口参数说明

字段名

变量名

类型/长度

说明

可空

协议版本

version

d{1,2}.d{1,2}.d{1,2}

 

 

字符编码

charset

ads{0,20}

必须为合法的字符集,全大写形式
  
默认UTF-8

 

交易类型

transType

d{2}

01:消费
31:
消费撤销
02:
预授权
32:
预授权撤销
03:
预授权完成
33:
预授权完成撤销
04:
退货
71:
实名认证

 

原始交易流水号

origQid

d{21}

 

transType=01,02,71

商户代码

merId

d{15,24}

 

 

商户简称

merAbbr

w{0,25}

 

 

收单机构代码

acqCode

d{0,11}

 

Y

商户类别

merCode

d{4}

 

acqCode is empty

商品URL

commodityUrl

ads{0,1024}

参数中中文等特殊字符需编码

Y

商品名称

commodityName

w{0,256}

 

Y

商品单价

commodityUnitPrice

d{0,12}

 

Y

商品数量

commodityQuantity

d{0,10}

 

Y

折扣

commodityDiscount

d{0,12}

 

Y

运费

transferFee

d{0,12}

 

Y

订单号

orderNumber

ad{8,32}

商户端的订单号,每个商户内唯一
  
消费类和后续类的订单号均需全新生成

 

交易金额

orderAmount

d{0,12}

 

 

交易币种

orderCurrency

d{3}

 

 

交易时间

orderTime

d{14}

yyyyMMddHHmmss, GMT+8

 

用户IP

customerIp

ds{0,40}

 

 

用户真实姓名

customerName

w{0,20}

 

Y

默认支付方式

defaultPayType

a{1,}

支持以下列表中的某一值(括号中为注释):
LitePay
(认证支付)
ProPay
(快捷支付)
CommonPay
(普通支付)
MicroPay
(小额支付)
ExpressPay
(储值卡支付)
CSPay
(网银支付)

Y

默认银行编号

defaultBankNumber

d{0,11}

 

Y

交易超时时间

transTimeout

d{0,10}

 

Y

前台回调URL

frontEndUrl

ads{0,256}

参数中中文等特殊字符需编码

 

后台回调URL

backEndUrl

ads{0,256}

参数中中文等特殊字符需编码

 

商户保留域

merReserved

ads{0,1024}

需要显示的支付方式,支持的全部方式参见defaultPayType,以逗号连接,举例如下:{payModes=LitePay,ProPay,CommonPay,MicroPay,ExpressPay,CSPay}

Y

签名方法

signMethod

ad{0,10}

MD5/RSA/DSA/其它, default=md5

 

签名

signature

ad{32}

 

 

 

 

4.3 样例

交易请求:

<script language="javascript">window.onload=function(){document.pay_form.submit();}</script><form id="pay_form" name="pay_form" action="http://127.0.0.1:8080/UpopWeb/api/Pay.action" method="post"><input type="hidden" name="acqCode" id="acqCode" value="00215800" /><input type="hidden" name="backEndUrl" id="backEndUrl" value="http://172.17.136.36:8080/UpopApi/payBackResServlet" /><input type="hidden" name="charset" id="charset" value="UTF-8" /><input type="hidden" name="commodityDiscount" id="commodityDiscount" value="0" /><input type="hidden" name="commodityName" id="commodityName" value="物品名称如短袖" /><input type="hidden" name="commodityQuantity" id="commodityQuantity" value="1" /><input type="hidden" name="commodityUnitPrice" id="commodityUnitPrice" value="18800" /><input type="hidden" name="commodityUrl" id="commodityUrl" value="http://218.80.192.2231/shop1/payment/quickpay/quickpay_result.php?payid=123456&dd=123" /><input type="hidden" name="customerIp" id="customerIp" value="127.0.0.1" /><input type="hidden" name="customerName" id="customerName" value="张三" /><input type="hidden" name="defaultBankNumber" id="defaultBankNumber" value="" /><input type="hidden" name="defaultPayType" id="defaultPayType" value="" /><input type="hidden" name="frontEndUrl" id="frontEndUrl" value="http://172.17.136.36:8080/UpopApi/payFrontResServlet" /><input type="hidden" name="merAbbr" id="merAbbr" value="用户商城名称" /><input type="hidden" name="merCode" id="merCode" value="3333" /><input type="hidden" name="merId" id="merId" value="335550149170027" /><input type="hidden" name="merReserved" id="merReserved" value="" /><input type="hidden" name="orderAmount" id="orderAmount" value="20000" /><input type="hidden" name="orderCurrency" id="orderCurrency" value="156" /><input type="hidden" name="orderNumber" id="orderNumber" value="2011052516560615" /><input type="hidden" name="orderTime" id="orderTime" value="20110525165606" /><input type="hidden" name="origQid" id="origQid" value="" /><input type="hidden" name="transTimeout" id="transTimeout" value="120000" /><input type="hidden" name="transType" id="transType" value="01" /><input type="hidden" name="transferFee" id="transferFee" value="1200" /><input type="hidden" name="version" id="version" value="1.0.0" /><input type="hidden" name="signature" id="signature" value="4d2e92068ffb8f6aacfa5ed7fbc939d6"><input type="hidden" name="signMethod" id="signMethod" value="MD5" /></form>

 

 

注意:

1:以上请求类接口支持POST方式

2:请按照“签名机制”中的签名方法对输入参数进行签名,该接口请求才能够被系统接收;

 

 

5 交易前台通知参数说明

5.1 含义

快捷支付对机构(商户)的请求数据处理完成后,会将处理的结果数据通过系统程序控制客户端页面自动跳转的方式通知给机构(商户)网站。这些处理结果数据就是页面跳转前台通知参数。

5.2 参数说明

前台交易回复接口参数说明

字段名

变量名

类型/长度

说明

可空

 

 

 

 

 

协议版本

version

d{1,2}.d{1,2}.d{1,2}

1.0.0

 

字符编码

charset

ads{0,20}

默认为交易请求中的字符集

 

交易类型

transType

d{2}

01:消费
31:
消费撤销
02:
预授权
32:
预授权撤销
03:
预授权完成
33:
预授权完成撤销
04:
退货

 

响应码

respCode

d{2}

两位数字

 

响应信息

respMsg

w{0,1024}

 

 

响应时间

respTime

d{14}

yyyyMMddHHmmss

 

商户代码

merId

d{15,24}

 

 

商户简称

merAbbr

w{0,25}

 

 

订单号

orderNumber

ad{1,20}

商户端的订单号,每个商户内唯一

 

系统跟踪号

traceNumber

d{6}

对账时使用

 

系统跟踪时间

traceTime

d{10}

MMddHHmmss

 

交易流水号

qid

d{21}

UPOP系统内全局唯一

 

交易金额

orderAmount

d{0,12}

 

 

交易币种

orderCurrency

d{3}

 

 

清算金额

settleAmount

d{0,12}

单位为分

 

清算币种

settleCurrency

d{3}

交易成功时必填

 

清算日期

settleDate

d{4}

MMdd

 

汇率

exchangeRate

d{8}

右对齐,无小数点。小数位数由最左边一位数字表示,第二位至第八位指的是汇率的值

 

兑换日期

exchangeDate

d{4}

MMdd

 

系统保留域

cupReserved

ads{0,1024}

 

Y

签名方法

signMethod

ad{0,10}

MD5/RSA/DSA/其它, default=md5

 

签名

signature

ad{32}

 

 

 

 

6 交易后台通知参数说明

6.1 含义

快捷支付对对机构(商户)的请求数据处理完成后,会将处理的结果数据通过服务器主动通知的方式通知给机构(商户)网站。这些处理结果数据就是服务器后台通知参数。

6.2 参数说明

参考 页面跳转前台通知参数说明的前台交易回复接口参数说明。

 

注意:

1:由于网络原因,机构(商户)收到前后台通知的顺序不固定。可能获取不到前台通知,需要以后台通知为准。

2:无论前后台通知,机构(商户)必须对报文进行签名验证。


(责任编辑:admin)
标签:shopex在线支付银联快捷支付UPOP
上一篇:shopex/分销王按货号模糊查询商品 下一篇:shopex/分销王产品详细页显示上一个商品下一个商品