Payment Query API

Tips

• All requests are Post requests, and the data format is json

Brief Description

• Query the current status and details of a collection order.

Request URL

• /v1/paypro/queryPayInResult

Request Method

• POST

Header

Header	Required	Type	Description
merchantNo	Yes	String	Merchant number

Request Body Parameters

Name	Required	Type	Description
tradeNo	Yes	String	Merchant transaction number used when creating the collection order
timestamp	Yes	Long	13-digit Unix timestamp in milliseconds
sign	Yes	String	Request signature generated using the signature logic in the Overview

Request Example

{
  "sign": "ac13b9abf95c66ffc4025abaaeeb3a83",
  "timestamp": 1728613488294,
  "tradeNo": "test_00000008"
}

Response Parameters

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	Long	Timestamp (e.g., 1715941383720)
success	Yes	Boolean	Whether the API request was accepted
data	Yes	Object	Response object
data.tradeNo	Yes	string	Merchant transaction number
data.platFormTradeNo	Yes	string	PayPro transaction number
data.status	Yes	string	Transaction status: 0000 success, 0015 processing, or 00029 failed.
data.amount	Yes	string	Collection amount in COP
data.successTime	Conditional	string	Transaction success time, formatted as yyyy-MM-dd HH:mm:ss; returned after a successful transaction
data.message	Yes	string	Status or error description

Failed Response Example

{
    "msg": "success",
    "code": "0000",
    "timestamp": 1728613513280,
    "success": true,
    "data": {
        "tradeNo": "test_00000008",
        "platFormTradeNo": "68o0uwogz7mnzutt",
        "status": "00029",
        "amount": "300",
        "message": "Collection order timed out without payment"
    }
}

---