(new): v1.2 release

tgapi/stars_methods.go

@@ -6,8 +6,11 @@ import "context"
 // Since: Bot API 7.5
 // See https://core.telegram.org/bots/api#getstartransactions
 type GetStarTransactions struct {
+	// Offset Optional. Number of transactions to skip in the response
 	Offset int `json:"offset,omitempty"`
-	Limit  int `json:"limit,omitempty"`
+	// Limit Optional. The maximum number of transactions to be retrieved. Values between 1-100 are accepted.
+	// Defaults to 100.
+	Limit int `json:"limit,omitempty"`
 }
 
 // GetMyStarBalance returns the bot's Telegram Star balance.
@@ -48,7 +51,9 @@ func (api *API) GetStarTransactionsWithContext(ctx context.Context, params GetSt
 // Since: Bot API 7.4
 // See https://core.telegram.org/bots/api#refundstarpayment
 type RefundStarPayment struct {
-	UserID                  int64  `json:"user_id"`
+	// UserID Required. Identifier of the user whose payment will be refunded
+	UserID int64 `json:"user_id"`
+	// TelegramPaymentChargeID Required. Telegram payment identifier
 	TelegramPaymentChargeID string `json:"telegram_payment_charge_id"`
 }
 
@@ -74,9 +79,14 @@ func (api *API) RefundStarPaymentWithContext(ctx context.Context, params RefundS
 // Since: Bot API 8.0
 // See https://core.telegram.org/bots/api#edituserstarsubscription
 type EditUserStarSubscription struct {
-	UserID                  int64  `json:"user_id"`
+	// UserID Required. Identifier of the user whose subscription will be edited
+	UserID int64 `json:"user_id"`
+	// TelegramPaymentChargeID Required. Telegram payment identifier for the subscription
 	TelegramPaymentChargeID string `json:"telegram_payment_charge_id"`
-	IsCanceled              bool   `json:"is_canceled"`
+	// IsCanceled Required. Pass True to cancel extension of the user subscription; the subscription must be
+	// active up to the end of the current subscription period. Pass False to allow the user to re-enable a
+	// subscription that was previously canceled by the bot.
+	IsCanceled bool `json:"is_canceled"`
 }
 
 // EditUserStarSubscription cancels or re-enables a user star subscription extension.