定金确认-自研

定金确认

服务ID	zjrcuoip.pay.uas.deposit.confirm.trxcrt
VERSION	1.0.0

服务详细描述

由开放平台接入的商户系统发起的定金确认服务。

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

示例代码

DepositConfirmDemoOp.java

/**
 * 定金确认-自研
 * 
 * @author
 */
@Service
public class DepositConfirmDemoOp {

	@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.deposit.confirm.trxcrt");
		// 设置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	conScene	消费场景	M	String	2	14-定金确定
3	txId	商户订单号	M	String	32	32个字符以内、只能包含字母、数字、下划线，需保证在商户端不重复。
4	orglTxId	原商户订单号	M（三选一)	String	32	orglTxId为原定金支付交易的商户订单号
5	orglMsgId	原交易流水号	M（三选一)	String	32	orglMsgId为原定金支付交易由收单系统生成的流水号
6	orglTradeNo	原支付流水号	M（三选一)	String	32	orglTradeNo为原定金支付交易由支付系统生成的流水号
7	txTp	交易类型	M	String	2	14-定金确定
8	txDtTm	交易时间	M	Datetime	14	交易发起时间，格式yyyyMMddHHmmss
9	amt	交易金额	M	String	15	单位为元，精确到小数点后两位。
10	ccy	交易币种	O	String	3	默认CNY-人民币，指amt的币种
11	notifyUrl	通知地址	O	String	128	商户接收异步通知的地址
12	remark	备注	O	String	256
13	attach	附加数据	O	String	78	附加数据，在通知和查询接口中原样返回，该字段主要用于携带自定义数据。如包含特殊字符需做Base64编码

业务输出项

序号	key	中文名称	是否必输	类型	长度	说明
1	bizSts	交易状态	M	String	4	指定金确认交易结果。01-交易处理中，02-交易成功，03-交易失败
2	bizStsDesp	交易状态描述	M	String	255	如：交易成功
3	rjctRsnCd	错误码	O	String	32
4	rjctRsn	错误描述	O	String	255

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

1	txId	商户订单号	M	String	32	请求的txId原样返回
2	msgId	交易流水号	M	String	32	收单系统生成的唯一交易流水号