Deposit notification (webhook)

General

General Information Generate a signature

Deposits

Getting started Create a deposit Create a deposit without redirection (iframe) Deposit notification (webhook) Check an deposit status Get a list of deposits Deposits without 8-day waiting period (Steam Trade Protection) Deposit approval with 8-day hold Get failed webhook notifications

Deposits without SkinsBack UI

Create a deposit without SkinsBack UI (API) Get user's inventory

Skins Withdraw

Skins price list Skins search Buy skin Bulk buy skins Get skin purchase info Skin purchase history

Other

Get the project balance Get the history of withdrawals and deposits of money Get currencies and rates Server status Events real-time: websockets Events real-time: webhooks

Deposit notification (webhook)

Unlike conventional payment systems, SkinsBack does not accept specific refill amounts. The refill amount is sent to Result URL (webhook) after we receive the game items.

Parameters sent by the POST method to Result URL:

sign

string

Signature to verify. Use the signature verification method to verify the signature of the request.

OR you can verify the X-SIGN header sent to your server using the algorithm:
md5(clientId + clientSecret) (concatenation).

status

string

success - payment successful, pending - waiting, fail - failed, in_hold - deposit on hold

A deposit with in_hold status can transition to either success or fail status.

Only for deposits without 8-day waiting period: hold_approved - on-hold deposit was approved, hold_returned - canceled approved on-hold deposit. More details...

transaction_id

string

Transaction ID in our system

order_id

string

Unique Order ID in your system

steam_id

string

User's Steam ID

date

int

Deposit creation date (UNIX time)

amount

double

The amount that the user deposited in the currency 'currency'
(only when status = success, in_hold or hold_approved)

amount_currency

string

Payment currency
(only when status = success, in_hold or hold_approved)

amount_in_currencies

object

Refill amount in all available currencies
(only when status = success, in_hold or hold_approved)

user_amount

double

The amount that the user deposited multiplied by the value from the project settings
(only when status = success, in_hold or hold_approved)

user_amount_in_currencies

object

The amount that the user deposited multiplied by the value from the project settings in all available currencies
(only when status = success, in_hold or hold_approved)

offer_date

int

Trade offer creation date (UNIX)
(may be missing)

in_hold_until

int

In hold until (UNIX time)
(may be missing, only for deposits with 8-day waiting period)

trade_offer_id

string

Trade Offer ID on Steam (may be missing)

skins_send_date

int

Trade Offer accept UNIX time (may be missing)
(only when status = success, in_hold or hold_approved)

custom_currency

string

Custom currency name (if specified)
(only when status = success, in_hold or hold_approved)

custom_currency_rate

double

Custom currency rate (if specified)
(only when status = success, in_hold or hold_approved)

custom_currency_sum

double

The amount that the user deposited in the currency 'custom_currency'
(only when status = success, in_hold or hold_approved)

reason

string

Reason for fail status:
1. 'timeout' - time to select skins has expired
2. 'trade_timeout' - time to accept trade on Steam has expired
3. 'trade_canceled' - trade has been cancelled on Steam

(only if status = fail)

user_risk.total_deposits_count

int

Total number of user deposits across all projects for entire period.
(only when status = in_hold)

user_risk.total_deposits_sum

float

Total sum of user deposits across all projects for entire period.
(only when status = in_hold)

user_risk.total_rollback_deposits_count

int

Number of rollback deposits where user received advance payments from projects.
(only when status = in_hold)

user_risk.total_rollback_deposits_sum

float

Sum of rollback deposits where user received advance payments from projects.
(only when status = in_hold)

user_risk.joined_at

datetime

User registration date
(only when status = in_hold)

user_risk.last_deposit_at

datetime

Date of last deposit
(only when status = in_hold)

user_risk.user_inventory

array

User inventory value
(only when status = in_hold)

user_risk.user_inventory[].last_updated_at

datetime

Last inventory update date for specific game
(only when status = in_hold)

user_risk.user_inventory[].sum

float

User inventory sum in USD
(only when status = in_hold)