Endpoints del catálogo

El catálogo es un árbol de tres niveles: las grandes categorías contienen categorías, las categorías contienen subcategorías, y una subcategoría es el artículo que realmente se compra. Estos endpoints le permiten replicar ese árbol en su propia base de datos y consultar el precio de un artículo justo antes de pedirlo.

GET

/catalog/big-categories

List Big Categories

Get all top-level categories (e.g., Mobile Games, PC Games, Gift Cards).

Límite de solicitudes80 req / 60s per user (shared across all catalog endpoints)

Parámetros de consulta

Nombre	Tipo	Obligatorio	Descripción	Ejemplo
for_ui	boolean	No	Include image URLs in the response.	true

Solicitud

curl -s "https://shop2topup.com/api/endpoints/v1/catalog/big-categories?for_ui=true" \
  -H "Authorization: Bearer YOUR_KEY_ID.YOUR_KEY_SECRET"

Respuesta de ejemplo

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

List Categories

Get categories, optionally filtered by big category. Each category represents a game or service.

Límite de solicitudes80 req / 60s per user (shared across all catalog endpoints)

Parámetros de consulta

Nombre	Tipo	Obligatorio	Descripción	Ejemplo
bigCategoryId	number	No	Filter by big category ID.	1
for_ui	boolean	No	Include image URLs in the response.	true

Solicitud

curl -s "https://shop2topup.com/api/endpoints/v1/catalog/categories?bigCategoryId=1&for_ui=true" \
  -H "Authorization: Bearer YOUR_KEY_ID.YOUR_KEY_SECRET"

Respuesta de ejemplo

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

List Subcategories (Products)

Get available products/denominations. Each subcategory is a purchasable item.

Límite de solicitudes80 req / 60s per user (shared across all catalog endpoints)

Parámetros de consulta

Nombre	Tipo	Obligatorio	Descripción	Ejemplo
categoryId	number	No	Filter by category ID.	12

Solicitud

curl -s "https://shop2topup.com/api/endpoints/v1/catalog/subcategories?categoryId=12" \
  -H "Authorization: Bearer YOUR_KEY_ID.YOUR_KEY_SECRET"

Respuesta de ejemplo

{
  "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",
      "fulfillment_type": "api",
      "returns_voucher": false
    }
  ]
}

GET

/catalog/subcategory/:itemId/price

Get Item Price

Get the current discounted price for a specific subcategory/item. Use this before creating an order to know the exact cost.

Límite de solicitudes80 req / 60s per user (shared across all catalog endpoints)

Nota: The unit_price is what you will be charged. Use this value for expected_unit_price when creating orders.

Parámetros de ruta

Nombre	Tipo	Obligatorio	Descripción	Ejemplo
itemId	number	Sí	The subcategory/item ID.	999

Solicitud

curl -s "https://shop2topup.com/api/endpoints/v1/catalog/subcategory/999/price" \
  -H "Authorization: Bearer YOUR_KEY_ID.YOUR_KEY_SECRET"

Respuesta de ejemplo

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

Get Category Requirements

Get the dynamic requirement fields for a specific category. These fields describe what information is needed when validating a player or creating an order (e.g., player ID, server, region).

Límite de solicitudes80 req / 60s per user (shared across all catalog endpoints)

Nota: Use the returned fields to build dynamic forms for player validation and order creation. Each field specifies its data_type (text, number, single_select, multi_select) and available options for select fields.

Parámetros de ruta

Nombre	Tipo	Obligatorio	Descripción	Ejemplo
categoryId	number	Sí	The category ID to get requirements for.	12

Solicitud

curl -s "https://shop2topup.com/api/endpoints/v1/catalog/category/12/requirements" \
  -H "Authorization: Bearer YOUR_KEY_ID.YOUR_KEY_SECRET"

Respuesta de ejemplo

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

Envíe una solicitud real desde esta página

Pegue una clave de API para llamar a estos endpoints en vivo. La clave se queda en esta pestaña del navegador y solo se envía a la propia API.

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

Elija un endpoint

Include images (for_ui=true)

Enter your API key above to try this endpoint.

Response will appear here after sending a request.

Explorador del catálogo

Catalog Explorer

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

Enter your API key above to browse the catalog.

¿Recién llega a la plataforma? Empiece por la presentación de la API de recargas de juegos para revendedores, o lea la presentación del programa de revendedores de SHOP2TOPUP para ver cómo funciona la cuenta de socio.