代付订单查询 (Payout Query)
接口描述
商户调用此接口主动查询代付(出款)订单的当前处理状态与详情。
请求信息
- 请求 URL:
/payout/query - 请求方式:
POST - Content-Type:
application/json; charset=utf-8
请求头(HTTP Headers)
| 参数名 | 必填 | 类型 | 说明 |
|---|---|---|---|
merchantNo | 是 | String | 商户号 |
sign | 是 | String | 请求 Body 的 RSA 签名 |
请求 Body 参数
| 参数名 | 必选 | 类型 | 示例值 | 说明 |
|---|---|---|---|---|
timestamp | 是 | Long | 1772880500000 | 毫秒级时间戳 |
merchantOrderNo | 是 | String | PO202603070001 | 商户订单号(下单时传入的唯一编号) |
请求示例
json
{
"timestamp": 1772880500000,
"merchantOrderNo": "PO202603070001"
}响应参数
成功返回示例
json
{
"code": 1,
"msg": "ok",
"data": {
"merchantNo": "M1639466186292",
"merchantOrderNo": "PO202603070001",
"platOrderNo": "876324486452871168",
"amount": "220.00",
"fee": "5.00",
"status": "3"
}
}失败返回示例
json
{
"code": 0,
"msg": "order not found"
}返回参数说明
| 参数名 | 类型 | 说明 |
|---|---|---|
code | Integer / String | 业务状态码:1 成功,0 失败 |
msg | String | 消息说明 |
data | Object | 订单详细数据对象 |
data.merchantNo | String | 商户号 |
data.merchantOrderNo | String | 商户订单号 |
data.platOrderNo | String | 平台内部订单号 |
data.amount | String | 出款金额 |
data.fee | String | 出款手续费 |
data.status | String | 代付订单状态:0: 已创建1: 支付中 / 银行处理中2: 失败3: 成功 |
