Query Refund Order
Description
Query refund order details by refund number, including amount, status, and finish time. This is an open Payment API (RSA signature); local data only — no channel call, use Refund Sync for real-time channel status.
Request
POST /unipay/query/refund-order
- Auth: RSA signature (
@PaymentVerify) - Response:
DaxResult<RefundOrderResult>
Parameters
Common params same as Pay - Common Parameters. Business parameters:
| Parameter | Type | Required | Max | Description |
|---|---|---|---|---|
| refundNo | string | No* | 100 | Platform refund number |
| bizRefundNo | string | No* | 100 | Merchant refund number |
*At least one required. Priority: refundNo > bizRefundNo
Example
json
{
"mchNo": "M200000001",
"appId": "APP001",
"reqId": "REQ20241201033",
"reqTime": "2024-12-01 12:33:00",
"sign": "Base64Signature",
"refundNo": "R2024120112345700001"
}Response
DaxResult<RefundOrderResult>, data fields (public slim version):
| Field | Type | Description |
|---|---|---|
| refundNo | string | Platform refund number |
| bizRefundNo | string | Merchant refund number |
| tradeNo | string | Original payment fund trade number |
| bizOrderNo | string | Original payment merchant order number |
| outRefundNo | string | Channel refund transaction number |
| amount | long | Refund amount (cents) |
| orderAmount | long | Original order amount (cents) |
| status | string | Refund status (RefundOrderStatusEnum: progress / success / fail / close) |
| reason | string | Refund reason |
| finishTime | string | Refund finish time (Beijing time, yyyy-MM-dd HH:mm:ss) |
| errorMsg | string | Error message |
Example
json
{
"code": 0,
"msg": "success",
"data": {
"refundNo": "R2024120112345700001",
"bizRefundNo": "REFUND20241201001",
"tradeNo": "T2024120112345700001",
"bizOrderNo": "ORDER20241201001",
"outRefundNo": "5000050xxxxxxxxxxxx",
"amount": 100,
"orderAmount": 100,
"status": "success",
"reason": "Customer requested refund",
"finishTime": "2024-12-01 14:00:00"
},
"sign": "Base64Signature",
"resTime": "2024-12-01 12:33:00",
"reqId": "REQ20241201033"
}Usage Tips
- Query is idempotent and returns locally persisted data only; prefer Refund Sync for real-time channel status.