ZH-CN
EN
DE
ES
PL
PT-BR
PT-PT
RU
TR
VI
主要
基本信息
生成签名
存款
入门
创建存款
创建存款（不带重定向）(iframe)
存款通知（webhook）
检查存款状态
获取存款列表
无需8天等待的存款（Steam交易保护）
批准8天冻结期的存款
获取失败的 webhook 通知
无SkinsBack用户界面的存款
Create a deposit without SkinsBack UI (API)
获取用户库存
提取皮肤
价格列表（皮肤可用性）
搜索皮肤
购买皮肤
批量购买皮肤
购买皮肤的状态
皮肤购买历史
其他
项目余额
余额和存款提现历史记录
货币和汇率
服务器状态
事件实时性：websockets
实时事件：回调
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
个蓝色 个必填参数。
向 API终点 发送POST请求，使用以下参数：
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
result_url
string
Optional Result URL that will be used
instead of the one specified in the project settings
instead of the one specified in the project settings
custom_multiplier
double
自定义价格乘数（覆盖项目设置中的值）。最小值：0.5，最大值：2
custom_currency
string
自定义货币（custom_currency_rate 必需）。您可以传递自定义货币的名称并指定其汇率。皮肤价格将以此货币显示。最多 4 个字符。
custom_currency_rate
double
任意货币的汇率（custom_currency 必需）。最小值：0.1
服务器响应：
如果成功，服务器的响应将是一个JSON对象，内容如下：
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
成功响应示例：
{
"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"
}
}
可能的错误列表：
1
invalid_game
指定的游戏无效
2
invalid_steam_id
无效的 steam_id。Steam ID 示例：76561198827262007
3
invalid_trade_token
无效交易令牌。向用户请求一个新的交易 URL
4
invalid_item_asset_ids
传递的 item_asset_ids 值不正确
5
invalid_order_id
传入的 order_id 值不正确
6
invalid_result_url
指定的 URL 无效
7
invalid_currency
指定的货币无效
8
order_id_already_exists
指定的 order_id 已用于创建存款
9
deposit_amount_less_minimum
所选皮肤的金额小于最小值
10
inventory_is_outdated
库存已过期（4 小时）。为用户加载新库存
11
items_overstock
其中一些物品库存过多。为用户加载新库存
12
user_not_tradable
用户在贸易系统中受到限制
13
some_item_not_found
用户库存中没有找到一个（或多个）游戏物品。为用户加载新的库存
14
one_of_selected_items_is_not_acceptable
我们无法接受一个（或多个）指定的 item_asset_ids。请检查 item_asset_ids 是否正确，并尝试重新为用户加载新清单
15
internal_error
内部错误，请重试
16
invalid_custom_currency
指定的自定义货币无效
17
invalid_custom_currency_rate
指定的自定义货币汇率无效
18
invalid_custom_multiplier
指定的自定义乘数无效. 最小值：0.5，最大值：2
标准错误：
-1
please_use_post_method
需要使用POST方法
-2
invalid_shopid
项目ID在系统中未找到
-3
invalid_signature
签名格式不正确
-4
shop_not_active
项目不处于活动状态
-5
invalid_method
无效的API方法
-7
request_limit_reached
请求限制已达到（每分钟500次）
-8
invalid_ip_address
请在项目设置中指定IP地址
-9
under_maintenance
网站维护中
-10
invalid_client_secret
无效的 X-CLIENT-SECRET 标头
错误响应示例：
{
"status": "error",
"error_code": 7,
"error_message": "order_id_already_exists"
}