Creating a deposit without SkinsBack UI (API)

Chung

Thông tin chính Tạo chữ ký

Tiền gửi

Bắt đầu Tạo khoản tiền gửi Tạo khoản tiền gửi mà không chuyển hướng (iframe) Thông báo về khoản tiền gửi (webhook) Kiểm tra trạng thái khoản tiền gửi Lấy danh sách khoản tiền gửi Tiền gửi không cần chờ 8 ngày (Bảo vệ giao dịch Steam) Phê duyệt tiền gửi với thời gian giữ 8 ngày Nhận thông báo webhook không thành công

Tiền gửi không Có Giao diện Người Dùng SkinsBack

Create a deposit without SkinsBack UI (API) Nhận hàng tồn kho của người dùng

Rút skin

Bảng giá (sẵn có skin) Tìm kiếm skin Mua skin Mua skin số lượng lớn Trạng thái mua skin Lịch sử mua skin

Khác

Số dư dự án Lịch sử rút tiền từ số dư và khoản tiền gửi Đồng tiền và tỷ giá Trạng thái máy chủ Sự kiện thời gian thực: websockets Sự kiện thời gian thực: 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

Các tham số bắt buộc được đánh dấu bằng màu xanh.

Gửi yêu cầu POST tới Điểm cuối API với các tham số sau:

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

Hệ số giá tùy chỉnh (ghi đè giá trị từ cài đặt dự án). Giá trị tối thiểu: 0.5, tối đa: 2

custom_currency

string

Tiền tệ tùy chỉnh (bắt buộc với custom_currency_rate). Bạn có thể truyền tên của một loại tiền tệ tùy chỉnh và chỉ định tỷ giá của nó. Giá giao diện sẽ được hiển thị bằng loại tiền tệ này. Tối đa 4 ký tự.

custom_currency_rate

double

Tỷ giá của một loại tiền tệ tùy ý (bắt buộc với custom_currency). Giá trị tối thiểu: 0,1

Phản hồi từ máy chủ:

Nếu thành công, phản hồi từ máy chủ sẽ là một đối tượng JSON với nội dung sau:

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

Ví dụ phản hồi thành công:

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

Danh sách các lỗi có thể xảy ra:

invalid_game

Trò chơi không hợp lệ đã chỉ định

invalid_steam_id

steam_id không hợp lệ. Ví dụ về ID Steam: 76561198827262007

invalid_trade_token

Trade_token không hợp lệ. Yêu cầu URL giao dịch mới từ người dùng

invalid_item_asset_ids

Giá trị item_asset_ids đã được truyền không đúng cách

invalid_order_id

Giá trị order_id đã được truyền không đúng cách

invalid_result_url

URL không hợp lệ đã chỉ định

invalid_currency

Tiền tệ không hợp lệ được chỉ định

order_id_already_exists

order_id đã chỉ định đã được sử dụng để tạo khoản tiền gửi

deposit_amount_less_minimum

Số lượng skin đã chọn ít hơn số lượng tối thiểu

inventory_is_outdated

Kho đã hết hạn (4 giờ). Tải kho mới cho người dùng

items_overstock

Một số vật phẩm này đang trong tình trạng tồn kho quá mức. Tải kho mới cho người dùng

user_not_tradable

Người dùng có các hạn chế trong hệ thống giao dịch

some_item_not_found

Một (hoặc nhiều) vật phẩm trong trò chơi không được tìm thấy trong kho của người dùng. Tải một kho mới cho người dùng

one_of_selected_items_is_not_acceptable

Chúng tôi không thể chấp nhận một (hoặc nhiều) item_asset_ids đã chỉ định. Kiểm tra xem item_asset_ids có chính xác không và thử tải lại kho mới cho người dùng

internal_error

Lỗi nội bộ. thử lại

invalid_custom_currency

Tiền tệ tùy chỉnh không hợp lệ đã chỉ định

invalid_custom_currency_rate

Tỷ giá tiền tệ tùy chỉnh không hợp lệ đã chỉ định

invalid_custom_multiplier

Hệ số nhân tùy chỉnh không hợp lệ đã chỉ định. Giá trị tối thiểu: 0.5, tối đa: 2

các lỗi tiêu chuẩn:

-1

please_use_post_method

Cần sử dụng phương thức POST

-2

invalid_shopid

ID dự án không được tìm thấy trong hệ thống

-3

invalid_signature

Chữ ký được tạo không hợp lệ

-4

shop_not_active

Dự án không hoạt động

-5

invalid_method

Phương thức API không hợp lệ

-7

request_limit_reached

Vượt quá giới hạn yêu cầu (500/1 phút)

-8

invalid_ip_address

Vui lòng cung cấp địa chỉ IP trong cài đặt dự án

-9

under_maintenance

Trang web đang được bảo trì

-10

invalid_client_secret

Tiêu đề X-CLIENT-SECRET không hợp lệ

Ví dụ phản hồi lỗi:

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