Pomoc Kontakty
plPL
ENEN DEDE ESES PLPL PT-BRPT-BR PT-PTPT-PT RURU TRTR VIVI ZH-CNZH-CN
Połącz witrynę
Pomoc Kontakty

API

Główny
Podstawowe informacje Generowanie podpisu
Depozyty
Pierwsze kroki Tworzenie depozytu Tworzenie depozytu bez przekierowania (iframe) Powiadomienie o wpłacie (webhook) Sprawdzanie statusu depozytu Uzyskanie listy depozytów Depozyty bez 8-dniowego oczekiwania (Steam Trade Protection) Zatwierdzenie depozytu z 8-dniowym holdem Otrzymuj powiadomienia o nieudanych webhookach
Depozyty bez interfejsu użytkownika SkinsBack
Create a deposit without SkinsBack UI (API) Pobierz ekwipunek użytkownika
Wyjście skinów
Cennik (dostępność skinów) Wyszukaj skinów Kup skiny Kupuj skórki hurtowo Stan zakupu skina Historia zakupów skinów
Inny
Bilans projektu Historia wypłat z salda i depozytów Waluty i kursy Status serwera Zdarzenia w czasie rzeczywistym: websockets Zdarzenia w czasie rzeczywistym: webhooki

Tworzenie depozytu

W przeciwieństwie do klasycznych systemów płatności, SkinsBack nie akceptuje określonej kwoty do uzupełnienia. Kwota doładowania jest wysyłana na Result URL (webhook) po przesłaniu do nas elementów gry.

Odpowiedź tej metody będzie zawierała adres URL, na który należy przekierować użytkownika (jest to strona płatności).

Parametry 'min_amount' i/lub 'max_amount' są wymagane do wykorzystania wyłącznie przy tworzeniu depozytów Limited. Wówczas konieczne jest także określenie parametru 'currency'. Jeśli wartość 'min_amount' jest mniejsza niż minimalna kwota rozdania w grze, zostanie zastosowana minimalna kwota rozdania w grze.

Niebieski podświetla wymagane parametry.

Wyślij żądanie POST do API Endpoint z następującymi parametrami:

method
string
create
order_id
string
Unikalny ID depozytu w Twoim systemie
steam_id
string
Domyślny ID użytkownika Steam. Użytkownik może zmienić konto w trakcie doładowania.
trade_token
string
'token' z Trade URL użytkownika (8 znaków)
currency
string
Waluta (opcjonalnie)
result_url
string
Opcjonalny Result URL, który będzie używany
zamiast tego określonego w ustawieniach projektu
fail_url
string
Opcjonalny Fail URL
success_url
string
Opcjonalny Success URL
min_amount
double
Minimalna kwota uzupełnienia.
Używane wyłącznie z 'currency'
max_amount
double
Maksymalna kwota uzupełnienia. Musi być większa niż 'min_amount'.
Używane wyłącznie z 'currency'
widget
bool
Jeśli wartość wynosi 1, odpowiedź z serwera będzie zawierać adres URL, który ma wyświetlić interfejs uzupełniania wewnątrz Twojej witryny (iframe). Więcej szczegółów w uzupełnieniu bezpośrednio na stronie
game
string
Gra otwierana domyślnie podczas ładowania inwentarza w formularzu płatności ('cs2', 'dota2', 'rust')
custom_multiplier
double
Mnożnik ceny niestandardowej (zastępuje wartość z ustawień projektu). Wartość minimalna: 0.5, maks.: 2
custom_currency
string
Waluta niestandardowa (wymagana z custom_currency_rate). Możesz przekazać nazwę waluty niestandardowej i określić jej kurs. Ceny skórek będą wyświetlane w tej walucie. Maksymalnie 4 znaki.
custom_currency_rate
double
Kurs dowolnej waluty (wymagany z custom_currency). Wartość minimalna: 0,1

Odpowiedź z serwera:

Jeśli się powiedzie, odpowiedź z serwera będzie zawierać obiekt JSON o następującej treści:

url
string
URL, na który użytkownik powinien zostać przekierowany
transaction_id
int
Transaction ID w naszym systemie

Przykład udanej odpowiedzi:

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

Lista możliwych błędów:

1
invalid_order_id
Wartość order_id została przekazana nieprawidłowo
2
invalid_steam_id
Nieprawidłowy steam_id. Przykład Steam ID: 76561198827262007
5
order_id_already_exists
Podany order_id został już użyty do utworzenia depozytu
7
invalid_max_value
Maksymalna kwota uzupełnienia powinna być większa niż 'min_value' i minimalna suma transakcji w grze
8
invalid_currency
Podano nieprawidłową walutę
9
invalid_result_url
Podano nieprawidłowy adres URL
10
invalid_success_url
Nieprawidłowy adres URL sukcesu
11
invalid_fail_url
Nieprawidłowy adres URL niepowodzenia
12
invalid_custom_currency
Nieprawidłowa waluta niestandardowa
13
invalid_custom_currency_rate
Określono nieprawidłowy niestandardowy kurs waluty
14
invalid_custom_multiplier
Określono nieprawidłowy mnożnik niestandardowy
15
invalid_game
Określono nieprawidłową grę
standardowe błędy:
-1
please_use_post_method
Musisz użyć metody POST
-2
invalid_shopid
W systemie nie znaleziono identyfikatora projektu
-3
invalid_signature
Błędnie złożony podpis
-4
shop_not_active
Projekt jest nieaktywny
-5
invalid_method
Nieprawidłowa metoda API
-7
request_limit_reached
Przekroczono limit żądań (500/minutę)
-8
invalid_ip_address
Określ adres IP w ustawieniach projektu
-9
under_maintenance
Witryna w trakcie prac konserwacyjnych
-10
invalid_client_secret
Nieprawidłowy nagłówek X-CLIENT-SECRET

Przykład odpowiedzi z błędem:

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

Przykład żądania z nagłówkami autoryzacji w 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);

Przykład podpisanego żądania w 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/pl/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);
© 2025 SkinsBack. All right reserved.
Pomoc Kontakty Oferta