Creating a deposit without SkinsBack UI (API)

Główny

Podstawowe informacje Generowanie podpisu

Depozyty

Pierwsze kroki Tworzenie depozytu Tworzenie depozytu bez przekierowania (iframe) Powiadomienie o wpłacie (webhook) Sprawdzanie statusu depozytu Uzyskanie listy depozytów Depozyty bez 8-dniowego oczekiwania (Steam Trade Protection) Zatwierdzenie depozytu z 8-dniowym holdem Otrzymuj powiadomienia o nieudanych webhookach

Depozyty bez interfejsu użytkownika SkinsBack

Create a deposit without SkinsBack UI (API) Pobierz ekwipunek użytkownika

Wyjście skinów

Cennik (dostępność skinów) Wyszukaj skinów Kup skiny Kupuj skórki hurtowo Stan zakupu skina Historia zakupów skinów

Inny

Bilans projektu Historia wypłat z salda i depozytów Waluty i kursy Status serwera Zdarzenia w czasie rzeczywistym: websockets Zdarzenia w czasie rzeczywistym: webhooki

Creating a deposit without SkinsBack UI (API)

If you don't want to redirect the user to SkinsBack, then you can implement your own user interface to select game items and then transfer them to us. Thus, interaction will only occur through the SkinsBack API.

Flow

1. Load the user's inventory using API method for getting user's inventory and display it in your interface
2. Create a deposit by first transferring there the identifiers of game items from the user’s inventory (item_asset_ids)
3. Receive a webhook notification about the payment status at the Result URL specified in the project settings or use the API method for checking the deposit status

Niebieski podświetla wymagane parametry.

Wyślij żądanie POST do API Endpoint z następującymi parametrami:

method

string

create_from_user_inventory

game

string

'cs2', 'dota2', 'rust'

steam_id

string

User Steam ID

trade_token

string

'token' value from the user's Trade URL

item_asset_ids

array<string>

An array consisting of the asset_id of game items obtained from the API method for getting the user's inventory

order_id

string

Unique Order ID in your system

currency

string

Currency (optional)

result_url

string

Optional Result URL that will be used
instead of the one specified in the project settings

custom_multiplier

double

Mnożnik ceny niestandardowej (zastępuje wartość z ustawień projektu). Wartość minimalna: 0.5, maks.: 2

custom_currency

string

Waluta niestandardowa (wymagana z custom_currency_rate). Możesz przekazać nazwę waluty niestandardowej i określić jej kurs. Ceny skórek będą wyświetlane w tej walucie. Maksymalnie 4 znaki.

custom_currency_rate

double

Kurs dowolnej waluty (wymagany z custom_currency). Wartość minimalna: 0,1

Odpowiedź z serwera:

Jeśli się powiedzie, odpowiedź z serwera będzie zawierać obiekt JSON o następującej treści:

transaction_id

int

Transaction ID in our system

sum

float

Deposit amount in USD currency

local_sum

float

Deposit amount in currency 'currency'

local_sum_multiplied

float

Deposit amount with a multiplier from the project settings, which was made by the user in currency 'currency'

local_currency

string

Currency in which local_sum and local_sum_multiplied values are provided

trade_offer_id

string

Steam Trade Offer ID (you can redirect the user to the trade confirmation window: https://steamcommunity.com/tradeoffer/XXXX/)

trade_offer_expiry_at

datetime

Trade offer expiration time

bot_steam_id

string

Steam ID of the bot from which the trade offer was sent

bot_name

string

Name of the bot from which the trade offer was sent

Przykład udanej odpowiedzi:

{
    "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"
    }
}

Lista możliwych błędów:

invalid_game

Określono nieprawidłową grę

invalid_steam_id

Nieprawidłowy steam_id. Przykład Steam ID: 76561198827262007

invalid_trade_token

Nieprawidłowy trade_token. Zażądaj nowego adresu URL transakcji od użytkownika

invalid_item_asset_ids

Wartość item_asset_ids została przekazana nieprawidłowo

invalid_order_id

Wartość order_id została przekazana nieprawidłowo

invalid_result_url

Podano nieprawidłowy adres URL

invalid_currency

Podano nieprawidłową walutę

order_id_already_exists

Podany order_id został już użyty do utworzenia depozytu

deposit_amount_less_minimum

Ilość wybranych skórek jest mniejsza niż minimum

inventory_is_outdated

Inwentarz jest nieaktualny (4 godziny). Załaduj nowy ekwipunek dla użytkownika

items_overstock

Niektóre z tych przedmiotów są w nadmiarze. Załaduj nowy zapas dla użytkownika

user_not_tradable

Użytkownik ma ograniczenia w systemie handlu

some_item_not_found

Jeden (lub więcej) z przedmiotów gry nie został znaleziony w ekwipunku użytkownika. Załaduj nowy ekwipunek dla użytkownika

one_of_selected_items_is_not_acceptable

Jeden(lub więcej) z określonych identyfikatorów item_asset_ids nie może zostać przez nas zaakceptowany.Sprawdź, czy item_asset_ids są poprawne i spróbuj ponownie załadować nowy ekwipunek dla użytkownika

internal_error

Błąd wewnętrzny. Spróbuj ponownie

invalid_custom_currency

Nieprawidłowa waluta niestandardowa

invalid_custom_currency_rate

Określono nieprawidłowy niestandardowy kurs waluty

invalid_custom_multiplier

Określono nieprawidłowy mnożnik niestandardowy

standardowe błędy:

-1

please_use_post_method

Musisz użyć metody POST

-2

invalid_shopid

W systemie nie znaleziono identyfikatora projektu

-3

invalid_signature

Błędnie złożony podpis

-4

shop_not_active

Projekt jest nieaktywny

-5

invalid_method

Nieprawidłowa metoda API

-7

request_limit_reached

Przekroczono limit żądań (500/minutę)

-8

invalid_ip_address

Określ adres IP w ustawieniach projektu

-9

under_maintenance

Witryna w trakcie prac konserwacyjnych

-10

invalid_client_secret

Nieprawidłowy nagłówek X-CLIENT-SECRET

Przykład odpowiedzi z błędem:

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