Статус покупки скина

Главное

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

Депозиты

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

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

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

Вывод скинов

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

Другое

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

Статус покупки скина

Информация по приобретенному скину. Метод позволяет узнать Steam Trade Offer ID, а также проверить, принят ли предмет пользователем (или он был отклонен).

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

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

method

string

market_getinfo

buy_id

int

'buy_id' покупки (из метода market_buy)

— ИЛИ —

custom_ids

array

массив из 'custom_id' из вашей системы. Если указан этот параметр, то в ответе будет массив items, содержащий информацию по каждой покупке

— ИЛИ —

buy_ids

array

массив из 'buy_id' покупок. Если указан этот параметр, то в ответе будет массив items, содержащий информацию по каждой покупке

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

В случае успеха, в ответе от сервера будет объект 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)

in_hold

bool

Скин в холде или нет

in_hold_until

string (datetime)

Дата, до которой скин будет в холде (может быть сделан роллбэк)

error_reason

string

Причина (если присутствует):
1. 'user_cant_trade' - у пользователя есть ограничение на торговлю в Steam
2. 'private_inventory' - пользователю необходимо открыть инвентарь
3. 'user_trade_ban' - у пользователя Trade Ban
4. 'user_inventory_is_full' - инвентарь пользователя полный
5. 'too_many_failed_attempts' - слишком много неудачных попыток вывода для пользователя
6. 'skin_unavailable' - скин недоступен для покупки (или уже продан)

steamid

string

Steam ID пользователя

date

int

Дата покупки (UNIX время)

balance_debited_sum

float

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

tradeofferid

string

Trade Offer ID в Steam (есть только если обмен был создан)

custom_id

string

'custom_id' в вашей системе

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

{
    "status": "success",
    "item": {
        "id": "1280",
        "name": "Taunt: RazorFlip!",
        "price": "0.16",
        "classid": "1723112726"
    },
    "buy_id": "9",
    "offer_status": "trade_create_error",
    "error_reason": null,
    "steamid": "76561198050648523",
    "date": "1596999226",
    "balance_debited_sum": "11.73"
}

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

missing_one_of_required_params

Отсутствует входящий параметр (buy_id, buy_ids, или же custom_ids)

offer_not_found

Покупка не найдена

-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