Skin-Kauf stornieren

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

Skin-Kauf stornieren

Diese Methode sendet eine Stornierungsanfrage für P2P-Skins, die auf die Erstellung eines Trades warten. Stornierungsanfragen sind erst 30 Minuten nach Erstellung des Kaufs verfügbar.

Blaue markiert obligatorische Parameter.

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

method

string

market_cancel

custom_ids

array

Array von 'custom_id' aus Ihrem System. Wenn dieser Parameter angegeben ist, wird im Antwort-Array ein 'items'-Array enthalten sein, das Informationen zu jedem Kauf enthält

Antwort vom Server:

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

items

array

Array mit den unten beschriebenen Elementen

unavailable

object

Bei einer gemischten Anfrage enthält dieses Objekt die custom_id und den Fehler für Käufe, die noch nicht storniert werden können. error_details.available_at enthält den Zeitpunkt der möglichen Stornierung.

Objekt 'items'

item

object

Objekt, das Informationen über den gekauften Skin enthält

— item.id

int

Skin-ID

— item.name

string

Skin-Name

— item.price

float

Skin-Preis in USD

— item.delivery_type

int

Lieferart: 1 = Instant, 2 = Slow

— item.classid

string

Class ID des Skins

buy_id

int

ID der Skin-Kauf

offer_status

string

Kaufstatus:
1. 'creating_trade' — Handel wird erstellt
2. 'waiting_accept' — Handel wartet auf Annahme
3. 'accepted' — Handel angenommen
4. 'canceled' — Handel vom Benutzer abgelehnt
5. 'timeout' — Handel nicht innerhalb von 10 Minuten angenommen
6. 'invalid_trade_token' — ungültiges Handelstoken
7. 'user_not_tradable' — Benutzer hat Einschränkungen im Handelssystem
8. 'trade_create_error' — Fehler beim Erstellen des Handels (bitte erneut versuchen)
9. 'rollback_user' — Skin wurde vom Benutzer zurückgegeben (Steam Trade Protection)
10. 'rollback_supplier' — Skin wurde vom Lieferanten zurückgegeben (Steam Trade Protection)

in_hold

bool

Ob der Skin in Hold ist oder nicht

in_hold_until

string (datetime)

Datum, bis zu dem der Skin in Hold ist (wenn der Skin in Hold ist)

error_reason

string

Grund (falls vorhanden):
1. 'user_cant_trade' – für den Benutzer besteht eine Handelsbeschränkung bei Steam
2. 'private_inventory' – Benutzer muss Inventar öffnen
3. 'user_trade_ban' – Benutzer hat Handelsverbot
4. 'user_inventory_is_full' – das Inventar des Benutzers ist voll
5. 'too_many_failed_attempts' - zu viele fehlgeschlagene Auszahlungsversuche für den Benutzer
6. 'skin_unavailable' – Skin nicht käuflich (oder verkauft)
7. 'p2p_purchase_canceled_by_user' – P2P-Kauf wurde vom Benutzer storniert
8. 'p2p_purchase_canceled_by_system' – P2P-Kauf wurde automatisch vom System storniert

steamid

string

Steam ID des Benutzers

date

int

Kaufdatum (UNIX-Zeit)

balance_debited_sum

float

Betrag, der vom Projekt-Guthaben abgezogen wurde (USD)

tradeofferid

string

Trade Offer ID in Steam (nur vorhanden, wenn ein Handel erstellt wurde)

custom_id

string

'custom_id' in Ihrem System

refund_percent @deprecated

int

Rücklaufquote für Rollbacks aufgrund von Benutzerfehlern. Veraltet: refund_amount verwenden

refund_amount

string|null

Tatsächlicher Erstattungsbetrag bei Rollback

Beispiel für eine erfolgreiche Antwort:

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

Liste möglicher Fehler:

missing_one_of_required_params

Gültige custom_ids fehlen oder Käufe können nicht storniert werden

cancel_request_too_early

Stornierungsanfragen sind erst 30 Minuten nach Erstellung des Kaufs verfügbar

-6

market_disabled

Markt deaktiviert

Standardfehler:

-1

please_use_post_method

Es muss die POST-Methode verwendet werden

-2

invalid_shopid

Projekt-ID wurde nicht im System gefunden

-3

invalid_signature

Ungültige Signatur

-4

shop_not_active

Projekt ist inaktiv

-5

invalid_method

Ungültige API-Methode

-7

request_limit_reached

Anfrage-Limit überschritten (500/Minute)

-8

invalid_ip_address

Geben Sie die IP-Adresse in den Projekteinstellungen an

-9

under_maintenance

Website in Wartung

-10

invalid_client_secret

Ungültiger X-CLIENT-SECRET-Header