payments.upgradeStarGift

Upgrade a gift to a collectible gift: can only be used if the upgrade was already paid by the gift sender; see here » for more info on the full flow (including the different flow to use in case the upgrade was not paid by the gift sender).

func (c *Client) PaymentsUpgradeStarGift(ctx context.Context, request *PaymentsUpgradeStarGiftRequest) (UpdatesClass, error)

Calling this method

client.Run(ctx, func(ctx context.Context) error {
	api := client.API()
	
	res, err := api.PaymentsUpgradeStarGift(ctx, &tg.PaymentsUpgradeStarGiftRequest{
		// see Parameters
	})
	if err != nil {
		return err
	}
	_ = res // UpdatesClass
	return nil
})

Parameters

Name	Type	Required	Description
KeepOriginalDetails	bool	—	Set this flag to keep the original gift text, sender and receiver in the upgraded gift as a starGiftAttributeOriginalDetails attribute.
Stargift	InputSavedStarGiftClass	yes	The gift to upgrade

Returns

UpdatesClass

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	PAYMENT_REQUIRED	Payment is required for this action, see here » for more info.
400	SAVED_ID_EMPTY	The passed inputSavedStarGiftChat.saved_id is empty.
400	STARGIFT_ALREADY_CONVERTED	The specified star gift was already converted to Stars.
400	STARGIFT_ALREADY_UPGRADED	The specified gift was already upgraded to a collectible gift.
400	STARGIFT_UPGRADE_UNAVAILABLE	A received gift can only be upgraded to a collectible gift if the messageActionStarGift/savedStarGift.can_upgrade flag is set.

References

• Official documentation
• Generated Go reference
• TL definition: payments.upgradeStarGift#aed6e4f5