Selling Guide

Update Notes

2026-08-03 Added Testing Recommendations and Notify CS2DT of Order Status Changes
2025-11-24 Initial release

Prerequisites

Before using the selling APIs:

Create a CS2DT merchant account.

Obtain your app-key from Merchant Center → API Management.
All CS2DT API endpoints require an app-key query parameter. Example:
GET https://openapi.cs2dt.com/v2/user/v1/t-coin/balance?app-key=appkey-example

Configure the required seller endpoints in the Merchant Center.
企业微信截图_5957dc1c-692e-48ad-8f2f-860b8aa7be6a.png

Order Create URL: CS2DT calls this endpoint when a user purchases one of your listings.
Order Details URL: CS2DT calls this endpoint to retrieve the latest status of an order.

Testing Recommendations

When testing the selling process, please list low-priced items. This minimizes disruption to the service and reduces the potential impact if a test order fails or behaves unexpectedly. You can also price your item below the market to sell it faster for quick testing.
Your can coordinate testing with your CS2DT account manager.

Manage Your Listings

Use the following endpoints to manage items listed for sale:


Endpoint	Purpose
List for sale	List one or more items for sale.
Sell listing update	Update an active sell listing, such as changing its price.
Cancel sell listings	Remove active listings from sale.
Sell listing details	Check whether a listing is still active and retrieve its current information.

Order Creation

When a user purchases one of your listings, CS2DT sends a request to the Order Create URL configured in the Merchant Center.

Request example

{
"requestId": "our buy request id",
"productId": "your sell productId",
"payPrice": "our payPrice",
"tradeUrl": "our buyer's tradeUrl",
"sign":"xxx"
}

For instructions on signing, please refer to Webhook Notifications.

For example:

MD5(payPrice=3.47&productId=456&requestId=123&tradeUrl=https://steamcommunity.com/tradeoffer/new/?partner=123331190&token=ABCDEFGH&sign={your own appSecret})

Required response

Your endpoint must return a response in the following format:

{
// 1-success 2-fail
"status": 1,
"orderId": "20250112_14673283468273468",
"errorMsg": ""
}

Order Status Query

After creating an order, CS2DT may call the Order Details URL configured in the Merchant Center to retrieve its latest status.

Example configured URL:

https://www.example.com/order/query

Request example:

{
    "requestId": "our buy request id"
}

Where requestId is the unique ID assigned to the purchase request by CS2DT.

Your response:

{
    "requestId": "our buy request id",
    // -1=Order does not exist  1-wait delivery 2-delivering 3-wait receive 10-accepted 11-cancel 200-settled 220-reversed
    "orderStatus":  1,
    // if order status = 220,need data 1-seller 2-buyer
    "reversedType":  1,
     //Steam's official offer status
    "tradeOfferStatus": 2,
    "tradeOfferId":879817398
}

Notify CS2DT of Order Status Changes

To ensure correct sell workflow it's cruital to syncronize order status with us every time it changes. For example, when buyer accept the order, status should be updated form 3 to 10, and you need to send a new status notification with orderStatus set to 10.
You can use the update order status endpoint to synchronize an order’s latest status with CS2DT.

Request example:

{
    "requestId": "our buy request id",
    // 1-wait delivery 2-delivering 3-wait receive 10-accepted 11-cancel 200-settled 220-reversed
    "orderStatus":  1,
    // if order status = 220,need data 1-seller 2-buyer
    "reversedType":  1,
    //Steam's official offer status
    "tradeOfferStatus": 2,
    "tradeOfferId":879817398
}

Update Notes#

Prerequisites#

Testing Recommendations#

Manage Your Listings#

Order Creation#

Request example#

Required response#

Order Status Query#

Example configured URL:#

Request example:#

Your response:#

Notify CS2DT of Order Status Changes#

Request example:#

Update Notes

Prerequisites

Testing Recommendations

Manage Your Listings

Order Creation

Request example

Required response

Order Status Query

Example configured URL:

Request example:

Your response:

Notify CS2DT of Order Status Changes

Request example: