[Order] Checking Order Status

Retrieves [Order Status] or complete details by providing either the [orderId] or [externalTradeNo].

Attention1: Rate limit is 10 requests per second.

Attention2: Since the cancellation process is asynchronous, to determine whether the refund is successful, please do not rely entirely on whether the cancelStatus field of the response is equal to 1, but combine the response field orderAssetStatus with whether it is equal to 6.

Curl request

$ curl 'https://www.skindeer.com/market/open_api/request/?action=merchant.order.buy.detail' -i -X POST \
    -H 'Content-Type: application/json' \
    -d '{
  "orderId" : "1179273226945818624", // OR externalTradeNo
  "apiKey" : "955a2f4e8f121cdda99ae97ae9728d2d"
}'

HTTP request

POST /market/open_api/request/?action=merchant.order.buy.detail HTTP/1.1
Content-Type: application/json
Content-Length: 82
Host: localhost:8080

{
  "orderId" : "1179273226945818624", // OR externalTradeNo OR transId
  "apiKey" : "955a2f4e8f121cdda99ae97ae9728d2d"
}

Request body

{
  "orderId" : "1179273226945818624", // OR externalTradeNo OR transId
  "apiKey" : "955a2f4e8f121cdda99ae97ae9728d2d"
}

Path	Type	Description
apiKey	String	api key
orderId	String	Platform Order Number(choise one of three)
externalTradeNo	String	Third party merchant order number(choise one of three)
transId	String	Platform transaction number(choise one of three)

HTTP response

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 1244

{
  "code": 0,
  "message": "SUCCESS",
  "data": {
    "orderId": "4020241114092742135894",
    "externalTradeNo": "2312111157",
    "transId":"2020241114104231088436",
    "failedDes": "SUCCESS",
    "failedCode": 0,
    "buyerInfo": {
      "steamTradeUrl": "https:\/\/steamcommunity.com\/tradeoffer\/new\/?partner=122ab37189&token=S9lbaLgD"
    },
    "orderAssetInfo": {
      "orderAssetStatus": 2,
      "orderAssetDesc": "Waiting for Seller to Confirm Shipment",
      "marketHashName": "Souvenir P90 | Desert DDPAT (Field-Tested)",
      "imageUrl": "https:\/\/static.skindeer.com\/market\/e\/c1\/4318_170x128",
      "commodityPaintSeed": 595,
      "commodityPaintIndex": 925,
      "commodityAbrade": "0.1606601029634475700",
      "commodityHaveNameTag": 0,
      "commodityHaveSticker": 1,
      "commodityHaveCharm": 1,
    },
    "orderCreateTime": 1731576462,
    "paySuccessTime": 1731576490,
    "finishOrderTime": 0,
    "sendOfferSuccessTime": 0,
    "tradeOfferId": 0,
    "paymentAmount": "0.02",
    "refundAmount": "0.00",
    "refundFee": "0.00",
    "cancelStatus":0
  }
}

Table 6. Response fields

Path	Type	Description
code	Number	Response code.
message	String	Response message.
data	Object	Actual data.
data.orderId	String	The order id.
ata.transId	String	transaction number
data.externalTradeNo	String	Third party merchant order number.
data.failedDes	String	If the order fails, the reason will be shown here.
data.failedCode	Number	Failed Code
data.orderCreateTime	Number	Order creation time.
data.paySuccessTime	Number	Payment success time
data.finishOrderTime	Number	Order completion time
data.sendOfferSuccessTime	Number	Seller delivery time
data.tradeOfferId	Number	steam offer id, concatenated to the address where steam accepts the offer.https://steamcommunity.com/tradeoffer/{trdadeOfferId}
data.refundAmount	String	Refund amount
data.refundFee	String	Refund handling fee.
data.cancelStatus	Number	Cancellation Status [ 0: The order is proceeding as normal; 1: Cancellation successful; 2: The order is in the process of being cancelled; 3: Order cancellation has failed. ]
data.paymentAmount	String	Pay the price
data.buyerInfo	Object	Buyer steam Information.
data.buyerInfo.steamTradeUrl	String	The recipient’s steam trade link.
data.orderAssetInfo	Object	Order details.
data.orderAssetInfo.orderAssetStatus	Number	[11: Order Confirmation in Progress] [0: Payment is in progress] [1: Transaction Completed] [2: Waiting for Seller to Confirm Shipment] [4: Waiting for Buyer to Confirm Receipt] [5: Refund in Progress] [6: Refund Completed]
data.orderAssetInfo.orderAssetDesc	String	Order status Description
data.orderAssetInfo.marketHashName	String	Item market hash name.
data.orderAssetInfo.imageUrl	String	Item image url.
data.orderAssetInfo.commodityPaintSeed	Number	Commodity Paint Seed
data.orderAssetInfo.commodityPaintIndex	Number	Commodity Paint Index
data.orderAssetInfo.commodityAbrade	String	commodity wear
data.orderAssetInfo.commodityHaveNameTag	Number	Whether there is no label (0 no 1 yes)
data.orderAssetInfo.commodityHaveSticker	Number	Whether there is a print (0 no 1 yes)
data.orderAssetInfo.commodityHaveCharm	Number	Is there a pendant (0 none 1 yes)