Oyuncu doğrulama uç noktası

Oyuncu doğrulama, para hareket etmeden önce oyun içi hesabı çözümler. Kimliğin o ürün için var olduğunu doğrular, alıcınızın kontrol edebilmesi için oyun içi adı döndürür ve bölgeyi açığa çıkarır; böylece bölgeler arası bir sipariş, ödemeden sonra başarısız olmak yerine baştan reddedilir.

Hangi alanlar gönderilmeli

İstek gövdesi, sabit bir çift ile oyunun kendisinin gerektirdiği alanlardan oluşur. Önce GET /catalog/category/:categoryId/requirements adresini okuyun, ardından döndürdüğü her field_name değerini sub_category_id ve player_id ile birlikte gönderin. single_select veya multi_select türündeki alanlar yalnızca kendi select_options listesindeki bir değeri kabul eder; başka her şey oyuna ulaşmadan INVALID_PRODUCT_CONFIG ile doğrulamada takılır.

Başarılı bir yanıt, kimliğin arkasındaki oyun içi adı ve bölgeyi döndürür. Bu bölgeyi satmak üzere olduğunuz ürünle karşılaştırın: uyuşmazlık REGION_MISMATCH ile reddedilir ve bunu doğrulama aşamasında yakalamak tek bir isteğe mal olurken, sipariş aşamasında yakalamak eksiksiz bir iade döngüsüne mal olur.

POST

/player/validate

Validate Player

Validate a player ID for a specific game. Include the dynamic requirement fields returned by the Get Category Requirements endpoint.

Hız sınırıHas its own rate limiter

Not: Use the Get Category Requirements endpoint to discover which fields are needed for each game. Include all required fields in the request body.

İstek gövdesi

Ad	Tür	Zorunlu	Açıklama	Örnek
sub_category_id	number	Evet	The subcategory ID of the product. Use Catalog Explorer to find this.	999
player_id	string	Evet	The in-game player ID.	123456789
...requirements	varies	Hayır	Additional fields from the Get Category Requirements endpoint. Include each field_name as a key with the user-provided value.	"server": "Asia"

İstek

curl -s -X POST "https://shop2topup.com/api/endpoints/v1/player/validate" \
  -H "Authorization: Bearer YOUR_KEY_ID.YOUR_KEY_SECRET" \
  -H "Content-Type: application/json" \
  -d '{
  "sub_category_id": 999,
  "player_id": 123456789
}'

Örnek yanıt

{
  "success": true,
  "player": {
    "player_id": "123456789",
    "player_name": "ProGamer99",
    "region": "Asia"
  }
}

Bu sayfadan gerçek bir istek gönderin

Bu uç noktaları canlı çağırmak için bir API anahtarı yapıştırın. Anahtar bu tarayıcı sekmesinde kalır ve yalnızca API'nin kendisine gönderilir.

Enter your API key to use the interactive playground. Get your API key

Bir uç nokta seçin

sub_category_id *

Use Catalog Explorer to find this

No requirements for this category.

Enter your API key above to try this endpoint.

Response will appear here after sending a request.

Platformda yeni misiniz? bayiler için oyun yükleme API'sine genel bakış ile başlayın veya SHOP2TOPUP bayi programına genel bakış sayfasından iş ortağı hesabının nasıl çalıştığını okuyun.