kind set to topup, telegram_premium or telegram_stars. The credit is sent straight to the player’s account or Telegram username: there is no code to retrieve. They use the same purchase and order endpoints as every other product.
Prices follow our supplier automatically, so always read them from the catalog instead of hard-coding them.
1
Find the product and its inputs
In
GET /api/catalog, products with kind topup, telegram_premium or telegram_stars list their input_fields. Each field has an index.2
Verify the player (optional but recommended)
Send the inputs keyed by
index. Games that support verification return the player name.Response
status is valid, invalid, or unknown when verification is unavailable (you can still order).3
Order
Use the normal purchase endpoint with the inputs keyed by
index.4
Follow the order
Poll
POST /api/products/orders/retrieve. The order is processing for a few seconds up to a few minutes, then completed. If the supplier cannot deliver (for example a wrong player ID), the order becomes failed and the full amount is refunded to your wallet automatically.quantity above 1 places one separate top-up per unit for the same player. Check the player ID twice: top-ups cannot be recalled once delivered.