Skin satın alımını iptal et

Merchant API v2

Overview

Ana Sayfa

Temel Bilgiler İmza Oluşturma

Depozitler

Başlarken Depozito Oluşturma Depozito Oluşturma (iframe ile yönlendirme olmadan) Depozito Bildirimi (webhook) Depozito Durumu Kontrolü Depozito Listesi Alma 8 gün beklemesiz yatırımlar (Steam Trade Protection) 8 günlük bekletme ile yatırım onayı Başarısız web kancası bildirimleri alın

SkinsBack kullanıcı arayüzü olmadan para yatırma

Create a deposit without SkinsBack UI (API) Kullanıcının envanterini al

Skin çekme

Fiyat listesi (skin mevcudu) Skin arama Skin satın alma Toplu satın alma skinleri Skin satın alma durumu Skin satın alma geçmişi Skin satın alımını iptal et

Diğer

Proje Bakiyesi Bakiye ve Depozito Çekme Geçmişi Para birimleri ve döviz kurları Sunucu durumu Gerçek zamanlı olaylar: websockets Gerçek zamanlı olaylar: web kancaları

Skin satın alımını iptal et

Bu yöntem, trade oluşturulmasını bekleyen P2P skinler için iptal isteği gönderir. İptal istekleri yalnızca satın alma oluşturulduktan 30 dakika sonra kullanılabilir.

Mavi zorunlu parametreleri vurgulanmıştır.

Aşağıdaki parametreleri içeren POST isteği gönderin: API Endpoint

method

string

market_cancel

custom_ids

array

sisteminizdeki 'custom_id' dizisi. Bu parametre belirtilirse, her bir satın alma hakkında bilgi içeren bir öğeler dizisi olan öğeler dizisi yanıtında olacaktır

Sunucudan gelen yanıt:

Başarılı olursa, sunucudan gelen yanıtta aşağıdaki JSON nesnesi olacaktır:

items

array

Aşağıda açıklanan öğelerin bir dizisi

unavailable

object

Karma bir istekte bu nesne, henüz iptal edilemeyen satın almaların custom_id ve hata bilgisini içerir. error_details.available_at iptal zamanını UNIX timestamp olarak içerir.

'items' nesnesi

item

object

Satın alınan skin hakkında bilgi içeren bir nesne

— item.id

int

Skin ID

— item.name

string

Skin Adı

— item.price

float

Skinin USD fiyatı

— item.delivery_type

int

Teslimat türü: 1 = Instant, 2 = Slow

— item.classid

string

Skinin Sınıf ID'si

buy_id

int

Skin satın alma ID'si

offer_status

string

Satın alma durumu:
1. 'creating_trade' — ticaret oluşturuluyor
2. 'waiting_accept' — ticaret kabul edilmesi bekleniyor
3. 'accepted' — ticaret kabul edildi
4. 'canceled' — ticaret kullanıcı tarafından iptal edildi
5. 'timeout' — ticaret 10 dakika içinde kabul edilmedi
6. 'invalid_trade_token' — geçersiz ticaret token'i
7. 'user_not_tradable' — kullanıcının ticaret sisteminde kısıtlamaları var
8. 'trade_create_error' — ticaret oluşturma hatası (yeniden deneyin)
9. 'rollback_user' — skin kullanıcı tarafından iade edildi (Steam Trade Protection)
10. 'rollback_supplier' — skin tedarikçi tarafından iade edildi (Steam Trade Protection)

in_hold

bool

Skin beklemede mi

in_hold_until

string (datetime)

Bekletilen skinin son kullanma tarihi

error_reason

string

Neden (eğer mevcutsa):
1. 'user_cant_trade' - kullanıcının Steam'de ticaret yapma konusunda kısıtlaması var
2. 'private_inventory' - kullanıcının envanteri açması gerekiyor
3. 'user_trade_ban' - kullanıcının Ticaret Yasağı var
4. 'user_inventory_is_full' - kullanıcının envanteri dolu
5. 'too_many_failed_attempts' - kullanıcı için çok fazla başarısız para çekme girişimi
6. 'skin_unavailable' - satın alınamayan (veya satılamayan) bir cilt
7. 'p2p_purchase_canceled_by_user' - P2P satın alma kullanıcı tarafından iptal edildi
8. 'p2p_purchase_canceled_by_system' - P2P satın alma sistem tarafından otomatik olarak iptal edildi

steamid

string

Steam ID kullanıcısı

date

int

Satın Alma Tarihi (UNIX zamanı)

balance_debited_sum

float

Projeden düşülen miktar (USD)

tradeofferid

string

Steam'deki Ticaret Teklif ID'si (sadece ticaret oluşturulduysa mevcut)

custom_id

string

Sistemdeki 'custom_id'

refund_percent @deprecated

int

Kullanıcı hatasından kaynaklanan geri alma işlemleri için iade yüzdesi. Kullanımdan kalktı: refund_amount kullanın

refund_amount

string|null

Geri alma işlemindeki gerçek iade tutarı

Başarılı yanıt örneği:

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

Mümkün olan hataların listesi:

missing_one_of_required_params

Geçerli custom_ids yok veya satın alımlar iptal için uygun değil

cancel_request_too_early

İptal isteği yalnızca satın alma oluşturulduktan 30 dakika sonra kullanılabilir

-6

market_disabled

Pazar kapalı

standart hatalar:

-1

please_use_post_method

POST yöntemi kullanılmalıdır

-2

invalid_shopid

Proje kimliği sistemde bulunamadı

-3

invalid_signature

Geçersiz imza

-4

shop_not_active

Proje etkin değil

-5

invalid_method

Geçersiz API yöntemi

-7

request_limit_reached

İstek sınırı aşıldı (500/dakika)

-8

invalid_ip_address

Proje ayarlarında IP adresini belirtin

-9

under_maintenance

Site bakımda

-10

invalid_client_secret

Geçersiz X-CLIENT-SECRET başlığı