Query Payment Order
Description
Query system order details by order number, including current payment status and amount.
Request
POST /unipay/query/pay-order
- Auth: RSA signature (
@PaymentVerify) - Response:
DaxResult<NormalPayOrderResult>
Parameters
Common params same as Pay - Common Parameters. Business parameters:
| Parameter | Type | Required | Max | Description |
|---|---|---|---|---|
| orderNo | string | No* | 100 | Platform order number |
| bizOrderNo | string | No* | 100 | Merchant order number |
*At least one required. Priority: orderNo > bizOrderNo
Example
json
{
"mchNo": "M200000001",
"appId": "APP001",
"reqId": "REQ20241201003",
"reqTime": "2024-12-01 12:10:00",
"sign": "Base64Signature",
"orderNo": "P2024120112345700001"
}Response
DaxResult<NormalPayOrderResult>, data fields:
| Field | Type | Description |
|---|---|---|
| orderNo | string | Platform order number |
| bizOrderNo | string | Merchant order number |
| tradeNo | string | Fund trade number |
| outOrderNo | string | Channel order number |
| title | string | Order title |
| description | string | Order description |
| channel | string | Payment channel (ChannelEnum) |
| method | string | Payment method (PayMethodEnum) |
| limitPay | string | Restricted payment type (PayLimitPayEnum) |
| amount | long | Amount (cents) |
| realAmount | long | Actual paid amount (cents) |
| refundableBalance | long | Refundable balance (cents) |
| status | string | Pay status (PayStatusEnum) |
| refundStatus | string | Refund status (PayRefundStatusEnum) |
| provider | string | Payment provider (PayProviderEnum, e.g., WECHAT/ALIPAY) |
| payTime | string | Payment time (UTC) |
| closeTime | string | Close time (UTC) |
| expiredTime | string | Expiry time (UTC) |
| terminalNo | string | Terminal device code |
| storeNo | string | Store number |
| buyerId | string | Buyer user ID |
| attach | string | Custom data (returned as-is) |
| errorMsg | string | Error message |
Refund Status (PayRefundStatusEnum)
Refund marker on the payment order:
| refundStatus | Description |
|---|---|
| no_refund | No refund |
| refunding | Refund processing |
| partial_refund | Partially refunded |
| refunded | Fully refunded |
Example
json
{
"code": 0,
"msg": "success",
"data": {
"orderNo": "P2024120112345700001",
"bizOrderNo": "ORDER20241201001",
"tradeNo": "T2024120112345700001",
"outOrderNo": "WX2024120100001",
"title": "Test Product",
"channel": "wechat",
"method": "wechat_qr",
"amount": 100,
"realAmount": 100,
"refundableBalance": 100,
"status": "success",
"refundStatus": "no_refund",
"provider": "WECHAT",
"payTime": "2024-12-01T04:00:00Z",
"expiredTime": "2024-12-01T04:30:00Z",
"attach": "{\"orderId\": 123}"
},
"sign": "Base64Signature",
"resTime": "2024-12-01T04:10:00Z",
"reqId": "REQ20241201003"
}