当前位置: 产品API > 云闪付 > 云闪付APP-无感支付
产品介绍
  • 服务对象
    通过银联相关部门审核的全渠道商户、收单机构等
  • 产品详情

     接入方可通过两种方式发起签约(暂不支持云闪付APP外的H5发起签约):

    1.     SDK签约:接入方APP通过SDK唤起云闪付APP签约

    2.     H5签约:接入方H5嵌入云闪付APP后可唤起签约页


    接入云闪付APP无感支付后整体流程如下:

    QQ截图20190325104331.png

     

  • 产品亮点
    1. 技术创新保障业务安全:基于银联成熟的支付标记化技术,“云闪付APP无感支付”具备了支付标记化已有的商户管理、限额管理、风控信息管理等功能,保障支付安全性。同时结合云闪付APP开放平台OAUTH2.0授权联登技术及基于SCOPE的接入方权限管理技术,充分校验商户与用户身份,进一步增强用户签约时的安全性。

       

    2. 用户体验好,方案灵活:产品设计从用户的体验出发,操作简洁,一次签约授权,以后都可无感支付。同时基于用户账户支付,支持银行卡降级扣款,支付成功率高。用户可在云闪付APP上统一管理所有已签约的无感支付项目,安全、便捷。

     

  • 应用场景

     适用于小额高频、定时扣款、先用后付场景。

     QQ截图20190325104010.png

接入流程
接入流程

 

编号

阶段

责任方

说明

1

合作洽谈

接入申请方(银联总公司各部门及各分公司等)

内容提供方

接入申请方自行完成业务合作洽谈工作,与内容提供方建立合作意向。签订无感支付业务合作协议。

 

2

全渠道商户入网

接入申请方(银联总公司各部门及各分公司等)

内容提供方

接入方完成全渠道商户入网,获得商户号。如是首次入网,请先开通手机控件支付。

3

云闪付APP入网

接入申请方(银联总公司各部门及各分公司等)
  内容提供方
  云闪付事业部

1、合作意向确定后,接入申请方通过UOSP“云闪付APP开放平台内容接入申请(获取用户B类及以上数据)”工单向云闪付事业部提出业务接入申请。

2、云闪付事业部提交商户入网BOS工单“申请开通云闪付APP无感支付(签约免密支付)权限”


4

技术对接

接入申请方

内容提供方

云闪付事业部

内容提供方根据云闪付APP开放平台商户对接文档进行改造,银联会指派人员进行技术支持与后续的测试。

5

业务上线

接入申请方

内容提供方

云闪付事业部

测试通过后,接入申请方通过UOSP提交"云闪付APP应用接入上线"申请,附件提供无感支付业务合作协议及业务操作手册,流程审批通过后方可上线。

联系人:徐鑫源/黄知亮

联系电话:021-20632403/021-20637072

 

注意事项

1、支付联调支持

支付消费相关接口可参考手机控件支付,对接如有问题,可线上咨询。商户号及证书相关问题请联系收单或商户号申请专员提供。

https://open.unionpay.com/tjweb/acproduct/list?apiservId=450


2、获取用户相关信息

云闪付无感支付产品不涉及用户信息授权,接入方如涉及获取用户手机号等信息申请,请参考无感支付内容接入模板相关接口。

https://open.unionpay.com/tjweb/api/detail?apiSvcId=482


3、支付状态同步问题

接入方发起支付请求后,请等待银联的异步通知,以确定最终支付状态。建议超过5分钟以上仍未收到结果通知,再发起主动查询。如发起支付后立刻查询支付状态,将无法获得最终的支付状态。

避免短时间内频繁查询同一订单状态,否则会被拉黑,影响正常业务。

QQ截图20190325104710.png

