Query payout
POST
/trade/payout/queryRequest headers
Request parameters
| Field | Type | Required | Maximum length | Description |
|---|---|---|---|---|
merchantOrderNo | String | Yes | 32 | Merchant order number |
Request example
{ "merchantOrderNo": "PAYOUT202609170001"}Response parameters
| Field | Type | Required | Maximum length | Description |
|---|---|---|---|---|
code | int | Yes | - | Status code; a value other than 200 indicates an error |
data | Object | Yes | - | Response body |
data.merchantOrderNo | String | Yes | 32 | Merchant order number |
data.tradeNo | String | Yes | 32 | Platform order number |
data.transactionAmount | String | Yes | - | Payout amount |
data.payoutType | String | Yes | 24 | Payout method |
data.status | String | Yes | 20 | Order status |
data.failMsg | String | No | 24 | Order failure reason |
data.serviceAmount | String | No | - | Service fee |
data.serviceRate | String | No | - | Service fee rate |
data.immService | String | No | - | Fixed fee |
data.completeTime | String | No | - | Completion time (local time) |
data.totalRefundAmount | String | No | - | Total refund amount |
data.refundDetails | Array | No | - | Refund detail list |
data.refundDetails.refundNo | String | No | 32 | Refund number |
data.refundDetails.refundAmount | String | No | - | Refund amount |
data.refundDetails.refundTime | String | No | - | Refund time (local time, format yyyy-MM-dd HH:mm:ss) |
msg | String | No | - | Error message |
tid | String | Yes | - | Trace ID |
Order status
| Status | Description |
|---|---|
INIT | Accepted |
PAYING | Processing |
SUCCESS | Completed |
FAIL | Failed |
REFUND | Refunded |
PART_REFUND | Partially refunded |
Response example
{ "code": 200, "data": { "merchantOrderNo": "PAYOUT202609170001", "tradeNo": "VF2405220001BR0000508467743993", "transactionAmount": "100.00", "payoutType": "CPF", "status": "SUCCESS", "serviceAmount": "1.00", "completeTime": "2026-09-17 15:30:00", "totalRefundAmount": "100.00", "refundDetails": [ { "refundNo": "REFUND202609170001", "refundAmount": "100.00", "refundTime": "2026-09-17 15:30:00" } ] }, "msg": "success", "tid": "747bbf80261844ed85b809212aab0d81"}