Чтобы принимать платежи в Telegram, нужно сделать три вещи: 1. [Создать бота](#telegram__01). 2. [Подключить его к боту ЮKassa](#telegram__02). 3. [Настроить своего бота для работы с платежами](#telegram__03). Для настройки платежей через бота потребуется параметр — он появится у вас после [подключения к ЮKassa](/joinups). Чтобы подключить бота к ЮKassa, нужно перевести магазин на email-протокол. Попросите нас об этом по почте [ecommerce@yoomoney.ru](mailto:ecommerce@yoomoney.ru) или по телефону 8 800 250‒66‒99. Важно: укажите shopId магазина, к которому хотите подключить бота.

1. В Telegram откройте диалог с [@BotFather](https://telegram.me/botfather), отправьте ему команду **/start**, затем — **/newbot**. ![](kassa/support/instructions-telegram-01.png) 2. Придумайте боту имя (name) и юзернейм (username). Имя бота будет в списке контактов и наверху чата, оно может быть неуникальным. Юзернейм будет в короткой ссылке на бота, он должен быть уникальным. ![](kassa/support/instructions-telegram-02.png) 3. Например: ЮKassa: платежи — имя бота YooKassaPaymentBot — это юзернейм бота ![](kassa/support/instructions-telegram-03.png) 4. Если юзернейм не занят, BotFather пришлет в ответ сообщение с токеном — «ключом» для доступа к созданному боту, его нельзя сообщать посторонним (даже службе поддержки ЮKassa или Telegram). ![](kassa/support/instructions-telegram-04.png) Когда ключ у вас, бот готов: теперь можно добавить иконку и настроить диалог с клиентами. Одновременно можно настраивать платежи через бота.

Не забудьте перевести магазин на email-протокол. Для этого напишите нам [ecommerce@yoomoney.ru](mailto:ecommerce@yoomoney.ru) или позвоните 8 800 250‒66‒99. 1. Отправьте [@BotFather](https://telegram.me/botfather) команду **/mybots**. Нажмите на имя своего бота. ![](kassa/support/instructions-telegram-05.png) 2. Откроется панель управления ботом. Выберите **BotSettings — Payments**. ![](kassa/support/instructions-telegram-06.png) 3. Если хотите сразу настроить настоящие платежи, в открывшемся меню выберите **Connect ЮKassa: платежи**. Если хотите сначала протестировать — выберите **Connect ЮKassa: тест**. ![](kassa/support/instructions-telegram-07.png)

* Откроется диалог с ботом ЮKassa.Отправьте ему команду **/start**, затем ваш (его можно скопировать в личном кабинете ЮKassa).

* Бот спросит ваш . Если не знаете этот параметр, отправьте в ответ 0 (ноль).

![](kassa/support/instructions-telegram-08.png)

* Откроется диалог с тестовым ботом ЮKassa. Отправьте ему команду **/start**. В ответ бот пришлёт вам число — идентификатор тестового магазина (он заменяет , который будет нужен при настройке настоящих платежей). Отправьте это число боту в ответ.

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

Обратите внимание, что платежи для тестового магазина должны быть не более 1000 рублей.

6. Вернитесь к диалогу с @BotFather. Он пришлёт вам токен, который нужен для выставления счетов. Токен всегда можно посмотреть через **BotSettings — Payments**.

Обратите внимание: дальше речь пойдёт о настройке бота через API Telegram. Если вы используете конструктор ботов (Manybot, Botobot, Botmaker или любой другой), следуйте его инструкциям. 1. Реализуйте [метод sendinvoice из платёжного API Telegram](https://core.telegram.org/bots/api#sendinvoice): в ответ на этот запрос ваш бот будет отправлять клиенту счёт на оплату. В счёте должна быть стоимость, название, описание товара, параметр и параметр — это тот самый токен, который выдал @BotFather после подключения вашего бота к боту ЮKassa. Обратите внимание, что платежи для тестового магазина должны быть не более 1000 рублей. ![](kassa/support/instructions-telegram-09.png) **Если вы настраивали фискализацию через ЮKassa**, нужно передавать в ЮKassa данные для фискализации. Для этого добавьте в запрос следующие параметры: - или - (если вы запрашивали у клиента электронную почту) или (если вы запрашивали у клиента телефон), - и в нём объект . Подробности — в [API ЮKassa](/developers/api#create_payment) (смотрите раздел **Атрибуты — receipt**). ![](kassa/support/instructions-telegram-10.png) Телефон или почту вы можете запросить у клиента раньше, в диалоге с ботом. Тогда первые два параметра не нужны, достаточно с объектом . ![](kassa/support/instructions-telegram-11.png) [Подробнее про 54-ФЗ в работе с ЮKassa](/docs/support/payments/tax-sync) **Если вам нужно получить от клиента адрес для доставки**, реализуйте метод **Shipping Query**. Когда пользователь укажет адрес, на этот запрос нужно ответить методом **answerShippingQuery**. В этом методе нужно передать способы доставки и их цены. 2. Когда пользователь подтвердит платёж, Telegram пришлёт вам webhook с Update, который содержит объект **PreCheckoutQuery**. На этот запрос нужно ответить в течение 10 секунд, вызвав метод **answerPreCheckoutQuery**. 3. Если платёж пройдёт успешно, вы получите два уведомления: от Telegram (webhook с объектом **SuccessfulPayment**) и от ЮKassa (email). Бота можно запрограммировать так, чтобы после успешного платежа он совершал определённое действие: например, подключал покупателю услугу или отправлял контент. В объекте **SuccessfulPayment** из уведомления от Telegram найдите параметр provider_payment_charge_id: там будет номер транзакции в ЮKassa. Этот номер лучше сохранить: по нему можно будет найти платёж в личном кабинете.

Обратите внимание: оплата через бота не поддерживается в десктопной и веб-версии Telegram — только в приложении. Для примера возьмём оплату через тестовый бот ЮKassa — @YooKassaTestShopBot. 1. Нажмите **Запустить** (команда **/start**). Вам придёт сообщение с инструкцией и кнопкой оплаты. В тестовом боте оно выглядит так: ![](kassa/support/instructions-telegram-12.png) 2. Нажмите **Заплатить**. 3. Откроется платёжная форма. 4. Введите данные карты и нажмите **Заплатить**. 5. На странице **Checkout** нажмите **Pay**. ![](kassa/support/instructions-telegram-14.png) 6. После успешной оплаты @YooKassaTestShopBot отправит в чат номер транзакции (для своего бота вы сможете запрограммировать другое действие).