payments.getStarsStatus

Get the current Telegram Stars balance of the current account (with peer=inputPeerSelf), or the stars balance of the bot specified in peer.

 Method schema is available as of layer 206. Switch »

Parameters

Name Type Description
flags # Flags, see TL conditional fields
ton flags.0?true  
peer InputPeer Peer of which to get the balance.

Result

payments.StarsStatus

Possible errors

Code Type Description
403 BOT_ACCESS_FORBIDDEN  
400 BUSINESS_CONNECTION_INVALID The connection_id passed to the wrapping invokeWithBusinessConnection call is invalid.
400 PEER_ID_INVALID The provided peer id is invalid.

Related pages

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.

inputPeerSelf

Defines the current user.

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.