Payout Query API
Tips
- All requests are
Postrequests, and the data format isjson
API Documentation for Querying PayOut Result
Brief Description
- The business party can actively query the payment results.
Request URL
/v1/paypro/queryPayOutResult
Request Method
- POST
Header
| Name | Required | Type | Description |
|---|---|---|---|
| merchantNo | Yes | string | - |
Request Body Parameters
| Name | Required | Type | Description |
|---|---|---|---|
| tradeNo | Yes | string | The transaction number provided by the merchant during payout |
| timestamp | Yes | string | Timestamp |
| sign | Yes | string | Encrypted signature |
Request Example
{
"sign": "ee5c512fe36fed2afe2d36ab248e0eb8",
"timestamp": "1728613320708",
"tradeNo": "test_00000002"
}
Successful Response Example
| Parameter Name | Required | Type | Description |
|---|---|---|---|
| msg | Yes | string | Request result (Returning "success" only indicates the request was successful; it should not be used for merchant-side logic) |
| code | Yes | string | Request response code (Returning "0000" only indicates the request was successful; it should not be used for merchant-side logic) |
| timestamp | Yes | string | Timestamp (e.g., 1715941383720) |
| success | Yes | string | Transaction result |
| data | Yes | Object | Response object |
| data.tradeNo | Yes | string | Transaction number returned by the merchant |
| data.platFormTradeNo | Yes | string | PayPro transaction number |
| data.orderAmount | Yes | float | Order amount |
| data.payAmount | Yes | float | Payment amount |
| data.status | Yes | string | Request result. The merchant can use this for logical processing. "0000" indicates transaction success, "0015" indicates processing, and other codes are error codes that can be treated as failures. |
| data.message | Yes | string | Error description |
| data.successTime | Yes | string | Transaction success time (local time) |
Successful Response Example**:
{
"msg": "success",
"code": "0000",
"timestamp": 1728613339884,
"success": true,
"data": {
"platFormTradeNo": "63mz9aepqczdw280",
"tradeNo": "test_00000002",
"orderAmount": "300.00",
"payAmount": "200.00",
"status": "0015",
"message": "Processing",
"successTime": "2024-10-12 12:59:32"
}
}
