Skip to content
Packet Loom markminiproto

payments.sendStarsForm

payments.sendStarsForm

Section titled “payments.sendStarsForm”

No description provided by the pinned schema.

Signature

Section titled “Signature”
payments.sendStarsForm#7998c914 form_id:long invoice:InputInvoice = payments.PaymentResult;

Result type

Section titled “Result type”

payments.PaymentResult

Parameters

Section titled “Parameters”
NameTypeFlagDefaultDescription
form_idlong——No description provided by the pinned schema.
invoiceInputInvoice——No description provided by the pinned schema.

Python binding

Section titled “Python binding”
from miniproto.raw.functions import PaymentsSendStarsForm

Public access: miniproto.raw.functions.PaymentsSendStarsForm.

Safe usage shape

Section titled “Safe usage shape”
from miniproto.raw.functions import PaymentsSendStarsForm


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

Result family

Section titled “Result family”

payments.PaymentResult

RPC errors

Section titled “RPC errors”
CodeErrorDescription
400BALANCE_TOO_LOWThe transaction cannot be completed because the current Telegram Stars balance is too low.
400BOT_INVOICE_INVALIDThe specified invoice is invalid.
400BUSINESS_CONNECTION_INVALIDThe connection_id passed to the wrapping invokeWithBusinessConnection call is invalid.
400BUSINESS_CONNECTION_NOT_ALLOWEDThis 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.
400FORM_EXPIREDThe form was generated more than 10 minutes ago and has expired, please re-generate it using payments.getPaymentForm and pass the new form_id.
400FORM_ID_EMPTYThe specified form ID is empty.
400FORM_SUBMIT_DUPLICATEThe same payment form was already submitted. .
400FORM_UNSUPPORTEDPlease update your client.
400GIFT_STARS_INVALIDThe specified amount of stars is invalid.
400MEDIA_ALREADY_PAIDYou already paid for the specified media.
400MONTH_INVALIDThe number of months specified in inputInvoicePremiumGiftStars.months is invalid.
400PEER_ID_INVALIDThe provided peer id is invalid.
400PURPOSE_INVALIDThe specified payment purpose is invalid.
400STARGIFT_ALREADY_UPGRADEDThe specified gift was already upgraded to a collectible gift.
400STARGIFT_NOT_FOUNDThe specified gift was not found.
400STARGIFT_OWNER_INVALIDYou cannot transfer or sell a gift owned by another user.
400STARGIFT_SLUG_INVALIDThe specified gift slug is invalid.
400STARGIFT_USAGE_LIMITEDThe gift is sold out.
400STARGIFT_USER_USAGE_LIMITEDYou’ve reached the starGift.limited_per_user limit, you can’t buy any more gifts of this type.
400TO_ID_INVALIDThe specified to_id of the passed inputInvoiceStarGiftResale or inputInvoiceStarGiftTransfer is invalid.
400USER_ID_INVALIDThe provided user ID is invalid.
401AUTH_KEY_UNREGISTEREDThe specified authorization key is not registered in the system (for example, a PFS temporary key has expired).
403BOT_ACCESS_FORBIDDENThe 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.
406API_GIFT_RESTRICTED_UPDATE_APPPlease update the app to access the gift API.
406PRECHECKOUT_FAILEDPrecheckout failed, a detailed and localized description for the error will be emitted via an updateServiceNotification as specified here ».
406STARS_FORM_AMOUNT_MISMATCHThe form amount has changed, please fetch the new form using payments.getPaymentForm and restart the process.

Accepted types

Section titled “Accepted types”

InputInvoice Known selected constructors: inputInvoiceBusinessBotTransferStars, inputInvoiceChatInviteSubscription, inputInvoiceMessage, inputInvoicePremiumAuthCode, inputInvoicePremiumGiftCode, inputInvoicePremiumGiftStars, inputInvoiceSlug, inputInvoiceStarGift, inputInvoiceStarGiftAuctionBid, inputInvoiceStarGiftDropOriginalDetails, inputInvoiceStarGiftPrepaidUpgrade, inputInvoiceStarGiftResale, inputInvoiceStarGiftTransfer, inputInvoiceStarGiftUpgrade, inputInvoiceStars

Returned types

Section titled “Returned types”

payments.PaymentResult Known selected constructors: payments.paymentResult, payments.paymentVerificationNeeded

Section titled “Related methods”

payments.getPaymentForm, payments.sendPaymentForm, payments.validateRequestedInfo

Availability evidence

Section titled “Availability evidence”
  • business supported

Provenance

Section titled “Provenance”

Source-diff notes

Section titled “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
miniproto

Fast paths where they count. Explicit boundaries everywhere else.