IC卡交易结果上送-服务商

大约 4 分钟

IC卡交易结果上送-服务商

IC卡交易结果上送

服务IDzjrcuoip.pay.uas.terminal.notice
VERSION1.0.0

服务详细描述

终端收到响应的AC值后,上送TC值。若有写卡操作,则通知发卡方脚本处理结果。

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

示例代码

UasTerminalDemoOp.java

/**
 * 脚本处理结果通知-服务商
 * 
 * @author
 */
@Service
public class UasTerminalDemoOp {

	@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.terminal.notice");
		// 设置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中文名称是否必输类型长度说明
1mchSeq商户识别号MString32
2txId商户订单号MString32当前交易的请求流水号,也是交易唯一标识,可包含数字、大小写字母、下划线,需保证在商户端不重复。 编号规则为系统编号(2位)+年月日(8位数字)+序号(最长22位)。
3orglTxId原商户订单号M(二选一)String32orglTxId为原交易的商户订单号
4orglMsgId原交易流水号M(二选一)String32orglMsgId为原交易由收单系统生成的流水号
5rtrvlRefNb检索参考号MString12对应银联卡交换规范的第37域,12位定长
6txTp交易类型MString218-脚本处理结果通知
7txDtTm交易时间MDatetime14交易发起时间,格式yyyyMMddHHmmss
8tunnel交易通道MString10UNIONPAY-银联
9acctNo账号MString32
10cardSqncNb卡序列号CString3IC卡序列号,IC卡必送。 对应银联卡交换规范的第23域,3位定长
11iccDtIC卡数据域CString510IC卡必送。 对应银联卡交换规范的第55域
12issScrRslt发卡行脚本结果CString21发卡方脚本结果df31字段存在必送
13etryMdCd服务点输入方式码MString3对应银联卡交换规范的第22域,3位定长
14cdtnCd服务点条件码MString200-正常提交
15termId银联终端号MString8银联报备的终端号,对应银联卡交换规范的第41域

业务输出项

序号key中文名称是否必输类型长度说明
1bizSts交易状态MString4指交易结果。02-交易成功,03-交易失败
2bizStsDesp交易状态描述MString255如:交易成功
3rjctRsnCd错误码OString32
4rjctRsn错误描述OString255

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

序号key中文名称是否必输类型长度说明
1txId商户订单号OString32请求的txId原样返回
2msgId交易流水号OString32收单交易系统生成的流水号