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

Failure Response

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

Field Specifications

Field	Type	Description
code	Integer / String	1 for success, 0 for failure
msg	String	Status or error description
data	Object	Detailed order data object
data.merchantNo	String	Merchant ID
data.merchantOrderNo	String	Merchant order reference number
data.platOrderNo	String	Platform transaction number
data.amount	String	Transaction amount
data.fee	String	Processing fee
data.expireTime	String	Expiration time of the checkout URL
data.payUrl	String	Cashier checkout page redirect URL
data.status	String	Order status: 0: Created 1: Expired 2: Failed 3: Succeeded