По умолчанию выключено. Напишите нам, чтобы включить функцию для вашего мерчант-аккаунта. Дальше настраиваете сами: в кабинете мерчанта, раздел Разработчикам → Лоты, сохраните три 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.
Управление лотами
status лота: 1 в продаже, 2 снят, 3 скрыт (мы перестали видеть предмет на аккаунте; вернётся сам), 4 в сделке, 5 продан.
Цена ниже половины нашей рыночной отклоняется с price_below_market, как у любого P2P-лота.
Ответы
У всех ответов один вид:success равен false, errorCodeStr — код для ветвления, errorMsg — то же словами.