退款查询-服务商

退款查询

服务ID	zjrcuoip.pay.uas.refund.query
VERSION	1.0.0

服务详细描述

查询退款订单处理结果，主动查询接口时，轮询频率建议0.5S/次，可根据实际情况调整放慢查询频率，轮询时间为5分钟。注意设计轮询结束时间及处理机制，避免无限轮询

注：参数中的必填要求：M为必填项，O为非必填项，C为条件选填项。

示例代码

UasRefundQryDemoOp.java

/**
 * 退款查询-服务商
 * 
 * @author
 */
@Service
public class UasRefundQryDemoOp {

	@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.refund.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	txDtTm	交易时间	M	Datetime	14	查询交易发起时间，格式为yyyyMMddHHmmss
3	orglTxId	原商户退款单号	M（三选一）	String	32	orglTxId为原退款交易的商户退款单号
4	orglMsgId	原交易流水号	M（三选一）	String	32	orglMsgId为原退款交易由收单系统生成的流水号
5	orglTradeNo	原支付流水号	M（三选一）	String	32	orglTradeNo为原退款交易由支付系统生成的流水号
6	remark	备注信息	O	String	255	备注信息
7	termInfo	终端信息	C	Map		行业终端必送，商户侧受理终端信息。详见termInfo说明

termInfo说明：

序号	key	中文名称	是否必输	类型	长度	说明
1	location	终端实时经纬度信息	O	String	32	受理终端设备实时经纬度信息，格式为纬度/经度，+表示北纬、东经，-表示南纬、西经。终端实时经纬度信息与devIp-商户端设备IP应二选一必送
2	ntwLcs	终端入网认证编号	O	String	5	银行卡受理终端产品入网认证编号。该编号由“中国银联标识产品企业资质认证办公室”为通过入网认证的终端进行分配。 格式：5位字符，例如P3100
3	devTp	商户端设备类型	M	String	2	终端设备类型，受理方可参考终端注册时的设备类型填写，取值如下： 01：自动柜员机（含ATM和CDM）和多媒体自助终端 02：传统POS 03：mPOS 04：智能POS 05：II型固定电话 06：云闪付终端； 07：保留使用； 08：手机POS； 09：刷脸付终端； 10：条码支付受理终端； 11：条码支付辅助受理终端； 12：行业终端（公交、地址用于指定行业的终端）； 13：MIS终端
4	serlNm	终端序列号	C	String	32	终端设备的硬件序列号，商户端设备类型（devTp）填写为 02、03、04、05、06、08、09 或 10时，必须填写终端序列号。
5	devId	终端设备号	M	String	8	终端设备号，收单机构为商户终端分配的唯一编号。应送商户云绑定辅助受理终端生成的银联终端号（行社收单管理员提供）
6	enRdNm	加密随机因子	O	String	10	仅在被扫支付类交易报文中出现：若付款码为19位数字，则取后6位； 若付款码为EMV二维码，则取其tag57的卡号/token号的后6位。
7	scrtTxt	密文数据	O	String	16	仅在被扫支付类交易报文中出现：64bit的密文数据，对终端硬件序列号和加密随机因子加密后的结果。本子域取值为：64bit密文数据进行base64编码后的结果。
8	appVer	应用程序版本号	O	String	8	终端应用程序的版本号。应用程序变更应保证版本号不重复。当长度不足时，右补空格。
9	devIp	商户端设备IP	C	String	40	商户端终端设备IP地址。注：如经、纬度信息未上送，该字段必送。
10	mblCtryCd	移动国家代码	O	String	3	基站信息，由国际电联（ITU）统一分配的移动国家代码（MCC）
11	mblNtNm	移动网络号码	O	String	2	中国为460
12	iccId	ICCID	O	String	20	基站信息，由国际电联（ITU）统一分配的移动网络号码（MNC）
13	lctionCd1	位置区域码1	O	String	4	移动：00、02、04、07； 联通：01、06、09； 电信：03、05、11
14	lbsNum1	基站编号1	O	String	12	SIM卡卡号
15	lbsSgnl1	基站信号1	O	String	4	LAC（移动、联通），16进制
16	lctionCd2	位置区域码2	O	String	4	CID（移动、联通），16进制
17	lbsNum2	基站编号2	O	String	12	SIG（移动、联通），16进制
18	lbsSgnl2	基站信号2	O	String	4	LAC（移动、联通），16进制
19	lctionCd3	位置区域码3	O	String	4	CID（移动、联通），16进制
20	lbsNum3	基站编号3	O	String	12	SIG（移动、联通），16进制
21	lbsSgnl3	基站信号3	O	String	4	LAC（移动、联通），16进制
22	telSysId	电信系统识别码	O	String	4	CID（移动、联通），16进制
23	telNetId	电信网络识别码	O	String	4	SIG（移动、联通），16进制
24	telLbs	电信基站	O	String	4	SID（电信），电信系统识别码，每个地级市只有一个SID
25	telLbsSgnl	电信基站信号	O	String	4	NID（电信），电信网络识别码，由电信各地级分公司分配。每个地级市可能有1到3个NID

业务输出项

（如公共报文头里面报错，则表示查询交易本身异常）

序号	key	中文名称	是否必输	类型	长度	说明
1	bizSts	交易状态	M	String	4	指退款交易状态。01-交易处理中，02-交易成功，03-交易失败
2	bizStsDesp	交易状态描述	M	String	255	如：交易成功
3	rjctRsnCd	错误码	O	String	10
4	rjctRsn	错误描述	O	String	255
5	msgId	交易流水号	M	String	32	收单系统生成的流水号
6	txId	商户退款单号	O	String	32	退款申请时的txId原样返回
7	txTp	交易类型	M	String	2	02-退款
8	txAmt	申请退款金额	M	String	15	单位元，精确到小数点后两位。
9	ccy	交易币种	O	String	3	默认CNY-人民币。指txAmt的币种。
10	attach	附加数据	O	String	78	退款申请时的附加数据原样返回

以下字段在bizSts为02-交易成功时返回：

序号	key	中文名称	是否必输	类型	长度	说明
1	tradeNo	支付流水号	M	String	32	支付系统生成的唯一流水号
2	tnltxId	银联流水号	O	String	64	非丰收互联、银联支付，且交易成功时返回
3	tradeDate	交易日期	M	Date	8	格式为yyyyMMdd，对账用。
4	timeEnd	退款完成时间	M	Datetime	14	退款成功时有值，格式为yyyyMMddHHmmss。
5	mrchNm	特约商户简称	M	String	128
6	tunnel	交易通道	M	String	10	ALIPAY-支付宝，WEIXIN-微信，UNIONPAY-银联，ZJRCU-丰收互联
7	settleAmt	应结金额	M	String	15	单位元，精确到小数点后两位
8	ftRefundAmt	用户实退金额	O	String	15	本次退款金额中买家退款金额。单位元，精确到小数点后两位
9	promTtlAmt	优惠退款金额	O	String	15	微信或丰收互联通道，且交易成功时返回，单位元，精确到小数点后两位

以下字段在bizSts为02-交易成功且交易通道为支付宝时有返回：

序号	key	中文名称	是否必输	类型	长度	说明
1	storeName	商户门店名称	O	String	512
2	sendBackAmt	商户实际退回金额	O	String	15	注：在签约收单产品时需勾选“返回资金明细”才会返回，单位为元，精确到小数点后两位
3	mdiscountAmt	商家优惠退款金额	O	String	15	单位为元，精确到小数点后两位
4	discountAmt	平台优惠退款金额	O	String	15	单位为元，精确到小数点后两位
5	buyerLogonId	买家账号	O	String	100	用户的登录id
6	buyerId	买家用户id	O	String	28	用户在支付宝的用户id。
7	fundChange	是否发生资金变化	O	String	1	Y-是；N-否。
8	indstyDetail	行业特殊信息	O	String	4096	例如在医保卡支付业务中，向用户返回医疗信息。
9	fundBillList	退款使用的资金渠道	O	List		详见fundBillList说明。

fundBillList说明：

序号	key	中文名称	是否必输	类型	长度	说明
1	fundChannel	交易使用的资金渠道	M	String	32	交易使用的资金渠道。 COUPON-支付宝红包 ALIPAYACCOUNT-支付宝账户 POINT-集分宝 DISCOUNT-折扣券 PCARD-预付卡 MCARD-商家储值卡 MDISCOUNT-商户优惠券 MCOUPON-商户红包 BANKCARD-银行卡
2	bankCode	银行卡支付时的银行代码	O	String	10	如CEB
3	amount	使用金额	M	String	32	该支付工具类型所使用的金额，单位为元，精确到小数点后两位
4	realAmount	渠道实际付款金额	O	String	11	渠道实际付款金额，单位为元，精确到小数点后两位
5	fundType	渠道所使用的资金类型	O	String	32	渠道所使用的资金类型,目前只在资金渠道(fund_channel)是银行卡渠道(BANKCARD)的情况下才返回该信息。 DEBIT_CARD-借记卡 CREDIT_CARD-信用卡 MIXED_CARD-借贷合一卡

以下字段在bizSts为02-交易成功且交易通道为微信支付时有返回：

序号	key	中文名称	是否必输	类型	长度	说明
1	subMrchId	子商户号	M	String	32	微信支付分配的子商户号。
2	subAppId	子商户公众账号ID	O	String	32	微信分配的子商户公众账号ID。
3	wxPromInfo	优惠退款详情	O	List		详见wxPromInfo说明。
4	refundChnl	退款渠道	O	String	16	ORIGINAL-原路退款 BALANCE-退回到余额 OTHER_BALANCE-原账户异常退到其他余额账户 OTHER_BANKCARD-原银行卡异常退到其他银行卡
5	refundAcct	退款资金来源	O	String	30	REFUND_SOURCE_RECHARGE_FUNDS-可用余额退款/基本账户； REFUND_SOURCE_UNSETTLED_FUNDS-未结算资金退款。
6	refundRecvAcct	退款入账账户	O	String	64	1)退回银行卡:{银行名称}{卡类型}{卡尾号} 2)退回支付用户零钱:支付用户零钱 3)退还商户:商户基本账户、商户结算银行账户 4)退回支付用户零钱通:支付用户零钱通

