payments.transferStarGift

payments.transferStarGift

No description provided by the pinned schema.

Signature

payments.transferStarGift#7f18176a stargift:InputSavedStarGift to_id:InputPeer = Updates;

Result type

Updates

Parameters

Name	Type	Flag	Default	Description
stargift	InputSavedStarGift	—	—	No description provided by the pinned schema.
to_id	InputPeer	—	—	No description provided by the pinned schema.

Python binding

from miniproto.raw.functions import PaymentsTransferStarGift

Public access: miniproto.raw.functions.PaymentsTransferStarGift.

Safe usage shape

from miniproto.raw.functions import PaymentsTransferStarGift

# Naming the raw request class is local only; it performs no I/O or network request.
request_type = PaymentsTransferStarGift

Result family

Updates

RPC errors

Code	Error	Description
400	BUSINESS_CONNECTION_INVALID	The connection_id passed to the wrapping invokeWithBusinessConnection call is invalid.
400	BUSINESS_CONNECTION_NOT_ALLOWED	This method was invoked over a business connection using invokeWithBusinessConnection, but either (1) we’re a user, and users cannot invoke methods over a business connection; (2) we’re a bot, but business mode was disabled in @botfather or (3); we’re a bot, but this method cannot be invoked over a business connection.
400	MESSAGE_ID_INVALID	The provided message id is invalid.
400	PAYMENT_REQUIRED	Payment is required for this action, see here » for more info.
400	PEER_ID_INVALID	The provided peer id is invalid.
400	SAVED_ID_EMPTY	The passed inputSavedStarGiftChat.saved_id is empty.
400	STARGIFT_NOT_FOUND	The specified gift was not found.
400	STARGIFT_NOT_OWNER	You’re not the owner of the gift you trying to transfer.
400	STARGIFT_NOT_UNIQUE	You can’t transfer a non-collectible gift.
400	STARGIFT_OWNER_INVALID	You cannot transfer or sell a gift owned by another user.
400	STARGIFT_PEER_INVALID	The specified inputSavedStarGiftChat.peer is invalid.
400	STARGIFT_TRANSFER_TOO_EARLY_%d	You cannot transfer this gift yet, wait %d seconds.
401	AUTH_KEY_UNREGISTERED	The specified authorization key is not registered in the system (for example, a PFS temporary key has expired).

Accepted types

InputPeer, InputSavedStarGift Known selected constructors: inputPeerChannel, inputPeerChannelFromMessage, inputPeerChat, inputPeerEmpty, inputPeerSelf, inputPeerUser, inputPeerUserFromMessage, inputSavedStarGiftChat, inputSavedStarGiftSlug, inputSavedStarGiftUser

Returned types

Updates Known selected constructors: updateShort, updateShortChatMessage, updateShortMessage, updateShortSentMessage, updates, updatesCombined, updatesTooLong

Related methods

account.disablePeerConnectedBot, account.getBotBusinessConnection, account.getNotifyExceptions, account.getPaidMessagesRevenue, account.reportPeer, account.reportProfilePhoto, account.saveAutoSaveSettings, account.toggleConnectedBotPaused, account.toggleNoPaidMessagesException, account.toggleWebBrowserSettingsException, account.updateConnectedBot, bots.allowSendMessage, bots.setCustomVerification, channels.convertToGigagroup, channels.createChannel, channels.deleteChannel, channels.deleteHistory, channels.deleteParticipantHistory, channels.editAdmin, channels.editBanned, channels.editPhoto, channels.editTitle, channels.getParticipant, channels.getSendAs, channels.leaveChannel, channels.reportSpam, channels.restrictSponsoredMessages, channels.searchPosts, channels.setBoostsToUnblockRestrictions, channels.toggleAntiSpam, channels.toggleAutotranslation, channels.toggleForum, channels.toggleJoinRequest, channels.toggleJoinToSend, channels.toggleParticipantsHidden, channels.togglePreHistoryHidden, channels.toggleSignatures, channels.toggleSlowMode, channels.toggleViewForumAsMessages, channels.updateColor, channels.updateEmojiStatus, channels.updatePaidMessagesPrice, chatlists.editExportedInvite, chatlists.exportChatlistInvite, chatlists.joinChatlistInvite, chatlists.joinChatlistUpdates, chatlists.leaveChatlist, communities.create, communities.getParticipantJoinedChats, communities.toggleCommunityCollapsedInDialogs, communities.toggleParticipantBanned, communities.togglePeerLink, communities.togglePeerLinkRequestApproval, contacts.acceptContact, contacts.addContact, contacts.block, contacts.blockFromReplies, contacts.deleteContacts, contacts.getLocated, contacts.resetTopPeerRating, contacts.setBlocked, contacts.unblock, ephemeral.deleteMessage, ephemeral.editMessage, ephemeral.getCallbackAnswer, ephemeral.reportMessage, ephemeral.sendMessage, folders.editPeerFolders, help.dismissSuggestion, help.hidePromoData, messages.acceptUrlAuth, messages.addPollAnswer, messages.appendTodoList, messages.checkHistoryImportPeer, messages.createForumTopic, messages.deleteChatUser, messages.deleteExportedChatInvite, messages.deleteFactCheck, messages.deleteHistory, messages.deleteParticipantReaction, messages.deleteParticipantReactions, messages.deletePollAnswer, messages.deleteQuickReplyMessages, messages.deleteRevokedExportedChatInvites, messages.deleteSavedHistory, messages.deleteScheduledMessages, messages.deleteTopicHistory, messages.editChatAbout, messages.editChatCreator, messages.editChatDefaultBannedRights, messages.editChatParticipantRank, messages.editChatPhoto, messages.editChatTitle, messages.editExportedChatInvite, messages.editFactCheck, messages.editForumTopic, messages.editMessage, messages.exportChatInvite, messages.forwardMessages, messages.getAdminsWithInvites, messages.getAllDrafts, messages.getBotCallbackAnswer, messages.getChatInviteImporters, messages.getDialogUnreadMarks, messages.getDialogs, messages.getDiscussionMessage, messages.getExportedChatInvite, messages.getExportedChatInvites, messages.getExtendedMedia, messages.getFactCheck, messages.getForumTopics, messages.getForumTopicsByID, messages.getFutureChatCreatorAfterLeave, messages.getGameHighScores, messages.getHistory, messages.getInlineBotResults, messages.getMessageEditData, messages.getMessageReactionsList, messages.getMessageReadParticipants, messages.getMessagesReactions, messages.getMessagesViews, messages.getOnlines, messages.getOutboxReadDate, messages.getPaidReactionPrivacy, messages.getPeerSettings, messages.getPollResults, messages.getPollVotes, messages.getRecentLocations, messages.getReplies, messages.getRichMessage, messages.getSavedDialogs, messages.getSavedDialogsByID, messages.getSavedHistory, messages.getSavedReactionTags, messages.getScheduledHistory, messages.getScheduledMessages, messages.getSearchCounters, messages.getSearchResultsCalendar, messages.getSearchResultsPositions, messages.getSponsoredMessages, messages.getUnreadMentions, messages.getUnreadPollVotes, messages.getUnreadReactions, messages.hideAllChatJoinRequests, messages.hideChatJoinRequest, messages.hidePeerSettingsBar, messages.initHistoryImport, messages.markDialogUnread, messages.migrateChat, messages.prolongWebView, messages.rateTranscribedAudio, messages.readDiscussion, messages.readHistory, messages.readMentions, messages.readPollVotes, messages.readReactions, messages.readSavedHistory, messages.reorderPinnedForumTopics, messages.report, messages.reportMessagesDelivery, messages.reportReaction, messages.reportReadMetrics, messages.reportSpam, messages.requestAppWebView, messages.requestMainWebView, messages.requestUrlAuth, messages.requestWebView, messages.saveDefaultSendAs, messages.saveDraft, messages.search, messages.searchGlobal, messages.sendBotRequestedPeer, messages.sendInlineBotResult, messages.sendMedia, messages.sendMessage, messages.sendMultiMedia, messages.sendPaidReaction, messages.sendQuickReplyMessages, messages.sendReaction, messages.sendScheduledMessages, messages.sendScreenshotNotification, messages.sendVote, messages.sendWebViewData, messages.setChatAvailableReactions, messages.setChatTheme, messages.setChatWallPaper, messages.setGameScore, messages.setHistoryTTL, messages.setTyping, messages.startBot, messages.startHistoryImport, messages.summarizeText, messages.toggleNoForwards, messages.togglePaidReactionPrivacy, messages.togglePeerTranslations, messages.toggleSuggestedPostApproval, messages.toggleTodoCompleted, messages.transcribeAudio, messages.translateRichMessage, messages.translateText, messages.unpinAllMessages, messages.updatePinnedForumTopic, messages.updatePinnedMessage, messages.uploadImportedMedia, messages.uploadMedia, payments.applyGiftCode, payments.assignAppStoreTransaction, payments.assignPlayMarketTransaction, payments.changeStarsSubscription, payments.connectStarRefBot, payments.convertStarGift, payments.craftStarGift, payments.createStarGiftCollection, payments.deleteStarGiftCollection, payments.editConnectedStarRefBot, payments.fulfillStarsSubscription, payments.getConnectedStarRefBot, payments.getConnectedStarRefBots, payments.getGiveawayInfo, payments.getPaymentReceipt, payments.getPremiumGiftCodeOptions, payments.getSavedStarGift, payments.getSavedStarGifts, payments.getStarGiftCollections, payments.getStarGiftWithdrawalUrl, payments.getStarsRevenueAdsAccountUrl, payments.getStarsRevenueStats, payments.getStarsRevenueWithdrawalUrl, payments.getStarsStatus, payments.getStarsSubscriptions, payments.getStarsTransactions, payments.getStarsTransactionsByID, payments.getSuggestedStarRefBots, payments.launchPrepaidGiveaway, payments.refundStarsCharge, payments.reorderStarGiftCollections, payments.resolveStarGiftOffer, payments.saveStarGift, payments.sendStarGiftOffer, payments.toggleChatStarGiftNotifications, payments.toggleStarGiftsPinnedToTop, payments.updateStarGiftCollection, payments.updateStarGiftPrice, payments.upgradeStarGift, phone.createConferenceCall, phone.createGroupCall, phone.declineConferenceCallInvite, phone.deleteConferenceCallParticipants, phone.deleteGroupCallMessages, phone.deleteGroupCallParticipantMessages, phone.discardCall, phone.discardGroupCall, phone.editGroupCallParticipant, phone.editGroupCallTitle, phone.getGroupCallChainBlocks, phone.getGroupCallJoinAs, phone.getGroupCallStreamRtmpUrl, phone.getGroupParticipants, phone.inviteConferenceCallParticipant, phone.inviteToGroupCall, phone.joinGroupCall, phone.joinGroupCallPresentation, phone.leaveGroupCall, phone.leaveGroupCallPresentation, phone.saveDefaultGroupCallJoinAs, phone.saveDefaultSendAs, phone.sendConferenceCallBroadcast, phone.sendGroupCallMessage, phone.setCallRating, phone.startScheduledGroupCall, phone.toggleGroupCallRecord, phone.toggleGroupCallSettings, phone.toggleGroupCallStartSubscription, premium.applyBoost, premium.getBoostsList, premium.getBoostsStatus, premium.getUserBoosts, stats.getPollStats, stats.getStoryPublicForwards, stats.getStoryStats, stories.activateStealthMode, stories.canSendStory, stories.createAlbum, stories.deleteAlbum, stories.deleteStories, stories.editStory, stories.exportStoryLink, stories.getAlbumStories, stories.getAlbums, stories.getAllReadPeerStories, stories.getPeerMaxIDs, stories.getPeerStories, stories.getPinnedStories, stories.getStoriesArchive, stories.getStoriesByID, stories.getStoriesViews, stories.getStoryReactionsList, stories.getStoryViewsList, stories.incrementStoryViews, stories.readStories, stories.reorderAlbums, stories.report, stories.searchPosts, stories.sendReaction, stories.sendStory, stories.startLive, stories.togglePeerStoriesHidden, stories.togglePinned, stories.togglePinnedToTop, stories.updateAlbum, users.suggestBirthday

Availability evidence

• business supported
• user only

Provenance

• layer: 228
• structural source: tdlib
• canonical schema: https://raw.githubusercontent.com/tdlib/td/refs/heads/master/td/generate/scheme/telegram_api.tl
• prose merge precedence: TDLib → Telegram Desktop → Core JSON
• source note: Canonical structure is the pinned TDLib telegram_api.tl; Layer 228 comes only from the matching Telegram Desktop end-of-file marker; core.telegram.org inputs enrich documentation and RPC error metadata without overriding structure.

Source-diff notes

• tdlib_vs_core: changed_count=68; core_only_count=1; overlap_count=2302; tdlib_only_count=158
• tdlib_vs_tdesktop: changed_count=0; overlap_count=2448; tdesktop_only=null; tdlib_only=accessPointRule, ephemeral.editMessage, help.configSimple, inputPeerPhotoFileLocationLegacy, inputStickerSetThumbLegacy, invokeWithApnsSecretPrefix, invokeWithBusinessConnectionPrefix, invokeWithGooglePlayIntegrityPrefix, invokeWithReCaptchaPrefix, ipPort, ipPortSecret, updateEphemeralBotCallbackQuery