API接口
获取backendToken
接口描述
基础服务令牌, backendToken为OAUTH2授权用,其有效期前设置为7200秒,接入方放入缓存,定期更新即可。
请求方式
POST
生产地址
https://open.95516.com/open/access/1.0/backendToken
测试地址
https://open.95516.com/open/access/1.0/backendToken
请求报文体参数
名称 标识 字段类型 长度 请求要求 默认值 备注
接入方唯一标识 appId string M-必填 接入方的唯一标识   
随机字符串 nonceStr string M-必填 生成签名的随机串   
生成签名的时间戳 timestamp string M-必填 生成签名的时间戳   
签名值 signature string M-必填 签名值,签名因子包括(appId, secret, nonceStr, timestamp)   
同步应答参数
名称 标识 字段类型 长度 请求要求 默认值 备注
凭证超时时间 expiresIn string M-必填 backendToken超时时间,单位(秒)   
基础服务令牌 backendToken string M-必填 backendToken为OAUTH2授权用,其有效期前设置为7200秒,接入方放入缓存,定期更新即可。   
示例代码
请求代码

HttpPost httpPost = new HttpPost("https://open.95516.com/open/access/1.0/backendToken");

       CloseableHttpClient client = HttpClients.createDefault();

       String respContent = null;

       // appid

       String appid = new String("a00000000000000000000000000000001");

       // secret秘钥

       String secret = new String("2aaaaaaaaaaaaaaaaaaaaaaaaaaaaaa0");

       // json方式

       JSONObject jsonParam = new JSONObject();

       jsonParam.put("appId", appid);

       // 生成随机字符串

       String str = Utils.createNonceStr();

       jsonParam.put("nonceStr", str);

       // 时间戳

       String date = String.valueOf(System.currentTimeMillis() / 1000);

       jsonParam.put("timestamp", date);

       // 生成签名

       String waitSign = "appId=" + appid + "&nonceStr=" + str + "&secret=" + secret + "&timestamp=" + date;

       String sign = Utils.sha256(waitSign.getBytes());

       jsonParam.put("signature", sign);

       System.out.println(jsonParam.toString());

       // 解决中文乱码问题

       StringEntity entity = new StringEntity(jsonParam.toString(), "utf-8");

       entity.setContentEncoding("UTF-8");

       entity.setContentType("application/json");

       httpPost.setEntity(entity);

       HttpResponse resp = client.execute(httpPost);

       if (resp.getStatusLine().getStatusCode() == 200) {

           HttpEntity he = resp.getEntity();

           respContent = EntityUtils.toString(he, "UTF-8");

       }

    System.out.println(respContent);

待补充

