TGTools — Telegram NFT marketplace
TGTools APIDeveloper reference
Docs›purchase›Gift Premium
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.

POSThttps://api.tg-tools.shop/api/purchase/premium
Authentication requiredSend your API key as X-Api-Key. Keys remain private in this page and are never stored.

Request

Example parameters

Edits update the request example below.

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.