Payment Query API
Tips
- All requests are
Post
requests, and the data format isjson
Brief Description
- The business party can actively query the payment results
Request URL
/v1/paypro/queryPayInResult
Request Method
- Post
Header
Name | Required | Type | Description |
---|---|---|---|
merchantNo | Y | string | - |
Request Body Parameters
Name | Required | Type | Description |
---|---|---|---|
tradeNo | Y | string | Transaction number passed by the merchant when making the payment |
timestamp | Y | string | Timestamp |
sign | Y | string | Encryption |
Request Example
{
"sign": "b609f38f4c3900a82beaf2222611083d",
"timestamp": "1729153976003",
"tradeNo": "133323384"
}
Successful Response Example
Parameter Name | Required | Type | Description |
---|---|---|---|
msg | Yes | string | Request result (when returning "success", it only indicates that this request was successful; it should not be used for merchant-side logic judgment) |
code | Yes | string | Request response code (when returning "0000", it only indicates that this request was successful; it should not be used for merchant-side logic judgment). For specific error codes, please refer to the business error code enumeration. |
timestamp | Yes | string | Timestamp (e.g., 1715941383720) |
success | Yes | string | Transaction result |
data | Yes | Object | Returned object |
data.platFormTradeNo | Yes | string | Platform order number |
data.tradeNo | Yes | string | Merchant transaction number returned |
data.amount | Yes | string | Transaction amount |
data.status | Yes | string | Request result; merchants can use it for logical processing. When the result is "0000", it indicates that the transaction is successful; "0015" indicates processing; all others are error codes and can be treated as failures. |
data.message | Yes | string | Error description |
data.successTime | Yes | string | Transaction success time (local time) |
{
"msg": "success",
"code": "0000",
"timestamp": 1729325978798,
"success": true,
"data": {
"platFormTradeNo": "7zr8om5hzclkemsz",
"tradeNo": "133323384",
"amount": "50000.00",
"status": "0000",
"successTime": "2024-10-19 14:37:28"
}
}