Telegram Bot icon

Telegram Bot

Interact with the Telegram Bot API – send messages, manage chats, handle payments, and more

Actions101

Payment → Create Invoice Link

AI-generated

Summary

Generate a payment invoice URL using Telegram Bot API with specified product details and pricing information.

Inputs

  • Title (required) — Product name for the invoice.
  • Description (required) — Product description for the invoice.
  • Payload (required) — Bot-defined invoice payload to track the invoice.
  • Provider Token (required) — Payment provider token for processing the payment.
  • Currency (required) — Three-letter ISO 4217 currency code for the invoice.
  • Prices (JSON) (required) — JSON array of LabeledPrice objects representing the prices.
  • Additional Fields — Optional additional invoice parameters such as max tip amount, suggested tips, photo URL and dimensions, user data requests (name, phone number, email, shipping address), provider data, and other payment options.

Output shape

a single object containing the created invoice link as returned from Telegram API

The operation returns the result property from the Telegram API response which includes the invoice link. Optional additional fields must be JSON parsed if provided as strings.

Examples

Example 1: Create an invoice link for a product with basic title, description, payload, provider token, currency, and price list specified.

Title: "Pro Membership", Description: "Monthly subscription", Payload: "user_subscription", Provider Token: "provider_token_example", Currency: "USD", Prices: [{"label":"Pro plan","amount":999}]

Example 2: Add optional photo and request user's email with specified tip amounts.

In Additional Fields: Photo URL set to product image URL, Requested Email true, Suggested Tip Amounts: [100, 200, 500]

Links

Discussion