Products

Product operations. Products exist in three types:

• digital - Digital product. Any Telegram message with optional attachments

• custom - Custom product. On-demand content, e.g., personalized video greetings

• physical - Physical product. Merchandise with shipping, e.g., printed t-shirts

All amounts are in smallest currency units (cents/kopecks)

Get Products List

get

Returns a paginated list of products

Authorizations

ApiKeyAuth

Api-KeystringRequired

API key for authentication.

Query parameters

pageinteger · min: 1Optional

Page number

Default: 1

sizeinteger · min: 1 · max: 100Optional

Items per page

Default: 20

typestring · enumOptional

Filter by product type

Possible values:

descbooleanOptional

Sort by ID descending

Default: false

Responses

200

Successful response

application/json

400

Bad request

application/json

401

Unauthorized (invalid API key)

application/json

get

/products

HTTPcURLJavaScriptPython

GET /api/v1/products HTTP/1.1
Host: tribute.tg
Api-Key: YOUR_API_KEY
Accept: */*

{
  "rows": [
    {
      "id": 2548,
      "type": "digital",
      "name": "VPN Access - 1 Month",
      "description": "High-speed VPN service with unlimited bandwidth and 50+ server locations worldwide",
      "amount": 499,
      "currency": "usd",
      "starsAmount": 100,
      "starsAmountEnabled": true,
      "status": "approved",
      "isCustom": false,
      "acceptCards": true,
      "acceptWalletPay": false,
      "protectContent": true,
      "created": "2025-08-25T10:30:00Z",
      "updated": "2025-08-25T10:30:00Z",
      "pendingOrders": 3,
      "imageUrl": "https://cdn.example.com/image.jpg",
      "link": "https://t.me/tribute_bot/app?startapp=pf6",
      "webLink": "https://web.tribute.tg/p/f6"
    }
  ],
  "meta": {
    "total": 1,
    "offset": 1,
    "limit": 1
  }
}

Get Product by ID

get

Returns a single product by its ID

Authorizations

ApiKeyAuth

Api-KeystringRequired

API key for authentication.

Path parameters

idintegerRequired

Product ID

Responses

200

Successful response

application/json

400

Bad request (invalid product ID format)

application/json

401

Unauthorized (invalid API key)

application/json

403

Access denied

application/json

404

Product not found

application/json

get

/products/{id}

HTTPcURLJavaScriptPython

GET /api/v1/products/{id} HTTP/1.1
Host: tribute.tg
Api-Key: YOUR_API_KEY
Accept: */*

{
  "id": 2548,
  "type": "digital",
  "name": "VPN Access - 1 Month",
  "description": "High-speed VPN service with unlimited bandwidth and 50+ server locations worldwide",
  "amount": 499,
  "currency": "usd",
  "starsAmount": 100,
  "starsAmountEnabled": true,
  "status": "approved",
  "isCustom": false,
  "acceptCards": true,
  "acceptWalletPay": false,
  "protectContent": true,
  "created": "2025-08-25T10:30:00Z",
  "updated": "2025-08-25T10:30:00Z",
  "pendingOrders": 3,
  "imageUrl": "https://cdn.example.com/image.jpg",
  "link": "https://t.me/tribute_bot/app?startapp=pf6",
  "webLink": "https://web.tribute.tg/p/f6"
}

Cancel Digital Product Purchase

post

Cancels a digital product purchase and refunds the payment.

Important: This endpoint only supports refunds for purchases paid with Telegram Stars. Purchases paid with other payment methods cannot be refunded via this endpoint.

Authorizations

ApiKeyAuth

Api-KeystringRequired

API key for authentication.

Path parameters

purchaseIdintegerRequired

Digital product purchase ID (ProductPurchase.ID)

Example: 12345

Responses

200

Purchase successfully cancelled and payment refunded

application/json

400

Bad request

application/json

401

Unauthorized (invalid API key)

application/json

403

Access denied (not the product owner)

application/json

404

Purchase or user not found

application/json

500

Internal server error

application/json

post

/products/purchases/{purchaseId}/cancel

HTTPcURLJavaScriptPython

POST /api/v1/products/purchases/{purchaseId}/cancel HTTP/1.1
Host: tribute.tg
Api-Key: YOUR_API_KEY
Accept: */*

{
  "success": true,
  "purchaseId": 12345,
  "message": "purchase cancelled and payment refunded"
}