获取code
接口描述
H5接入方跳转到此页面,请求获取code(客户端通过SDK获取,请参考SDK相关文档、DEMO)。
请求方式
GET
生产地址
https://open.95516.com/s/open/noPwd/html/open.html?appId=APPID&redirectUri=REDIRECTURI&responseType=code&scope=upapi_contract&planId=123&state=STATE
测试地址
https://open.95516.com/s/open/noPwd/html/open.html?appId=APPID&redirectUri=REDIRECTURI&responseType=code&scope=upapi_contract&planId=123&state=STATE
请求报文体参数
名称 标识 字段类型 长度 请求要求 默认值 备注
接入方唯一标识 appId string M-必填 接入方的唯一标识   
回调地址 redirectUri string M-必填 授权后重定向的回调地址,请使用urlencode对链接进行处理   
返回类型 responseType string M-必填 code 返回类型,请填写code   
授权域 scope string M-必填 应用授权作用域   
协议模板 planId string M-必填 接入方定义的签约协议模板Id,用于在签约页面中展示签约内容   
接入方自定义标识 state string R-原值返回 重定向后会带上state参数,开发者可以填写a-zA-Z0-9的参数值,最多128字节   
同步应答参数
名称 标识 字段类型 长度 请求要求 默认值 备注
code code string M-必填 用户签约后云闪付返回的code   
接入方自定义标识 state string R-原值返回 重定向后会带上state参数,开发者可以填写a-zA-Z0-9的参数值,最多128字节   
错误信息 errmsg string C-依条件必填 错误描述   
获取accessToken
接口描述
获取签约接口访问令牌。accessToken有效期为1小时,当accessToken超时后,需要重新获取。
请求方式
POST
生产地址
https://open.95516.com/open/access/1.0/token
测试地址
https://open.95516.com/open/access/1.0/token
请求报文体参数
名称 标识 字段类型 长度 请求要求 默认值 备注
接入方唯一标识 appId string M-必填 接入方的唯一标识   
backendToken backendToken string M-必填 接入方获取到的backendToken   
code code string M-必填 接入方获取到的code   
类型 grantType string M-必填 authorization_code 接入方直接填写常量字符串authorization_code   
同步应答参数
名称 标识 字段类型 长度 请求要求 默认值 备注
接口调用凭证 accessToken string M-必填 网页授权接口调用凭证   
有效期 expiresIn string M-必填 accessToken接口调用凭证超时时间,单位(秒)   
刷新token refreshToken string M-必填 用户刷新accessToken   
用户唯一标识 openId string M-必填 云闪付APP开放平台用户唯一标识   
授权域 scope string M-必填 用户授权的作用域   
申请签约
接口描述
获取签约协议号,用于后期发起无感支付。
请求方式
POST
生产地址
https://open.95516.com/open/access/1.0/contract.apply
测试地址
https://open.95516.com/open/access/1.0/contract.apply
请求报文体参数
名称 标识 字段类型 长度 请求要求 默认值 备注
接入方的唯一标识 appId string M-必填 云闪付为接入方分配   
accessToken accessToken string M-必填 根据之前的接口,待用户签约授权后获取   
用户唯一标识 openId string M-必填 获取accessToken时同步获取的openId   
backendToken backendToken string M-必填 根据之前接口获取的backendToken   
协议模板id planId string M-必填 用户签约模板,接入方提供模板内容后,由云闪付为接入方分配   
接入方协议号 contractCode string M-必填 接入方侧的签约协议号,由接入方自行生成,云闪付原文返回   
同步应答参数
名称 标识 字段类型 长度 请求要求 默认值 备注
接入方协议号 contractCode string R-原值返回 接入方侧的签约协议号,由接入方自行生成,云闪付原文返回   
协议模板id planId string M-必填 接入方传来的协议模板id   
用户唯一标识 openId string M-必填 获取accessToken时同步获取的openId   
操作时间 operateTime string M-必填 操作时间   
签约协议号 contractId string M-必填 签约成功后,云闪付返回的签约协议号,接入方凭此发起扣款,返回数据格式为AN32   
申请解约
接口描述
用户在商户侧解约时,商户后台调用本接口。
请求方式
POST
生产地址
https://open.95516.com/open/access/1.0/contract.relieve
测试地址
https://open.95516.com/open/access/1.0/contract.relieve
请求报文体参数
名称 标识 字段类型 长度 请求要求 默认值 备注
接入方的唯一标识 appId string M-必填 云闪付为接入方分配   
用户唯一标识 openId string M-必填 云闪付APP开放平台用户唯一标识   
backendToken backendToken string M-必填 接入方获取到的backendToken   
签约协议号 contractId string M-必填 签约成功后,云闪付返回的签约协议号   
协议模板id planId string M-必填 用户签约模板,接入方提供模板内容后,由云闪付为接入方分配   
接入方协议号 contractCode string M-必填 接入方侧的签约协议号,由接入方自行生成,云闪付原文返回   
同步应答参数
名称 标识 字段类型 长度 请求要求 默认值 备注
接入方协议号 contractCode string R-原值返回 接入方侧的签约协议号,由接入方自行生成,云闪付原文返回   
协议模板id planId string M-必填 协议模板id   
用户唯一标识 openId string M-必填 云闪付APP开放平台用户唯一标识   
操作时间 operateTime string M-必填 操作时间   
解约结果通知
接口描述
用户在云闪付APP侧解约时,云闪付后台通知商户后台。(目前暂不支云闪付APP侧的解约,建议接入方设计授权解约功能)
请求方式
POST
生产地址
调用第三方回调地址,通知解约结果
测试地址
调用第三方回调地址,通知解约结果
请求报文体参数
名称 标识 字段类型 长度 请求要求 默认值 备注
接入方的唯一标识 appId string M-必填 接入方的唯一标识   
时间戳 timestamp string M-必填 生成签名的时间戳   
随机字符串 nonceStr string M-必填 生成签名的随机串   
操作时间 operateTime string M-必填 操作时间   
用户唯一标识 openId string M-必填 OAUTH2中获取的openId   
协议模板id planId string M-必填 接入方传来的协议模板id   
接入方侧协议号 contractCode string M-必填 接入方传来的签约协议号   
签名 signature string M-必填 请使用银联的公钥验证签名,输出格式为base64.   
同步应答参数
名称 标识 字段类型 长度 请求要求 默认值 备注
通知应答 resp string M-必填 成功接收通知以后发送 {‘resp’: ‘00’} 返回   
用户状态查询
接口描述
接入方在用户入场前,查询用户目前是否存在欠款情况。如存在欠款,可提示用户去云闪付APP完成补缴,并阻止用户进入。
请求方式
POST
生产地址
https://open.95516.com/open/access/1.0/contract.status
测试地址
https://open.95516.com/open/access/1.0/contract.status
请求报文体参数
名称 标识 字段类型 长度 请求要求 默认值 备注
backendToken backendToken string M-必填 根据之前接口获取的backendToken   
用户唯一标识 openId string M-必填 云闪付APP开放平台用户唯一标识   
接入方的唯一标识 appId string M-必填 云闪付为接入方分配   
同步应答参数
名称 标识 字段类型 长度 请求要求 默认值 备注
用户状态 enable string M-必填 返回0,表示无未完成订单;返回1-N,表示存在N笔未完成订单。   
发起消费交易
接口描述
商户组织消费交易报文,发送报文给后台系统,后台系统完成交易处理,并将组织受理结果报文和交易结果返回商户。
请求方式
POST
生产地址
https://gateway.95516.com/gateway/api/backTransReq.do
测试地址
https://gateway.95516.com/gateway/api/backTransReq.do
请求报文体参数
名称 标识 字段类型 长度 请求要求 默认值 备注
版本号 version string M-必填 5.1.0 固定填写   
编码方式 encoding string M-必填 UTF-8 默认取值:UTF-8   
证书ID certId string C-依条件必填   
签名 signature string M-必填 填写对报文摘要的签名   
签名方法 signMethod string M-必填 非对称签名:01(表示采用RSA签名) HASH表示散列算法 11:支持散列方式验证SHA-256 12:支持散列方式验证SM3   
交易类型 txnType string M-必填 1.0 取值:01   
交易子类 txnSubType string M-必填 10.0 10:无感支付(签约协议号支付)   
产品类型 bizType string 6 M-必填 默认000000   
渠道类型 channelType string 2 M-必填 07/08   
前台通知地址 frontUrl string O-选填 前台返回商户结果时使用,前台类交易需上送   
后台通知地址 backUrl string M-必填 后台返回商户结果时使用,如上送,则发送商户后台交易结果通知,如需通过专线通知,需要在通知地址前面加上前缀:专线的首字母加竖线ZX|   
接入类型 accessType string M-必填 0:普通商户直连接入 1:收单机构接入 2:平台类商户接入   
收单机构代码 acqInsCode string C-依条件必填 接入类型为收单机构接入时需上送   
商户类别 merCatCode string C-依条件必填 接入类型为收单机构接入时需上送   
商户代码 merId string M-必填   
商户名称 merName string C-依条件必填 接入类型为收单机构接入时需上送   
商户英文名称 merEnName string C-依条件必填 接入类型为收单机构接入时需上送   
商户简称 merAbbr string C-依条件必填 接入类型为收单机构接入时需上送   
二级商户代码 subMerId string C-依条件必填 商户类型为平台类商户接入时必须上送   
二级商户全称 subMerName string C-依条件必填 商户类型为平台类商户接入时必须上送   
二级商户简称 subMerAbbr string C-依条件必填 商户类型为平台类商户接入时必须上送   
商户订单号 orderId string M-必填 商户端生成   
订单发送时间 txnTime string M-必填 商户发送交易时间   
签约协议号 contractId string M-必填 交易子类为10签约支付时必送   
交易金额 txnAmt string M-必填 单位为分   
交易币种 currencyCode string M-必填 156.0 默认为156   
银行卡验证信息及身份信息 customerInfo string C-依条件必填 1、后台类消费交易时上送 2、认证支付2.0,后台交易时可选 Key=value格式 (具体填写参考数据元说明)   
订单接收超时时间(防钓鱼使用) orderTimeout string O-选填 1、前台类消费交易时上送 2、认证支付2.0,后台交易时可选   
终端号 termId string O-选填   
请求方保留域 reqReserved string O-选填 商户自定义保留域,交易应答时会原样返回   
保留域 reserved string O-选填   
风险信息域 riskRateInfo string O-选填   
加密证书ID encryptCertId string C-依条件必填   
发卡机构代码 issInsCode string O-选填   
终端信息域 userMac string O-选填 移动支付业务需要上送   
持卡人IP customerIp string O-选填 前台交易,有IP防钓鱼要求的商户上送   
订单描述 orderDesc string C-依条件必填 移动支付上送   
分账域 accSplitData string O-选填 分账域,用法参见注13 该域需整体做Base64编码。   
控制规则 ctrlRule string O-选填 32位01字符串控制位,从左至右第四位取值为1时表示需要强制分期处理   
同步应答参数
名称 标识 字段类型 长度 请求要求 默认值 备注
版本号 version string R-原值返回   
编码方式 encoding string R-原值返回   
签名 signature string M-必填   
签名方法 signMethod string M-必填   
交易类型 txnType string R-原值返回   
交易子类 txnSubType string R-原值返回   
产品类型 bizType string R-原值返回   
接入类型 accessType string R-原值返回   
收单机构代码 acqInsCode string C-依条件必填   
商户代码 merId string R-原值返回   
商户订单号 orderId string R-原值返回   
订单发送时间 txnTime string R-原值返回   
交易金额 txnAmt string R-原值返回   
交易币种 currencyCode string R-原值返回 默认为156   
请求方保留域 reqReserved string R-原值返回   
保留域 reserved string O-选填   
交易查询流水号 queryId string M-必填 消费交易的流水号,供后续查询用   
响应码 respCode string M-必填   
应答信息 respMsg string M-必填   
账号 accNo string C-依条件必填 根据商户配置返回   
支付卡类型 payCardType string C-依条件必填 根据商户配置   
支付方式 payType string C-依条件必填 根据商户配置   
银联订单号 tn string C-依条件必填 商户推送订单后银联移动支付系统返回该流水号,商户调用支付控件时使用   
签名公钥证书 signPubKeyCert string C-依条件必填 此域填写银联签名公钥证书,使用RSA签名方式时,默认返回,如果ctrlRule第五位为1时,不返。   
异步应答参数
名称 标识 字段类型 长度 请求要求 默认值 备注
版本号 version string R-原值返回   
编码方式 encoding string R-原值返回   
签名 signature string M-必填   
签名方法 signMethod string M-必填   
交易类型 txnType string R-原值返回   
交易子类 txnSubType string R-原值返回   
产品类型 bizType string R-原值返回   
接入类型 accessType string R-原值返回   
收单机构代码 acqInsCode string C-依条件必填   
商户代码 merId string R-原值返回   
商户订单号 orderId string R-原值返回   
订单发送时间 txnTime string R-原值返回   
交易金额 txnAmt string R-原值返回   
交易币种 currencyCode string R-原值返回 默认为156   
请求方保留域 reqReserved string R-原值返回   
保留域 reserved string O-选填   
交易查询流水号 queryId string M-必填 消费交易的流水号,供后续查询用   
响应码 respCode string M-必填   
响应信息 respMsg string M-必填   
清算金额 settleAmt string M-必填   
清算币种 settleCurrencyCode string M-必填   
清算日期 settleDate string M-必填   
系统跟踪号 traceNo string M-必填   
交易传输时间 traceTime string M-必填   
兑换日期 exchangeDate string C-依条件必填 交易成功,交易币种和清算币种不一致的时候返回   
汇率 exchangeRate string C-依条件必填 交易成功,交易币种和清算币种不一致的时候返回   
账号 accNo string C-依条件必填 根据商户配置返回   
支付卡类型 payCardType string C-依条件必填 根据商户配置返回   
支付方式 payType string C-依条件必填 根据商户配置返回   
支付卡标识 payCardNo string C-依条件必填 移动支付交易时,根据商户配置返回   
支付卡名称 payCardIssueName string C-依条件必填 移动支付交易时,根据商户配置返回   
签名公钥证书 signPubKeyCert string C-依条件必填 此域填写银联签名公钥证书,使用RSA签名方式时,默认返回,如果ctrlRule第五位为1时,不返。   
消费撤销交易
接口描述
因人为原因而撤销已完成的消费,商户可以通过SDK向银联全渠道支付平台发起消费撤销交易,消费撤销必须是撤销CUPS当日当批的消费。发卡行批准的消费撤销金额将即时地反映到该持卡人的账户上。完成交易的过程不需要同持卡人交互,属于后台交易。
请求方式
POST
生产地址
https://gateway.95516.com/gateway/api/backTransReq.do
测试地址
https://gateway.95516.com/gateway/api/backTransReq.do
请求报文体参数
名称 标识 字段类型 长度 请求要求 默认值 备注
版本号 version string M-必填 5.1.0 固定填写   
编码方式 encoding string M-必填 UTF-8 默认取值:UTF-8   
证书ID certId string C-依条件必填   
签名 signature string M-必填 填写对报文摘要的签名   
签名方法 signMethod string M-必填 非对称签名:01(表示采用RSA签名) HASH表示散列算法 11:支持散列方式验证SHA-256 12:支持散列方式验证SM3   
交易类型 txnType string M-必填 31 取值:31   
交易子类 txnSubType string M-必填 00 默认:00   
产品类型 bizType string M-必填   
渠道类型 channelType string M-必填   
后台通知地址 backUrl string M-必填 前台返回商户结果时使用,前台类交易需上送   
接入类型 accessType string M-必填 后台返回商户结果时使用,如上送,则发送商户后台交易结果通知,如需通过专线通知,需要在通知地址前面加上前缀:专线的首字母加竖线ZX|   
收单机构代码 acqInsCode string C-依条件必填 0:普通商户直连接入 1:收单机构接入 2:平台类商户接入   
商户类别 merCatCode string C-依条件必填 接入类型为收单机构接入时需上送   
商户代码 merId string M-必填 接入类型为收单机构接入时需上送   
商户名称 merName string C-依条件必填   
商户英文名称 merEnName string C-依条件必填 接入类型为收单机构接入时需上送   
商户简称 merAbbr string C-依条件必填 接入类型为收单机构接入时需上送   
二级商户代码 subMerId string C-依条件必填 接入类型为收单机构接入时需上送   
二级商户全称 subMerName string C-依条件必填 商户类型为平台类商户接入时必须上送   
二级商户简称 subMerAbbr string C-依条件必填 商户类型为平台类商户接入时必须上送   
商户订单号 orderId string M-必填 商户类型为平台类商户接入时必须上送   
原始交易流水号 origQryId string M-必填 消费撤销的订单号,由商户生成   
订单发送时间 txnTime string M-必填 原始消费交易的queryId   
交易金额 txnAmt string M-必填   
终端号 termId string O-选填 与原始消费交易一致   
请求方保留域 reqReserved string O-选填   
保留域 reserved string O-选填 商户自定义保留域,交易应答时会原样返回   
同步应答参数
名称 标识 字段类型 长度 请求要求 默认值 备注
版本号 version string R-原值返回   
编码方式 encoding string R-原值返回   
签名 signature string M-必填   
签名方法 signMethod string M-必填   
交易类型 txnType string R-原值返回   
交易子类 txnSubType string R-原值返回   
产品类型 bizType string R-原值返回   
接入类型 accessType string R-原值返回   
收单机构代码 acqInsCode string C-依条件必填   
商户代码 merId string R-原值返回   
商户订单号 orderId string R-原值返回   
原始交易流水号 origQryId string R-原值返回 原始消费交易的queryId   
订单发送时间 txnTime string R-原值返回   
交易金额 txnAmt string R-原值返回   
请求方保留域 reqReserved string R-原值返回   
保留域 reserved string O-选填   
银联交易流水号 queryId string M-必填 退货交易的交易流水号 供查询用   
响应码 respCode string M-必填   
应答信息 respMsg string M-必填   
签名公钥证书 signPubKeyCert string C-依条件必填 此域填写银联签名公钥证书,使用RSA签名方式时,默认返回,如果ctrlRule第五位为1时,不返。   
异步应答参数
名称 标识 字段类型 长度 请求要求 默认值 备注
版本号 version string R-原值返回   
编码方式 encoding string R-原值返回   
签名 signature string M-必填   
签名方法 signMethod string M-必填   
交易类型 txnType string R-原值返回   
交易子类 txnSubType string R-原值返回   
产品类型 bizType string R-原值返回   
接入类型 accessType string R-原值返回   
收单机构代码 acqInsCode string C-依条件必填   
商户代码 merId string R-原值返回   
商户订单号 orderId string R-原值返回   
原始交易流水号 origQryId string R-原值返回 原始消费交易的queryId   
订单发送时间 txnTime string R-原值返回   
交易币种 currencyCode string M-必填   
交易金额 txnAmt string R-原值返回   
请求方保留域 reqReserved string R-原值返回   
保留域 reserved string O-选填   
银联交易流水号 queryId string M-必填 退货交易的交易流水号 供查询用   
响应码 respCode string M-必填   
响应信息 respMsg string M-必填   
清算金额 settleAmt string M-必填   
清算币种 settleCurrencyCode string M-必填   
清算日期 settleDate string M-必填   
系统跟踪号 traceNo string M-必填   
交易传输时间 traceTime string M-必填   
兑换日期 exchangeDate string C-依条件必填 交易成功,交易币种和清算币种不一致的时候返回   
汇率 exchangeRate string C-依条件必填 交易成功,交易币种和清算币种不一致的时候返回   
签名公钥证书 signPubKeyCert string C-依条件必填 此域填写银联签名公钥证书,使用RSA签名方式时,默认返回,如果ctrlRule第五位为1时,不返。   
账号 accNo string C-依条件必填 根据商户配置返回   
退货交易
接口描述
对于跨清算日或者当清算日的消费交易,商户可以通过调用SDK向银联全渠道支付平台发起退货交易,从而实现客户的退款需求,支持部分退货、多次退货。该交易参加资金清算,为后台交易。
请求方式
POST
生产地址
https://gateway.95516.com/gateway/api/backTransReq.do
测试地址
https://gateway.95516.com/gateway/api/backTransReq.do
交易状态查询交易
接口描述
对于未收到交易结果的联机交易,商户应向银联全渠道支付平台发起交易状态查询。建议商户在发起消费类交易后,先等待交易结果推送,如未收到交易结果,5分钟后再发起交易状态查询。查询5次以上,仍获取不到明确状态的交易,后续可以间隔更长时间发起查询,最终结果以对账文件为准。
请求方式
POST
生产地址
https://gateway.95516.com/gateway/api/backTransReq.do
测试地址
https://gateway.95516.com/gateway/api/backTransReq.do
加密公钥更新查询交易
接口描述
商户定期(1天1次)向银联全渠道系统发起获取加密公钥信息交易。在加密公钥证书更新期间,全渠道系统支持新老证书的共同使用,新老证书并行期为1个月。全渠道系统向商户返回最新的加密公钥证书,由商户服务器替换本地证书。
请求方式
POST
生产地址
https://gateway.95516.com/gateway/api/backTransReq.do
测试地址
https://gateway.95516.com/gateway/api/backTransReq.do
联系我们

业务咨询: 徐鑫源

021-20632403

xuxinyuan@unionpay.com

中国银联版权所有©2002-2019沪 ICP备07032180号