Layer 220
PaymentsSendStarsForm
Make a payment using Telegram Stars, see here for more info.
method
Users
Bots
Business
payments.sendStarsForm#7998c914 form_id:long invoice:InputInvoice = payments.PaymentResult;
Parameters
| Name | Type | Description |
|---|---|---|
| FormId | long | Payment form ID |
| Invoice | InputInvoice | Invoice |
Returns
payments.PaymentResultPossible 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 invoke With Business Connection call is invalid. |
| 400 | FORM_EXPIRED | The form was generated more than 10 minutes ago and has expired, please re-generate it using payments. get Payment Form 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 input Invoice Premium Gift Stars. 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 update Service Notification 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 star Gift. 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. get Payment Form and restart the process. |
| 400 | TO_ID_INVALID | The specified to_id of the passed input Invoice Star Gift Resale or input Invoice Star Gift Transfer is invalid. |
| 400 | USER_ID_INVALID | The provided user ID is invalid. |
Gogram Example
// PaymentsSendStarsForm - positional arguments result, err := client.PaymentsSendStarsForm(int64(0), &tg.InputInvoice{}) if err != nil { // handle error } // result is *tg.PaymentsPaymentResult