Создание депозита без SkinsBack UI (API)

Главное

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

Депозиты

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

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

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

Вывод скинов

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

Другое

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

Создание депозита без SkinsBack UI (API)

Если вы не хотите переадресовывать пользователя на SkinsBack, то вы можете реализовать свой пользовательский интерфейс для выбора игровых вещей и дальнейшей передачи их нам. Таким образом, взаимодействие будет происходить только через SkinsBack API.

Схема взаимодействия

1. Загрузите инвентарь пользователя используя API метод получения инвентаря пользователя и отобразите его в своем интерфейсе
2. Создайте депозит, передав туда предварительно идентификаторы игровых вещей из инвентаря пользователя (item_asset_ids)
3. Получите на указанный в настройках проекта Result URL webhook-уведомление о статусе платежа или же используйте метод API проверки статуса депозита

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

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

method

string

create_from_user_inventory

game

string

'cs2', 'dota2', 'rust'

steam_id

string

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

trade_token

string

'token' из Trade URL пользователя (8 символов)

item_asset_ids

array<string>

Массив, состоящий из asset_id игровых вещей, полученных из API метода получения инвентаря пользователя

order_id

string

Уникальный ID депозита в вашей системе

currency

string

Валюта (опционально)

result_url

string

Опциональный Result URL, который будет использоваться
вместо того, который указан в настройках проекта

custom_multiplier

double

Кастомный множитель цены (переопределяет значение из настроек проекта). Мин. значение: 0.5, макс.: 2

custom_currency

string

Кастомная валюта (обязательно с custom_currency_rate). Вы можете передать название своей валюты и указать ее курс. Цены на скины будут отображаться в этой валюте. Максимум 4 символа.

custom_currency_rate

double

Курс кастомной валюты (обязательно с custom_currency). Мин. значение: 0,1

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

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

transaction_id

int

Transaction ID в нашей системе

sum

float

Сумма депозита в валюте USD

local_sum

float

Сумма депозита в валюте 'currency'

local_sum_multiplied

float

Сумма депозита с множителем из настроек проекта, которую внес пользователь в валюте 'currency'

local_currency

string

Валюта, в которой предоставлены значения local_sum и local_sum_multiplied

trade_offer_id

string

Steam Trade Offer ID (можете переадресовать пользователя на окно подтверждения обмена: https://steamcommunity.com/tradeoffer/XXXX/)

trade_offer_expiry_at

datetime

Время истечения предложения обмена

bot_steam_id

string

Steam ID бота, от которого выслано предложение обмена

bot_name

string

Имя бота, от которого выслано предложение обмена

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

{
    "status": "success",
    "data": {
        "transaction_id": 116749989,
        "sum": 1.31,
        "local_sum": 121.5,
        "local_sum_multiplied": 243,
        "local_currency": "rub",
        "trade_offer_id": "6828703963",
        "trade_offer_expiry_at": "2024-03-12T10:00:34.000000Z",
        "bot_steam_id": "76561199390042107",
        "bot_name": "Dragonfly"
    }
}

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

invalid_game

Указана неверная игра

invalid_steam_id

Неверный steam_id. Пример Steam ID: 76561198827262007

invalid_trade_token

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

invalid_item_asset_ids

Неверно передано значение item_asset_ids

invalid_order_id

Неверно передано значение order_id

invalid_result_url

Указан неверный URL

invalid_currency

Указана неверная валюта

order_id_already_exists

Указанный order_id уже был использован для создания депозита

deposit_amount_less_minimum

Сумма выбранных скинов меньше минимальной

inventory_is_outdated

Инвентарь устарел (4 часа). Загрузите новый инвентарь для пользователя

items_overstock

Некоторые из указанных вещей находятся в оверстоке. Загрузите новый инвентарь для пользователя

user_not_tradable

Пользователь имеет ограничения в системе обмена

some_item_not_found

Один (или несколько) из игровых вещей не найден в инвентаре пользователя. Загрузите новый инвентарь для пользователя

one_of_selected_items_is_not_acceptable

Один (или несколько) из указанных item_asset_ids не может быть принят нами. Проверьте корректность item_asset_ids и попробуйте еще раз загрузить новый инвентарь для пользователя

internal_error

Внутренняя ошибка. Попробуйте еще раз

invalid_custom_currency

Указана неверная произвольная валюта

invalid_custom_currency_rate

Указан неверный курс произвольной валюты

invalid_custom_multiplier

Указан неверный опциональный множитель. Мин. значение: 0.5, макс: 2.

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

-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

Пример ответа с ошибкой:

{
    "status": "error",
    "error_code": 7,
    "error_message": "order_id_already_exists"
}