payments.convertStarGift

Convert a received gift » into Telegram Stars: this will permanently destroy the gift, converting it into starGift.convert_stars Telegram Stars, added to the user's balance.

Note that starGift.convert_stars will be less than the buying price (starGift.stars) of the gift if it was originally bought using Telegram Stars bought a long time ago.

 Method schema is available as of layer 196. Switch »

Parameters

Name Type Description
stargift InputSavedStarGift The gift to convert.

Result

Bool

Only users can use this method

This method can be invoked over a business connection »

Possible errors

Code Type Description
400 BUSINESS_CONNECTION_INVALID The connection_id passed to the wrapping invokeWithBusinessConnection call is invalid.
400 MESSAGE_ID_INVALID The provided message id is invalid.
400 SAVED_ID_EMPTY The passed inputSavedStarGiftChat.saved_id is empty.
400 STARGIFT_PEER_INVALID The specified inputSavedStarGiftChat.peer is invalid.
400 USER_ID_INVALID The provided user ID is invalid.

Related pages

Telegram Gifts

Users can send Gifts to their friends. The recipients of gifts can display them on their profile pages or turn them into Telegram Stars ». Telegram Stars can be used for many things, including supporting creators and buying services in mini apps.

starGift

Represents a star gift, see here » for more info.

Telegram Stars

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.

Business

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.