wxPromInfo说明：

序号	key	中文名称	是否必输	类型	长度	说明
1	promotionId	券ID	M	String	32	券或者立减优惠id。
2	scope	优惠范围	O	String	32	GLOBAL-全场代金券 SINGLE-单品优惠
3	type	优惠类型	O	String	32	COUPON-代金券，需要走结算资金的充值型代金券,(境外商户券币种与支付币种一致) DISCOUNT-优惠券，不走结算资金的免充值型优惠券，(境外商户券币种与标价币种一致
4	amount	优惠券面额	O	String	32	用户享受优惠的金额。单位为分
5	refundAmount	优惠券退款额	O	String	32	按比例退款的优惠券金额。单位为分

以下字段在bizSts为02-交易成功且交易通道为银联时有返回：

序号	key	中文名称	是否必输	类型	长度	说明
1	unionPromInfo	优惠详情	O	List		详细字段见unionPromInfo说明。
2	issAddData	商品优惠信息	O	Map		详细字段见issAddData说明。

unionPromInfo说明：

序号	key	中文名称	是否必输	类型	长度	说明
1	type	项目类型	M	String	4	DD01：随机立减； CP01：抵金券1:无需领取，交易时直接适配并承兑的优惠券； CP02：抵金券2:事前领取，交易时上送银联并承兑的优惠券
2	spnsrId	出资方	C	String	20	银联作为出资方:固定填写00010000; 付款方作为出资方:填写8位付款方机构代码; 商户作为出资方:填写15位商户代码。
3	offstAmt	抵消交易金额	C	String	12	以分为单位
4	id	项目编号	M	String	40	票券编号、活动编号等
5	desc	项目简称	O	String	60	优惠活动简称，可用于展示、打单等。
6	addnInfo	附加信息	O	String	100	内容自定义
7	issuerId	项目发行方	O	String	4	发行优惠活动的平台或组织，银联将向项目发行方核销优惠活动。取值如下: KQPT:银联卡券平台 注:本子域不出现时，默认为银联U点平台。

issAddData说明：

序号	key	中文名称	是否必输	类型	长度	说明
1	dctDetail	商品优惠信息	O	List		商品优惠明细内容，详见dctDetail说明。
2	customData	自定义数据	O	String	500	自定义数据

dctDetail说明：

序号	key	中文名称	是否必输	类型	长度	说明
1	id	商品编号	M	String	32	参与优惠的商品编号
2	dctId	优惠活动编号	M	String	40
3	dctQuantity	商品优惠数量	M	String	10	参与优惠的商品数量，示例:本商品数量为10，其中2件参与了优惠，则本字段值为2。
4	dctPrice	商品优惠金额	M	String	12	商品的优惠金额，以分为单位，示例: 商品单价10元，共5件，其中2件参与优惠，每件优惠3元，则本字段值为600。
5	addnInfo	附加信息	O	String	100	内容自定义

以下字段在bizSts为02-交易成功且交易通道为行内通道时有返回：

序号	key	中文名称	是否必输	类型	长度	说明
1	refundInfo	退款详情	O	List		详细字段见refundInfo说明
2	zjrcuPromInfo	优惠退款详情	O	List		详细字段见zjrcuPromInfo说明

refundInfo说明：

序号	key	中文名称	是否必输	类型	长度	说明
1	bankCode	入账银行	O	String	4
2	acctTp	入账账户类型	M	String	4	0101-存折；0102-借记卡；0201-信用卡；0301-电子账户；0302-亲情钱包；0401-平台账户；0501-随心花；S001-积分。
3	acctNo	入账账号/卡号	M	String	32
4	amt	退款金额	M	String	15	单位元，精确到小数点后两位. 当支付方式为存折/借记卡/信用卡/电子账户/亲情钱包/平台账户/随心花时，表示对应的账户退款金额； 当支付方式为积分时，表示积分抵扣退款金额。
5	usrInstFee	用户分期总手续费	O	String	15	使用信用卡分期且客户需要付息时有值
6	promBranNo	营销机构号	O	String	6	acctTp为S001-积分时有值

zjrcuPromInfo说明：

序号	key	中文名称	是否必输	类型	长度	说明
1	promTp	优惠类型	M	String	4	PR01-随机减，PR02-票券
2	promAmt	优惠金额	M	String	15	单位为元，精确到小数点后两位。
3	platContAmt	银行出资金额	C	String	15	单位元，精确到小数点后两位
4	mrchContAmt	商户出资金额	C	String	15	单位元，精确到小数点后两位
5	userContAmt	用户支付金额	C	String	15	单位为元，精确到小数点后两位。用户在购买券时支付的金额
6	promTm	活动时间	O	String	32	如：20240101-20240130 银行卡支付场景下返回
7	promNm	活动名称	O	String	32	银行卡支付场景下返回
8	promBranNo	营销机构号	O	String	6