银行卡退款申请-服务商

银行卡退款申请

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

服务详细描述

银行卡退款/消费撤销时，先调用该接口，该接口响应成功仅表示受理成功，消费撤销/退款是否成功以异步通知结果为准。

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

示例代码

UasCardRefundDemoOp.java

/**
 * 银行卡退款申请-服务商
 * 
 * @author
 */
@Service
public class UasCardRefundDemoOp {

	@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.card.refund");
		// 设置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	deviceNo	终端序列号	M	String	32	终端序列号
2	safeModule	安全模块号	M	String	32	密码键盘序列号
3	track	磁道密文	O	String	255	二磁道补‘F’至16的整数倍+三磁道补‘F’至16的整数倍,用签到所得tdk 进行SM4加密
4	cardNo	卡号	M	String	19
5	pinBlock	密码密文	O	String	32	PIN的格式应符合ANSIX9.8Format(带主账号信息)，用签到所得pik 进行SM4加密
6	algType	算法标志	M	String	1	2：国密
7	etryMdCd	服务点输入方式	M	String	3
8	mchSeq	商户识别号	M	String	32
9	txTp	交易类型	M	String	2	02-退款
10	txId	商户退款单号	M	String	32	当前交易的请求流水号，也是交易唯一标识，可包含数字、大小写字母、下划线，需保证在商户端不重复。 编号规则为系统编号（2位）+年月日（8位数字）+序号（最长22位）。
11	rtrvlRefNb	检索参考号	M	String	12	对应银联卡交换规范的第37域，12位定长
12	orglTxId	原商户订单号	M（三选一)	String	32	orglTxId为原消费交易的商户订单号
13	orglMsgId	原交易流水号	M（三选一)	String	32	orglMsgId为原消费交易由收单系统生成的流水号
14	orglTradeNo	原支付流水号	M（三选一)	String	32	orglTradeNo为原消费交易由支付系统生成的流水号
15	txDtTm	交易时间	M	Datetime	14	申请退款时间，格式yyyyMMddHHmmss
16	txAmt	交易金额	M	String	15	单位为元，精确到小数点后两位
17	ccy	交易币种	O	String	3	默认CNY-人民币，指amt的币种
18	refundDesc	退款原因	O	String	80
19	notifyUrl	通知地址	O	String	128	商户接收异步通知的地
20	iccTl	安全控制信息	C	Map		对应核心的@ICCTL数据结构，IC卡必送 详细字段见iccTl说明
21	iccDt	IC卡数据域	C	String	510	IC卡必送 对应银联卡交换规范的第55域
22	token	token数据	O	String	512	对应银联卡交换规范的第63域中的TK。 上送时整串数据进行扩位。
23	cdtnCd	服务点条件码	M	String	2	00-正常提交 对应银联卡交换规范的第25域
24	pinCptrCd	服务点PIN获取码	C	String	2	由服务点设备接受的PIN的最大字符数目。 对应银联卡交换规范的第26域，2位定长。 取值范围：04-12 有密交易必须上送
25	reserved	自定义域	M	String	100	对应银联卡交换规范的第60域，详见reserved说明
26	acqrRsvd	受理方保留	M	String	100	对应银联卡交换规范的第122域
27	prvtAtch	私有附加数据	O	String	512	对应银联卡交换规范的第48域
28	termInfo	终端信息	M	Map		商户侧受理终端信息。详见termInfo说明
29	termId	终端号	M	String	10	行内分配的终端号
30	termPrms	终端信息	M（三选一)	String	248	对应银联卡交换规范的第104域中的PI。 终端具备获取位置信息等能力时必须上送; 针对一般POS终端，需要传递F104 PI用法tag0102及0408; 针对mPOS终端，需要传递F104 PI用法tag01~08; 上送数据示例:PI+3位后续数据长度+子域标签tag01-08(1位十六进制)+子域长度(1位十六进制)+子域数据，例:PI012+(01)(0a)1234567890；10位tag01子域数据，子域长度为0a； 上送时整串数据进行扩位。
31	lbsInfo	LBS信息	M（三选一)	String	300	对应银联卡交换规范的第104域中的LB。 终端具备获取基站信息等能力时必须上送; 上送数据示例同PI; 上送时整串数据进行扩位。
32	address	交易地点信息	M（三选一)	String	310	对应银联卡交换规范的第126域。 终端具备获取位置信息等能力时必须上送; 传递F126 TA用法tag01~03:用于传递交易地点相关关信息; 上送数据元例同PI; 上送时无需扩位。
33	deviceId	银联终端号	M	String	8	银联报备的终端号，对应银联卡交换规范的第41域
34	ip	终端IP地址	M	String	45	终端设备IP
35	mac	终端MAC地址	C	String	32	终端设备MAC
36	remark	备注信息	O	String	255	备注信息
37	attach	附加数据	O	String	78	附加数据，在通知和查询接口中原样返回，该字段主要用于携带自定义数据。 如包含特殊字符，请做Base64编码。
38	extendParams	业务扩展参数	O	Map		备用字段，暂未定义子key。

