telegram api method · layer 229 · #7998c914
payments.sendStarsForm
Make a payment using Telegram Stars, see here » for more info.
definition
payments.sendStarsForm#7998c914 form_id:long invoice:InputInvoice = payments.PaymentResult;
parameters
| name | type | description |
|---|---|---|
form_id | long | Payment form ID |
invoice | InputInvoice | Invoice |
returns
errors (26)
| code | error | description |
|---|---|---|
| 400 | BALANCE_TOO_LOW | The transaction cannot be completed because the current Telegram Stars balance is too low. |
| 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 | 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 | 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. |
| 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. |
| 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. |
| 401 | AUTH_KEY_UNREGISTERED | The specified authorization key is not registered in the system (for example, a PFS temporary key has expired). |
| 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. |
| 406 | API_GIFT_RESTRICTED_UPDATE_APP | Please update the app to access the gift API. |
| 406 | PRECHECKOUT_FAILED | Precheckout failed, a detailed and localized description for the error will be emitted via an updateServiceNotification as specified here ». |
| 406 | STARS_FORM_AMOUNT_MISMATCH | The form amount has changed, please fetch the new form using payments.getPaymentForm and restart the process. |
history
present in layers 181–229 · constructor id changed 1×
| id | layers |
|---|---|
| #02bb731d | 181–188 |
| #7998c914 | 189–229 |