Ayuda Contactos
esES
ENEN DEDE ESES PLPL PT-BRPT-BR PT-PTPT-PT RURU TRTR VIVI ZH-CNZH-CN

API

Principal
Información principal Generación de firma
Depósitos
Empezando Creación de depósito Creación de depósito sin redireccionamiento (iframe) Notificación de depósito (webhook) Verificación del estado del depósito Obtener lista de depósitos Depósitos sin período de espera de 8 días (Steam Trade Protection) Aprobación de depósito con retención de 8 días Recibir notificaciones de webhooks fallidos
Depósitos sin SkinsBack UI
Create a deposit without SkinsBack UI (API) Crear un depósito sin SkinsBack UI (API)
Retiro de skins
Lista de precios (disponibilidad de skins) Buscar skins Comprar skin Compra de skins al por mayor Estado de compra de skin Historial de compras de skins
Otro
Saldo del proyecto Historial de retiros del saldo y depósitos Monedas y tasas Estado del servidor Eventos en tiempo real: websockets Eventos en tiempo 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


Los parámetros obligatorios están resaltados en azul .

Envía una solicitud POST a API Endpoint con los siguientes 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 precio personalizado (anula el valor de la configuración del proyecto). Valor mínimo: 0.5, máximo: 2
custom_currency
string
Moneda personalizada (requerida con custom_currency_rate). Puedes pasar el nombre de una moneda personalizada y especificar su tasa. Los precios de los aspectos se mostrarán en esta moneda. Máximo 4 caracteres.
custom_currency_rate
double
La tasa de una moneda arbitraria (requerida con custom_currency). Valor mínimo: 0,1

Respuesta del servidor:

En caso de éxito, la respuesta del servidor será un objeto JSON con el siguiente contenido:

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

Ejemplo de respuesta exitosa:

{
    "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 posibles errores:

1
invalid_game
Juego no válido especificado
2
invalid_steam_id
steam_id inválido. Ejemplo de ID de Steam: 76561198827262007
3
invalid_trade_token
trade_token inválido. Solicita una nueva URL de comercio al usuario
4
invalid_item_asset_ids
El valor de item_asset_ids fue pasado incorrectamente
5
invalid_order_id
El valor de order_id ha sido introducido incorrectamente
6
invalid_result_url
URL no válida especificada
7
invalid_currency
Moneda no válida especificada
8
order_id_already_exists
El order_id especificado ya ha sido utilizado para crear un depósito
9
deposit_amount_less_minimum
La cantidad de pieles seleccionadas es menor que el mínimo
10
inventory_is_outdated
El inventario está caducado (4 horas). Cargar un nuevo inventario para el usuario
11
items_overstock
Algunos de estos artículos están en exceso de stock. Carga un nuevo inventario para el usuario
12
user_not_tradable
El usuario tiene restricciones en el sistema de comercio
13
some_item_not_found
Uno(o más) de los ítems del juego no fue encontrado en el inventario del usuario. Carga un nuevo inventario para el usuario
14
one_of_selected_items_is_not_acceptable
Uno(o más) de los item_asset_ids especificados no pueden ser aceptados por nosotros.Compruebe que item_asset_ids es correcto e intente cargar un nuevo inventario para el usuario de nuevo
15
internal_error
Error interno.Inténtalo de nuevo
16
invalid_custom_currency
Moneda personalizada no válida especificada
17
invalid_custom_currency_rate
Tipo de moneda personalizado no válido
18
invalid_custom_multiplier
Multiplicador personalizado no válido especificado
errores estándar:
-1
please_use_post_method
Es necesario utilizar el método POST
-2
invalid_shopid
ID del proyecto no encontrado en el sistema
-3
invalid_signature
Firma incorrecta
-4
shop_not_active
El proyecto no está activo
-5
invalid_method
Método API inválido
-7
request_limit_reached
Se ha alcanzado el límite de solicitudes (500 por minuto)
-8
invalid_ip_address
Por favor, especifique la dirección IP en la configuración del proyecto
-9
under_maintenance
El sitio web está en mantenimiento
-10
invalid_client_secret
Encabezado X-CLIENT-SECRET no válido

Ejemplo de respuesta con error:

{
    "status": "error",
    "error_code": 7,
    "error_message": "order_id_already_exists"
}
© 2026 SkinsBack. All right reserved.
Ayuda Contactos Acuerdo de servicio