4、Query Collection Address and Callback Order Status

Request Method

• POST

Request URL

/api/v3/wallet/query/notifystatus

Request Header

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

Parameter Name	Type	Description	Example Value
access_key	String	Merchant backend access key	pFqV75X3
timestamp	int64	13-digit timestamp (milliseconds)	1679724896223
nonce	String	Random string (UUID V4)	794c26b0-d33c-4394-b2bb-c485eca16d9e
sign	String	Signature generated using key	kAXyh+eerqrefyaF8dyFB0M4FVo=

Request Parameters (JSON)

{
  "address": "TKWHPtoVuSvPC6tnVhQc8QVt4hcLiYLarg",
  "startTime":"2025-04-17T16:00:00Z",
  "endTime":"2025-04-18T15:59:59Z",
  "state": 1,
  "page": 1,
  "size": 10
}

Parameter Explanation

Parameter	Type	Description	Required
address	String	Collection wallet address	✅ Yes
startTime	String	Start time (UTC)	✅ Yes
endTime	String	End time (UTC)	✅ Yes
state	Int64	Callback status (0=Success, 1=Failure)	✅ Yes
page	Int64	Page number (default starts from 1)	❌ Optional
size	Int64	Number of items per page	❌ Optional

Response Type

Header: {
  "Content-Type": "application/json;charset=utf-8"
}

Response Example

{
  "code": "200",
  "success": true,
  "msg": "成功",
  "msgEn": "SUCCESS",
  "data": [
    {
      "orderId": "OCRYPPAID202311060927381699262858736DEV001OO0000000400001140",
      "cashierId": "",
      "orderType": 1,
      "orderResourceType": 1,
      "userId": "1719629264270237698",
      "orderStatus": 4,
      "orderTime": 1699262859000,
      "externalOrderId": "",
      "orderAmount":"20",
      "orderActualAmount":"20",
      "orderEntryAmount":"19.513",
      "orderFee":"0.487",
      "orderPayTime":1744956461000,
      "orderCompleteTime":1744956461000,
      "currencyType": "USD",
      "tokenType": "USDT",
      "chainType": "TRON",
      "exchangeRate": "0.991",
      "addressFrom": "TNsGPpkaaMZX9GgUrk6FiGdAf94z9co2PA",
      "addressTo": "TKWHPtoVuSvPC6tnVhQc8QVt4hcLiYLarg",
      "tradeHash": "18d7c6e333b4d889b9029d3838d76390c8ed82256467a84be19b9a4a954a357e",
      "orderTypeCode": "Pay",
      "orderResourceTypeCode": "Crypto",
      "orderStatusCode": "Completed"
    }
  ]
}

Response Parameter Explanation

Parameter	Type	Description
orderId	String	Order ID
cashierId	String	Cashier ID (can be empty)
orderType	Int64	Order type (1-Collection)
orderResourceType	Int64	Order business type (1-Crypto Order)
userId	String	Initiator ID
orderStatus	Int64	Order status code (see status code explanation below)
orderTime	Int64	Order creation time (milliseconds)
externalOrderId	String	Merchant order number
orderAmount	String	Order amount
orderActualAmount	String	Actual received amount
orderFee	String	Transaction fee
currencyType	String	Fiat currency type (e.g., USD)
tokenType	String	Cryptocurrency type (e.g., USDT)
chainType	String	Blockchain network type (e.g., TRON)
exchangeRate	String	Exchange rate at the time of order creation
addressTo	String	Collection address
tradeHash	String	Blockchain transaction hash
orderTypeCode	String	Order type code (e.g., Pay)
orderResourceTypeCode	String	Order business description
orderStatusCode	String	Status description (e.g., Completed)

Order Status Code Explanation (orderStatus)

Status Code	Description
1	Pending Payment
2	On Blockchain Confirmation
4	Completed
8	Payment Amount Mismatch
16	Timeout Collection
32	Unpaid