平台账户退款查询

大约 3 分钟

平台账户退款查询

服务 IDzjrcuoip.platform.account.refund.qry
VERSION1.0.0

服务详细描述

对已退款的订单进行退款查询操作。

示例代码

PlatRefundQryDemoOp.java

/**
 * 平台账户--平台账户退款查询
 *
 * @author
 */
@Service
public class PlatRefundQryDemoOp {

	@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.platform.account.refund.qry");
		// 设置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("appTp", "03");
		map.put("purpPrtry", "A1207013");
		map.put("merchId", "123456");
		map.put("bizId", "123456");
		map.put("orderId", "123456");
		map.put("bizTime", "20220919153912");
		map.put("bizRemark", "sdasda");

		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
数据项名称
类型
长度
是否必输
数据项说明
1appTp应用类型String201-电脑端 WEB 接入,02-POS 接入,03-移动应用接入,04-移动端 H5 接入,默认 03
2purpPrtry业务种类String8A1207001-医疗退款,A1207002-社保缴费退款,A1207003-台州一卡通退款,A1207008-公交云退款,A1207010-协议支付退款,A1207012-主扫信用账户支付退款,A1207013-平台账户退款,默认 A1207013
3merchId商户号String32支付系统分配,且各环境有可能不一样。当 purpPrtry 为 A1207001、A1207002、A1207003、A1207008、A1207010、A1207012 时必输。
4bizId原交易业务流水号String64传要查询的原交易的 bizid. bizId 和 orderId 二选一,如果都传了,以 bizId 为准。
5orderId原交易订单号String32传要查询的原交易的 orderId. bizId 和 orderId 二选一,如果都传了,以 bizId 为准。
6bizTime交易时间String14当前退款交易发起时间,格式 yyyyMMddHHmmss
7bizRemark备注信息String255备注信息

业务输出项

序号
key
数据项名称
类型
长度
是否非空
数据项说明
1bizId原交易业务流水号String64支付系统能查询到对应记录才会返回
2orderId原交易订单号String32支付系统能查询到对应记录才会返回
3totalAmount退款总金额String12单位元,保留两位小数。退款总金额=优惠金额+退款金额。
4promAmount优惠金额String12营销部分退款金额,单位元,保留两位小数。
5bizAmount退款金额String12支付系统能查询到对应记录才会返回,存在优惠金额标识优惠后金额
6returnCode总响应码String4原交易状态。M-处理中,S-成功,F-失败
7returnMsg总响应信息String255原交易状态描述。如交易成功
8subCode子响应码String8原交易错误码
9subMsg子响应信息String255原交易错误描述
10attach附加信息String127原交易请求输入的附加信息原样返回
11transTime交易日期String8支付系统交易日期 yyyyMMdd

响应码

服务响应码响应信息
00000000交易成功