# 3、Order Inquiry

# Inquiry for Payment Orders

API Description

This API allows you to query the details and status of an encrypted payment order by using the platform order ID and merchant order ID.

Request Method

POST

Request URL

/api/v3/wallet/query/pay

Request Header

Content-Type: application/json;charset=utf-8

Parameter	Description	Example Value
access_key	Obtained from the merchant backend	pFqV75X3
timestamp	Unix timestamp (13 digits)	1679724896223
nonce	UUID V4	794c26b0-d33c-4394-b2bb-c485eca16d9e
sign	HMAC-SHA1 signature	kAXyh+eerqrefyaF8dyFB0M4FVo=

Request Parameters (JSON)

{
  "externalOrderId": "402297358314559082",
  "orderId": "OCRYPPAID202307310902391690794159441DOCKER020000000400001108"
}

Parameter Description

Parameter	Type	Description	Required
externalOrderId	String	Merchant Order ID	Yes
orderId	String	Platform Order ID	Yes

Response Type

Content-Type: application/json;charset=utf-8

Response Example

{
  "code": "200",
  "success": true,
  "msg": "成功",
  "msgEn": "SUCCESS",
  "data": [{
    "orderId": "OCRYPPAID202307310902391690794159441DOCKER020000000400001108",
    "cashierId": "OCRYPPAID202307310902391690794159250DOCKER020000000200001107",
    "orderType": 1,
    "orderResourceType": 1,
    "userId": "1663371399710216194",
    "orderStatus": 1,
    "orderTime": 1690794159000,
    "externalOrderId": "402297358314559082",
    "orderAmount": "1",
    "currencyType": "USD",
    "tokenType": "USDT",
    "chainType": "ETH",
    "exchangeRate": "0.983",
    "addressTo": "0xe072c63c1e04f8c6f36133f6629f66778147d5d8",
    "orderTypeCode": "Pay",
    "orderResourceTypeCode": "Crypto",
    "orderStatusCode": "Wait pay"
  }]
}

Response Parameter Description

Parameter	Type	Description
orderId	String	Platform Order ID
cashierId	String	Cashier ID
orderType	int64	Order type, enum values: 1 - Payment
orderTypeCode	String	Order type description
orderResourceType	int64	Business type, enum values: 1 - Crypto order
orderResourceTypeCode	String	Business type description
userId	String	User ID who initiated the order
orderTime	int64	Order creation time (timestamp)
externalOrderId	String	Merchant Order ID
orderAmount	String	Order amount
currencyType	String	Fiat currency type (e.g., USD)
tokenType	String	Cryptocurrency type (e.g., USDT)
chainType	String	Blockchain type (e.g., ETH)
exchangeRate	String	Exchange rate at the time the order was created
addressTo	String	Payment address (platform-generated receiving address)
orderStatusCode	String	Status code description
orderStatus	int64	Status code, enum values: 1, 2, 4, 8, 16 (see details below)

Order Status Code Description

Status Code	Status Description	Is Final State	Explanation
1	Waiting for Payment	No	The order has been created, and the user has not yet paid. No action needed.
2	On-chain Confirmation	No	The user clicked "Payment Completed", and the system is checking if the payment has been received on the blockchain. No action needed.
4	Completed	Yes	Payment successful. The system will trigger a callback. The merchant should adjust balances or complete delivery according to business logic.
8	Payment Amount Mismatch	Yes	The user's payment amount ≠ the expected amount. The system will trigger a callback. It is recommended to record the actual paid amount.
16	Payment Timeout	Yes	The user’s payment has timed out. The system will not callback. The merchant should manually process if payment has been received.
32	Not Paid (Address Released)	Yes	The user has not paid for a long time, and the address is released. If paid later, a new order will be created.

# Inquiry for Transfer Orders

API Description

The merchant can use this API to query the details of a specific on-chain transfer order, including order status, amount, fees, and on-chain transaction hash.