Use case · Telegram bot

Sell gift cards & game top-ups in a Telegram bot — FazerCards integration

A Telegram bot is the fastest way to launch a digital-goods storefront. The bot collects an order from the customer, calls FazerCards POST /order with the SKU, receives the code via webhook, and replies in the same chat — usually in under a minute. No website hosting, no checkout pages, no card processor.

Integration steps

  1. 1

    Create a bot in @BotFather

    Open @BotFather in Telegram, run /newbot, name your bot, and save the HTTP API token. This is what authenticates your bot with Telegram.

  2. 2

    Register at FazerCards and grab an API key

    Sign up at reseller.fazercards.com, start the 5-day Gold trial, open Settings → API and copy your X-Api-Key. Store it in an environment variable on your server.

  3. 3

    Wire your bot to FazerCards API

    On the bot side, when the user picks a product (e.g. PUBG 60 UC), call POST https://api.fzr.cards/api/v2/order with the SKU id, the player's game ID, and an Idempotency-Key. Read the order id from the response.

  4. 4

    Set up the webhook endpoint

    Expose a public HTTPS URL (e.g. /webhooks/fazercards) and register it in the FazerCards dashboard. On order.completed, parse the payload, look up the Telegram chat id by order id, and message the customer with the code or confirmation.

  5. 5

    Accept payment from the customer

    Charge the end customer through Telegram Stars, USDT, or your local payment integration — the choice is yours. FazerCards only cares about the wholesale debit; retail markup and checkout flow live in your bot.

What you get

  • Launch in a few hours — no website needed.
  • Operate 24/7 with no manual fulfilment.
  • Crypto-native both ways: USDT in (from customer) and USDT out (to FazerCards).
  • Same bot can serve gift cards, ID top-ups, and subscriptions.

Watch out for

  • Telegram has anti-spam thresholds — pace bulk messages.
  • Always confirm the game ID (PUBG, Free Fire, MLBB) before submitting an order — wrong ID = lost top-up.
  • Keep the API key on the server only; never expose it in the bot's source if you publish it.

Launch in 5 minutes — no card needed

5-day Gold trial: full API, full catalog.

FAQ

Do I need a Telegram Business account?

No. A standard Telegram bot via @BotFather is enough. Telegram Stars / Premium are unlocked features for the customer, not for the bot operator.

Can the bot operate in multiple languages?

Yes. Localise the bot prompts in your code; FazerCards returns codes and statuses in a language-agnostic format.

How do refunds work?

If FazerCards fails an order, the order.refunded webhook fires and the balance is restored. Your bot logic should reverse the customer-side debit accordingly.

Other use cases