Перейти к основному содержанию
Лоты мерчанта нужны продавцу, у которого предметы лежат на нескольких Steam-аккаунтах и есть свой софт для отправки трейдов. Вы присылаете нам лоты; мы выставляем их на P2P-маркет CSBoard; когда лот покупают, мы вызываем ваш сервер; вы отправляете оффер в Steam и сообщаете, что с ним стало. Steam-аккаунты к CSBoard не подключаются: мы не просим ни логин, ни API-ключ ваших аккаунтов. В каждом лоте указывается трейд-ссылка аккаунта, на котором он лежит: через неё наши боты видят аккаунт.
По умолчанию выключено. Напишите нам, чтобы включить функцию для вашего мерчант-аккаунта. Дальше настраиваете сами: в кабинете мерчанта, раздел Разработчикам → Лоты, сохраните три URL из раздела ниже. При первом сохранении один раз показывается ваш app secret; кнопка Новый секрет заменяет потерянный, старый перестаёт работать сразу.

Цифры

Принимаются только предметы, доступные к обмену прямо сейчас (assetType: 1).

Три URL на вашей стороне

Все три вызова: POST с JSON в теле. На ответ Order Create у вас 5 секунд (3 секунды, если покупатель пришёл с партнёрской площадки). Нет ответа вовремя = покупка не состоится. Поэтому предмет, выставленный на нескольких площадках, не продастся дважды: перед каждой продажей мы спрашиваем вас.

Проверка наших вызовов

В каждом теле есть sign: возьмите остальные поля, отсортируйте по имени, соедините как имя=значение через &, добавьте &sign=<ваш app secret>, посчитайте MD5 в верхнем регистре. Значение null записывается строкой null.
То же тело подписано и в заголовке X-CSBoard-Signature (t=<unix>,v1=<hex>, HMAC-SHA256 от <t>.<тело> с тем же секретом), как наши вебхуки.

Как проходит продажа

1

Выставьте лоты

productId — ваш собственный номер лота. tradeUrl — трейд-ссылка того же аккаунта, что и steamId; присылайте актуальную с каждым лотом, мы храним последнюю. delivery: 1, если оффер отправляете вручную, 2, если ваш бот отправляет его сразу после нашего вызова заказа: такой лот покупатели видят как мгновенный, на отправку 10 минут. До 100 лотов за вызов. Лот, который мы не можем принять, вернётся в errorData.failList с причиной; остальные приняты.Лот ещё не в продаже. Сначала мы сами читаем публичный инвентарь Steam-аккаунта и выставляем лот, когда увидели в нём предмет. Следите через GET /p2p/sell/detail/{productId}: operationStatus идёт от 100 (выставляется) к 101 (выставлен) или 102 (отказ, причина в failedCode).
2

Примите заказ

Мы вызываем ваш Order Create URL: requestId (наш номер продажи, используйте его во всех статусах), ваш productId, payPrice и tradeUrl покупателя. Ответьте status: 1 и отправьте оффер в Steam на эту трейд-ссылку.
3

Сообщайте каждый статус

Один вызов на каждую смену статуса. Повтор безопасен.tradeOfferId — это tradeofferid самого Steam у оффера, который вы отправили по этому заказу. Он обязателен со статусами 2, 3 и 10, если вы его ещё не передавали; у одного заказа один оффер, и по этому номеру мы находим оффер в Steam.
4

Получите выплату

GET /p2p/sell/order/list показывает каждую продажу: наш orderStatus, нашу комиссию fee и settleTime, момент выплаты на баланс.

Статусы заказа

tradeOfferStatus — это ETradeOfferState самого Steam. Что мы делаем со статусом:
  • 10 принимается, как любой статус, а дальше мы проверяем его сами: названный вами оффер читаем в Steam по его tradeOfferId со стороны покупателя, а если так не получается, смотрим, что предмет ушёл с аккаунта продавца (публичный инвентарь и трейд-окно по tradeUrl лота). Пока мы этого не увидели, в ответе data равно checking, а в GET /p2p/sell/order/list заказ остаётся в статусе 3. Повторять статус не нужно: мы сами смотрим снова раз в несколько минут.
  • 11 после отправленного оффера не закрывает продажу только по вашему слову: сначала мы ищем предмет обратно в инвентаре продавца.
  • 220 с reversedType: 2 ставит продажу на ручную проверку. Выплаты по нему нет.

Refresh-токен Steam

Добавьте refreshToken к статусу, чтобы мы прочитали эту одну сделку в Steam:
  • Это должен быть мобильный refresh-токен того Steam-аккаунта, который отправил оффер.
  • Мы используем его для одного чтения и забываем. Он не хранится, не попадает в логи, и мы не просим Steam его обновить, так что ваша копия остаётся рабочей.
  • Со статусом 10 мы проверяем, что в оффере проданный предмет и что его принял покупатель этой продажи. Со статусом 200, отправленным после окончания защиты Steam, читаем сделку: завершена — продажа выплачивается сразу; откатили — оформляется реверс.
  • В ответе поле tokenRead говорит, что показало чтение: accepted, complete, reversed, not_final (рано, пришлите 200 позже), mismatch (токен другого аккаунта, либо оффер или сделка, в которых предмет этой продажи не ушёл её покупателю), token_refused, unreadable.
Токен необязателен. Без него продажа выплачивается на 14-й день. Держите инвентарь аккаунта-продавца открытым до выплаты. На 14-й день мы смотрим в него ещё раз; если прочитать не удалось, выплата ждёт, и мы повторяем раз в час.

Управление лотами

status лота: 1 в продаже, 2 снят, 3 скрыт (мы перестали видеть предмет на аккаунте; вернётся сам), 4 в сделке, 5 продан. Цена ниже половины нашей рыночной отклоняется с price_below_market, как у любого P2P-лота.

Ответы

У всех ответов один вид:
При отказе success равен false, errorCodeStr — код для ветвления, errorMsg — то же словами.