Query Payment Order

This interface is used to query the detailed information of a single order based on the order number.

Request Information

Request Path

POST /v1/payment/info

Headers

The request headers need to include authentication information and content type.

Field	Type	Description
X-API-Key	string	Your API Key, used to identify the caller.
X-Timestamp	string	The timestamp of the current request (Unix epoch time, seconds).
X-Nonce	string	A random string (Nonce). Each request must use a unique Nonce.
X-Signature	string	The signature of the request content.

Request Body

The request body is in JSON format and contains the order number to be queried.

Field	Type	Description	Required	Example Value
order_no	string	Merchant's order number or system order number.	Yes	"Pay1756208527"

Request Body Example (JSON):

{
  "order_no": "Pay1756208527"
}

Response Information

Successful Response Example (JSON)

When the request is successful (HTTP status code 200), the response content will vary depending on the order status (state).

Response Example for an Unpaid Order

{
  "code": 10000,
  "message": "OK",
  "data": {
    "id": "5104887808",
    "order_no": "Pay1756198910",
    "currency": "EUR",
    "amount": "0.1",
    "chain_type": "bsc",
    "order_amount": "0.12",
    "product_name": "Test product name",
    "cancel_time": 1756200711,
    "meta": "",
    "state": 1,
    "pay_url": "https://zaepe.com/pay/0198e59c-bec0-7039-83dd-d3b061c4c9d7"
  }
}

Response Example for a Paid Order

{
  "code": 10000,
  "message": "OK",
  "data": {
    "id": "524206080",
    "order_no": "Pay1756019978",
    "currency": "EUR",
    "amount": "0.1",
    "chain_type": "bsc",
    "order_amount": "0.12",
    "product_name": "Test product name",
    "cancel_time": 1756021778,
    "meta": "",
    "state": 2,
    "pay_amount": "0.12",
    "fee": "0.01",
    "txid": "0xa3c6beb38c2fa1b4681d3b126a...",
    "pay_time": 1756020040
  }
}

Field	Type	Description
id	string	The internal order ID in the payment system.
order_no	string	Merchant's order number.
currency	string	Order currency code.
amount	string	Original order amount. Note that this is a string type.
chain_type	string	Payment chain type.
order_amount	string	Actual amount collected in USDT.
product_name	string	Product or service name.
cancel_time	integer	The order's cancellation/expiration time (Unix Timestamp, seconds).
meta	string	Additional metadata.
state	integer	The current status of the order. For specific values, please refer to Order Status.
pay_url	string	Payment page URL (only returned for unpaid orders).
pay_amount	string	Actual payment amount (only returned after payment).
fee	string	Transaction fee (only returned after payment).
txid	string	Blockchain transaction hash (only returned after payment).
pay_time	integer	Payment completion time (Unix Timestamp, seconds, only returned after payment).

Error Response Example (JSON)

When the request fails (HTTP status code is not 200):

{
  "code": 10004,
  "message": "Order does not exist"
}