Query Pay-in Order (/payin/query)

Description

Merchants can query the real-time status and details of an existing pay-in order. This endpoint is typically used when the asynchronous callback notification is delayed or for periodic reconciliation.

---

Request Information

• Endpoint: /payin/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 the request body

---

Request Body Parameters

Parameter	Required	Type	Example	Description
timestamp	Yes	Long	1772880200000	Epoch timestamp in milliseconds
merchantOrderNo	Yes	String	202603070001	Merchant unique order number

Request Payload Example

{
  "timestamp": 1772880200000,
  "merchantOrderNo": "202603070001"
}

---

Response Parameters

Success Response

{
  "code": 1,
  "msg": "success",
  "data": {
    "merchantNo": "M1639466186292",
    "merchantOrderNo": "202603070001",
    "platOrderNo": "876324486452871168",
    "amount": "220.00",
    "fee": "2.20",
    "payUrl": "https://gateway.example.com/checkout/876324486452871168",
    "expireTime": "2026-05-05 11:11:11",
    "status": "3",
    "payTime": "2026-09-09 22:22:22",
    "payAccountNo": "01666777888",
    "trxId": "SDIIFKISDL"
  }
}

Failure Response

{
  "code": 0,
  "msg": "param merchant error"
}

Field Specifications

Field	Required	Type	Description
code	Yes	Integer / String	1 for success, 0 for failure
msg	Yes	String	Status or error description
data	Yes	Object	Detailed order 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	Transaction amount
data.fee	Yes	String	Processing fee
data.expireTime	Yes	String	Expiration time of the checkout URL
data.payUrl	Yes	String	Cashier checkout page redirect URL
data.status	Yes	String	Order status: 0: Created 1: Expired 2: Failed 3: Succeeded
data.payTime	No	String	Payment time (format: yyyy-MM-dd HH:mm:ss)
data.payAccountNo	No	String	Payer's wallet account number
data.trxId	No	String	Unique transaction ID generated by the e-wallet system to identify this transaction