Skin satın alma durumu

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 alma durumu

Satın alınan skin hakkında bilgi. Bu yöntem, Steam Trade Offer ID'sini öğrenmenizi ve öğenin kullanıcı tarafından kabul edilip edilmediğini kontrol etmenizi sağlar.

Mavi zorunlu parametreleri vurgulanmıştır.

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

method

string

market_getinfo

buy_id

int

'market_buy' yönteminden 'buy_id' satın alma

— VEYA —

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

— VEYA —

buy_ids

array

'buy_id' satın almalarının bir 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:

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",
    "item": {
        "id": "1280",
        "name": "Taunt: RazorFlip!",
        "price": "0.16",
        "classid": "1723112726"
    },
    "buy_id": "9",
    "offer_status": "trade_create_error",
    "error_reason": null,
    "steamid": "76561198050648523",
    "date": "1596999226",
    "balance_debited_sum": "11.73",
    "refund_percent": 95,
    "refund_amount": null
}

Mümkün olan hataların listesi:

missing_one_of_required_params

Gerekli parametre eksik (buy_id, buy_ids veya custom_ids)

offer_not_found

Skin satın alma bulunamadı

-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ığı