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

注意：

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

2：机构（商户）应该以后台通知为准。

3：机构（商户）不一定每笔交易均收到前台应答。

字段名

变量名

类型/长度

说明

可空

协议版本

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}

<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：请按照“签名机制”中的签名方法对输入参数进行签名，该接口请求才能够被系统接收；

字段名

变量名

类型/长度

说明

可空

协议版本

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}

注意：

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

2：无论前后台通知，机构（商户）必须对报文进行签名验证。