Query Pay-in Order

Merchants query the status and detailed information of a pay-in order via this interface.

---

Interface Info

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

---

Request Header Parameters

Parameter	Required	Type	Description
merchantNo	Yes	string	Merchant Number
sign	Yes	string	RSA Signature (Refer to Global Specification)

---

Request Body Parameters

Parameter	Required	Type	Description
timestamp	Yes	Long	Millisecond timestamp
merchantOrderNo	Yes	string	Merchant order number (Unique)

---

Response Examples

Success Response

{
  "code": 1,
  "msg": "success",
  "data": {
    "merchantNo": "M1639466186292",
    "merchantOrderNo": "202112151143188593456",
    "platOrderNo": "876324486452871168",
    "amount": "220.00",
    "fee": "2.20",
    "payType": "payType",
    "payUrl": "payUrl",
    "expireTime": "2026-05-05 11:11:11",
    "status": "1"
  }
}

Error Response

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

---

Response Parameter Description

Parameter	Type	Description
code	string / number	1 for Success, 0 for Failure
msg	string	Message explanation
data	object	Returned data payload
└ merchantNo	string	Merchant Number
└ merchantOrderNo	string	Merchant Order Number
└ platOrderNo	string	Platform Order Number
└ amount	string	Amount
└ fee	string	Service Fee
└ payType	string	Payment Type: THAI_DYNAMIC_QR, BANK
└ payUrl	string	Payment URL
└ expireTime	string	Expiration Time
└ status	string	Status: 0 Created, 1 Processing, 2 Failed, 3 Success