TGTools REST API
Gift Premium
Purchase Telegram Premium (3, 6, or 12 months) from wallet balance. Optional trackingCode rejects duplicates if that code already completed.
How to get a Fragment API key in Telegram
Open @ifragmentapibot and tap Start or send /start. Getting a key is free and requires no identity verification (KYC) or subscription.
POST
https://api.tg-tools.shop/api/purchase/premiumAuthentication requiredSend your API key as X-Api-Key. Keys remain private in this page and are never stored.
Request
EXAMPLE
curl -X POST 'https://api.tg-tools.shop/api/purchase/premium' \
-H 'X-Api-Key: tgt_YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{"recipientUsername":"johndoe","months":3,"paymentMethod":"ton","trackingCode":"order-456"}'Response
Returned on 200 OK.transactionIdnumber- Returned transaction id.
statusstring- Returned status.
recipientUsernamestring- Returned recipient username.
amountnumber- Returned amount.
quotedTotalTonnumber- Returned quoted total ton.
costTonnullable- Returned cost ton.
providerReferencenullable- Returned provider reference.
providerOutcomeUnresolvedboolean- Returned provider outcome unresolved.
messagestring- Returned message.
EXAMPLE200 OK
{
"transactionId": 43,
"status": "Pending",
"recipientUsername": "johndoe",
"amount": 0,
"quotedTotalTon": 8.37,
"costTon": null,
"providerReference": null,
"providerOutcomeUnresolved": false,
"message": "Order queued for fulfilment. Poll GET /api/purchase/{id} for delivery."
}Inspect
isSuccess and data when the endpoint returns an API envelope.