payments.sendStarsForm

Make a payment using Telegram Stars, see here » for more info.

func (c *Client) PaymentsSendStarsForm(ctx context.Context, request *PaymentsSendStarsFormRequest) (PaymentsPaymentResultClass, error)

Calling this method

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

Parameters

Name	Type	Required	Description
FormID	int64	yes	Payment form ID
Invoice	InputInvoiceClass	yes	Invoice

Returns

PaymentsPaymentResultClass

Possible errors

Code	Type	Description
406	API_GIFT_RESTRICTED_UPDATE_APP	Please update the app to access the gift API.
400	BALANCE_TOO_LOW	The transaction cannot be completed because the current Telegram Stars balance is too low.
403	BOT_ACCESS_FORBIDDEN	The specified method can be used over a business connection for some operations, but the specified query attempted an operation that is not allowed over a business connection.
400	BOT_INVOICE_INVALID	The specified invoice is invalid.
400	BUSINESS_CONNECTION_INVALID	The connection_id passed to the wrapping invokeWithBusinessConnection call is invalid.
400	FORM_EXPIRED	The form was generated more than 10 minutes ago and has expired, please re-generate it using payments.getPaymentForm and pass the new form_id.
400	FORM_ID_EMPTY	The specified form ID is empty.
400	FORM_SUBMIT_DUPLICATE	The same payment form was already submitted. .
400	FORM_UNSUPPORTED	Please update your client.
400	GIFT_STARS_INVALID	The specified amount of stars is invalid.
400	MEDIA_ALREADY_PAID	You already paid for the specified media.
400	MONTH_INVALID	The number of months specified in inputInvoicePremiumGiftStars.months is invalid.
400	PEER_ID_INVALID	The provided peer id is invalid.
406	PRECHECKOUT_FAILED	Precheckout failed, a detailed and localized description for the error will be emitted via an updateServiceNotification as specified here ».
400	PURPOSE_INVALID	The specified payment purpose is invalid.
400	STARGIFT_ALREADY_UPGRADED	The specified gift was already upgraded to a collectible gift.
400	STARGIFT_NOT_FOUND	The specified gift was not found.
400	STARGIFT_OWNER_INVALID	You cannot transfer or sell a gift owned by another user.
400	STARGIFT_SLUG_INVALID	The specified gift slug is invalid.
400	STARGIFT_USAGE_LIMITED	The gift is sold out.
400	STARGIFT_USER_USAGE_LIMITED	You've reached the starGift.limited_per_user limit, you can't buy any more gifts of this type.
406	STARS_FORM_AMOUNT_MISMATCH	The form amount has changed, please fetch the new form using payments.getPaymentForm and restart the process.
400	TO_ID_INVALID	The specified to_id of the passed inputInvoiceStarGiftResale or inputInvoiceStarGiftTransfer is invalid.
400	USER_ID_INVALID	The provided user ID is invalid.

References

• Official documentation
• Generated Go reference
• TL definition: payments.sendStarsForm#7998c914