Package io.github.natanimn.telebof.requests.send

Class SendInvoice

java.lang.Object
io.github.natanimn.telebof.requests.AbstractBaseRequest<SendInvoice,Message>
io.github.natanimn.telebof.requests.send.SendBuilder<SendInvoice,Message>
io.github.natanimn.telebof.requests.send.SendInvoice
public class SendInvoice extends SendBuilder<SendInvoice,Message>
SendInvoice class. Returns the sent Message on success.
Since:
3 March 2025
See Also:

  • Constructor Details

    • SendInvoice

      public SendInvoice(Object chatId, String title, String description, String payload, String currency, LabeledPrice[] prices, Api api)
      Required
      Parameters:
      chatId - chat id
      title - title
      description - description
      payload - payload
      currency - currency
      prices - prices
      api - api

  • Method Details

    • providerToken

      public SendInvoice providerToken(String providerToken)
      Optional
      Parameters:
      providerToken - Payment provider token, obtained via @BotFather. Pass an empty string for payments in Telegram Stars.
      Returns:
      SendInvoice

    • maxTipAmount

      public SendInvoice maxTipAmount(int maxTipAmount)
      Optional
      Parameters:
      maxTipAmount - The maximum accepted amount for tips in the smallest units of the currency (integer, not float/double). For example, for a maximum tip of US$ 1.45 pass max_tip_amount = 145. See the exp parameter in currencies.json, it shows the number of digits past the decimal point for each currency (2 for the majority of currencies). Defaults to 0. Not supported for payments in Telegram Stars.
      Returns:
      SendInvoice

    • suggestedTipAmounts

      public SendInvoice suggestedTipAmounts(Integer[] suggestedTipAmounts)
      Optional
      Parameters:
      suggestedTipAmounts - A JSON-serialized array of suggested amounts of tips in the smallest units of the currency (integer, not float/double). At most 4 suggested tip amounts can be specified. The suggested tip amounts must be positive, passed in a strictly increased order and must not exceed max_tip_amount.
      Returns:
      SendInvoice

    • startParameter

      public SendInvoice startParameter(String startParameter)
      Optional
      Parameters:
      startParameter - Unique deep-linking parameter. If left empty, forwarded copies of the sent message will have a Pay button, allowing multiple users to pay directly from the forwarded message, using the same invoice. If non-empty, forwarded copies of the sent message will have a URL button with a deep link to the bot (instead of a Pay button), with the value used as the start parameter
      Returns:
      SendInvoice

    • providerData

      public SendInvoice providerData(String providerData)
      Optional
      Parameters:
      providerData - JSON-serialized data about the invoice, which will be shared with the payment provider. A detailed description of required fields should be provided by the payment provider.
      Returns:
      SendInvoice

    • photoUrl

      public SendInvoice photoUrl(String photoUrl)
      Optional
      Parameters:
      photoUrl - URL of the product photo for the invoice. Can be a photo of the goods or a marketing image for a service. People like it better when they see what they are paying for.
      Returns:
      SendInvoice

    • photoSize

      public SendInvoice photoSize(int photoSize)
      Optional
      Parameters:
      photoSize - Photo size in bytes
      Returns:
      SendInvoice

    • photoWidth

      public SendInvoice photoWidth(int photoWidth)
      Optional
      Parameters:
      photoWidth - Photo width
      Returns:
      SendInvoice

    • photoHeight

      public SendInvoice photoHeight(int photoHeight)
      Optional
      Parameters:
      photoHeight - Photo height
      Returns:
      SendInvoice

    • needName

      public SendInvoice needName(boolean needName)
      Optional
      Parameters:
      needName - Pass True if you require the user's full name to complete the order. Ignored for payments in Telegram Stars.
      Returns:
      SendInvoice

    • needPhoneNumber

      public SendInvoice needPhoneNumber(boolean needPhoneNumber)
      Optional
      Parameters:
      needPhoneNumber - Pass True if you require the user's phone number to complete the order. Ignored for payments in Telegram Stars.
      Returns:
      SendInvoice

    • needEmail

      public SendInvoice needEmail(boolean needEmail)
      Optional
      Parameters:
      needEmail - Pass True if you require the user's email address to complete the order. Ignored for payments in Telegram Stars.
      Returns:
      SendInvoice

    • needShippingAddress

      public SendInvoice needShippingAddress(boolean needShippingAddress)
      Optional
      Parameters:
      needShippingAddress - Pass True if you require the user's shipping address to complete the order. Ignored for payments in Telegram Stars.
      Returns:
      SendInvoice

    • sendPhoneNumberToProvider

      public SendInvoice sendPhoneNumberToProvider(boolean sendPhoneNumberToProvider)
      Optional
      Parameters:
      sendPhoneNumberToProvider - Pass True if the user's phone number should be sent to the provider. Ignored for payments in Telegram Stars.
      Returns:
      SendInvoice

    • sendEmailToProvider

      public SendInvoice sendEmailToProvider(boolean sendEmailToProvider)
      Optional
      Parameters:
      sendEmailToProvider - Pass True if the user's email address should be sent to the provider. Ignored for payments in Telegram Stars.
      Returns:
      SendInvoice

    • isFlexible

      public SendInvoice isFlexible(boolean isFlexible)
      Optional
      Parameters:
      isFlexible - Pass True if the final price depends on the shipping method. Ignored for payments in Telegram Stars.
      Returns:
      SendInvoice