Selling Guide

Update Notes

2026-10-14 Added Order Cancellation Request
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.

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.

If you sell on multiple platforms or resell items from other sellers, please pay close attention to your pricing. Our system automatically compares prices for identical items across all sellers. Only the lowest-priced listing will be displayed.

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.
Important: Money settlement will not be processed unless you send us a orderStatus 200 after the trade protection period has ended.
Settlements are processed once per day.

Request example:

{
    "requestId": "our buy request id",
    // 1-wait delivery 2-delivering 3-wait receive 10-accepted 11-cancel 200-trade protectionis over, no reverse 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
}

Order Cancellation Request

We may request an order cancellation due to the long shipping time. In that case, we will send you the following request.

Configured URL example:

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

Request example:

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

Your response:

{
    "message": "",//If the cancellation fails, you can return the reason for the failure, etc.
    "cancelSuccess":  true,//true-Cancellation successful, false-Cancellation failed
}

This result is for reference only; we will send another request to the order query API (Order Details URL) to confirm the order status.

You must ensure that the Steam trade offer has not been sent or has been cancelled, to ensure that no losses are incurred.

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:#

Order Cancellation Request#

Configured URL example:#

Request example:#

Your response:#

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:

Order Cancellation Request

Configured URL example:

Request example:

Your response: