Endpoint katalog

Katalog berbentuk pohon tiga level: big category berisi kategori, kategori berisi subkategori, dan subkategori adalah item yang benar-benar kamu beli. Lewat endpoint ini kamu bisa menyalin pohon itu ke database sendiri dan mengecek harga item tepat sebelum memesannya.

GET

/catalog/big-categories

Daftar Kategori Utama

Daftar semua kategori tingkat teratas (misalnya Mobile Games, PC Games, Gift Cards).

Batas request5000 req / 60 detik per akun (kuota bersama untuk semua endpoint katalog)

Parameter query

NamaTipeWajibDeskripsiContoh
for_uibooleanTidakSertakan URL gambar di respons.true
Permintaan
curl -s "https://shop2topup.com/api/endpoints/v1/catalog/big-categories?for_ui=true" \
  -H "Authorization: Bearer YOUR_KEY_ID.YOUR_KEY_SECRET"
Contoh respons
{
  "success": true,
  "big_categories": [
    {
      "id": 1,
      "name": "Mobile Games",
      "description": "Popular mobile game top-ups"
    },
    {
      "id": 2,
      "name": "PC Games",
      "description": "PC game credits and items"
    }
  ]
}
GET

/catalog/categories

Daftar Kategori

Menampilkan kategori, bisa difilter per kategori utama. Satu kategori mewakili satu game atau layanan.

Batas request5000 req / 60 detik per akun (kuota bersama untuk semua endpoint katalog)

Parameter query

NamaTipeWajibDeskripsiContoh
bigCategoryIdnumberTidakFilter berdasarkan ID kategori utama.1
for_uibooleanTidakSertakan URL gambar di respons.true
Permintaan
curl -s "https://shop2topup.com/api/endpoints/v1/catalog/categories?bigCategoryId=1&for_ui=true" \
  -H "Authorization: Bearer YOUR_KEY_ID.YOUR_KEY_SECRET"
Contoh respons
{
  "success": true,
  "categories": [
    {
      "id": 12,
      "name": "Free Fire",
      "description": "Garena Free Fire diamonds",
      "big_category_id": 1,
      "big_category_name": "Mobile Games"
    }
  ]
}
GET

/catalog/subcategories

Daftar Subkategori (Produk)

Daftar produk/nominal yang tersedia. Setiap subkategori adalah item yang bisa dibeli.

Batas request5000 req / 60 detik per akun (kuota bersama untuk semua endpoint katalog)

Catatan: product_type bernilai 'topup' untuk top up langsung ke akun pemain dan 'voucher' untuk produk yang mengirimkan kode. fulfillment_type ('api' untuk top up, 'voucher' untuk kode) dan returns_voucher (true untuk kode) sudah deprecated: keduanya cuma mengulang product_type. Kalau ada field id, nilainya sama dengan item_id.

Parameter query

NamaTipeWajibDeskripsiContoh
categoryIdnumberTidakFilter berdasarkan ID kategori.12
Permintaan
curl -s "https://shop2topup.com/api/endpoints/v1/catalog/subcategories?categoryId=12" \
  -H "Authorization: Bearer YOUR_KEY_ID.YOUR_KEY_SECRET"
Contoh respons
{
  "success": true,
  "subcategories": [
    {
      "item_id": 999,
      "name": "FF 100 Diamonds",
      "description": "100 Free Fire Diamonds",
      "category_id": 12,
      "category_name": "Free Fire",
      "price": "0.99",
      "product_type": "topup",
      "fulfillment_type": "api",
      "returns_voucher": false
    }
  ]
}
GET

/catalog/subcategory/:itemId/price

Ambil Harga Item

Cek harga diskon terkini untuk subkategori/item tertentu. Panggil endpoint ini sebelum membuat pesanan supaya kamu tahu biaya pastinya.

Batas request5000 req / 60 detik per akun (kuota bersama untuk semua endpoint katalog)

Catatan: Nilai unit_price adalah harga yang akan ditagihkan ke kamu. Pakai nilai ini untuk expected_unit_price saat membuat pesanan.

Parameter path

NamaTipeWajibDeskripsiContoh
itemIdnumberYaID subkategori/item.999
Permintaan
curl -s "https://shop2topup.com/api/endpoints/v1/catalog/subcategory/999/price" \
  -H "Authorization: Bearer YOUR_KEY_ID.YOUR_KEY_SECRET"
Contoh respons
{
  "success": true,
  "price": {
    "item_id": 999,
    "item_name": "FF 100 Diamonds",
    "unit_price": "0.950000",
    "currency": "USD",
    "original_price": "0.990000",
    "discount_applied": true,
    "timestamp": "2024-06-15T12:00:00Z"
  }
}
GET

/catalog/category/:categoryId/requirements

Ambil Syarat Kategori

Ambil field syarat dinamis untuk kategori tertentu. Field ini menjelaskan data apa saja yang diperlukan saat memvalidasi pemain atau membuat pesanan (misalnya ID pemain, server, region).

Batas request5000 req / 60 detik per akun (kuota bersama untuk semua endpoint katalog)

Catatan: Pakai field yang dikembalikan untuk membangun form dinamis untuk validasi pemain dan pembuatan pesanan. Setiap field mencantumkan data_type-nya (text, number, single_select, multi_select) beserta opsi yang tersedia untuk field bertipe select.

Parameter path

NamaTipeWajibDeskripsiContoh
categoryIdnumberYaID kategori yang syaratnya ingin diambil.12
Permintaan
curl -s "https://shop2topup.com/api/endpoints/v1/catalog/category/12/requirements" \
  -H "Authorization: Bearer YOUR_KEY_ID.YOUR_KEY_SECRET"
Contoh respons
{
  "success": true,
  "requirements": [
    {
      "field_name": "player_id",
      "data_type": "text",
      "placeholder": "Enter player ID"
    },
    {
      "field_name": "server",
      "data_type": "single_select",
      "placeholder": "Select server",
      "select_options": [
        "Asia",
        "Europe",
        "America"
      ]
    }
  ]
}

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

Enter your API key above to try this endpoint.

Response will appear here after sending a request.

Penjelajah katalog

Catalog Explorer

Browse the product hierarchy and copy IDs for use in API calls.

Enter your API key above to browse the catalog.

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.

Referensi API Katalog | Big Category, Kategori, Harga