Telegram бот bePaid

Любой торговец, у которого есть активный магазин в системе bePaid, а также действующий бот магазина в Telegram, может подключить бот bePaid для приема платежей через Telegram.

Технические ограничения и требования

Для интеграции платежного бота, торговцу необходимо создать бот магазина с помощью Bot Payments API. Пример реализованного бота магазина от Telegram. Перед началом приема платежей торговец должен убедиться, что он выполняет все требования, указанные в чек-листе Telegram.
Оплата с помощью ботов возможна только в приложении Telegram, как в мобильной, так и в десктопной версии. В Telegram Web оплата с помощью ботов недоступна.
С помощью бота bePaid можно оплачивать только физические товары и услуги. Подробнее в политиках Google и Apple.
В боте bePaid доступна оплата с помощью платежных карт. Оплата с помощью альтернативных платежных методов, включая ЕРИП, недоступна.
Оплата с помощью Apple Pay, Google Pay, Samsung Pay недоступна в текущей версии.

Привязка бота магазина к тестовому боту bePaid

Протестировать тестовый бот bePaid может любой торговец, у которого разработан бот магазина с возможностью выставления инвойсов. Торговцу не нужен зарегистрированный магазин в системе bePaid для взаимодействия с тестовым ботом bePaid.

Для тестирования нужно выполнить следующие шаги:

1) Зайти в @BotFather в Telegram.

2) Выбрать бот своего магазина среди своих ботов.

3) Выбрать раздел Payments

4) Выбрать bePaid.by.

5) Выбрать тестовый бот bePaid – @BePaidPaymentTestBot (Connect bePaid.by Test)

Далее после перенаправления в бот bePaid нужно следовать указаниям бота:

6) Ввести ID тестового магазина. Значение будет указано в сообщении бота.

7) Ввести public_key тестового магазина. Значение будет указано в сообщении бота.

В случае успешной привязки бота магазина к боту bePaid необходимо вернуться в @BotFather для получения токена провайдера.

8) Полученный токен нужно указать в качестве provider_token в проекте бота магазина.

9) Проведите тестовую оплату в вашем боте магазина. Используйте карты из таблицы ниже для получения успешной оплаты.

Карточный бренд	Номер карты	3-D Secure аутентификация
Visa	4012000000001006 СКОПИРОВАНО	не требуется
Visa	4012000000001097 СКОПИРОВАНО	требуется
Mastercard	5204240000015003 СКОПИРОВАНО	не требуется
Mastercard	5204240000015029 СКОПИРОВАНО	требуется

Процесс проведения оплаты

Обратите внимание, что процесс может незначительно отличаться в зависимости от конфигурации бота магазина.

1) Покупатель инициирует покупку товара в боте магазина – покупателю отображается инвойс для оплаты товара.

Альтернативный сценарий: продавец размещает инвойс товара в своем публичном канале. В этом случае каждый подписчик канала может оплатить продукт.

2) Покупатель нажимает на кнопку оплаты на инвойсе товара.

3) Открывается окно оформления заказа. Данные, которые покупатель должен предоставить перед вводом данных карты, настраиваются в боте магазина. В данном примере покупатель должен добавить адрес и выбрать способ доставки.

4) Покупатель заполняет необходимые данные.

5) При выборе способа оплаты или при нажатии на кнопку оплаты, при условии, что дополнительные данные добавлены, открывается виджет bePaid. Покупатель вводит данные карты и при желании сохраняет карту в системе bePaid.

6) После ввода карточных данных маска карты отображается на странице оформления заказа.

7) После завершения оплаты, покупатель получает сообщение в боте магазина (настраивается в боте магазина). В случае оплаты в боте магазина (не в публичном канале), Telegram формирует чек для покупателя.

8) В зависимости от настроек бота магазина, после оплаты торговец (администратор бота магазина) получает в боте сообщение с данными транзакции и другой информацией о заказе (настраивается в боте магазина). Например, сообщение может содержать Telegram ID покупателя.

Привязка бота магазина к live боту bePaid

Выполните те же шаги, что и в разделе Привязка бота магазина к тестовому боту bePaid, но в шаге 5 выберите live бота @BePaidPaymentBot.

А в шагах 6–7 введите ID и public_key своего магазина, указанные в личном кабинете bePaid. Если магазин зарегистрирован и активен, торговец получит токен live бота bePaid. После добавления токена в проект бота магазина, бот готов к использованию.