Mua số lượng lớn skin và gửi cho người dùng

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

Mua số lượng lớn skin và gửi cho người dùng

Mua số lượng lớn skin và gửi cho người dùng.

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

market_batch_buy

partner

string

Giá trị 'partner' từ Trade URL của người dùng

token

string

Giá trị 'token' từ Trade URL của người dùng

items

array

Mảng vật phẩm để mua skin

items[][id]

int

ID của skin từ danh sách giá hoặc tìm kiếm

items[][max_price]

float

Giá tối đa của skin để mua (theo USD). Được sử dụng như một ràng buộc giá

items[][custom_id]

string

ID duy nhất trong hệ thống của bạn. Được sử dụng để ngăn chặn việc mua hàng trùng lặp

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:

purchased

array

Mảng chứa danh sách các giao diện đã mua, mô tả bên dưới

unavailable

array

Mảng chứa danh sách ID skin không khả dụng và lý do:
- insufficient_funds (error_code: 4) — Không đủ tiền trong tài khoản của dự án
- skin_unavailable (error_code: 5) — Skin không khả dụng để mua
- skins_not_found_at_specified_price (error_code: 6) — Không có skin có giá <= 'max_price'
- custom_id_already_exists: (error_code: 7) — 'custom_id' đã tồn tại trong hệ thống của chúng tôi

Mảng 'purchased'

item

object

Đối tượng chứa thông tin về skin đã mua

— item.id

int

ID của skin

— item.name

string

Tên skin

— item.price

float

Giá skin theo USD

— item.classid

string

Class ID của skin

buy_id

int

ID của giao dịch mua, cần thiết để kiểm tra trạng thái chuyển giao vật phẩm sau này

offer_status

string

Trạng thái mua hàng:
1. 'creating_trade' — đang tạo giao dịch
2. 'waiting_accept' — đang chờ chấp nhận giao dịch
3. 'accepted' — giao dịch đã được chấp nhận
4. 'canceled' — giao dịch bị hủy bỏ bởi người dùng
5. 'timeout' — giao dịch không được chấp nhận sau 10 phút
6. 'invalid_trade_token' — mã trade token không hợp lệ
7. 'user_not_tradable' — người dùng có hạn chế trong hệ thống giao dịch
8. 'trade_create_error' — lỗi khi tạo giao dịch (vui lòng thử lại)
9. 'rollback_user' — skin đã được người dùng hoàn trả (Bảo vệ Giao dịch Steam)
10. 'rollback_supplier' — skin đã được nhà cung cấp hoàn trả (Bảo vệ Giao dịch Steam)

Phương thức này chỉ có thể chứa create_trade. Các trạng thái khác trong phương thức market_getinfo / market_history.

balance_debited_sum

float

Số tiền đã trừ từ số dư dự án (USD)

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

{
   "status":"success",
   "purchased":{
      "62696971":{
         "item":{
            "id":"62696971",
            "name":"'The Doctor' Romanov | Sabre",
            "price":8.28,
            "classid":"3608084106",
            "instanceid":"0"
         },
         "buy_id":129112705,
         "offer_status":"creating_trade",
         "steamid":"76561198050648523",
         "date":"1748862060",
         "balance_debited_sum":8.28,
         "custom_id":"10000"
      },
      "62697425":{
         "item":{
            "id":"62697425",
            "name":"'The Doctor' Romanov | Sabre",
            "price":8.03,
            "classid":"3608084106",
            "instanceid":"0"
         },
         "buy_id":129112706,
         "offer_status":"creating_trade",
         "steamid":"76561198050648523",
         "date":"1748862060",
         "balance_debited_sum":8.03,
         "custom_id":"10001"
      }
   },
    "unavailable":{
      "62696979":{
         "error_code":5,
         "error_message":"skin_unavailable"
      },
      "62697480":{
         "error_code":5,
         "error_message":"skin_unavailable"
      }
   }
}

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

invalid_partner_value

Giá trị 'partner' không hợp lệ

invalid_token_value

Giá trị 'token' không hợp lệ. Xin yêu cầu Trade URL mới từ người dùng

too_many_failed_attempts_for_user

Quá nhiều lần gửi skin không thành công cho người dùng (Trade URL không chính xác, người dùng không chấp nhận skin trong thời gian quy định, người dùng không thể trao đổi skin). Xin thử lại sau

-6

market_disabled

Thị trường đã tắt

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ệ