《银联手机支付商户服务器接口说明文档.docVIP

商户服务器 接口说明文档 2012年7月9日  签名定义 生成签名 定义：商户端用银联分配的商户数字证书对交易信息的签名，防止交易被篡改 加密函数：BASE64(RSA(MD5(SRC),privatekey)) 参照：代码中SignBy.java中的createSign方法。 （方法参数:签名原串SRC、密码、私钥假名、私钥路径。） 订单支付接口（必备） 定义：由“订单提交”和“订单支付”两部分组成。 提交订单 定义:本接口用于商户服务器向前置服务器提交订单详情。 功能：服务器将指定报文及标准数据提交至前置服务器进行验签，验签成功后，前 置会返回相关数据，提示操作成功。其中签名原串为： SRC 描述 merchantName=**** merchantId=**** merchantOrderId=**** merchantOrderTime=**** merchantOrderAmt=**** merchantOrderDesc=**** transTimeout=**** 通过使用898000000000002.p12对三种加密方法中SRC（称为原串）进行加密处理 SRC（根据报文情况）可以为商户名称、商户代码、商户订单号、商户订单时间、商户订单金额、商户订单描述、交易超时时间域 3） 依次以key=value格式和符号拼接形成的字符串 订单验证： 定义：本接口用于商户客户端和插件进行数据验证操作。 功能：商户客户端，在接收到商户服务器传来的标准xml后，用其按照指定方式调 起插件，插件通过相关数据验证，对其xml进行数据验证操作。其中，签名原串为： SRC 描述 merchantId=**** merchantOrderId=**** merchantOrderTime=**** 与订单提交签名方式相同 2) 签名数据仅有3个节点，又称“三要素”。 订单查询接口（必备） 定义：用于插件根据商户号、订单号、交易时间等信息，或使用CUPS流水号来查 询商户订单详细处理信息 功能：用于商户对订单信息进行查询和验证 商户向银联平台发起的请求报文如下 ?xml version=1.0 encoding=UTF-8 ? upomp application=”QueryOrder.Req” version=1.0.0 transType交易类型(两位数字，01:消费,31:消费撤销,04:退货)/transType merchantId商户代码（15-24位数字）/merchantId merchantOrderId商户订单号/merchantOrderId merchantOrderTime商户订单时间(YYYYMMDDHHMMSS)/merchantOrderTime sign商户的签名/sign merchantPublicCert商户公钥证书（BASE64编码）/merchantPublicCert /upomp 银联在线支付平台返回给商户的响应报文如下 ?xml version=1.0 encoding=UTF-8 ? upomp application=”QueryOrder.Rsp” version=1.0.0. transType交易类型(两位数字，01:消费,31:消费撤销,04:退货)/transType merchantId商户代码（15-24位数字）/merchantId merchantOrderId商户订单号/merchantOrderId merchantOrderTime商户订单时间(YYYYMMDDHHMMSS)/merchantOrderTime sign银联手机在线支付平台的签名/sign queryResult查询结果(0：成功,1：失败,2：处理中,3：无此交易)/queryResult settleDate清算日期（MMdd）/settleDate setlAmt清算金额（12位整数, 单位为分）/setlAmt setlCurrency清算币种(3位数字，人民币为156)/setlCurrency converRate清算汇率/converRate cupsQidCUPS交易流水号/cupsQid cupsTraceNumCUPS系统跟踪号/cupsTraceNum cupsTraceTimeCUPS系统跟踪时间/cupsTraceTime cupsRespCodeCUPS响应码(00表示交易成功，其他表示失败)/cupsRespCode cupsRespDescCUPS响应码描述/cupsRespDesc /upomp