# Telegram
## Как подключить платежную систему
### Платежная система встроена в Telegram.
Чтобы совершать платежи внутри мессенджера, вам нужно:
* подключить платежную систему к боту в боте BotFather
* перейти в настройки нужного бота и в меню выбрать Payments
* следуя инструкциям, подключить доступную платежную систему и скопировать выданный токен
## Как выставить счет клиенту
Чтобы отправить счет в Telegram, используйте метод
tg\_send\_invoice(provider\_token, platform\_id, title, description, currency, prices, photo\_url, payload, protect\_content, disable\_notification, need\_name, phone\_number, need\_email, reply\_to\_message\_id, reply\_markup, reply\_id) - обязательные параметры выделены жирным
**provider\_token** - токен, полученный в BotFather после подключения платежной системы
**platform\_id** - получатель — идентификатор пользователя, группы или канала
**title** - название товара, 1-32 символа
**description** - описание товара, 1-255 символов
**currency** - валюта платежа (RUB, USD, UAH и так далее )
**payload** - первая часть данных о платеже, по умолчанию tg\_payment
**prices** - разбивка цены (описание ниже)
**photo\_url** - ссылка на изображение товара
**disable\_notification** - 1 — отправить с уведомлением, 0 — без уведомления
**protect\_content** - 1 — защита от копирования и скриншотов, 0 — без защиты
**need\_name** - 1, если вам нужно полное имя пользователя для завершения заказа, 0 — без запроса имени
**need\_phone\_number** - 1, если вам нужен номер телефона пользователя для завершения заказа, 0 — без запроса номера
**need\_email** - 1, если вам нужен email пользователя для завершения заказа, 0 — без запроса почты
**reply\_to\_message\_id** - id сообщения, на которое мы отвечаем, '' — не ответ
**reply\_markup** - клавиатура, первая кнопка должна быть кнопкой с типом оплаты
Если указан один из параметров need\_name, need\_phone\_number или need\_email, перед оплатой у пользователя будут запрошены данные и сохранены в переменные клиента, если платеж пройдет успешно. На скриншоте ниже запрос всех данных для ввода:
**prices** - массив массивов с данными о стоимости товаров и дополнительных услуг (доставка, упаковка и т. д.). Отображается на странице оплаты. Сумма указывается либо целым числом, например 125, либо дробным через точку 120.25. Например: \[\["товар", 2000], \["НДС", 20.75], \["упаковка", 100]
## Callback при оплате
После успешной оплаты в чат с пользователем придет колбек следующим образом:
**phone\_best 4737685 2120.75 UAH 1955518436**
где phone\_best - payload - из запроса на создание счета 473737685 - id чата, которому изначально был отправлен счет 2120.75 - полная сумма платежа UAH - валюта 1955518436 - id платежа в системе мерчанта
Также, если вы запросили имя, телефон и/или email, клиент запишет переменные:
**tg\_payment\_name, tg\_payment\_phone** и **tg\_payment\_email**
{% hint style="info" %}
В случае успеха колбек будет отправлен в личные сообщения пользователя. Для этого клиент и бот должны взаимодействовать до оплаты (клиент должен быть подписан на бота)!
{% endhint %}
{% hint style="info" %}
После получения хука об оплате платеж будет автоматически подтвержден через answerPreCheckoutQuery .
{% endhint %}
## Примеры
`prices = [["product", 2000], ["NDS", 20.75], ["package", 100]]` \
`result = tg_send_invoice('632593626:TEST:sandbox_i38014109763', platform_id, 'phoneW-200', 'Best Model on the Market', 'UAH', prices, 'https://images11.popmeh.ru/cropped.jpg', 'phone_best', 0, 0, 1, 0, 1)`
### Пример с минимальным набором параметров
`prices = [["an amazing product", 20000]] result = tg_send_invoice('632593626:TEST:sandbox_i38014109763', platform_id, 'The best bot ever!',`` ``'Потрясающий курс! Будь лучшим!'``, 'UAH', prices)`
### Пример с клавиатурой
`prices = [["product", 2000], ["NDS", 20.75], ["package", 100]] result = tg_send_invoice('632593626:TEST:sandbox_i38014109763', platform_id, 'Phone W-200', 'BEst Model on the Market', 'UAH', prices, 'https://helpix.ru/news/200405/181746/gf200_2.jpg', 'phone_best', 0, 0, 1, 1, 1, '', '{"inline_keyboard": [[{"text":"Pay", "pay":"True"}], [{"text":"One more button", "callback_data": "One more button"}]]}')`
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.mavibot.ai/doc/ru/integrations/payment/telegram.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.