Skip to content
Nasfam Business

Appearance

Telegram Stars API and Telegram Premium API

Digital commerce APIs for businesses

The Telegram Stars API and the Telegram Premium API let you sell and deliver digital products from your own app, bot or store, and see every order through to its end.

One order, start to end
  1. 01Your customerPays you

    Your customer pays you and names the Telegram account to receive it.

  2. 02Your app, bot or storeAsks for a quote

    A quote checks the recipient and fixes the price.

  3. 03Nasfam BusinessSets it aside

    The order sets the amount aside and runs.

  4. 04Your customerReceives it

    Stars or Premium reach the account your customer named.

  5. 05Your app, bot or storeHears the result

    A signed event tells your system the result.

Priced per order, in USD.

The problem it solves

A digital product is simple to sell and slow to deliver by hand.

  1. Delivery by hand

    Buying Stars or Premium one username at a time stops working at your first campaign.

  2. The right account

    A customer pays you first, and the product must reach the account they named.

  3. An answer for every order

    Without a status and an event, your team learns what happened when a customer asks.

Digital Commerce APIs

Digital-product fulfilment with one order shape for every product we serve.

  • Telegram Stars API

    Reward people or sell Stars inside your own product. A quote checks who receives them and fixes the price first.

    Telegram Stars API
    Sample

    Quote for 500 Stars

    quo_…000001
    • @nasfam_test_ok can receive it
    • Price held for up to 60 seconds
  • Telegram Premium API

    Gift a term of Premium to the right account. An account that cannot receive it is refused before anything is set aside.

    Telegram Premium API
    Sample

    3 months of Premium to @nasfam_test_ok

    ord_…000002Processing

    order.processing

  • Order management

    Create, list and read every order. A retry with the same key returns the first order instead of placing a second.

    Orders and statuses
    Sample
    1. First requestIdempotency-Key: reward-7f3aOrder ord_…000002 placed
    2. Same request againIdempotency-Key: reward-7f3aOrder ord_…000002 returned, not placed again
  • Delivery status and webhooks

    A status on every order and a signed event at every change, so your system knows the result without asking.

    Webhooks
    Sample

    500 Stars to @nasfam_test_ok

    ord_…000001Succeeded

    order.succeeded

Who it is for

  • Bots and mini apps that reward people with Stars or Premium.
  • Stores that sell digital products to their own customers.
  • Wallets and fintech apps that run loyalty or gifting.

How to begin

Get started
  1. Open your Nasfam Business account with your email.
  2. Fund your account with crypto.
  3. Create an API key and place your first order.

See every call an order makes.

Quotes, orders, statuses and signed events, each documented with examples.