《2022年银联手机支付_商户服务器接口说明文档 .pdf》由会员分享,可在线阅读,更多相关《2022年银联手机支付_商户服务器接口说明文档 .pdf(7页珍藏版)》请在taowenge.com淘文阁网|工程机械CAD图纸|机械工程制图|CAD装配图下载|SolidWorks_CaTia_CAD_UG_PROE_设计图分享下载上搜索。
1、商户服务器接口说明文档2012 年 7月 9 日名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 1 页,共 7 页 - - - - - - - - - 签名定义生成签名定义:商户端用银联分配的商户数字证书对交易信息的签名,防止交易被篡改加密函数: BASE64(RSA(MD5( SRC ),privatekey) 参照:代码中SignBy.java中的 createSign方法。(方法参数 : 签名原串SRC 、密码、私钥假名、私钥路径。)订单支付接口(必备)定义:由“订单提交”和“
2、订单支付”两部分组成。提交订单定义 : 本接口用于商户服务器向前置服务器提交订单详情。功能: 服务器将指定报文及标准数据提交至前置服务器进行验签,验签成功后, 前置会返回相关数据,提示操作成功。其中签名原串为:SRC描述merchantName=* &merchantId=*&merchantOrderId=*&merchantOrderTime=*&merchantOrderAmt=*&merchantOrderDesc=*&transTimeout=* 1)通过使用898000000000002.p12对三种加密方法中SRC (称为原串)进行加密处理2)SRC (根据报文情况)可以为商户名
3、称、商户代码、商户订单号、商户订单时间、商户订单金额、商户订单描述、交易超时时间域3) 依次以key=value格式和 &符号拼接形成的字符串名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 2 页,共 7 页 - - - - - - - - - 订单验证 :定义:本接口用于商户客户端和插件进行数据验证操作。功能: 商户客户端, 在接收到商户服务器传来的标准xml 后,用其按照指定方式调起插件, 插件通过相关数据验证,对其 xml 进行数据验证操作。其中,签名原串为:SRC描述merc
4、hantId=*&merchantOrderId=*&merchantOrderTime=*&1) 与订单提交签名方式相同2) 签名数据仅有3 个节点,又称“三要素” 。订单查询接口(必备)定义:用于插件根据商户号、订单号、交易时间等信息,或使用CUPS流水号来查询商户订单详细处理信息功能:用于商户对订单信息进行查询和验证商户向银联平台发起的请求报文如下 交易类型 ( 两位数字, 01: 消费 ,31: 消费撤销 ,04: 退货 ) 商户代码( 15-24 位数字) 商户订单号 商户订单时间 (YYYYMMDDHHMMSS) 商户的签名 商户公钥证书(BASE64编码) 名师资料总结 - -
5、-精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 3 页,共 7 页 - - - - - - - - - 银联在线支付平台返回给商户的响应报文如下 交易类型 ( 两位数字, 01: 消费 ,31: 消费撤销 ,04: 退货 ) 商户代码( 15-24 位数字) 商户订单号 商户订单时间 (YYYYMMDDHHMMSS) 银联手机在线支付平台的签名 查询结果 (0 :成功 ,1 :失败 ,2 :处理中 ,3 :无此交易) 清算日期( MMdd ) 清算金额( 12 位整数 , 单位为分) 清算币种 (3 位数
6、字,人民币为156) 清算汇率 CUPS交易流水号 CUPS系统跟踪号 CUPS 系统跟踪时间 CUPS 响应码 (00 表示交易成功, 其他表示失败 ) CUPS响应码描述 名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 4 页,共 7 页 - - - - - - - - - 订单退货接口(可选)定义:已提交成功的订单,采取的人为退订的一个过程功能:给与商户对商品提供退货的的功能,通过如下报文6 节点签名传给服务器,最后由银联支付平台返回结果通知(0000 成功,其他表示失败)注意
7、: 1.新商户订单号是指就是新生成的商户订单号,而不是原来的订单号,原交易流水号是指交易结果通知中的交易流水号商户发送到服务器的请求报文如下 商户代码( 15-24 位数字) 新商户订单号 新商户订单时间(YYYYMMDDHHMMSS) 原商户订单金额(单位为分) 原交易的CUPS交易流水号 商户通知 URL(商户用来接收交易结果通知的URL) 上方 6 节点的签名 商户公钥证书(BASE64编码) 银联手机在线支付平台返给商户的响应报文如下 商户代码( 15-24 位数字) 名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师
8、精心整理 - - - - - - - 第 5 页,共 7 页 - - - - - - - - - 商户订单号 商户订单时间 (YYYYMMDDHHMMSS) 商户订单金额 (12 位整数 , 单位为分) 原交易的CUPS交易流水号 银联手机在线支付平台的签名 响应码 (0000 表示提交退货请求成功,其他表示失败) 响应码描述 订单撤销接口(可选)定义:已提交的订单产品采取撤销的操作,24 小时内可以撤销订单有效,超时无效功能:实现已订产品的撤销操作注意: 1.新商户订单号是指就是新生成的商户订单号,而不是原来的订单号,原交易流水号是指交易结果通知中的交易流水号商户发送到服务器的请求报文如下
9、商户代码( 15-24 位数字) 新商户订单号 新商户订单时间(YYYYMMDDHHMMSS) 原商户订单金额(单位为分) 原交易的CUPS交易流水号 商户通知 URL(商户用来接收交易结果通知的URL) 名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 6 页,共 7 页 - - - - - - - - - 上方 6 节点的签名 商户公钥证书(BASE64编码) 银联手机在线支付平台返给商户的响应报文如下 商户代码( 15-24 位数字) 商户订单号 商户订单时间 (YYYYMMDDHHMMSS) 商户订单金额 (12 位整数 , 单位为分) 原交易的CUPS交易流水号 银联手机在线支付平台的签名 响应码 (0000 表示提交消费撤销请求成功,其他表示失败) 响应码描述 名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 7 页,共 7 页 - - - - - - - - -