Отмена покупки скина

Merchant API v2

Overview

Главное

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

Депозиты

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

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

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

Вывод скинов

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

Другое

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

Отмена покупки скина

Метод отправляет запрос на отмену покупки для P2P-скинов, которые находятся в ожидании создания трейда. Запрос на отмену доступен только через 30 минут после создания покупки.

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

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

method

string

market_cancel

custom_ids

array

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

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

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

items

array

Массив из элементов, описанных ниже

unavailable

object

При смешанном запросе этот объект содержит custom_id и ошибку покупок, которые пока нельзя отменить. В error_details.available_at указано время отмены в формате UNIX timestamp.

Объект 'items'

item

object

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

— item.id

int

Skin ID

— item.name

string

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

— item.price

float

Цена скина в USD

— item.delivery_type

int

Тип доставки: 1 = Instant, 2 = Slow

— 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' - скин недоступен для покупки (или уже продан)
7. 'p2p_purchase_canceled_by_user' - P2P-покупка отменена пользователем
8. 'p2p_purchase_canceled_by_system' - P2P-покупка автоматически отменена системой

steamid

string

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

date

int

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

balance_debited_sum

float

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

tradeofferid

string

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

custom_id

string

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

refund_percent @deprecated

int

Процент возврата при роллбэке по вине юзера. Устарело: используйте refund_amount

refund_amount

string|null

Фактическая сумма возврата при роллбэке

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

{
    "status": "success",
    "items": [
        {
            "id": "2715",
            "name": "SSG 08 | Fever Dream (Field-Tested)",
            "price": "77.02",
            "classid": "3770669160",
            "buy_id": "50123",
            "offer_status": "creating_trade",
            "in_hold": false,
            "in_hold_until": null,
            "error_reason": null,
            "steamid": "76561190000000000",
            "date": "1719825675",
            "balance_debited_sum": "77.02",
            "tradeofferid": null,
            "custom_id": "project-order-1"
        }
    ]
}

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

missing_one_of_required_params

Отсутствуют валидные custom_ids или покупки недоступны для отмены

cancel_request_too_early

Запрос на отмену доступен только через 30 минут после создания покупки

-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