CS2DT饰品开放平台
🇨🇳简体中文
  • 🇨🇳简体中文
  • 🇺🇸 English
首页商户中心
首页商户中心
🇨🇳简体中文
  • 🇨🇳简体中文
  • 🇺🇸 English
  1. 订单相关接口
  • CS2DT开放平台接入指南
  • v1
    • 用户相关接口
      • 用户余额查询
      • 创建Steam账号状态检测
      • 查询Steam账号状态
    • 市场商品相关接口
      • CS2款式数据
      • 根据商品id批量查询出售中的商品
      • 获取全量在售文件
      • 市场搜索
      • 饰品价格查询
      • 获取市场所有的筛选条件
      • 获取某一个饰品的所有在售
      • 获取商品的在售状态
      • 获取某个商品的在售详情
    • 购买功能接口
      • 普通购买v2
      • 快速购买接口v2
    • 订单相关接口
      • 购买订单列表接口
        GET
      • 购买订单详情
        GET
      • 买家取消订单接口
        POST
    • 回调通知说明
      • 回调通知服务说明
    • 汇率转换
      • 获取usd-cny汇率
    • 市场推送
      • websocket服务说明
      • 获取wss地址
  1. 订单相关接口

购买订单详情

GET
https://openapi.cs2dt.com/v1/order/v2/buy/detail
买家订单详情接口
errorCode说明:
140015 该商户订单号购买失败,没有产生相应的订单号
订单原因 failedCode 字段说明
ORDER_FAILED_OF_AUTO_DELIVER_ORDER_CANCEL_OF_BUYER_NOT_ACCEPT("自动发货,买家超时不收货, 系统取消"),
ORDER_FAILED_OF_MANUAL_DELIVER_ORDER_CANCEL_OF_SELLER_CANCEL("人工发货,买家收货太慢,卖家手动取消"),
ORDER_FAILED_OF_MANUAL_DELIVER_ORDER_CANCEL_OF_BUYER_NOT_ACCEPT("人工发货,买家超时不收货, 系统取消"),
ORDER_FAILED_OF_BUYER_DECLINE("买家拒绝收货,拒绝了报价"),
ORDER_FAILED_OF_BUYER_COUNTERED("买家发起还价"),
ORDER_FAILED_OF_SELLER_CANCEL("卖家私下取消"),
ORDER_FAILED_OF_INVALID_ITEMS("无效饰品"),
ORDER_FAILED_OF_ADMIN_CANCEL("管理员取消"),
ORDER_FAILED_OF_OFFER_EXPIRED("报价过期"),
ORDER_FAILED_OF_SELLER_DELIVER_TOO_SLOW_CHANNEL_BUYER_CANCEL("卖家发货太慢,买家不想等取消"),
ORDER_FAILED_OF_CHANNEL_BUYER_CANCEL("买家主动取消"),
ORDER_CHANNEL_BUYER_CANCEL_PAY("买家放弃支付,订单取消"),
ORDER_ASSET_NOT_IN_INVENTORY_CANCEL("部分东西不在库存"),
ORDER_FAILED_OF_SELLER_ACTIVE_CANCEL("卖家主动取消"),
ORDER_FAILED_OF_FRAUD_CANCEL("疑似诈骗,系统取消报价"),
ORDER_PURCHASE_CHECK_FAILED("购买检查失败"),
ORDER_DELIVER_FAILED_OF_RECEIVER_INVENTORY_PRIVACY("买家库存隐私"),
ORDER_DELIVER_FAILED_OF_RECEIVER_TRADE_DISABLE("买家无法交易"),
ORDER_DELIVER_FAILED_OF_RECEIVER_TRADE_URL_NOT_VALID("买家交易链接无效"),
ORDER_DELIVER_FAILED_OF_RECEIVER_TRADE_BAN("买家交易被封禁"),
ORDER_DELIVER_FAILED_OF_RECEIVER_TRADE_VAC("买家 vac"),
ORDER_DELIVER_FAILED_OF_RECEIVER_BLOCK_SENDER("买家屏蔽了卖家"),
ORDER_DELIVER_FAILED_OF_RECEIVER_INVENTORY_SLOT_FULL("买家库存满"),
ORDER_DELIVER_FAILED_OF_RECEIVER_TRADE_GAME_DEVELOPER_BAN("买家被游戏开发者封禁"),
ORDER_DELIVER_FAILED_OF_SENDER_FAMILY_VIEW_ENABLED("卖家开起了家庭监护"),
ORDER_DELIVER_FAILED_OF_SENDER_TRADE_BAN("卖家交易被 ban"),
ORDER_DELIVER_FAILED_OF_SENDER_TRADE_DISABLE("卖家无法交易"),
ORDER_DELIVER_FAILED_OF_SENDER_BLOCK_RECEIVER("卖家屏蔽了买家"),
ORDER_DELIVER_FAILED_OF_SENDER_LOGIN_INVALID("卖家登录信息失效"),
ORDER_DELIVER_FAILED_OF_SENDER_CANNOT_GEN_APIKEY("卖家 apikey 失效,并且也无法生成 apiKey"),
ORDER_DELIVER_FAILED_OF_SENDER_TRADE_IN_ESCROW("卖家交易暂挂期"),
ORDER_DELIVER_FAILED_OF_SENDER_BETWEEN_RECEIVER_TOO_MANY_OFFERS("买家和卖家两个 steam 账号之间超过了 5 个交易报价"),
ORDER_DELIVER_FAILED_OF_SENDER_TOO_MANY_ACTIVE_OFFERS("卖家 steam 活跃报价超过了 30 个"),
ORDER_DELIVER_FAILED_OF_SENDER_TRADE_VAC("卖家 vac"),
ORDER_DELIVER_FAILED_OF_SENDER_TRADE_GAME_DEVELOPER_BAN("卖家游戏被开发者封禁"),
ORDER_DELIVER_FAILED_OF_SENDER_CONFIRM_OFFER_TIME_OUT("卖家确认超时-30分钟"),
ORDER_DELIVER_FAILED_OF_SEND_ITEMS_NOT_EXISTS("卖家发货的部分东西不在库存"),
ORDER_DELIVER_FAILED_OF_SEND_ITEMS_DISABLE_TRADE("买家发货部分东西无法交易"),
ORDER_DELIVER_FAILED_OF_SENDER_ASSISTANT_GUARD_ERROR("卖家交易助手令牌找回"),
ORDER_BUYER_PAID_FAILED("买家支付失败,订单取消"),
ORDER_BUYER_PAID_TIME_OUT("买家支付超时,系统取消"),
ORDER_BUYER_CANCEL_PAY("买家放弃支付,订单取消"),
ORDER_FAILED_OF_SELLER_DELIVER_TOO_SLOW("卖家发货太慢,买家不想等取消"),
ORDER_FAILED_OF_SELLER_DELIVER_TIMEOUT("卖家发货超时,系统取消"),
ORDER_DELIVER_FAILED_OF_STEAM_SERVER_ERROR("steam 服务异常"),
ORDER_DELIVER_FAILED_OF_UNKNOWN_ERROR("发送报价失败,未知原因,需要进一步分析"),

