ECOSteam
    • ECO开放平台接入流程
    • RSA公私钥生成、签名
    • 通用请求参数与响应
    • 订单状态处理流程说明
    • 回调通知服务
    • WebSocket监听商品变动消息
    • 服务商入驻流程
    • 商户
      • 获取用户钱包金额
        POST
      • 获取资金流水
        POST
      • 求购账户转入转出
        POST
      • 查询已绑定steam账号列表
        POST
      • 验证交易链接
        POST
      • 获取steamID
        POST
    • 市场
      • 获取steam市场名称和在售价格(推荐)
        POST
      • 品类查询(不推荐)
        POST
      • 在售/预售商品列表
        POST
      • 批量查询在售商品价格
        POST
      • 批量获取商品详情
        POST
      • 批量查询在售商品状态
        POST
      • 获取检视图
        POST
    • 购买
      • 指定商品购买
        POST
      • 指定类别购买
        POST
      • 购买预售商品
        POST
      • P2P购买订单
        POST
    • 订单
      • 历史订单查询
        POST
      • 查询订单状态
        POST
      • 查询购买订单列表
        POST
      • 查询订单详情
        POST
      • 查询报价信息
        POST
      • 处罚订单查询
        POST
      • 买家取消订单
        POST
      • 举报卖家撤回报价
        POST
      • 买家确认订单交易成功
        POST
      • 查询出售订单列表
        POST
      • 卖家订单发送报价
        POST
      • 用户接受报价
        POST
      • 用户一键处理报价
        POST
      • 卖家查询订单状态
        POST
      • 卖家查询订单详情
        POST
      • 卖家查询报价对应订单
        POST
      • 预售订单交易链接修改
        POST
    • 出售
      • 刷新用户Steam库存
      • 查询Steam库存
      • 出售商品列表
      • 上架库存
      • 批量改价
      • 预售商品上架/改价
      • 下架在售/预售商品
      • 用户店铺状态设置
    • 求购
      • 发布求购信息
      • 编辑求购信息
      • 终止求购信息
      • 批量暂停/开启/删除求购信息
      • 批量更新求购收货链接
      • 获取我的求购分页列表
      • 秒出货库存查询
      • 秒出货求购供应
      • Steam库存查询
      • 创建交易存款
      • 创建交易报价
    • 出租
      • 可租可售上架/可租可售改价
      • 下架出租商品
      • 查询自己出租的商品
      • 查询出租订单列表
      • 卖家查询出租订单详情
    • 汰换合炉
      • 创建合炉
      • 我的合炉列表
      • 合炉支付
    • 其他
      • 解封超时未收货用户
      • 获取交易汇率
    • 服务商
      • 获取服务商绑定的用户集合

    回调通知服务

    回调通知服务用于接入方在购买或出售时，若订单状态发生变化会通过主动配置的回调接口或websocket消息对用户发送事件通知。
    通知场景包括：1.等待发货 2.等待收货 3.购买成功 4.订单取消 5.交易保护
    目前支持HTTP和WebSocket两种方式接收回调通知。

    HTTP方式说明：#

    URL：用户设置的回调地址
    Method：POST
    通信协议：HTTPS/HTTP

    回调地址设置#

    1.
    申请开通开放能力，审核通过后可设置回调地址；注意：回调地址域名必须以http：或https：开头；
    2.
    已成功申请通过开放能力用户可在查看身份ID页面点击设置回调通知功能进入回调通知设置页面；
    3.
    填写回调地址后点击保存，开放平台服务器将发送GET请求到填写的服务器地址URL上，收到开放平台的Get请求后，需要返回result参数内容，result内容为用户身份ID MD5后小写的值如下。响应content-type格式为application/json。返回指定内容验证通过后生效，否则接入失败。
    {
    "result":"2b15b258641b3701b54a0fa634e6dd94"
}
    4.
    打开设置内的回调开关即可接收回调通知。订单状态发生变化后开放平台服务器将发送Post请求到填写的服务器地址URL上。设置页面内可获取到ECO回调公钥，为了防止伪造请求建议收到通知后使用ECO回调公钥做签名验证。
    5.
    若回调请求响应的结果非success，ECO平台会向你的服务器不断重发通知，最多7次。首次是即时推送，重试通知时间间隔为 10s、30s、2min、5min、10min、30min、1h，直到你正确回复success或者超过最大重发次数，ECO平台将不再发送。正确响应示例如下：注意响应结构大小写敏感，需完全一致
    {
  "Status":"success",
  "ErrorMsg":""
}

    Headers：#

    参数名称参数值是否必须示例备注
    Content-Typeapplication/json是application/json

    WebSocket方式说明：#

    1.
    联系客服开通webscoket回调能力
    2.
    参考WebSocket监听商品变动消息说明，建立WebSocket长连接后保持消息监听等待，不需要加入聊天组。
    3.
    订单状态有变化时会收到对应的推送消息，消息结构如下：
    {
	"PartnerId": "xxxxxxxxxxxxx",
	"Content": "{\"CallBackInfo\":\"{\\\"OrderNum\\\":\\\"2025011111993203040731137\\\",\\\"GoodsNum\\\":\\\"2025011111993203040731137\\\",\\\"MerchantNo\\\":\\\"\\\",\\\"OrderState\\\":\\\"订单交易取消\\\",\\\"CurrentReasons\\\":\\\"报价被拒绝,系统自动取消\\\",\\\"FinishTime\\\":\\\"2025-03-26 14:21:42\\\",\\\"OrderStateCode\\\":3,\\\"SendOfferRole\\\":2,\\\"OfferID\\\":\\\"123456\\\"}\",\"MessageNo\":\"5a0359e15bf4444e8eed87fc7e86ebc0\"}",
	"GroupId": "",
	"MessageType": 1
}
    其中MessageType=1代表本条消息类型是订单状态通知，其余信息内容与HTTP方式收到的相同。Content是回调信息字符串形式，需要反序列化。WebSocket内的消息不需要验签，也不需要返回success。
    请注意连接断开期间的消息不会再次推送。建议通过开放平台订单查询接口作为辅助补偿措施。

    Body：#

    参数名称数据类型是否必须备注
    MessageNoString是消息幂等编号。
    CallBackInfoString是回调信息字符串形式，需要反序列化。
    详细说明参照：CallBackInfo-JSON解释
    SignString是API输入参数签名结果。

    CallBackInfo-JSON解释：#

    参数名称数据类型备注
    OrderNumString订单号
    GoodsNumString商品编号
    MerchantNoString商户订单号
    OrderStateString订单状态描述
    OrderStateCodeInt订单状态枚举数值：等待发货=1 等待对方确认=2 交易取消=3 交易成功=6 交易暂挂=9 交易保护=30
    SendOfferRoleInt发报价用户角色 1买家 2卖家
    OfferIDString报价ID
    CurrentReasonsString订单状态对应原因说明
    FinishTimeString订单结束时间

    请求示例：#

    {
  "CallBackInfo": "{\"OrderNum\":\"202301110278660107943936\",\"GoodsNum\":\"202301110278660107943936\",\"MerchantNo\":\"\",\"OrderState\":\"等待发货\",\"CurrentReasons\":\"\",\"FinishTime\":\"\",\"SendOfferRole\":2,\"OfferID\":\"123456\"}",
  "MessageNo": "1da667bcbc3c45c0b07228e86aaa7e40",
  "Sign": "k69bpTSu3DukNCZq8er7Sro6oPuQa3w+Qgx2wirMEjURuIvcBD1/vjlxvH0DdneEpjBDNPkU5y9DXOlo9WuHI4+UAjCErhlUz0Tk6HPGsDScr9VL9lx2qdhklAddN5Vqo4un78DeCxfIYsXdkb27ePwXczon16i0fb6/YVb6UgHs5UEWPam+cBBZ1vRUXnc7OyTMYter/IRjKMBaEzreFI27LpdxFCRf+o/4upBiyiKm4+hXaT/CxW3xJa1URvHqUzY5cjUjCyuSw6IJEWNBHX8qRXQDPtlb3OHIb7QL0x1fvtUZI2r+Y2S5Z34ddoH/2cK7/MDrggZ0NQ+fJUdtpg=="
}

    JAVA验签示例#

    c#验签示例#

    被调用接口返回内容：#

    参数名称数据类型是否必须备注
    StatusString是success:成功。未响应成功会定时重试，超过最大次数不再重试。
    ErrorMsgString否状态描述。

    返回内容示例：#

    {
  "Status":"success",
  "ErrorMsg":""
}
    修改于 2026-03-30 09:40:02
    上一页
    订单状态处理流程说明
    下一页
    WebSocket监听商品变动消息
    Built with