查询对账单下载地址

服务 ID	zjrcuoip.plat.acct.payment.bill.downloadurl.query
VERSION	1.0.0

服务详细描述

查询对账单下载地址。

规则：下载链接有效期：30s 文件有效期 2 个月

示例代码

PlatBillDownLoadQryDemoOp.java

/**
 * 平台账户--查询对账单下载地址
 *
 * @author
 */
@Service
public class PlatBillDownLoadQryDemoOp {

	@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.plat.acct.payment.bill.downloadurl.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("merchId", "11111111111");
		map.put("billDate", "20220919");
		map.put("billType", "PLAT");

		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	merchId	商户号	String	32	是	支付系统分配,
2	billDate	对账单日期	String	8	是	下载对账单的日期，格式：yyyyMMdd
3	billType	账单类型	String	8	是	默认送：PLAT

业务输出项

序号	key	数据项名称	类型	长度	是否非空	数据项说明
1	billDownloadUrl	账单下载地址链接	String	2048	是	账单下载地址链接，获取连接后 30 秒后未下载，链接地址失效。 https://apiuat.zj96596.com.cn:8800/downloadBillFile.resource?bizType=X&fileType=X&downloadFileName=X&fileId=X
	说明：压缩文件中有两个 txt 文件
	spay 文件字段定义如下：
	字段含义	补充说明
	支付流水号	支付平台生成的流水
	业务种类	枚举值同联机交易接口的请求字段 purpPrtry
	币种	CNY-人民币
	交易类型	20-消费，30-转账，15-退款
	交易日期	自然日 YYYYMMDD
	交易状态	09-成功
	端到端标识号	上游系统请求流水 bizid
	支付系统交易日期	随支付系统日切变化 YYYYMMDD
	手续费金额	单位元
	订单总金额	单位元

对账单底部有一行汇总信息：

消费总笔数，消费总金额，消费手续费总金额，退款总笔数（汇总文件中所有退款交易），退款总金额（汇总文件中所有退款交易），退款手续费总金额（汇总文件中所有退款交易）。