Thông báo về khoản nạp tiền (webhook)

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

Thông báo về khoản nạp tiền (webhook)

Khác với các hệ thống thanh toán kinh điển, SkinsBack không chấp nhận một số tiền cụ thể để nạp tiền. Số tiền nạp sẽ được gửi tới Result URL (webhook) sau khi chúng tôi nhận được các vật phẩm trong game.

Các tham số gửi bằng phương thức POST tới Result URL:

sign

string

Chữ ký để xác minh. Sử dụng phương pháp xác minh chữ ký để xác minh chữ ký của yêu cầu.

HOẶC bạn có thể xác minh tiêu đề X-SIGN được gửi đến máy chủ của mình bằng thuật toán:
md5(clientId + clientSecret) (nối).

status

string

success - thanh toán thành công, pending - đang chờ, fail - thất bại, in_hold - tiền gửi đang bị giữ

Tiền gửi từ trạng thái in_hold có thể chuyển sang trạng thái success hoặc fail.

Chỉ dành cho tiền gửi không cần chờ 8 ngày: hold_approved - tiền gửi đã được phê duyệt, hold_returned - hủy phê duyệt tiền gửi đang giữ. Xem thêm...

transaction_id

string

ID giao dịch trong hệ thống của chúng tôi

order_id

string

ID duy nhất của khoản tiền gửi trong hệ thống của bạn

steam_id

string

Steam ID người dùng

date

int

Thời gian tạo khoản tiền gửi theo thời gian UNIX

amount

double

Số tiền người dùng gửi bằng loại tiền 'currency'
(chỉ khi status = success, in_hold hoặc hold_approved)

amount_currency

string

Đơn vị tiền tệ thanh toán
(chỉ khi status = success, in_hold hoặc hold_approved)

amount_in_currencies

object

Số tiền nạp trong tất cả các đơn vị tiền tệ có sẵn
(chỉ khi status = success, in_hold hoặc hold_approved)

user_amount

double

Số tiền người dùng đã gửi nhân với hệ số từ cài đặt dự án trong đơn vị tiền tệ currency
(chỉ khi status = success, in_hold hoặc hold_approved)

user_amount_in_currencies

object

Số tiền người dùng đã gửi nhân với hệ số từ cài đặt dự án trong tất cả các đơn vị tiền tệ có sẵn
(chỉ khi status = success, in_hold hoặc hold_approved)

offer_date

int

Thời gian tạo đề xuất trao đổi UNIX
cho người dùng (có thể không có)

in_hold_until

int

Thời gian giữ tiền gửi (nếu có) theo thời gian UNIX.

trade_offer_id

string

Trade Offer ID trên Steam (nếu có)

skins_send_date

int

Thời gian chấp nhận trao đổi skin (có thể không có)
(chỉ khi status = success, in_hold hoặc hold_approved)

custom_currency

string

Tên tiền tệ tùy chỉnh (nếu được chỉ định)
(chỉ khi status = success, in_hold hoặc hold_approved)

custom_currency_rate

double

Tỷ giá tiền tệ tùy chỉnh (nếu được chỉ định)
(chỉ khi status = success, in_hold hoặc hold_approved)

custom_currency_sum

double

Số tiền người dùng gửi bằng loại tiền tệ 'custom_currency'
(chỉ khi status = success, in_hold hoặc hold_approved)

reason

string

Lý do trạng thái không thành công:
1. 'timeout' - thời gian chọn giao diện đã hết hạn
2. 'trade_timeout' - thời gian chấp nhận giao dịch trên Steam đã hết hạn
3. 'trade_canceled' - giao dịch đã bị hủy trên Steam

(chỉ khi status = fail)

user_risk.total_deposits_count

int

Tổng số tiền gửi của người dùng trong toàn bộ thời gian trên tất cả các dự án.
(chỉ khi status = in_hold)

user_risk.total_deposits_sum

float

Tổng số tiền gửi của người dùng trong toàn bộ thời gian trên tất cả các dự án.
(chỉ khi status = in_hold)

user_risk.total_rollback_deposits_count

int

Số tiền gửi bị hoàn trả, trong đó người dùng nhận thanh toán trước từ các dự án.
(chỉ khi status = in_hold)

user_risk.total_rollback_deposits_sum

float

Tổng số tiền gửi bị hoàn trả, trong đó người dùng nhận thanh toán trước từ các dự án.
(chỉ khi status = in_hold)

user_risk.joined_at

datetime

Ngày đăng ký của người dùng
(chỉ khi status = in_hold)

user_risk.last_deposit_at

datetime

Ngày gửi tiền gần nhất
(chỉ khi status = in_hold)

user_risk.user_inventory

array

Giá trị kho đồ của người dùng
(chỉ khi status = in_hold)

user_risk.user_inventory[].last_updated_at

datetime

Ngày cập nhật kho đồ gần nhất của người dùng cho một trò chơi cụ thể
(chỉ khi status = in_hold)

user_risk.user_inventory[].sum

float

Tổng giá trị kho đồ của người dùng bằng USD
(chỉ khi status = in_hold)