QuanBot. Платежные кнопки
Zaur Abdulgalimov@QuanBot позволяет вам встроить в ваш пост(опрос) платежную кнопку, нажав на которую, пользователь сможет оплатить вашу услугу или товар. Скажу сразу, денежные средства переводятся сразу на ваш счет, и бот не удерживает ни какой комиссии за переводы, оплачивается только подписка $3 в месяц за активацию возможности пользоваться персональным ботом. Для этого вам необходимо зарегистрироваться в платежном провайдере, например Яндекс.Касса или международный Stripe и др. После регистрации в провайдере, вы сможете получить платежный токен, который будет использован ботом QuanBot для проведения оплаты. Хочу обратить внимание, что для получения реального платежного токена, у провайдеров надо зарегистрироваться как юридическое лицо. Информация о том, как зарегистрироваться юр.лицом и получить реальный токен выходит за рамки этой статьи, но к счастью в Телеграм есть возможность получить тестовый токен, для проведения тестовых платежей. Как это сделать я расскажу далее.
Подключение персонального бота
Чтобы оплата происходила напрямую на ваш счет, вы должны получить свой собственный платежный токен, получить его можно с помощью встроенного бота @BotFather. При этом вы можете получить платежный токен только для своего собственного бота, т.е. вы не сможете получить токен и работать с ним через бота QuanBot. Чтобы это было возможным, вам в первую очередь надо создать своего бота, и подключить его к QuanBot. Тогда все ваши опросы, созданные в QuanBot станут доступны в вашем персональном боте. Как создать своего бота и подключить его к возможностям QuanBot, читайте в статье.
Получение платежного токена
В этом разделе я вам покажу как получить тестовый платежный токен, который можно использовать для проверки возможностей бота. Получение реального токена отличается только тем, что вам придется на сайте провайдера ввести ваши данные как юр. лица.
Для получения токена, напишите боту @BotFather команду /mybots, и выберите своего бота:
Нажмите кнопку API Payments:
Выберите провайдера, например Яндекс.Касса:
Обратите внимание, здесь бот показывает две кнопки, первая для получения тестового токена, а вторая для реальных платежей. Тестовый токен работает идентично реальному, за исключением того, что при оплате деньги с карты не списываются. Нажимаем Connect Яндекс.Касса: тест и BotFather нас перенаправляет к боту Яндекс.Кассы, где внизу надо нажать Start(или Начать). Яндекс.Бот попросит вас ответить на несколько вопросов:
Возвращаемся к боту @BotFather, как предлагает Яндекс бот, и тут же видим новый созданный токен:
Обратите внимание, что токеном является только то, что выделено на скриншоте выше, т.е. без названия и даты создания. В данном случае токен это строка:
381764678:TEST:3106
Здесь же сразу можно заметить что этот токен тестовый, об этом говорит слово TEST, в случае реального платежного токена в этом месте будет слово LIVE. Вы можете создать несколько токенов с разными провайдерами. На этом заканчиваем с ботом BotFather и возвращаемся к вашему персональному бота.
Подключение токена
Уточнение, подключить токен внутри бота QuanBot вы не сможете, потому что токен привязывается к конкретному боту, а это значит что дальнейшие действия вы должны делать уже внутри своего персонального бота, который работает на основе QuanBot. Запускаем персонального бота и набираем команду /menu, войдите в раздел Персональный бот:
Откройте раздел Платежные токены, и нажмите кнопку ➕Добавить токен, бот предложит выбрать валюту, вы можете выбрать из списка, или написать текстом, например "rub":
Здесь надо отметить, что провайдеры поддерживают оплату только в определенных валютах, например в Яндекс.Кассе нельзя указывать валюту в долларах или евро, поэтому выбираем RUB. Этот шаг нужен только для проверки подлинности вашего токена, если вдруг платежный провайдер поддерживает оплаты в разных валютах, как например Stripe, тогда при создании кнопок оплаты, вы сможете выбрать любую валюту. Итак, выбираем RUB, и бот попросит вам написать ему название этого токена. Это название только для вас, чтобы вы могли отличить его в списке от других своих токенов, это название не увидят пользователи вашего бота. Например можно написать Яндекс - тест, далее бот попросит прислать ему сам токен, ту строку, которую вам показал @BotFather после регистрации у провайдера:
Все, платежный токен создан. На скрине выше видно что перед созданием токена, бот попытался создать платежную кнопку на сумму 119,40 RUB, это он сделал для проверки правильности вашего токена, если с токеном что то не так, вы получите ошибку. Обратите внимание на символ 🛠 перед названием вашего токена Яндекс - тест, символ означает что это Тестовый токен, чтобы вы не путали его с реальным при создании платежных кнопок. При повторном нажатии на кнопку с названием токена, бот предложить удалить этот токен с подтверждением.
Нажмите на кнопку назад, чтобы выйти в предыдущее меню, для создания квитанций.
Создание квитанций
Квитанция в терминологии QuanBot - это просто набор параметров, которые используются для выдачи пользователю платежных кнопок. Т.е. вы создаете разные квитанции а затем привязываете нужную квитанцию к нужной кнопке внутри вашего опроса(поста). В главном меню персонального бота, нажмите на кнопку Квитанции(имейте ввиду, что это кнопка появляется только после того как вы добавили хотя бы 1 платежный токен):
В разделе квитанци жмите кнопку ➕Добавить квитанцию:
Выбираем здесь созданный ранее токен и бот опять просит выбрать валюту. Это уже будет та валюта, в которой ваши пользователи будут платить, кликнув на платежную кнопку:
После выбора валюты, бот попросит написать ему имя квитанции(32 символа) и описание(255 символов) - это та информация, которую увидит пользователь при попытке оплатить. После указания имени и описания, напишите боту цену, которую вы хотите закрепить в этой квитанции:
Здесь стоит обговорить подробнее. Откуда взялись ограничивающие цифры 59,70 и 597 089,78? Эти данные берутся из таблицы(или json файл), которую предоставляет Telegram, и он выдаст ошибку, если попытаться указать цену выходящую за эти рамки. Так же опытным путем установлено, что данные в таблице обновляются с опозданием, и может быть так, что вы указали цену например 59.8, но бот показывает ошибку и просит вновь написать цену в указанных рамках. Это значит что скорее всего минимально допустимая цена на серверах Telegram обновилась, а вот в таблице нет. В этом случае попробуйте указать цену чуть больше, например 60 или больше. Как Telegram формирует эту таблицу, и почему нельзя указать цену меньше заявленной в таблице - с этим вопросом надо обращаться в тех поддержку Telegram. После указания цены, бот попросит прислать ему фото или же ссылку на картинку. Эта картинка будет отображаться на форме оплаты:
После чего квитанция будет создана, и вы увидите меню с дополнительными настройками:
Все опции по умолчанию выключены, вы можете включить их нажав на кнопку, и включенные опции будут помечены иконкой ✅, как Имя и Телефон на скрине выше. Установка опций Имя, Телефон, Email и Адрес будет означать что бот в момент оплаты потребует от пользователя соответствующую информацию. После завершения настроек, нажмите на кнопку Проверить квитанцию и если все хорошо, вы увидите кнопку для оплаты:
Помните что оплата возможно только в мобильных приложениях, десктопные и web пока не умеют принимать оплату.
Нажмите в мобильном клиенте кнопку Pay 60,00 RUB и бот покажет форму оплаты:
Здесь уже ваш Телеграм клиент попросит вас указать способ оплаты, а так же те опции, которые вы выбрали в настройках квитанции: Имя и Телефон. Обратите внимание наверху формы, рядом с текстом Оплатить, есть надпись (Test), это значит что был использован тестовый токен, и эту надпись увидят все пользователи вашего бота. Также хочу обратить ваше внимание на то, что ни бот QuanBot ни ваш персональный бот не сможет ни как получить информацию о способе оплаты, которую указывает пользователь, о чем клиент Telegram уведомляет пользователя при первой попытке оплатить:
На этом все, создание квитанции завершено. Вы можете создать сколько угодно квитанций, а потом одним кликом прикреплять их к вашему опросу(посту). Как это сделать читайте далее:
Создание платежных кнопок
Создайте ваш опрос, можно без кнопок голосования, просто текст и картинки/файлы при необходимости. Создайте новую кнопку и войдите в раздел редактирования этой кнопки, где вы увидите кнопку Квитанция:
Нажав на которую вы увидите список созданных ранее квитанций:
Выберите нужную квитанцию. Помните что иконкой 🛠 помечаются квитанции, которые были созданы тестовым токеном. Вот и всё, можно публиковать пост, который будет выглядеть как обычный опрос с кнопкой:
Вы можете к одному посту(опросу) прикрепить неограниченное количество платежных кнопок. Несколько кнопок может понадобиться например для разных цен или разных провайдеров, например 1 кнопка от провайдера Яндекс.Кассы для оплаты в рублях, и 1 кнопка от провайдера Stripe для оплаты в долларах.
Если этот пост опубликовать в группе или канале, то после нажатия на кнопку 💵 Оплатить, пользователь будет перенаправлен в приват к вашему персональному боту, где внизу надо будет нажать на кнопку Start(Начать), и пользователь увидит кнопку для оплаты:
Попробуйте оплатить, если токен был тестовый - реальное списание средств не будет, но после окончания процесса оплаты, вы увидите информацию о том, что чек успешно оплачен:
Обратите внимание на текст Чек #19 оплачен, 19 - это уникальный номер который присваивается каждой попытке воспользоваться вашей платежной кнопкой. Такое уведомление приходит пользователю совершившему оплату, а вам, как автору опроса придет аналогичное уведомление, с кнопкой отображения подробностей чека.
Посмотреть список платежей
Чтобы увидеть список пользователей, воспользовавшихся вашей платежной кнопкой, войдите в раздел Результаты, в главном меню вашего опроса: и нажмите кнопку Показать проголосовавших, под каждой платежной кнопкой вы увидите кнопку Показать чеки:
После нажатия бот покажет подробную статистику по использованию этой кнопки:
Здесь вы можете увидеть статусы созданных чеков и их количество.
➕CREATEЭтот статус означает что пользователь внутри опроса нажал на кнопку 💵 Оплатить📢PUBLISHБот показал пользователю кнопку для оплаты💲PRE_CHECKOUTПользователь нажал кнопку Pay 60,00 RUB, увидел форму оплаты, ввел данные и попытался оплатить☑️CHECKOUT_COMPLETE- Оплата прошла успешно🚫ERROR- В процессе оплаты произошла ошибка✅SUCCESSFUL- Оплата подтверждена провайдером
Под статусом ✅SUCCESSFUL отображается список пользователей, которые завершили оплату. Справа от имени пользователя отображается кнопка #19, с номером чека, кликнув на эту кнопку, вы увидите подробности этого чека:
Здесь поля Имя и Телефон - это те поля, которые мы запрашивали когда создавали квитанцию, т.е. то, что пользователь указал в форме в момент оплаты.