Creating a deposit without SkinsBack UI (API)

Principal

Informações Principais Gerando uma Assinatura

Depósitos

Começando Criando um Depósito Criando um Depósito sem Redirecionamento (iframe) Notificação de Depósito (webhook) Verificando o Status do Depósito Obtendo a Lista de Depósitos Depósitos sem período de espera de 8 dias (Steam Trade Protection) Aprovação de depósito com retenção de 8 dias Receba notificações de webhook com falha

Depósitos sem a interface do usuário do SkinsBack

Create a deposit without SkinsBack UI (API) Obter o inventário do usuário

Retirada de skins

Lista de preços (disponibilidade de skins) Pesquisar skins Comprar skin Comprar skins em grandes quantidades Status da compra de skin Histórico de compras de skins

Outro

Saldo do Projeto Histórico de Saques e Depósitos Moedas e taxas Status do servidor Eventos em tempo real: websockets Eventos em tempo real: webhooks

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

Parâmetros obrigatórios destacados em azul

Envie uma solicitação POST para o Endpoint da API com os seguintes parâmetros:

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

Multiplicador de preço personalizado (substitui o valor das configurações do projeto). Valor mínimo: 0.5, máximo: 2

custom_currency

string

Moeda personalizada (necessária com custom_currency_rate). Você pode passar o nome de uma moeda personalizada e especificar sua taxa. Os preços das skins serão exibidos nesta moeda. Máximo de 4 caracteres.

custom_currency_rate

double

A taxa de uma moeda arbitrária (necessária com custom_currency). Valor mínimo: 0,1

Resposta do servidor:

Em caso de sucesso, a resposta do servidor será um objeto JSON com o seguinte conteúdo:

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

Exemplo de resposta bem-sucedida:

{
    "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 de possíveis erros:

invalid_game

Jogo inválido especificado

invalid_steam_id

steam_id inválido. Exemplo de ID Steam: 76561198827262007

invalid_trade_token

trade_token inválido. Solicite um novo URL de negociação ao usuário

invalid_item_asset_ids

O valor de item_asset_ids foi passado incorretamente

invalid_order_id

O valor order_id foi passado incorretamente

invalid_result_url

URL inválido especificado

invalid_currency

Moeda inválida especificada

order_id_already_exists

O order_id especificado já foi usado para criar um depósito

deposit_amount_less_minimum

O valor das skins selecionadas é menor que o mínimo

inventory_is_outdated

O inventário está desatualizado (4 horas). Carregue um novo inventário para o usuário

items_overstock

Alguns desses itens estão em excesso de estoque.Carregue um novo inventário para o usuário

user_not_tradable

O usuário tem restrições no sistema de comércio

some_item_not_found

Um(ou mais) dos itens do jogo não foi encontrado no inventário do usuário.Carregue um novo inventário para o usuário

one_of_selected_items_is_not_acceptable

Um(ou mais) dos item_asset_ids especificados não pode ser aceito por nós.Verifique se os item_asset_ids estão corretos e tente carregar um novo inventário para o usuário novamente

internal_error

Erro interno. tente novamente

invalid_custom_currency

Moeda personalizada inválida especificada

invalid_custom_currency_rate

Taxa de moeda personalizada inválida especificada

invalid_custom_multiplier

Multiplicador personalizado inválido especificado. Valor mínimo: 0.5, máximo: 2

erros padrão:

-1

please_use_post_method

É necessário usar o método POST

-2

invalid_shopid

ID do projeto não encontrado no sistema

-3

invalid_signature

Assinatura inválida

-4

shop_not_active

Projeto inativo

-5

invalid_method

Método de API inválido

-7

request_limit_reached

Limite de solicitações excedido (500 por minuto)

-8

invalid_ip_address

Especifique o endereço IP nas configurações do projeto

-9

under_maintenance

Site em manutenção

-10

invalid_client_secret

Cabeçalho X-CLIENT-SECRET inválido

Exemplo de resposta com erro:

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