# Оплата Telegram

## Как подключить платежную систему

Платежная система встроена в Телеграм. Для того чтобы совершать платежи внутри мессенджера, нужно: 

* подключить платежную систему к боту в боте Botfather
* перейти в настройки нужного бота и в меню выбрать Payments
* следуя инструкциям, подключить доступную платежную систему и скопировать выданный токен

<figure><img src="/files/1ukp6I1swamtlWDBfRLK" alt="" width="563"><figcaption></figcaption></figure>

<figure><img src="/files/UX2aRkVFTbaxos4HNPLl" alt="" width="563"><figcaption></figcaption></figure>

## **Как выставить счет клиенту (invoice)**

Для отправки инвойса в Telegram используйте метод и укажите необходимые параметры.

**tg\_send\_invoice(provider\_token, platform\_id, title, description, currency, prices, photo\_url, payload, protect\_content, disable\_notification, need\_name, need\_phone\_number, need\_email, reply\_to\_message\_id, reply\_markup, message\_thread\_id, provider\_data)**

<table><thead><tr><th width="270">Параметры функции</th><th>Описание параметра</th></tr></thead><tbody><tr><td><mark style="color:red;"><strong>!</strong></mark> provider_token </td><td>(обязательный параметр) токен, полученный в Botfather после подключения платежной системы</td></tr><tr><td><mark style="color:red;"><strong>!</strong></mark> platform_id </td><td>(обязательный параметр) идентификатор получателя - пользователя, группы или канала</td></tr><tr><td><mark style="color:red;"><strong>!</strong></mark> title </td><td>(обязательный параметр) заголовок товара, 1-32 символа</td></tr><tr><td><mark style="color:red;"><strong>!</strong></mark> description </td><td>(обязательный параметр) описание товара, 1-255 символов</td></tr><tr><td><mark style="color:red;"><strong>!</strong></mark> currency </td><td>(обязательный параметр) валюта платежа (RUB, USD, UAH и тд подробнее<a href="https://core.telegram.org/bots/payments#supported-currencies"> https://core.telegram.org/bots/payments#supported-currencies</a> )</td></tr><tr><td>prices</td><td>массив массивов с данными по стоимости товара и дополнительных услуг (доставки, упаковки и тд). Отображается на странице оплаты. Сумма указывается либо целым числом 125, либо дробным через точку 120.25 Например: [["товар", 2000], ["НДС", 20.75], ["упаковка", 100]]</td></tr><tr><td>photo_url</td><td>ссылка на картинку товара</td></tr><tr><td>payload </td><td>первая часть коллбэка об оплате, по умолчанию tg_payment</td></tr><tr><td>protect_content</td><td>1 защитить от копирования и скриншотов, 0 - без защиты</td></tr><tr><td>disable_notification </td><td>1 - отправить с уведомлением, 0 - без уведомления</td></tr><tr><td>need_name</td><td>1, если вам требуется полное имя пользователя для завершения заказа, 0 - без запроса имени</td></tr><tr><td>need_phone_number</td><td>1, если вам требуется номер телефона пользователя для завершения заказа, 0 - без запроса номера</td></tr><tr><td>need_email </td><td>1, если вам требуется емейл пользователя для завершения заказа, 0 - без запроса почты</td></tr><tr><td>reply_to_message_id</td><td>id сообщения, на которое отвечаем, если хотите отправить инвойс отдельным сообщение, то поставьте две одинарные кавычки</td></tr><tr><td>reply_markup</td><td>клавиатура, первой кнопкой должна быть кнопка с типом pay</td></tr><tr><td>message_thread_id </td><td>идентификатор темы (доступно для супергрупп при наличии функционала форума)</td></tr><tr><td>provider_data </td><td>данные о счете в формате JSON, которые будут переданы поставщику платежных услуг. Платежная система должна предоставить подробное описание обязательных полей.</td></tr></tbody></table>

{% hint style="warning" %}
**Важно!** Все параметры необходимо передать в порядке, в котором они указаны в функции. Если вам необходимо указать какой-то определённый параметр и опустить другие, на месте параметров, которые вам не нужны, оставляйте пустые значения или значения, соответствующие документации.
{% endhint %}

Пример:

<figure><img src="/files/rrZqbr0LiXAV2WZ0vCUq" alt=""><figcaption><p>Настройка блока "Стартовое условие"</p></figcaption></figure>

В результате в Телеграм чате выставится счет:

<div align="left"><figure><img src="/files/A12Ry9wW2aiQveDDFilr" alt="" width="326"><figcaption></figcaption></figure> <figure><img src="/files/1WAxQbWDfhUykzTSXi76" alt="" width="406"><figcaption></figcaption></figure></div>

Если указан один из параметров **need\_name**, **need\_phone\_number** или **need\_email**, то перед оплатой у пользователя будут запрошены эти данные и при успешной оплате они сохранятся в переменные клиента.&#x20;

Пример:

<figure><img src="/files/CIfeYjZw2GWUOssiJpnC" alt=""><figcaption></figcaption></figure>

Результат: перед оплатой запрашиваются данные:

<figure><img src="/files/BDGFp4D3muoBGB2jZC0p" alt="" width="432"><figcaption></figcaption></figure>

## Коллбэк об оплате

После успешной оплаты в чат с пользователем придет коллбэк следующего содержания:

course\_pay 1372995196 120.75 RUB 2ff747b9-000f-5000-b000-16d7e3517aa9 **,** где&#x20;

1. course\_pay - payload - из запроса на создание инвойса;&#x20;
2. 1372995196 - ID чата, в который изначально был отправлен инвойс;&#x20;
3. 120.75 - полная сумма платежа;&#x20;
4. RUB - валюта;&#x20;
5. 2ff747b9-000f-5000-b000-16d7e3517aa9 - ID платежа в системе мерчанта.

<figure><img src="/files/A1Q2pcHHOJSkKa88umv9" alt=""><figcaption></figcaption></figure>

А также если запрашивали ввод имени, телефона и/или email, то у клиента пропишутся переменные:

**tg\_payment\_name**, **tg\_payment\_phone** и **tg\_payment\_email**

<figure><img src="/files/Nv5XiAGvYx5j5tnbJVru" alt="" width="386"><figcaption></figcaption></figure>

{% hint style="info" %}
В случае успеха коллбэк об оплате будет отправлен в личные сообщения пользователю.\
**Для этого обязательно взаимодействие клиента и бота до платежа (клиент должен быть подписан на бота)!**
{% endhint %}

{% hint style="info" %}
После получения хука об оплате, платеж будет автоматически подтвержден, методом answerPreCheckoutQuery <https://core.telegram.org/bots/api#answerprecheckoutquery>
{% endhint %}

## Закрепленное сообщение с кнопкой оплаты

После подключения платежной системы необходимо воспользоваться функцией закрепления сообщений - **tg\_pin\_chat\_message(platform\_id, message\_id, disable\_notification)**

<table><thead><tr><th width="271">Параметры функции </th><th>Описание</th></tr></thead><tbody><tr><td><mark style="color:red;"><strong>!</strong></mark><strong> platform_id</strong></td><td>идентификатор чата внутри Telegram <a href="#gde-vzyat-platform_id-dlya-otpravki-uvedomlenii"><strong>*</strong></a></td></tr><tr><td><strong>message_id</strong> </td><td>идентификатор сообщения, которое нужно закрепить</td></tr><tr><td><strong>disable_notification</strong> </td><td><p>параметр определяет нужно ли отправлять уведомление всем участникам чата о новом закрепленном сообщении (уведомления всегда отключены в каналах и приватных чатах). </p><p>Если не нужно отправлять уведомления, то в качестве значения параметра <strong>disable_notification</strong> передайте 1, иначе - 0.</p></td></tr></tbody></table>

Пример:

1 шаг:\
prices = \[\["курс", 100], \["НДС", 20.75]]

result=tg\_send\_invoice('381764678:TEST:129736', platform\_id, 'Курс по курсам', 'Создавать курсы - легко', 'RUB', prices, '<https://salebot.pro/promo.png>', 'course\_pay','0', '0', '1', '1', '1', '', '{"inline\_keyboard": \[\[{"text":"Оплатить", "pay":"True"}]]}')

2 шаг:\
В результате выполнения первого шага вы получите ответ, из которого требуется достать значение message\_id при помощи функции get(): \
res=get(result,'result')\
m\_id=get(res,'message\_id')

<figure><img src="/files/OIFjGELPSopFaZHY5EfI" alt="" width="383"><figcaption><p>Переменные сделки в разделе "Клиенты"</p></figcaption></figure>

Далее закрепляем сообщение: tg\_pin\_chat\_message(#{platform\_id}, #{m\_id}, 1)

<figure><img src="/files/6qu9jBcAWchFh2bQYJSc" alt="" width="445"><figcaption><p>Закрепленное сообщение в Telegram</p></figcaption></figure>

### Пример с минимальным набором параметров

prices = \[\["супер-курс", 100]]

result= tg\_send\_invoice('381764678:TEST:129736', platform\_id, 'SuperКурс по курсам', 'Создавать курсы - superлегко', 'RUB', prices)

<figure><img src="/files/SwGNG2Os2TDRYLBcZYkU" alt="" width="563"><figcaption></figcaption></figure>

<figure><img src="/files/2hHHk7P212ToGG2gZqOE" alt="" width="563"><figcaption></figcaption></figure>

### **Пример с клавиатурой**

prices = \[\["курс", 100], \["НДС", 20.75]]

tg\_send\_invoice('381764678:TEST:129736', platform\_id, 'Курс по курсам', 'Создавать курсы - легко', 'RUB', prices, '<https://salebot.pro/promo.png>', 'course\_pay','0', '0', '1', '1', '1', '', '{"inline\_keyboard": \[\[{"text":"Оплатить", "pay":"True"}], \[{"text":"Еще кнопка", "callback\_data": "Еще кнопка"}]]}')

<figure><img src="/files/XIYUbY6xroxG1YXiagRq" alt="" width="563"><figcaption></figcaption></figure>

<figure><img src="/files/u3AXO2Igbo7YhYC9m18R" alt="" width="503"><figcaption></figcaption></figure>


---

# 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.salebot.pro/chatbots/channels/telegram/payment.md?ask=<question>
```

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.