iccTl说明：

序号	key	中文名称	是否必输	类型	长度	说明
1	authAmt	授权金额	O	String	12
2	othAmt	其它金额	O	String	12
3	cntCd	终端国家代码	O	String	3
4	chkRlt	终端验证结果	O	String	10
5	curCd	交易货币代码	O	String	3
6	tradeDate	交易日期	O	String	6
7	tradeType	交易类型	O	String	2
8	unpNum	不可预知数	O	String	8
9	traAlp	应用交互特征	O	String	4
10	traAtc	应用交易计数器	O	String	4
11	cardCvr	卡片验证结果（CVR）	O	String	8
12	cardArqc	待检ARQC	O	String	16
13	cardNo	卡号	O	String	19
14	cardSer	卡片序列号	O	String	3
15	reserve	备用字段	O	String	60

reserved说明：

序号	key	中文名称	是否必输	类型	长度	说明
1	F60.1	报文原因码	M	String	4	0000
2	F60.2	服务点附加信息
3	F60.2.1	账户所有人类型	M	String	1	用于区分账户类型。
4	F60.2.2	终端读取能力	M	String	1	表明终端是否能够读取IC卡。
5	F60.2.3	IC卡条件代码	M	String	1	表示当在IC卡终端上使用IC卡的磁条信息时，IC卡终端的IC卡读写能力是否可用。根据该域与22域、60的值可以判断卡片或终端有无损坏，同时也可判断是否是伪卡交易。
6	F60.2.4	保留使用	M	String	1	由于芯片或终端不能正常工作，终端引导持卡人通过刷磁条进行的交易。这种情况需由60.2.2域和60.2.3域与22域联合判断。
7	F60.2.5	终端类型	M	String	2	保留使用
8	F60.2.6	受理免验密码标志	M	String	1
9	F60.2.7	IC卡验证可靠性标志	M	String	1	在IC卡交易中表明该卡验证的可靠性，受理方在商户或终端碰到问题时会设置该值；或者由CUPS在受理方或发卡方都不能执行该卡的验证时设置该值。在Token支付交易中，如Token由银联提供，则在银联向发卡方发送的请求报文中，使用该域标识由银联提供的Token服务。
10	F60.2.8	电子商务标志	M	String	2	对于电子商务交易，它表明在开放式网络中（例如，Internet）使用电子商务交易时的安全程度；在无卡自助消费业务中，该标志标识发卡方自主识别和辅助识别的模式。这个标志值由受理方提供，并由CUPS在请求和通知报文中转发给接收它的发卡方进行验证。如果发卡方不能验证或发卡方选择不接收它，那么该子域将在转发报文时被取消
11	F60.2.9	交互方式标志	M	String	1	用于区分相同终端类型的不同交互方式。
12	F60.3	交易发生附加信息
13	F60.3.1	特殊计费类型	M	String	2	00
14	F60.3.2	特殊计费档次	M	String	1	0
15	F60.3.3	保留使用	M	String	3	前两位取默认值 00，启用第3位用于标识MAC算法类型
16	F60.3.4	支持部分承兑和返回余额标志	M	String	1	0-不支持，1-支持
17	F60.3.5	交易发起方式	M	String	1	在交易类型关键信息域相同的情况下，该域可细分交易类型
18	F60.3.6	交易介质	M	String	1
19	F60.3.7	IC卡的应用类型	M	String	1
20	F60.3.8	账户结算类型	M	String	2
21	F60.3.9	卡账户等级	M	String	1	根据报备卡样或申请卡bin时的发卡项目等级确定该取值。
22	F60.3.10	卡产品	M	String	2	根据报备卡样或申请卡bin时的发卡项目类型确定该取值。

termInfo说明：

序号	key	中文名称	是否必输	类型	长度	说明
1	location	终端实时经纬度信息	O	String	32	受理终端设备实时经纬度信息，格式为纬度/经度，+表示北纬、东经，-表示南纬、西经。
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	终端序列号	M	String	32	终端设备的硬件序列号。
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	指退款申请结果。02-交易成功，03-交易失败
2	bizStsDesp	交易状态描述	M	String	255	如：交易成功
3	rjctRsnCd	错误码	O	String	32
4	rjctRsn	错误描述	O	String	255

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

序号	key	中文名称	是否必输	类型	长度	说明
1	txId	商户退款单号	M	String	32	请求的txId原样返回
2	msgId	交易流水号	M	String	32	收单系统生成的唯一交易流水号
3	txAmt	申请退款金额	M	String	15	退款金额，单位元，保留两位小数。
4	ccy	交易币种	O	String	3	默认CNY-人民币。指txAmt的币种。