Endpoint validasi pemain

Validasi pemain mengecek akun in-game sebelum ada uang yang berpindah. Endpoint ini memastikan identifier tersebut ada untuk produk itu, mengembalikan nama in-game supaya pembeli bisa mengeceknya, dan menampilkan region-nya sehingga pesanan lintas region ditolak lebih awal, bukan gagal setelah pembayaran.

Field yang perlu dikirim

Body request terdiri dari pasangan tetap, ditambah field apa pun yang dibutuhkan game itu sendiri. Baca GET /catalog/category/:categoryId/requirements dulu, lalu kirim setiap field_name yang dikembalikan bersama sub_category_id dan player_id. Field bertipe single_select atau multi_select hanya menerima nilai dari daftar select_options miliknya sendiri. Field yang tidak dikirim ditolak dengan MISSING_REQUIRED_FIELD, sedangkan nilai yang melanggar aturan field ditolak dengan INVALID_PARAMETER_FORMAT, INVALID_PARAMETER_VALUE, atau INVALID_PARAMETER_LENGTH. Di kedua kasus, details.field menyebutkan nama field-nya.

Response yang berhasil mengembalikan nama in-game dan region dari identifier tersebut. Cocokkan region itu dengan produk yang akan kamu jual: kalau tidak cocok, request ditolak dengan REGION_MISMATCH. Ketahuan saat validasi cuma makan satu request, sedangkan kalau baru ketahuan saat pesanan dibuat, kamu harus melewati satu siklus refund penuh.

POST

/player/validate

Validasi Pemain

Validasi ID pemain untuk game tertentu. Sertakan field syarat dinamis dari endpoint Ambil Syarat Kategori.

Batas requestKuota cek pemain harian kamu (per akun), tanpa header X-RateLimit

Catatan: Cek endpoint Ambil Syarat Kategori untuk tahu field apa saja yang dibutuhkan tiap game. Masukkan semua field wajib ke request body. PLAYER_NOT_FOUND berarti game sudah memastikan ID tersebut tidak ada; PLAYER_CHECK_UNAVAILABLE (HTTP 503, bisa dicoba ulang) berarti ID belum bisa dicek saat ini dan tidak ditolak.

Body request

Nama	Tipe	Wajib	Deskripsi	Contoh
sub_category_id	number	Ya	ID subkategori produk. Cari lewat Catalog Explorer.	999
player_id	string	Ya	ID pemain di dalam game.	123456789
...requirements	varies	Tidak	Field tambahan dari endpoint Ambil Syarat Kategori. Masukkan setiap field_name sebagai key, dengan nilai yang diisi pengguna.	"server": "Asia"

Permintaan

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
}'

Contoh respons

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

Coba kirim request langsung dari halaman ini

Tempel API key untuk memanggil endpoint ini secara live. Key hanya tersimpan di tab browser ini dan cuma dikirim ke API itu sendiri.

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

Pilih endpoint

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.

Kalau baru pertama kali pakai platform ini, mulai dari ringkasan API top up game untuk reseller, atau baca ringkasan program reseller SHOP2TOPUP untuk tahu cara kerja akun partner.