Массовая покупка скинов и отправка юзеру

Главное

Основная информация Генерация подписи

Депозиты

Начало работы Создание депозита Создание депозита без переадресации (iframe) Уведомление о депозите (webhook) Проверка статуса депозита Получение списка депозитов Депозиты без 8 дневного ожидания (Steam Trade Protection) Одобрение депозита с 8 дневным холдом Недошедшие уведомления о платежах

Депозиты без SkinsBack UI

Создание депозита без SkinsBack UI (API) Получить инвентарь пользователя

Вывод скинов

Прайс-лист (наличие скинов) Поиск скинов Купить скин Массовая покупка скинов Статус покупки скина История покупок скинов

Другое

Баланс проекта История выводов с баланса и депозитов Валюты и курсы Статус сервера Real-time обновления: WebSockets Real-time обновления: WebHooks

Массовая покупка скинов и отправка юзеру

Массовая покупка скинов и отправка их юзеру.

Синим выделены обязательные параметры.

Отправьте POST запрос на API Endpoint со следующими параметрами:

method

string

market_batch_buy

partner

string

Значение 'partner' из Trade URL пользователя

token

string

Значение 'token' из Trade URL пользователя

items

array

Массив из элементов для покупки скинов

items[][id]

int

ID скина из прайс листа или поиска

items[][max_price]

float

Максимальная стоимость скина для покупки (в USD). Используется как ограничитель стоимости

items[][custom_id]

string

ID в вашей системе. Используется для предотвращения двойной покупки

Ответ от сервера:

В случае успеха, в ответе от сервера будет объект JSON, со следующим содержанием:

purchased

array

Массив, содержащий список купленных скинов, описание ниже

unavailable

array

Массив, содержащий список идентификаторов недоступных скинов и причины:
- insufficient_funds (error_code: 4) — Недостаточно средств на балансе проекта
- skin_unavailable (error_code: 5) — Скин недоступен для покупки
- skins_not_found_at_specified_price (error_code: 6) — Нет скинов стоимость которых <= 'max_price'
- custom_id_already_exists: (error_code: 7) — 'custom_id' уже существует в нашей системе

Массив 'purchased'

item

object

Объект, содержащий информацию о купленном скине

— item.id

int

Skin ID

— item.name

string

Название скина

— item.price

float

Цена скина в USD

— item.classid

string

Class ID скина

buy_id

int

ID покупки, требуется в дальнейшем для проверки статуса передачи вещи

offer_status

string

Статус покупки:
1. 'creating_trade' — обмен создается
2. 'waiting_accept' — обмен ожидает принятия
3. 'accepted' — обмен принят
4. 'canceled' — обмен отклонен юзером
5. 'timeout' — обмен не принят за 10 минут
6. 'invalid_trade_token' — неверный trade token
7. 'user_not_tradable' — пользователь имеет ограничения в системе обмена
8. 'trade_create_error' — ошибка создания обмена (попробуйте еще раз)
9. 'rollback_user' — скин возвращен обратно пользователем (Steam Trade Protection)
10. 'rollback_supplier' — скин возвращен обратно поставщиком (Steam Trade Protection)

Этот метод может содержать только create_trade. Остальные статусы в методах market_getinfo / market_history.

balance_debited_sum

float

Сумма, списаная с баланса проекта (USD)

Пример успешного ответа:

{
   "status":"success",
   "purchased":{
      "62696971":{
         "item":{
            "id":"62696971",
            "name":"'The Doctor' Romanov | Sabre",
            "price":8.28,
            "classid":"3608084106",
            "instanceid":"0"
         },
         "buy_id":129112705,
         "offer_status":"creating_trade",
         "steamid":"76561198050648523",
         "date":"1748862060",
         "balance_debited_sum":8.28,
         "custom_id":"10000"
      },
      "62697425":{
         "item":{
            "id":"62697425",
            "name":"'The Doctor' Romanov | Sabre",
            "price":8.03,
            "classid":"3608084106",
            "instanceid":"0"
         },
         "buy_id":129112706,
         "offer_status":"creating_trade",
         "steamid":"76561198050648523",
         "date":"1748862060",
         "balance_debited_sum":8.03,
         "custom_id":"10001"
      }
   },
    "unavailable":{
      "62696979":{
         "error_code":5,
         "error_message":"skin_unavailable"
      },
      "62697480":{
         "error_code":5,
         "error_message":"skin_unavailable"
      }
   }
}

Список возможных ошибок:

invalid_partner_value

Неверное значение 'partner'

invalid_token_value

Неверное значение 'token'. Запросите новый Trade URL у пользователя

too_many_failed_attempts_for_user

Слишком много неудачных при отправке скинов пользователю (неверный Trade URL, пользователь не принимает скины в заданное время, пользователь не имеет возможности обмениваться скинами). Попробуйте позже

-6

market_disabled

Маркет выключен

стандартные ошибки:

-1

please_use_post_method

Необходимо использовать POST метод

-2

invalid_shopid

ID проекта не найден в системе

-3

invalid_signature

Неверно сформирована подпись

-4

shop_not_active

Проект неактивен

-5

invalid_method

Неверный API метод

-7

request_limit_reached

Превышен лимит запросов (500/в минуту)

-8

invalid_ip_address

Укажите IP адрес в настройках проекта

-9

under_maintenance

Сайт на обслуживании

-10

invalid_client_secret

Неверный передан заголовок X-CLIENT-SECRET