API

Im Gegensatz zu herkömmlichen Zahlungssystemen akzeptiert SkinsBack keinen festen Einzahlungsbetrag. Der Einzahlungsbetrag wird an die Result URL (webhook) gesendet, nachdem uns die In-Game-Gegenstände übergeben wurden.

Die Antwort auf diese Methode enthält die URL, auf die der Benutzer weitergeleitet werden muss (dies ist die Zahlungsseite).

Die Parameter 'min_amount' und/oder 'max_amount' sind nur für die Erstellung von Limited-Einzahlungen erforderlich. In diesem Fall muss auch der Parameter 'currency' angegeben werden. Wenn 'min_amount' kleiner als der Mindestbetrag für das Spiel ist, wird der Mindestbetrag für das Spiel verwendet.

Blaue markiert obligatorische Parameter.

Senden Sie eine POST-Anfrage an den API-Endpunkt mit den folgenden Parametern:

Antwort vom Server:

Bei Erfolg enthält die Antwort vom Server ein JSON-Objekt mit folgendem Inhalt:

Beispiel für eine erfolgreiche Antwort:

{
    "status": "success",
    "url": "https://skinsback.com/_/pay/9421749033d9d3f725c67572575975de/",
    "transaction_id": 13
}

Liste möglicher Fehler:

Beispiel einer fehlerhaften Antwort:

{
    "status": "error",
    "error_code": 1,
    "error_message": "invalid_order_id"
}

Beispiel für eine Anfrage mit Autorisierungsheadern in PHP:

<?php
$params = array(
	'method' => 'create',
	'order_id' => 1,
	'steam_id' => '76561198827262007',
	'trade_token' => 'i1ArBZey',
	'currency' => 'usd'
);
$clientId = '12312312323123';
$clientSecret = '123123123123213';

$headers = [
    'X-CLIENT-ID: ' . $clientId,
    'X-CLIENT-SECRET: ' . $clientSecret,
];

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL,"https://skinsback.com/api.php");
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($params));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
$server_output = curl_exec($ch);
curl_close ($ch);
var_dump($server_output);

Beispielanfrage mit Signatur in PHP:

<?php
$params = array(
	'shopid' => '1', // Client ID
    'method' => 'create',
	'order_id' => 1,
	'steam_id' => '76561198827262007',
	'trade_token' => 'i1ArBZey',
	'currency' => 'usd'
);
$clientSecret = '123123123123213';
// @see https://skinsback.com/de/docs/api/v1/signature/
$params['sign'] = buildSignature($params, $clientSecret);

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL,"https://skinsback.com/api.php");
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($params));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$server_output = curl_exec($ch);
curl_close ($ch);
var_dump($server_output);