Creating a deposit without SkinsBack UI (API)

Ana Sayfa

Temel Bilgiler İmza Oluşturma

Depozitler

Başlarken Depozito Oluşturma Depozito Oluşturma (iframe ile yönlendirme olmadan) Depozito Bildirimi (webhook) Depozito Durumu Kontrolü Depozito Listesi Alma 8 gün beklemesiz yatırımlar (Steam Trade Protection) 8 günlük bekletme ile yatırım onayı Başarısız web kancası bildirimleri alın

SkinsBack kullanıcı arayüzü olmadan para yatırma

Create a deposit without SkinsBack UI (API) Kullanıcının envanterini al

Skin çekme

Fiyat listesi (skin mevcudu) Skin arama Skin satın alma Toplu satın alma skinleri Skin satın alma durumu Skin satın alma geçmişi

Diğer

Proje Bakiyesi Bakiye ve Depozito Çekme Geçmişi Para birimleri ve döviz kurları Sunucu durumu Gerçek zamanlı olaylar: websockets Gerçek zamanlı olaylar: web kancaları

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

Mavi zorunlu parametreleri vurgulanmıştır.

Aşağıdaki parametreleri içeren POST isteği gönderin: API Endpoint

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

Özel fiyat çarpanı (proje ayarlarından gelen değeri geçersiz kılar). Min. değer: 0.5, maks.: 2

custom_currency

string

Özel para birimi (custom_currency_rate ile gereklidir). Özel bir para biriminin adını geçebilir ve oranını belirtebilirsiniz. Skin fiyatları bu para biriminde gösterilecektir. Maksimum 4 karakter.

custom_currency_rate

double

İsteğe bağlı bir para biriminin oranı (custom_currency ile gereklidir). Min. değer: 0.1

Sunucudan gelen yanıt:

Başarılı olursa, sunucudan gelen yanıtta aşağıdaki JSON nesnesi olacaktır:

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

Başarılı yanıt örneği:

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

Mümkün olan hataların listesi:

invalid_game

Geçersiz oyun belirtildi

invalid_steam_id

Geçersiz steam_id. Steam ID örneği: 76561198827262007

invalid_trade_token

Geçersiz trade_token. Kullanıcıdan yeni bir Trade URL'si talep edin

invalid_item_asset_ids

item_asset_ids değeri yanlış aktarıldı

invalid_order_id

order_id değeri yanlış aktarıldı

invalid_result_url

Geçersiz URL belirtildi

invalid_currency

Geçersiz para birimi belirtildi

order_id_already_exists

Belirtilen order_id zaten bir depozito oluşturmak için kullanıldı

deposit_amount_less_minimum

Seçilen derilerin miktarı minimumdan az

inventory_is_outdated

Envanter güncel değil (4 saat). Kullanıcı için yeni bir envanter yükleyin

items_overstock

Bu öğelerden bazıları fazla stokta. Kullanıcı için yeni bir envanter yükleyin

user_not_tradable

Kullanıcının ticaret sisteminde kısıtlamaları var

some_item_not_found

Oyun öğelerinden biri (veya daha fazlası) kullanıcının envanterinde bulunamadı. Kullanıcı için yeni bir envanter yükleyin

one_of_selected_items_is_not_acceptable

Belirtilen item_asset_id'lerden biri(veya daha fazlası) tarafımızdan kabul edilemez. item_asset_id'lerin doğru olup olmadığını kontrol edin ve kullanıcı için yeni bir envanter yüklemeyi tekrar deneyin

internal_error

Dahili hata. tekrar deneyin

invalid_custom_currency

Geçersiz özel para birimi belirtildi

invalid_custom_currency_rate

Geçersiz özel para birimi kuru belirtildi

invalid_custom_multiplier

Geçersiz özel çarpan belirtildi. Min değer: 0.5, maks: 2

standart hatalar:

-1

please_use_post_method

POST yöntemi kullanılmalıdır

-2

invalid_shopid

Proje kimliği sistemde bulunamadı

-3

invalid_signature

Geçersiz imza

-4

shop_not_active

Proje etkin değil

-5

invalid_method

Geçersiz API yöntemi

-7

request_limit_reached

İstek sınırı aşıldı (500/dakika)

-8

invalid_ip_address

Proje ayarlarında IP adresini belirtin

-9

under_maintenance

Site bakımda

-10

invalid_client_secret

Geçersiz X-CLIENT-SECRET başlığı

Hata yanıtı örneği:

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