Ereignisse in Echtzeit: Webhook

Merchant API v2

Overview

Hauptseite

Hauptinformationen Generierung der Unterschrift

Einzahlungen

Erste Schritte Depot erstellen Depot erstellen ohne Weiterleitung (iframe) Benachrichtigung über Einzahlung (webhook) Überprüfung des Einzahlungsstatus Abrufen der Liste der Einlagen Einzahlungen ohne 8-tägige Wartezeit (Steam Trade Protection) Einzahlungsgenehmigung mit 8-tägigem Hold Benachrichtigungen zu fehlgeschlagenen Webhooks erhalten

Einzahlungen ohne SkinsBack UI

Create a deposit without SkinsBack UI (API) Inventar des Benutzers abrufen

Skin-Abhebung

Preisliste (Skin-Verfügbarkeit) Skin-Suche Skin kaufen Skins in großen Mengen kaufen Status des Skin-Kaufs Kaufverlauf für Skins Skin-Kauf stornieren

Sonstiges

Projektsaldo Auszahlungs- und Einzahlungshistorie Währungen und Wechselkurse Serverstatus Ereignisse in Echtzeit: Websockets Ereignisse in Echtzeit: Webhook

Ereignisse in Echtzeit: Webhook

Erhalten Sie Echtzeit-Änderungen für gekaufte Skins und Guthabenänderungen.

Erzeugen einer Ereignis-Rückrufsignatur

Die Signatur wird aus dem Request Body gebildet und in SHA256 HMAC konvertiert und mit Client Secret signiert. Die Signatur wird im Authorization-Header gesendet. Sie können das Client Secret im Konto des Händlers herausfinden.

Beispiel für Signaturvalidierung 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');
}

Von der POST-Methode an die Webhook-Ereignis-URL gesendete Parameter:

event

string

Name des Ereignisses

data

array

Daten

An die Webhook-Ereignis-URL gesendete Header:

Signature

string

Zu überprüfende Signatur. Verwenden Sie die Signaturüberprüfungsmethode, um die Signatur der Anfrage zu überprüfen.

ODER Sie können den an Ihren Server gesendeten X-SIGN-Header mit dem folgenden Algorithmus überprüfen:
md5(clientId + clientSecret) (Verkettung).

Liste der möglichen Ereignisse

event

Daten

Beschreibung

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

Skin-Kauf

status_change

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

Status des Skin-Kaufs geändert

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

Projektguthaben geändert