No manual order processing
Create Stars and Premium orders directly from your system and retain a unique identifier for every purchase.
Gramix for resellers
API for automated Telegram Stars and Premium purchases
Connect Telegram Stars and Telegram Premium to your website, app, or bot. Create orders programmatically, pay from your reseller balance, and track fulfillment through the API or webhooks.
API documentation
Authentication, balance funding, Stars and Premium purchase methods, orders, webhooks, schemas, and code examples.
Read documentationAPI pricing
Current reseller prices for Telegram Stars, Telegram Premium plans, and other products available through the API.
View pricingAPI for business
Automate your Telegram Stars and Premium sales
Gramix API is built for resellers and digital services that want to offer Telegram Stars and Telegram Premium through their own website, app, bot, or internal platform. Instead of processing every purchase manually, your system sends an API request and Gramix creates a trackable order.
The integration uses a prepaid balance. Add funds to your dedicated API balance once, then let new orders debit it automatically. This removes the need to create and confirm a separate payment transaction before every customer order.
Orders start quickly
Payment is debited from your available balance, so a valid API request can move straight into processing.
Automated status updates
Receive results through a webhook or request the latest order status from the API whenever you need it.
Getting started
From registration to your first API order
A basic integration takes four clear steps. The Gramix API v1 documentation includes full request parameters, response schemas, and ready-to-use code examples.
- 1
Create an account and API key
Register with Gramix, open the API section in your account, and issue a key for your server-side integration.
- 2
Fund your API balance
Add funds manually from your account or request the deposit address and memo programmatically through the API.
- 3
Send a purchase request
Provide the Telegram username, selected product, and a required idempotency key that protects against duplicate orders.
- 4
Track the order status
Store the order ID, check it through the API, or configure a webhook to receive status notifications automatically.
Reseller dashboard
Balance, payments, and orders in one place
You can run the integration entirely through the API, while essential controls remain available in your Gramix account. Check funds, find an order, or update access settings without involving a developer.
Current balance and manual funding
Review available funds and top up your API balance using the wallet address and required memo. Funds are credited automatically after payment confirmation.
Transaction history
Review deposits, purchase debits, and refunds with the date, direction, amount, and currency of every transaction.
Order history and statuses
Find orders by ID, view the date, product, recipient, price, and current status, then open a complete order record.
Integration management
Create or rotate your API key, save a secure HTTPS webhook URL, and open the documentation or current pricing.
Processing speed
The same fulfillment infrastructure without paying for every order separately
API orders use the same Gramix service infrastructure as purchases placed on the website. For resellers, the difference is that funds are already available on the API balance. Once a request passes validation, its cost is debited automatically and the order enters processing without waiting for another payment transaction.
Actual fulfillment time depends on the selected product, valid recipient details, and the availability of the corresponding Telegram service.
- A prepaid balance for recurring orders
- Idempotency keys to prevent duplicate purchases
- Completed and failed statuses through webhooks
- Lookup for every order by its unique ID
Who it is for
An API for resellers, stores, and Telegram services
Online stores
Add Telegram Stars and Premium to your catalog and send paid customer orders to Gramix automatically.
Telegram bots and apps
Build your own purchase experience and connect server-side order fulfillment through a REST API.
High-volume resellers
Use a shared balance, automate repetitive work, and monitor the outcome of every customer order.
Frequently asked questions
Questions about the Gramix API
Who is the Gramix API designed for?
Gramix API is designed for resellers, online stores, Telegram bots, agencies, and other services that need to automate Telegram Stars and Telegram Premium purchases for their customers.
Which Telegram products can I order through the API?
The Gramix API lets you create orders for Telegram Stars and Telegram Premium subscriptions. The API pricing page lists the currently available products, subscription periods, and reseller prices.
How do I fund the balance used for API orders?
You can fund it manually from your Gramix account by copying the wallet address and required memo, then sending the payment. Your system can also request deposit details through the API. The balance updates automatically after transaction confirmation.
Where can I track orders and payments?
Your Gramix account shows the current balance, deposits, debits, refunds, and an order list with recipients, amounts, and statuses. You can also retrieve order status through the API or receive it through a webhook.
Why does an API order not require a separate payment?
The order cost is debited from your prepaid API balance. You do not need to create and confirm a new payment transaction for every purchase, so a valid request can enter processing immediately.
Ready to integrate the Telegram Stars and Premium API?
Compare current reseller prices, review the request format, and create an account to issue your API key and start integrating.