Creating a deposit without SkinsBack UI (API)

Hauptseite

Hauptinformationen Generierung der Unterschrift

Einzahlungen

Erste Schritte Depot erstellen Depot erstellen ohne Weiterleitung (iframe) Benachrichtigung über Einzahlung (webhook) Überprüfung des Einzahlungsstatus Abrufen der Liste der Einlagen Einzahlungen ohne 8-tägige Wartezeit (Steam Trade Protection) Einzahlungsgenehmigung mit 8-tägigem Hold Benachrichtigungen zu fehlgeschlagenen Webhooks erhalten

Einzahlungen ohne SkinsBack UI

Create a deposit without SkinsBack UI (API) Inventar des Benutzers abrufen

Skin-Abhebung

Preisliste (Skin-Verfügbarkeit) Skin-Suche Skin kaufen Skins in großen Mengen kaufen Status des Skin-Kaufs Kaufverlauf für Skins

Sonstiges

Projektsaldo Auszahlungs- und Einzahlungshistorie Währungen und Wechselkurse Serverstatus Ereignisse in Echtzeit: Websockets Ereignisse in Echtzeit: Webhook

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

Blaue markiert obligatorische Parameter.

Senden Sie eine POST-Anfrage an den API-Endpunkt mit den folgenden Parametern:

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

Benutzerdefinierter Preismultiplikator (überschreibt Wert aus Projekteinstellungen). Mindestwert: 0.5, Höchstwert: 2

custom_currency

string

Benutzerdefinierte Währung (erforderlich mit custom_currency_rate). Sie können den Namen einer benutzerdefinierten Währung übergeben und ihren Kurs angeben. Skin-Preise werden in dieser Währung angezeigt. Maximal 4 Zeichen.

custom_currency_rate

double

Der Kurs einer beliebigen Währung (erforderlich mit custom_currency). Mindestwert: 0,1

Antwort vom Server:

Bei Erfolg enthält die Antwort vom Server ein JSON-Objekt mit folgendem Inhalt:

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

Beispiel für eine erfolgreiche Antwort:

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

Liste möglicher Fehler:

invalid_game

Ungültiges Spiel angegeben

invalid_steam_id

Ungültige steam_id. Beispiel für Steam ID: 76561198827262007

invalid_trade_token

Ungültiges trade_token. Fordern Sie eine neue Handels-URL vom Benutzer an

invalid_item_asset_ids

Der item_asset_ids-Wert wurde falsch übergeben

invalid_order_id

Der Wert der order_id wurde falsch übergeben

invalid_result_url

Ungültige URL angegeben

invalid_currency

Ungültige Währung angegeben

order_id_already_exists

Die angegebene order_id wurde bereits zur Erstellung einer Einzahlung verwendet

deposit_amount_less_minimum

Die Menge der ausgewählten Felle ist kleiner als das Minimum

inventory_is_outdated

Das Inventar ist veraltet (4 Stunden). Laden Sie ein neues Inventar für den Benutzer

items_overstock

Einige dieser Artikel befinden sich im Überbestand.Laden Sie ein neues Inventar für den Benutzer

user_not_tradable

Der Benutzer hat Einschränkungen im Handelssystem

some_item_not_found

Einer(oder mehrere) der Spielgegenstände wurde im Inventar des Benutzers nicht gefunden.Lade ein neues Inventar für den Benutzer

one_of_selected_items_is_not_acceptable

Eine(oder mehrere) der angegebenen item_asset_ids kann von uns nicht akzeptiert werden.Überprüfen Sie, ob die item_asset_ids korrekt sind und versuchen Sie erneut, ein neues Inventar für den Benutzer zu laden

internal_error

Interner Fehler. versuchen Sie es erneut

invalid_custom_currency

Ungültige benutzerdefinierte Währung angegeben

invalid_custom_currency_rate

Ungültiger benutzerdefinierter Währungskurs angegeben

invalid_custom_multiplier

Ungültiger benutzerdefinierter Multiplikator angegeben

Standardfehler:

-1

please_use_post_method

Es muss die POST-Methode verwendet werden

-2

invalid_shopid

Projekt-ID wurde nicht im System gefunden

-3

invalid_signature

Ungültige Signatur

-4

shop_not_active

Projekt ist inaktiv

-5

invalid_method

Ungültige API-Methode

-7

request_limit_reached

Anfrage-Limit überschritten (500/Minute)

-8

invalid_ip_address

Geben Sie die IP-Adresse in den Projekteinstellungen an

-9

under_maintenance

Website in Wartung

-10

invalid_client_secret

Ungültiger X-CLIENT-SECRET-Header

Beispiel einer fehlerhaften Antwort:

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