Anuluj zakup skina

Merchant API v2

Overview

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 Anuluj zakup skina

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

Anuluj zakup skina

Ta metoda wysyła żądanie anulowania dla skinów P2P, które oczekują na utworzenie trade. Żądania anulowania są dostępne dopiero 30 minut po utworzeniu zakupu.

Niebieski podświetla wymagane parametry.

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

method

string

market_cancel

custom_ids

array

tablicę 'custom_id' z twojego systemu. Jeśli ten parametr zostanie określony, odpowiedź będzie zawierać tablicę items zawierającą informacje o każdym zakupie

Odpowiedź z serwera:

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

items

array

Tablica elementów opisanych poniżej

unavailable

object

W przypadku mieszanego żądania ten obiekt zawiera custom_id i błąd zakupów, których nie można jeszcze anulować. error_details.available_at zawiera czas anulowania jako znacznik UNIX.

obiekt 'items'

item

object

Obiekt zawierający informację o zakupionej skina

— item.id

int

ID skina

— item.name

string

Nazwa skina

— item.price

float

Cena skina w USD

— item.delivery_type

int

Typ dostawy: 1 = Instant, 2 = Slow

— item.classid

string

Class ID skina

buy_id

int

ID zakupu skina

offer_status

string

Status zakupu:
1. 'creating_trade' - trwa tworzenie giełdy
2. 'waiting_accept' - wymiana oczekuje na akceptację
3. 'accepted' - wymiana zaakceptowana
4. 'canceled' - wymiana odrzucona przez użytkownika
5. 'timeout' - wymiana nie została przyjęta w ciągu 10 minut
6. 'invalid_trade_token' - nieprawidłowy trade token
7. 'user_not_tradable' - użytkownik ma ograniczenia w systemie giełdowym
8. 'trade_create_error' - błąd podczas tworzenia giełdy (spróbuj ponownie)
9. 'rollback_user' — skin został zwrócony przez użytkownika (Ochrona Transakcji Steam)
10. 'rollback_supplier' — skin został zwrócony przez dostawcę (Ochrona Transakcji Steam)

in_hold

bool

Czy skina jest w holdzie

in_hold_until

string (datetime)

Data, do której skina będzie w holdzie (jeśli jest w holdzie)

error_reason

string

Powód (jeśli występuje):
1. 'user_cant_trade' - użytkownik ma ograniczenia w handlu na Steam
2. 'private_inventory' - użytkownik musi otworzyć inwentarz
3. 'user_trade_ban' - użytkownik ma zakaz handlu
4. 'user_inventory_is_full' - ekwipunek użytkownika jest pełny
5. 'too_many_failed_attempts' - zbyt wiele nieudanych prób wypłaty środków przez użytkownika
6. 'skin_unavailable' - skórka niedostępna do kupienia (lub sprzedaży)
7. 'p2p_purchase_canceled_by_user' - zakup P2P został anulowany przez użytkownika
8. 'p2p_purchase_canceled_by_system' - zakup P2P został automatycznie anulowany przez system

steamid

string

ID użytkownika Steam

date

int

Data zakupu (czas UNIX)

balance_debited_sum

float

Kwota odpisana z salda projektu (USD)

tradeofferid

string

Trade Offer ID na Steam (dostępny tylko jeśli utworzono giełdę)

custom_id

string

'custom_id' w twoim systemie

refund_percent @deprecated

int

Procent zwrotu dla wycofań spowodowanych błędem użytkownika. Przestarzałe: użyj refund_amount

refund_amount

string|null

Rzeczywista kwota zwrotu przy wycofaniu

Przykład udanej odpowiedzi:

{
    "status": "success",
    "items": [
        {
            "id": "2715",
            "name": "SSG 08 | Fever Dream (Field-Tested)",
            "price": "77.02",
            "classid": "3770669160",
            "buy_id": "50123",
            "offer_status": "creating_trade",
            "in_hold": false,
            "in_hold_until": null,
            "error_reason": null,
            "steamid": "76561190000000000",
            "date": "1719825675",
            "balance_debited_sum": "77.02",
            "tradeofferid": null,
            "custom_id": "project-order-1"
        }
    ]
}

Lista możliwych błędów:

missing_one_of_required_params

Brak prawidłowych custom_ids lub zakupów nie można anulować

cancel_request_too_early

Żądanie anulowania jest dostępne dopiero 30 minut po utworzeniu zakupu

-6

market_disabled

Rynek jest wyłączony

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