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

Главное

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

Депозиты

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

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

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

Вывод скинов

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

Другое

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

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

Покупка скина и отправка его юзеру.

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

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

method

string

market_buy

partner

string

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

token

string

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

name + game

string + string

Название скина (market hash name) + игра ('cs2', 'dota2', 'rust')

— ИЛИ —

int

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

max_price

float

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

custom_id

string

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

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

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

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",
    "item": {
        "id": "2729",
        "name": "Glock-18 | Bullet Queen (Battle-Scarred)",
        "price": "1591.91",
        "classid": "3770702114",
    },
    "buy_id": 5,
    "offer_status": "creating_trade",
    "balance_debited_sum": 3000
}

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

missing_name_and_id

Отсутствует название скина и ID

name_min_length_3

Минимальная длина названия скина 3 символа

missing_partner_or_token

Отсутствует параметр 'token' или 'partner'

insufficient_funds

Недостаточно средств на балансе проекта

skin_unavailable

Скин недоступен для покупки

skins_not_found_at_specified_price

Нет скинов стоимость которых <= 'max_price'

custom_id_already_exists

'custom_id' уже существует в нашей системе

invalid_partner_value

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

invalid_token_value

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

too_many_failed_attempts_for_user

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

custom_id_already_processing

Другой запрос с таким же 'custom_id' в данный момент обрабатывается. Пожалуйста, подождите и попробуйте снова

-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