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
Sprawdzanie statusu depozytu
Metoda ta służy do uzyskania informacji o utworzonym złożu.
Niebieski podświetla wymagane parametry.
Wyślij żądanie POST do API Endpoint z następującymi parametrami:
method
string
orderstatus
transaction_id
string
Transaction ID w naszym systemie
- LUB -
order_id
string
Unikalny ID depozytu w Twoim systemie
Odpowiedź z serwera:
Jeśli się powiedzie, odpowiedź z serwera będzie zawierać obiekt JSON o następującej treści:
status
string
success - płatność udana, pending - oczekiwanie, fail - niepowodzenie, in_hold - depozyt wstrzymany
Depozyt ze statusem in_hold może przejść do statusu success lub fail.
Tylko dla depozytów bez 8-dniowego oczekiwania: hold_approved - wstrzymany depozyt został zatwierdzony, hold_returned - anulowano zatwierdzony wstrzymany depozyt. Więcej szczegółów...
Depozyt ze statusem in_hold może przejść do statusu success lub fail.
Tylko dla depozytów bez 8-dniowego oczekiwania: hold_approved - wstrzymany depozyt został zatwierdzony, hold_returned - anulowano zatwierdzony wstrzymany depozyt. Więcej szczegółów...
transaction_id
string
Transaction ID w naszym systemie
order_id
string
Unikalny ID depozytu w Twoim systemie
steam_id
string
ID użytkownika Steam
date
int
Czas utworzenia depozytu UNIX
amount
double
Kwota, którą użytkownik zdeponował w walucie 'currency'
(tylko gdy status = success, in_hold lub hold_approved)
(tylko gdy status = success, in_hold lub hold_approved)
amount_currency
string
Waluta płatności
(tylko gdy status = success, in_hold lub hold_approved)
(tylko gdy status = success, in_hold lub hold_approved)
amount_in_currencies
object
Kwota wpłaty we wszystkich dostępnych walutach
(tylko gdy status = success, in_hold lub hold_approved)
(tylko gdy status = success, in_hold lub hold_approved)
user_amount
double
Kwota z mnożnikiem z ustawień projektu, która została wniesiona przez użytkownika w walucie
(tylko gdy status = success, in_hold lub hold_approved)
(tylko gdy status = success, in_hold lub hold_approved)
user_amount_in_currencies
object
Kwota wraz z mnożnikiem z ustawień projektu, którą wprowadził użytkownik, we wszystkich dostępnych walutach
(tylko gdy status = success, in_hold lub hold_approved)
(tylko gdy status = success, in_hold lub hold_approved)
offer_date
int
Czas utworzenia oferty wymiany skinami w systemie UNIX
dla użytkownika (może brakować)
dla użytkownika (może brakować)
in_hold_until
int
Czas, do którego depozyt jest wstrzymany w systemie UNIX (może brakować)
trade_offer_id
string
Trade Offer ID na Steam (może brakować)
skins_send_date
int
Czas transferu skinów UNIX (może brakować)
(tylko gdy status = success, in_hold lub hold_approved)
(tylko gdy status = success, in_hold lub hold_approved)
custom_currency
string
Nazwa waluty niestandardowej (jeśli została podana)
(tylko gdy status = success, in_hold lub hold_approved)
(tylko gdy status = success, in_hold lub hold_approved)
custom_currency_rate
double
Niestandardowy kurs waluty (jeśli został określony)
(tylko gdy status = success, in_hold lub hold_approved)
(tylko gdy status = success, in_hold lub hold_approved)
custom_currency_sum
double
Kwota, którą użytkownik zdeponował w walucie 'custom_currency'
(tylko gdy status = success, in_hold lub hold_approved)
(tylko gdy status = success, in_hold lub hold_approved)
reason
string
Powód statusu niepowodzenia:
1. 'timeout' - czas na wybór skórek upłynął
2. 'trade_timeout' - upłynął czas akceptowania transakcji na Steam
3. 'trade_canceled' - transakcja została anulowana na Steam
(tylko ze status = fail)
1. 'timeout' - czas na wybór skórek upłynął
2. 'trade_timeout' - upłynął czas akceptowania transakcji na Steam
3. 'trade_canceled' - transakcja została anulowana na Steam
(tylko ze status = fail)
Lista możliwych błędów:
1
order_id_or_transaction_id_missing
brakuje order_id i transaction_id
2
invalid_order_id
brakuje order_id
3
invalid_transaction_id
Brakujący lub nieprawidłowy transaction_id
4
transaction_not_found
Nie znaleziono depozytu
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