Тип данных InputInvoiceMessageContent

Описание

Представляет InputMessageContent сообщения счёта для отправки в результате инлайн-запроса.

Поле	Тип	Описание
title	String	Название товара, 1-32 символа
description	String	Описание товара, 1-255 символов
payload	String	Определённая ботом полезная нагрузка счёта, 1-128 байт. Не отображается пользователю, используйте для внутренних процессов.
provider_token	String	Необязательно. Токен платёжного провайдера, полученный через @BotFather. Передайте пустую строку для платежей в Telegram Stars.
currency	String	Трёхбуквенный код валюты ISO 4217, см. подробнее о валютах. Передайте «XTR» для платежей в Telegram Stars.
prices	Array of LabeledPrice	Разбивка цены, JSON-сериализованный список компонентов (например, цена товара, налог, скидка, стоимость доставки, налог на доставку, бонус и т.д.). Должен содержать ровно один элемент для платежей в Telegram Stars.
max_tip_amount	Integer	Необязательно. Максимально принимаемая сумма чаевых в наименьших единицах валюты (целое число, не float/double). Например, для максимальных чаевых `US$ 1.45` передайте `max_tip_amount = 145`. См. параметр exp в currencies.json, он показывает количество цифр после десятичной точки для каждой валюты (2 для большинства валют). По умолчанию 0. Не поддерживается для платежей в Telegram Stars.
suggested_tip_amounts	Array of Integer	Необязательно. JSON-сериализованный массив предлагаемых сумм чаевых в наименьших единицах валюты (целое число, не float/double). Можно указать не более 4 предлагаемых сумм чаевых. Предлагаемые суммы чаевых должны быть положительными, переданы в строго возрастающем порядке и не превышать max_tip_amount.
provider_data	String	Необязательно. JSON-сериализованный объект с данными о счёте, который будет передан платёжному провайдеру. Подробное описание требуемых полей должно быть предоставлено платёжным провайдером.
photo_url	String	Необязательно. URL фотографии товара для счёта. Может быть фото товаров или маркетинговым изображением для услуги.
photo_size	Integer	Необязательно. Размер фото в байтах
photo_width	Integer	Необязательно. Ширина фото
photo_height	Integer	Необязательно. Высота фото
need_name	Boolean	Необязательно. Передайте True, если для завершения заказа требуется полное имя пользователя. Игнорируется для платежей в Telegram Stars.
need_phone_number	Boolean	Необязательно. Передайте True, если для завершения заказа требуется номер телефона пользователя. Игнорируется для платежей в Telegram Stars.
need_email	Boolean	Необязательно. Передайте True, если для завершения заказа требуется адрес электронной почты пользователя. Игнорируется для платежей в Telegram Stars.
need_shipping_address	Boolean	Необязательно. Передайте True, если для завершения заказа требуется адрес доставки пользователя. Игнорируется для платежей в Telegram Stars.
send_phone_number_to_provider	Boolean	Необязательно. Передайте True, если номер телефона пользователя должен быть отправлен провайдеру. Игнорируется для платежей в Telegram Stars.
send_email_to_provider	Boolean	Необязательно. Передайте True, если адрес электронной почты пользователя должен быть отправлен провайдеру. Игнорируется для платежей в Telegram Stars.
is_flexible	Boolean	Необязательно. Передайте True, если итоговая цена зависит от способа доставки. Игнорируется для платежей в Telegram Stars.

Примеры

json

{
  "title": "Premium Subscription",
  "description": "Get access to all premium features for 1 month",
  "payload": "subscription_12345",
  "provider_token": "123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11",
  "currency": "USD",
  "prices": [
    {
      "label": "Monthly Subscription",
      "amount": 999
    }
  ],
  "max_tip_amount": 500,
  "suggested_tip_amounts": [100, 200, 300, 500],
  "provider_data": "{\"subscription_id\": \"sub_123\", \"plan\": \"monthly\"}",
  "photo_url": "https://example.com/product.jpg",
  "photo_size": 20480,
  "photo_width": 400,
  "photo_height": 300,
  "need_name": true,
  "need_phone_number": false,
  "need_email": true,
  "need_shipping_address": false,
  "send_phone_number_to_provider": false,
  "send_email_to_provider": true,
  "is_flexible": false
}

История изменений

API 5.2. Добавлен объект InputInvoiceMessageContent

Дополнительно

InputMessageContent - Объект, представляющий содержимое сообщения для отправки через инлайн-запрос, поддерживающий пять различных типов контента.
LabeledPrice - Объект, представляющий отдельную позицию в структуре цены товаров или услуг с указанием названия и стоимости в минимальных единицах валюты.