请求参数

Query 参数
orderId
integer 
可选
购买相关接口返回的orderId, 订单记录接口中的订单orderAssetId
outTradeNo
string 
可选
商户订单号, 与orderId 二选一传入即可,如果两个都传,那么已orderId为主
app-key
string 
可选
默认值:
{{app-key}}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location -g --request GET 'https://openapi.cs2dt.com/v1/order/v2/buy/detail?orderId&outTradeNo&app-key='

返回响应

🟢200成功
application/json
Body
WebApiRes<OrderDetailDTO>
success
boolean  | null 
可选
Is request successful
data
object 
可选
Business data
orderId
string  | null 
订单id
可选
productId
string  | null 
可选
该笔订单中的商品在售id
price
number  | null 
该笔订单的金额
可选
buyerFee
number  | null 
可选
该笔订单的买家手续费
statusName
string  | null 
订单状态名称
可选
status
integer  | null 
可选
订单状态值 1 等待发货 3 等待收货 10 订单成功 11 订单失败
deliverType
integer  | null 
可选
发货类型 1是人工发货,2是自动发货
receiveSteamId
string  | null 
可选
该笔订单中收货的steamId
openItemInfo
object (OpenItemInfo) 
饰品详情
可选
assetInfo
object (ItemAssetInfoVO) 
饰品独特的信息
可选
offerInfoDTO
object 
可选
订单关联的报价信息,当订单状态为3时可以获取到报价信息
failedDesc
string  | null 
可选
如果订单状态为11,那么这里内容为失败的原因
createTime
integer  | null 
可选
订单创建时间,时间戳
failedCode
string 
可选
当订单状态为11时-订单的失败原因
以下错误原因会对买家进行交易罚款
买家交易被封禁
ORDER_DELIVER_FAILED_OF_RECEIVER_TRADE_BAN
买家发起还价
ORDER_FAILED_OF_BUYER_COUNTERED
买家拒绝收货,拒绝了报价
ORDER_FAILED_OF_BUYER_DECLINE
自动发货,买家超时不收货, 系统取消
ORDER_FAILED_OF_AUTO_DELIVER_ORDER_CANCEL_OF_BUYER_NOT_ACCEPT
人工发货,买家超时不收货, 系统取消
ORDER_FAILED_OF_MANUAL_DELIVER_ORDER_CANCEL_OF_BUYER_NOT_ACCEPT
买家无法交易
ORDER_DELIVER_FAILED_OF_RECEIVER_TRADE_DISABLE
买家被游戏开发者封禁
ORDER_DELIVER_FAILED_OF_RECEIVER_TRADE_GAME_DEVELOPER_BAN
买家 vac
ORDER_DELIVER_FAILED_OF_RECEIVER_TRADE_VAC
买家屏蔽了卖家
ORDER_DELIVER_FAILED_OF_RECEIVER_BLOCK_SENDER
买家库存隐私
ORDER_DELIVER_FAILED_OF_RECEIVER_INVENTORY_PRIVACY
买家库存满
ORDER_DELIVER_FAILED_OF_RECEIVER_INVENTORY_SLOT_FULL
买家交易链接无效
ORDER_DELIVER_FAILED_OF_RECEIVER_TRADE_URL_NOT_VALID
errorCode
integer  | null 
可选
Error code
errorMsg
string  | null 
可选
Error message
errorData
object (Object) 
可选
Error data,when errorCode is not equals to 0,maybe this property will have a value
示例
{
  "success": false,
  "data": {
    "orderId": "",
    "productId": "",
    "price": 0.0,
    "buyerFee": 0.0,
    "statusName": "",
    "status": 0,
    "deliverType": 0,
    "receiveSteamId": "",
    "openItemInfo": {
      "itemId": "",
      "appId": 0,
      "name": "",
      "marketHashName": "",
      "imageUrl": ""
    },
    "assetInfo": {
      "fraudwarning": "",
      "classInfoId": 0,
      "classId": 0,
      "instanceId": 0,
      "assetId": 0,
      "styleId": 0,
      "lastStyle": "",
      "styleProgress": "",
      "wear": 0.0,
      "paintIndex": 0,
      "paintSeed": 0,
      "levelName": "",
      "levelColor": "",
      "gradient": 0.0,
      "fadeColor": "",
      "inspectImageUrl": "",
      "gems": [
        {
          "id": 0,
          "itemId": 0,
          "type": "",
          "gemType": "",
          "gemEnType": "",
          "name": "",
          "enName": "",
          "border": "",
          "image": "",
          "value": 0.0
        }
      ],
      "stickers": [
        {
          "id": 0,
          "type": 0,
          "stickerId": 0,
          "itemId": 0,
          "name": "",
          "enName": "",
          "image": "",
          "slot": 0,
          "wear": 0.0,
          "price": 0.0
        }
      ],
      "styles": [
        {
          "styleId": 0,
          "styleName": "",
          "styleEnName": "",
          "color": "",
          "locked": false
        }
      ],
      "itemSets": [
        {
          "name": "",
          "hashName": "",
          "itemId": 0,
          "price": 0.0,
          "isItemSet": 0,
          "imageUrl": ""
        }
      ],
      "ext": ""
    },
    "offerInfoDTO": {
      "transferId": 0,
      "tradeOfferId": 0
    },
    "failedDesc": "",
    "createTime": 0
  },
  "errorCode": 0,
  "errorMsg": "",
  "errorData": {}
}
修改于 2025-06-09 10:22:55
上一页
购买订单列表接口
下一页
买家取消订单接口
Built with