转账订单查询接口

提示

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

接口说明

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

请求参数

公共参数

业务参数

提示

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

字段名	变量名	必填	类型	长度	示例值	描述
转账订单号	transferNo	否	String	32	T00123	不可同时为空，转账订单号 > 商户订单号 > 通道订单号
商户转账订单号	bizTransferNo	否	String	100	DEVT24051019590563000001	不可同时为空，转账订单号 > 商户订单号 > 通道订单号
通道转账订单号	outOrderNo	否	String	100	2025110024006610001	不可同时为空，转账订单号 > 商户订单号 > 通道订单号

响应结果

业务响应参数

提示

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

字段名	变量名	必传	类型	示例值	描述
转账号	transferNo	是	String	DEVP1753370980523384832
商户转账号	bizTransferNo	是	String
通道转账号	outTransferNo	否	String
转账通道	channel	是	String	ali_pay
转账金额	amount	是	BigDecimal	10.12	进行转账的金额,单位为元，保留两位小数
转账标题	title	是	String
转账原因	reason	否	String	测试转账
收款人类型	payeeType	是	String		转账接收方类型， 见常量和状态表转账接收方类型相关的描述
收款人账号	payeeAccount	否	String
收款人姓名	payeeName	否	String
转账状态	status	是	String	success	见转账状态相关的描述
完成时间	finishTime	否	String	2024-10-24 12:00:00	时间格式 yyyy-MM-dd HH:mm:ss
商户扩展参数	attach	否	String	500	商户传入的扩展参数
错误信息	errorMsg	否	String	退款订单不存在	返回订单的错误信息

HTTP请求示例

请求参数

{
  "transferNo" : "DEV_T2025041111124570000027",
  "mchNo" : "M1723635576766",
  "appId" : "M8207639754663343",
  "sign" : "c0eb46aafef07a45e06c6fe8cbcdc83a",
  "reqTime" : "2025-04-11 16:29:47"
}

响应参数(成功)

{
  "code" : 0,
  "msg" : "success",
  "data" : {
    "bizTransferNo" : "T1744341164682",
    "transferNo" : "DEV_T2025041111124570000027",
    "outTransferNo" : "20250411020070011530210056025357",
    "channel" : "ali_pay",
    "amount" : 0.1,
    "title" : "测试支付宝转账",
    "reason" : "我要转个账",
    "payeeType" : "user_id",
    "payeeAccount" : "20886121923xxxxxx",
    "status" : "success",
    "finishTime" : "2025-04-11 11:12:46",
  },
  "sign" : "af84690bc872104e334aae7429228c06",
  "resTime" : "2025-04-11 16:29:47",
  "traceId" : "4ugAU7OLcfHd"
}

响应参数(失败)

{
    "code": 20041,
    "msg": "转账订单不存在",
    "sign": "ec5a99a641748e2f7cf8ef4d19c5fc71",
    "resTime": "2025-04-11 16:33:02",
    "traceId": "lCQJcgpwrxrg"
}

SDK请求示例

提示

使用SDK可以简化接入转账的速度

public void queryTransferOrder() {
    QueryTransferParam param = new QueryTransferParam();
    param.setTransferNo("DEV_T2025041111124570000021");
    DaxResult<TransferOrderResult> execute = DaxPayKit.execute(param);
    System.out.println("验签结果: " + DaxPayKit.verifySign(execute));
    System.out.println(JsonUtil.toJsonStr(execute));
}