Make a payment using Telegram Stars, see here » for more info.
Method schema is available as of layer 189. Switch »
| Name | Type | Description |
|---|---|---|
| form_id | long | Payment form ID |
| invoice | InputInvoice | Invoice |
| Code | Type | Description |
|---|---|---|
| 400 | BALANCE_TOO_LOW | The transaction cannot be completed because the current Telegram Stars balance is too low. |
| 403 | BOT_ACCESS_FORBIDDEN | |
| 400 | BOT_INVOICE_INVALID | The specified invoice is invalid. |
| 400 | BUSINESS_CONNECTION_INVALID | The connection_id passed to the wrapping invokeWithBusinessConnection call is invalid. |
| 400 | FORM_EXPIRED | The form was generated more than 10 minutes ago and has expired, please re-generate it using payments.getPaymentForm and pass the new form_id. |
| 400 | FORM_ID_EMPTY | The specified form ID is empty. |
| 400 | FORM_UNSUPPORTED | Please update your client. |
| 400 | GIFT_STARS_INVALID | The specified amount of stars is invalid. |
| 400 | PEER_ID_INVALID | The provided peer id is invalid. |
| 406 | PRECHECKOUT_FAILED | |
| 400 | PURPOSE_INVALID | |
| 400 | STARGIFT_USAGE_LIMITED | The gift is sold out. |
| 400 | TO_ID_INVALID | |
| 400 | USER_ID_INVALID | The provided user ID is invalid. |
Telegram Stars are virtual items that allow users to purchase digital goods and services from bots and mini apps inside the Telegram ecosystem, send gifts to content creators on the Telegram platform, and more.
Users can turn their Telegram account into a business account, gaining access to business features such as opening hours, location, quick replies, automated messages, custom start pages, chatbot support, and more.
Get a payment form