Endpoints du catalogue

Le catalogue est une arborescence à trois niveaux : les grandes catégories contiennent des catégories, les catégories contiennent des sous-catégories, et une sous-catégorie est l'article que vous achetez réellement. Ces endpoints vous permettent de recopier cette arborescence dans votre propre base de données et de tarifer un article juste avant de le commander.

GET

/catalog/big-categories

Lister les grandes catégories

Récupérez toutes les catégories de premier niveau (ex. jeux mobiles, jeux PC, cartes cadeaux).

Limite de requêtes5000 req / 60 s par compte (quota partagé entre tous les endpoints du catalogue)

Paramètres de requête

Nom	Type	Obligatoire	Description	Exemple
for_ui	boolean	Non	Ajoute les URL des images à la réponse.	true

Requête

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

Exemple de réponse

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

Lister les catégories

Récupérez les catégories, avec un filtre facultatif par grande catégorie. Chaque catégorie correspond à un jeu ou à un service.

Limite de requêtes5000 req / 60 s par compte (quota partagé entre tous les endpoints du catalogue)

Paramètres de requête

Nom	Type	Obligatoire	Description	Exemple
bigCategoryId	number	Non	Filtre par ID de grande catégorie.	1
for_ui	boolean	Non	Ajoute les URL des images à la réponse.	true

Requête

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

Exemple de réponse

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

Lister les sous-catégories (produits)

Obtenez les produits et montants disponibles. Chaque sous-catégorie correspond à un article que vous pouvez acheter.

Limite de requêtes5000 req / 60 s par compte (quota partagé entre tous les endpoints du catalogue)

Note: product_type vaut 'topup' pour une recharge directe sur le compte d'un joueur et 'voucher' pour un produit qui livre un code. fulfillment_type ('api' pour une recharge, 'voucher' pour un code) et returns_voucher (true pour un code) sont obsolètes : ils ne font que reprendre product_type. Quand un champ id est présent, il est égal à item_id.

Paramètres de requête

Nom	Type	Obligatoire	Description	Exemple
categoryId	number	Non	Filtre par ID de catégorie.	12

Requête

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

Exemple de réponse

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

Prix d'un article

Renvoie le prix remisé actuel d'une sous-catégorie ou d'un article. Appelez-le avant de créer une commande pour connaître le coût exact.

Limite de requêtes5000 requêtes / 60 s par compte (quota partagé entre tous les endpoints du catalogue)

Note: La valeur unit_price est le montant qui vous sera débité. Reprenez-la dans expected_unit_price lors de la création des commandes.

Paramètres de chemin

Nom	Type	Obligatoire	Description	Exemple
itemId	number	Oui	L'ID de la sous-catégorie ou de l'article.	999

Requête

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

Exemple de réponse

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

Obtenir les champs requis d'une catégorie

Renvoie les champs dynamiques exigés pour une catégorie donnée. Ils indiquent les informations à fournir pour valider un joueur ou créer une commande (par exemple ID joueur, serveur, région).

Limite de requêtes5000 requêtes / 60 s par compte (quota partagé entre tous les endpoints du catalogue)

Note: Servez-vous des champs renvoyés pour construire des formulaires dynamiques de validation joueur et de création de commande. Chaque champ précise son data_type (text, number, single_select, multi_select) et, pour les listes de sélection, les options disponibles.

Paramètres de chemin

Nom	Type	Obligatoire	Description	Exemple
categoryId	number	Oui	L'ID de la catégorie dont vous voulez les champs requis.	12

Requête

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

Exemple de réponse

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

Envoyez une vraie requête depuis cette page

Collez une clé API pour appeler ces endpoints en direct. La clé reste dans cet onglet du navigateur et n'est envoyée qu'à l'API elle-même.

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

Choisissez un endpoint

Include images (for_ui=true)

Enter your API key above to try this endpoint.

Response will appear here after sending a request.

Explorateur de catalogue

Catalog Explorer

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

Enter your API key above to browse the catalog.

Nouveau sur la plateforme ? Commencez par la présentation de l'API de recharge de jeux pour revendeurs, ou lisez la présentation du programme revendeur SHOP2TOPUP pour comprendre le fonctionnement du compte partenaire.