Перед началом
Правила для продавца с сайта действуют в API без изменений:- подтверждённый email или привязанный Telegram, чтобы мы могли сообщить вам о продаже;
- запущенное расширение или приложение CSBoard, способное отправить трейд в Steam, и Steam Mobile Authenticator на аккаунте;
- на аккаунте нет P2P-cooldown, приостановки или блокировки магазина.
403 contact_required или 400 no_capable_client.
Как это работает
1
Прочитайте инвентарь
listable: true можно опубликовать сразу; у остальных причина указана в reasons. Если inventory_proof.status равен pending, мы только что начали читать ваш инвентарь Steam — повторите запрос через retry_after_ms.2
Выставьте по своей цене
operational_asset_id и asset_revision из инвентаря без изменений, а price_usd — в целых центах. За раз можно отправить до 50 предметов в виде { "items": [...] }. Idempotency-Key обязателен: если соединение оборвалось, повторите тот же запрос с тем же ключом — ничего не будет выставлено дважды.3
Управляйте листингами
GET /v1/p2p/listings показывает, что выставлено и что уже продаётся, с seller_payout_usd для каждого листинга. Пока листинг в статусе active, цену можно изменить через PATCH /v1/p2p/listings/{id}, а сам листинг — снять через DELETE /v1/p2p/listings/{id}.4
Отправьте предмет после продажи
Когда покупатель оплачивает, листинг переходит в
trade_pending, и мы сообщаем вам об этом по email или в Telegram. Предмет ещё должен уйти из вашего инвентаря Steam: расширение или приложение CSBoard готовит трейд-оффер покупателю, а вы подтверждаете его через Steam Guard в мобильном приложении Steam. Не тяните — продажи без ответа блокируют ваш магазин (shop_locked).5
Получите выплату
Когда покупатель примет трейд, листинг переходит в
verification_hold на время защиты трейда в Steam. Когда она закончится и трейд останется в силе, seller_payout_usd зачисляется на ваш баланс CSBoard.Правила цены
- Цены указываются в USD, от
0.10до100000, в целых центах.12.345отклоняется, а не округляется. - Цена ниже половины нашей рыночной цены на предмет отклоняется с
422 price_below_market. В теле естьmarket_usdиfloor_usd, так что скрипт может сам поправить цену. На сайте продавец может подтвердить более низкую цену после предупреждения; через API-ключ такого подтверждения нет, поэтому утёкшим ключом нельзя слить ваш инвентарь за бесценок. - Наша комиссия указана в каждом листинге как
commission_usd;seller_payout_usd— то, что получаете вы.