Actions101
- Bot Actions
- Chat Actions
- Get Chat
- Get Chat Administrators
- Get Chat Member Count
- Get Chat Member
- Ban Chat Member
- Unban Chat Member
- Restrict Chat Member
- Promote Chat Member
- Set Chat Administrator Custom Title
- Set Chat Permissions
- Export Chat Invite Link
- Create Chat Invite Link
- Edit Chat Invite Link
- Revoke Chat Invite Link
- Approve Chat Join Request
- Decline Chat Join Request
- Set Chat Photo
- Delete Chat Photo
- Set Chat Title
- Set Chat Description
- Pin Chat Message
- Unpin Chat Message
- Unpin All Chat Messages
- Leave Chat
- Set Chat Menu Button
- Get Chat Menu Button
- Set Chat Sticker Set
- Delete Chat Sticker Set
- File Actions
- Forum Actions
- Game Actions
- Inline Actions
- Message Actions
- Send Message
- Forward Message
- Copy Message
- Send Photo
- Send Audio
- Send Document
- Send Video
- Send Animation
- Send Voice
- Send Video Note
- Send Media Group
- Send Location
- Send Venue
- Send Contact
- Send Poll
- Send Dice
- Send Chat Action
- Edit Message Text
- Edit Message Caption
- Edit Message Media
- Edit Message Reply Markup
- Edit Message Live Location
- Stop Message Live Location
- Stop Poll
- Delete Message
- Delete Messages
- Payment Actions
- Sticker Actions
- Update Actions
- Webhook Actions
Payment → Create Invoice Link
AI-generatedSummary
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]