Payout Query API

Tips

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

Brief Description

• The business party can actively query the payment results.

Request URL

• /api/queryPayOutResult

Request Method

• POST

Header

Name	required	type	desc
merchantNo	Yes	string	-

Request Body Parameters

Name	required	type	desc
tradeNo	Yes	string	Transactions requested by the business party
sign	Yes	string	sign

Request Example

{
    "tradeNo": "1000002",
	"sign": "00000000000"
}

Successful Response Example

Parameter	Required	Type	Description
msg	Yes	string	Request result (when returning success, it only indicates that the request was successful and cannot be used for merchant-side logic judgment)
code	Yes	string	Request response code (when returning 0000, it only indicates that the request was successful and cannot be used for merchant-side logic judgment). For specific error codes, please refer to the business error code enumeration.
timestamp	Yes	string	Transaction time
success	Yes	string	Transaction result
data	Yes	Object	Return object
data.platFormTradeNo	Yes	string	paypro transaction number
data.amount	Yes	string	Transaction amount
data.status	Yes	string	Request result, merchants can use this for logic processing. When the result is 0000, it indicates a successful transaction; 0015 indicates processing; all other codes indicate errors and can be treated as failures.
data.message	Yes	string	Error description
data.successTime	Yes	string	Transaction success time (Kenya time)

Successful Response Example

{
    "msg": "success",
    "code": "0000",
    "timestamp": 1719830071094,
    "success": true,
    "data": {
        "platFormTradeNo": "5286e98841194687a95d25b5f3be346d",
        "tradeNo": "00000020",
        "amount": 3.0000,
        "status": "00029",
        "message": "REJECTED_TRANSACTION",
        "successTime": "2024-07-01 18:34:31"
    }
}