Query Payout Order (/payout/query)

Description

Merchants can query the real-time status and details of a payout order.

---

Request Information

• Endpoint: /payout/query
• Method: POST
• Content-Type: application/json; charset=utf-8

---

HTTP Headers

Header	Required	Type	Description
merchantNo	Yes	String	Merchant ID
sign	Yes	String	Base64-encoded RSA digital signature of request body

---

Request Body Parameters

Parameter	Required	Type	Example	Description
timestamp	Yes	Long	1772880500000	Epoch timestamp in milliseconds
merchantOrderNo	Yes	String	PO202603070001	Merchant payout order reference

Request Payload Example

{
  "timestamp": 1772880500000,
  "merchantOrderNo": "PO202603070001"
}

---

Response Parameters

Success Response

{
  "code": 1,
  "msg": "ok",
  "data": {
    "merchantNo": "M1639466186292",
    "merchantOrderNo": "PO202603070001",
    "platOrderNo": "876324486452871168",
    "amount": "220.00",
    "fee": "5.00",
    "status": "3",
    "payTime": "2026-09-09 22:22:22",
    "payAccountNo": "01666777888",
    "trxId": "SDIIFKISDL"
  }
}

Failure Response

{
  "code": 0,
  "msg": "order not found"
}

Field Specifications

Field	Required	Type	Description
code	Yes	Integer / String	Status code: 1 indicates success, 0 indicates failure
msg	Yes	String	Message description
data	Yes	Object	Detailed payout data object
data.merchantNo	Yes	String	Merchant ID
data.merchantOrderNo	Yes	String	Merchant order reference number
data.platOrderNo	Yes	String	Platform transaction number
data.amount	Yes	String	Disbursed amount
data.fee	Yes	String	Payout fee
data.status	Yes	String	Payout status: 0: Created 1: Processing (sent to bank/wallet) 2: Failed 3: Succeeded
data.payTime	No	String	Payment completion timestamp (format: yyyy-MM-dd HH:mm:ss)
data.payAccountNo	No	String	Disbursing account number
data.trxId	No	String	Unique transaction ID generated by the e-wallet system to identify this transaction