payments.transferStarGift

Transfer a collectible gift to another user or channel: can only be used if transfer is free (i.e. messageActionStarGiftUnique.transfer_stars is not set); see here » for more info on the full flow (including the different flow to use in case the transfer isn't free).

func (c *Client) PaymentsTransferStarGift(ctx context.Context, request *PaymentsTransferStarGiftRequest) (UpdatesClass, error)

Calling this method

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

Parameters

Name	Type	Required	Description
Stargift	InputSavedStarGiftClass	yes	The gift to transfer.
ToID	InputPeerClass	yes	Destination peer.

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	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
400	STARGIFT_NOT_UNIQUE
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.

References

• Official documentation
• Generated Go reference
• TL definition: payments.transferStarGift#7f18176a