Real-time обновления: WebHooks

Главное

Основная информация Генерация подписи

Депозиты

Начало работы Создание депозита Создание депозита без переадресации (iframe) Уведомление о депозите (webhook) Проверка статуса депозита Получение списка депозитов Депозиты без 8 дневного ожидания (Steam Trade Protection) Одобрение депозита с 8 дневным холдом Недошедшие уведомления о платежах

Депозиты без SkinsBack UI

Создание депозита без SkinsBack UI (API) Получить инвентарь пользователя

Вывод скинов

Прайс-лист (наличие скинов) Поиск скинов Купить скин Массовая покупка скинов Статус покупки скина История покупок скинов

Другое

Баланс проекта История выводов с баланса и депозитов Валюты и курсы Статус сервера Real-time обновления: WebSockets Real-time обновления: WebHooks

Real-time обновления: WebHooks

Получение real-time изменений по приобретенным скинам и изменению баланса.

Создание подписи Webhook уведомлений о событиях

Подпись формируется из тела запроса и преобразуется в SHA256 HMAC с подписью Client Secret. Подпись отправляется в заголовке Authorization. Узнать Client Secret можно в кабинете мерчанта.

Пример сверки подписи на 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');
}

Параметры, отправляемые методом POST на URL Webhook событий:

event

string

Название события

data

array

Данные

Заголовки, отправляемые на URL Webhook событий:

Signature

string

Подпись для сверки. Используйте метод проверки подписи для проверки подписи запроса.

ИЛИ вы можете сверить заголовок X-SIGN, отправляемый на ваш сервер по алгоритму:
md5(clientId + clientSecret) (конкатенация).

Список возможных событий

event

Данные

Описание

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

Покупка скина

status_change

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

Статус покупки скина изменился

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

Баланс проекта изменился