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"
  }
}

Failure Response

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

Field Specifications

Field	Type	Description
code	Integer / String	1 indicates success, 0 indicates failure
msg	String	Message description
data	Object	Detailed payout data object
data.merchantNo	String	Merchant ID
data.merchantOrderNo	String	Merchant order reference number
data.platOrderNo	String	Platform transaction number
data.amount	String	Disbursed amount
data.fee	String	Payout fee
data.status	String	Payout status: 0: Created 1: Processing (sent to bank/wallet) 2: Failed 3: Succeeded