支付宝预授权查询-服务商
大约 4 分钟
支付宝预授权查询-服务商
支付宝预授权查询
服务ID | zjrcuoip.pay.uas.auth.query |
---|---|
VERSION | 1.0.0 |
服务详细描述
查询预授权订单处理结果。
注:参数中的必填要求:M为必填项,O为非必填项,C为条件选填项。
示例代码
UasPayAuthQryDemoOp.java
/**
* 支付宝预授权查询-服务商
*
* @author
*/
@Service
public class UasPayAuthQryDemoOp {
@SuppressWarnings({ "rawtypes", "unchecked" })
public static void execute() {
// 1.获取通讯连接对象
INetTools netTools = NetToolsHttpFactory.getHttpInstance();
// 2.生成公共请求报文对象
OipReqBean oipReqBean = new OipReqBean();
// 设置应用id
oipReqBean.setAppId("应用id");
// 设置开发者id
oipReqBean.setDlpId("开发者id");
// 设置产品id
oipReqBean.setProdId("产品id");
// 设置api方法名
oipReqBean.setMethod("zjrcuoip.pay.uas.auth.query");
// 设置api版本
oipReqBean.setVersion("1.0.0");
// 设置时间戳
SimpleDateFormat sfs = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
oipReqBean.setTimestamp(sfs.format(new Date()));
// 3.生成请求配置对象,配置请求地址/url等信息
NetReqConfBean netReqConfBean = new NetReqConfBean();
// 应用私钥
netReqConfBean.setAppPrivateKey("应用私钥");
// 请求地址
netReqConfBean.setNetUrl("请求地址");
// 开发者公钥
netReqConfBean.setPublicKey("开发者公钥");
// 设置业务报文
Date d=new Date();
SimpleDateFormat sf=new SimpleDateFormat("yyyyMMddHHmmss");
//以map接收所有参数生成业务报文,主要是必输项,具体参考接口文档
Map map =new HashMap();
map.put("输入项必输字段", "字段值");
String bizContent = JSON.toJSONString(map);
// 生成业务报文json对象
oipReqBean.setBizContent(bizContent);
// 通讯获取报文对象
OipRspBean oipRspBean = netTools.execute(oipReqBean, netReqConfBean);
// 响应成功
if (oipRspBean.isSuccess()) {
String bizJson = oipRspBean.getBizContent();
if (StringUtils.isNotBlank(bizJson)) {
Map bizData = JSON.parseObject(bizJson, Map.class);
System.out.println(bizData);
}
}
}
}
公共报文
业务输入项
序号 | key | 中文名称 | 是否必输 | 类型 | 长度 | 说明 |
---|---|---|---|---|---|---|
1 | mchSeq | 商户识别号 | M | String | 32 | |
2 | txTp | 交易类型 | M | String | 2 | 06-查询 |
3 | txDtTm | 交易时间 | M | Datetime | 14 | 查询交易发起时间,格式为yyyyMMddHHmmss |
4 | orglTxId | 原商户订单号 | M(三选一) | String | 32 | orglTxId为原预授权交易的商户订单号 |
5 | orglMsgId | 原交易流水号 | M(三选一) | String | 32 | orglMsgId为原预授权交易由收单系统生成的流水号 |
6 | orglTradeNo | 原支付流水号 | M(三选一) | String | 32 | orglTradeNo为原预授权交易由支付系统生成的流水号 |
7 | remark | 备注信息 | O | String | 255 | 备注信息 |
业务输出项
(如公共报文头里面报错,则表示查询交易本身异常)
序号 | key | 中文名称 | 是否必输 | 类型 | 长度 | 说明 |
---|---|---|---|---|---|---|
1 | bizSts | 交易状态 | M | String | 4 | 指预授权交易状态。01-交易处理中,02-交易成功,03-交易失败,04-已撤销,06-已解冻,07-预授权完成,08-预授权撤销处理中,09-预授权完成处理中 |
2 | bizStsDesp | 交易状态描述 | M | String | 255 | 如:交易成功 |
3 | rjctRsnCd | 错误码 | O | String | 32 | |
4 | rjctRsn | 错误描述 | O | String | 255 | |
5 | msgId | 交易流水号 | M | String | 32 | 收单交易系统生成的流水号。 |
6 | txId | 商户订单号 | O | String | 32 | 订单创建时的txId原样返回。 |
7 | mrchOrderNo | 商户原始订单号 | O | String | 64 | |
8 | txTp | 交易类型 | M | String | 2 | 20-预授权冻结 |
9 | txAmt | 交易金额 | M | String | 15 | 单位元,精确到小数点后两位。 |
10 | ccy | 标价币种 | O | String | 3 | 默认CNY-人民币。指txAmt的币种。 |
11 | attach | 附加数据 | O | String | 78 | 订单创建时的附加数据原样返回。 |
以下字段在bizSts为02-交易成功时有返回:
序号 | key | 中文名称 | 是否必输 | 类型 | 长度 | 说明 |
---|---|---|---|---|---|---|
1 | tradeNo | 支付流水号 | M | String | 32 | 支付系统生成的唯一流水号 |
2 | authNo | 预授权号 | M | String | 64 | |
3 | tnltxId | 通道流水号 | M | String | 64 | |
4 | mrchNm | 特约商户简称 | M | String | 128 | |
5 | userId | 用户子标识 | M | String | 128 | 支付宝支付时为买家在支付宝的用户ID |
6 | buyerLogonId | 付款方支付宝账号 | M | String | 100 | 付款方支付宝账号(Email或手机号) |
7 | timeEnd | 交易完成时间 | M | Datetime | 14 | 支付成功时有值,格式为yyyyMMddHHmmss。 |
8 | preAuthType | 预授权类型 | O | String | 20 | 目前支持CREDIT_AUTH(信用预授权);商户可根据该标识来判断该笔预授权的类型,当返回值为"CREDIT_AUTH"表明该笔预授权为信用预授权,没有真实冻结资金; 当返回值为空或者不为"CREDIT_AUTH"则表明该笔预授权为普通资金预授权,会冻结用户资金。 |
9 | creditAmt | 信用冻结金额 | O | String | 15 | 本次冻结操作中信用冻结金额 |
10 | fundAmt | 自有资金冻结金额 | O | String | 15 | 本次冻结操作中自有资金冻结金额 |