退款订单查询接口 ¶

提示

用于发起退款订单后，可以通过该接口主动查询退款订单的状态和信息，完成下一步的业务逻辑。

接口说明 ¶

参数	说明
请求URL	`/unipay/query/refundOrder`
请求方式	`POST`
请求类型	`application/json`

请求参数 ¶

业务参数 ¶

提示

设置参数时，不要忘了设置公共请求参数调用说明，未做特殊说明所有接口都需要传输

字段名	变量名	必填	类型	长度	示例值	描述
退款订单号	orderNo	否	String	100	1753370980523384832	不可同时为空，退款订单号 > 商户订单号 > 通道订单号
商户退款订单号	bizOrderNo	否	String	100	P0001	不可同时为空，退款订单号 > 商户订单号 > 通道订单号
通道退款订单号	outOrderNo	否	String	100	2025110024006610001	不可同时为空，退款订单号 > 商户订单号 > 通道订单号

响应结果 ¶

业务响应参数 ¶

提示

业务数据在公共响应参数中的data字段，在code为0时才会有返回数据，见调用说明。

字段名	变量名	必传	类型	示例值	描述
支付订单号	orderNo	是	String	DEVP1753370980523384832
商户支付订单号	bizOrderNo	是	String
通道支付订单号	outOrderNo	是	String
支付标题	title	是	String
退款号	refundNo	是	String	R0001
商户退款号	bizRefundNo	是	String
通道退款交易号	outRefundNo	是	String
退款通道	channel	是	String	ali_pay
订单金额	orderAmount	是	BigDecimal	10.12	单位为元，保留两位小数
退款金额	amount	是	BigDecimal	10.12	单位为元，保留两位小数
退款原因	reason	否	String	测试退款
退款结束时间	finishTime	否	String	2024-10-24 12:00:00	时间格式 yyyy-MM-dd HH:mm:ss
退款状态	status	是	String	success	见退款状态状态说明
商户扩展参数	attach	否	String	500	商户传入的扩展参数
错误信息	errorMsg	否	String	退款订单不存在	返回订单的错误信息

HTTP请求示例 ¶

请求参数 ¶

json

{
  "refundNo" : "DEV_R2025032911313670000027",
  "mchNo" : "M1723635576766",
  "appId" : "M8207639754663343",
  "clientIp" : "127.0.0.1",
  "sign" : "6b8d82281430cee9faca380ec68be124",
  "reqTime" : "2025-04-11 16:13:30"
}

响应参数(成功) ¶

json

{
  "code" : 0,
  "msg" : "success",
  "data" : {
    "orderNo" : "DEV_P2025032910365170000025",
    "outOrderNo" : "71d4460580694f699cd9e3b427dd18ac",
    "bizOrderNo" : "PAY_48835722351743215803856",
    "title" : "测试收网关支付",
    "refundNo" : "DEV_R2025032911313670000027",
    "bizRefundNo" : "MANUAL_DEV_R2025032911313670000026",
    "outRefundNo" : "32e5f5019ba04ece8cecc13b5be12bdd",
    "channel" : "vbill_pay",
    "orderAmount" : 0,
    "amount" : 0.1,
    "reason" : "",
    "finishTime" : "2025-03-29 11:31:38",
    "status" : "success"
  },
  "sign" : "826cfd7496394dc378113e235a15d1bd",
  "resTime" : "2025-04-11 16:13:31",
  "traceId" : "dF5KrCSjvLXQ"
}

响应参数(失败) ¶

json

{
    "code": 20041,
    "msg": "退款订单不存在",
    "sign": "3570542287b7d7381f2c25bfff5a7ee2",
    "resTime": "2025-04-11 16:16:12",
    "traceId": "M23d6RfaXpsS"
}

SDK请求示例 ¶

提示

使用SDK可以简化接入支付的速度

java

public void testRefund() {
    QueryRefundParam param = new QueryRefundParam();

    param.setRefundNo("DEV_R2025032911313670000021");
    param.setClientIp("127.0.0.1");

    DaxResult<RefundOrderResult> execute = DaxPayKit.execute(param);
    System.out.println("验签结果: " + DaxPayKit.verifySign(execute));
    System.out.println(JsonUtil.toJsonStr(execute));
}