跳转到内容

代付查询

请求地址

methodurl
POST/api/pay/payout/query/v1

头部信息(header)

header参数入参参数描述
timestamp请求时间戳
nonce随机值
countryBP
app_codeapp编号

请求参数

字段类型必需长度描述
merchantOrderNoStringyes32商户订单号
signStringyes签名
请求示例
{
"merchantOrderNo": "OrderNoExample",
"sign": "YOUR_SIGN"
}

返回参数

参数类型必需长度描述
merchantOrderNoStringyes32商户订单号
tradeNoStringyes平台订单号
amountStringyes代付金额
statusIntyes代付状态,2:成功 3:失败 4:退款
serviceAmountStringyes服务费用 = 固收金额 + 交易金额 * 服务费率
immServiceStringyes固收金额
serviceRateStringyes服务费率
errorCodenumberyes订单失败状态错误码
errorMessageStringyes订单失败错误信息
completeTimeStringyes完成时间 当前国家时区 yyyy-MM-dd HH:mm:ss格式
返回示例
{
"code": 200,
"data": {
"merchantOrderNo": "OrderNoExample",
"tradeNo": "TF2501010001BP0000000000000000",
"amount": "1000.00",
"status": 2,
"serviceAmount": "15.00",
"immService": "5.00",
"serviceRate": "0.010",
"errorCode": null,
"errorMessage": null,
"completeTime": "2025-05-01 00:00:00"
},
"msg": "success",
"traceId": "747bbf80261844ed85b809212aab0d81.85.17422898158610298"
}
订单不存在返回示例
{
"code": 400,
"msg":"Order not found",
"traceId": "747bbf80261844ed85b809212aab0d81.85.17422898158610298"
}