Events real-time: webhooks

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

Events real-time: webhooks

Getting real-time changes for purchased skins and balance changes.

Generate a events webhook signature

The signature is formed from request body and converting it to SHA256 HMAC signed with Client Secret. Signature sent in Authorization header. You can find out the Client Secret in the merchant's account.

Signature validation example in PHP:

<?php

$clientSecret = '123'; // Client Secret

$requestContent = file_get_contents('php://input');
$expectedSignature = hash_hmac('sha256', $requestContent, $clientSecret);
$providedSignature = $_SERVER['HTTP_SIGNATURE'] ?? '';

if (!hash_equals($expectedSignature,$providedSignature)) {
    die('Wrong signature');
}

Parameters sent by the POST method to Webhook Events URL:

event

string

Event name

data

array

Data

Headers sent to Webhook Events URL:

Signature

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).

List of possible events

event

Data

Description

buy_item

{
   "event":"buy_item",
   "data":{
	  "item":{
		 "id":"2516",
		 "name":"AK-47 | Safari Mesh (Minimal Wear)",
		 "price":"0.4",
		 "classid":"3940562910"
	  },
	  "buy_id":"65",
	  "offer_status":"creating_trade",
	  "balance_debited_sum":"29.93",
	  "custom_id": "123456"
   }
}

Buying a skin

status_change

{
   "event":"status_change",
   "data":{
      "item":{
         "id":"2516"
      },
      "buy_id":"65",
      "offer_status":"waiting_accept",
      "error_reason":null,
      "tradeofferid":"4176876858",
      "custom_id": "123456"
   }
}

Skin purchase status has changed

balance_change

{
   "event":"buy_item",
   "data":{
	  "item":{
		 "id":"2516",
		 "name":"AK-47 | Safari Mesh (Minimal Wear)",
		 "price":"0.4",
		 "classid":"3940562910"
	  },
	  "buy_id":"65",
	  "offer_status":"creating_trade",
	  "balance_debited_sum":"29.93",
	  "custom_id": "123456"
   }
}

Project balance has changed