ModularBot
February 22, 2024

Методы оплаты в Modular-Shop

Чтобы клиенты могли совершать покупки, необходимо настроить один или несколько способов оплаты:

ВНИМАНИЕ: для того, чтобы клиент мог продолжить оплату, должен быть выбран хотя бы один из способов!

Telegram

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

Telegram позволяет настраивать несколько различных провайдеров:
https://core.telegram.org/bots/payments#supported-payment-providers.

В этом руководстве мы будем использовать в качестве примера один из самых известных, а именно Stripe.
Первым делом нам нужно подключить нашего бота к Stripe, а для этого нам нужно запустить BotFather и отправить команду /mybots.

После того, как мы выбрали нашего бота из списка, нам нужно будет нажать кнопку «Payments».

Выбираем Stripe из списка провайдеров:

И, наконец, нажимаем кнопку, чтобы подключить режим Stripe TEST к нашему боту:

Через тестовый режим можно будет совершать нереальные платежи, чтобы проверить правильность работы платежа через бота.

Как только мы нажмем «Connect Stripe Test», мы будем перенаправлены к боту Stripe Test, чтобы разрешить Stripe подключиться к нашему боту:

Затем, нажав «Authorize», мы будем перенаправлены на сайт Stripe, чтобы начать настройку:

Введите адрес электронной почты и нажмите кнопку «Continue», чтобы продолжить.

Введите необходимую информацию, а в последние два поля введите информацию, касающуюся бота, например ссылку для первого случая и описание во втором. Нажмите «Continue», чтобы перейти к части, касающейся банковского счета:

В данном случае, поскольку мы настраиваем ТЕСТОВЫЙ режим, вы можете ввести нереальные данные и продолжить, нажав кнопку «Continue».

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

Однако прежде чем приступить к тестированию платежей, необходимо вернуться в чат с BotFather, при котором в меню провайдеров появится секретный токен:

Этот токен будет вставлен в соответствующее место системы управления Modular-Shop.
Итак, зайдём к нашему боту в раздел магазина:

Нажимаем «Управление магазином», что перенаправит нас в нашу систему управления:

Нажимаем кнопку «Настройки» в правом верхнем углу, чтобы попасть на страницу настройки способов оплаты, и вставляем токен в поле Токен Telegram - Test:

Нажмите «Подтвердить», и метод оплаты Telegram будет включен.

Давайте теперь попробуем совершить тестовый платеж:

Наконец, нажав кнопку «Карта», запустится процедура оплаты через Telegram:

После нажатия кнопки «Заплатить» в качестве номера карты введите: 4242 4242 4242 4242. Также введите остальные поля с вымышленной информацией:

Наконец, нажмите «Готово» > «Заплатить» > «Продолжить», и вы получите награду за продукт, который вы приобрели в качестве теста.

Мы только что увидели, как настроить оплату Telegram в тестовом режиме, теперь нам нужно также настроить реальный режим, чтобы клиенты могли приобретать наши товары.

Для этого просто выполните ту же только что описанную процедуру, введя правильные данные при регистрации в Stripe. Чтобы зарегистрироваться на Stripe в реальном режиме, просто нажмите кнопку Connect Stripe Live:

После завершения регистрации у вас будет второй секретный токен, который вам нужно будет вставить в поле Токен Telegram - Real системы управления.

Только после того, как вы введете токен Real (реальный), ваши пользователи смогут платить с помощью Telegram. Токен Test может оставаться активным и будет использоваться ботом для совершения тестовых платежей, если ваши администраторы захотят совершить покупку с помощью кнопки бота «Опробовать магазин».

Ручной

Ручной платеж заключается в отправке инструкций по оплате каждому пользователю, который хочет что-то приобрести в нашем магазине. Эти инструкции должны быть настроены в системе управления и будут автоматически отправлены ботом каждому пользователю в момент оплаты.
Инструкции означают, например, просьбу отправить денежную сумму на определенный банковский счет. Кроме того, в этой же инструкции нужно будет объяснить пользователю, что в качестве доказательства необходимо отправить в чат скриншот платежа.

Вы можете использовать следующие переменные для вставки пользовательских данных, которые заменят переменную в сообщении:

%amount%, который будет заменен общей стоимостью корзины.

%id%, который будет заменен идентификатором пользователя Telegram.

На изображении ниже мы можем видеть пример этого:

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

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

Чтобы использовать ручной платеж, необходимо сначала создать группу в Telegram для управления платежами пользователей; впоследствии мы активируем режим темы в нашем боте, перейдя в главное меню, нажав «Обратная связь» и «Режим темы»:

Затем нажимаем «Активировать режим Темы»; После завершения работы наша группа будет настроена в «Режим темы» с нашим ботом внутри:

Активировав «Режим темы», у вас будет чат для каждого пользователя, который отправит вам экран подтверждения платежа.

Затем приступаем к осуществлению тестового платежа:

После добавления товара в корзину и подтверждения нажимаем на настроенную кнопку, которую мы определили ранее (PayPal):

На этом этапе мы отправляем тестовое изображение:

Бот говорит нам дождаться одобрения. Затем мы возвращаемся к группе в которое мы активировали ранее «Режим Темы», где появится чат с пользователем, совершившим оплату (нами):

Убедившись, что все в порядке, просто нажмите «Действительный платеж», и пользователю будет отправлено награда за то, что он купил.

Однако если с отправленным изображением возникли проблемы, мы можем нажать «НЕДЕЙСТВИТЕЛЬНЫЕ ПЛАТЕЖ», и пользователь получит автоматическое сообщение об ошибке платежа.

Мы рекомендуем связаться с пользователем через чат в теме и объяснить, что пошло не так с платежом.

Криптовалюта

Чтобы настроить оплату криптовалютой, вам необходимо сначала запустить бота, с помощью которого будут управляться транзакции. Затем давайте запустим тестового бота @CryptoTestnetBot:

Нажимаем кнопку «Crypto Pay», чтобы начать настройку платежа:

И затем нажимаем «Создать приложение»:

Наконец, мы нажимаем «Вебхуки», а затем Включить вебхуки»:

На этом этапе нас попросят отправить URL-адрес сервера:

Затем мы отправляем URL-адрес сервера Modular https://cryptobot.modularbot.me/webhook.

Если операция прошла успешно, вы должны найти URL-адрес в сообщении бота.

Давайте вернемся и проверим, включена ли опция «Вебхуки»:

Затем мы нажимаем кнопку «API-токен»:

Код, выделенный синим цветом, — это ваш секретный токен для платежей в криптовалюте. Сохраните его, скоро он нам пригодится.Предупреждение: никогда и никому не отправляйте свой токен Crypto!

Этот токен нужно вставить в соответствующее место системы управления Modular-Shop.
Итак, зайдём к нашему боту в раздел магазина:

Нажимаем «Управление магазином», что перенаправит нас в нашу систему управления магазином:

Нажмите кнопку «Настройки» в правом верхнем углу, чтобы попасть на страницу настройки способов оплаты.

Мы выбираем Криптовалюта, после вставляем Криптотокен Тест , который мы сохранили несколько шагов назад, и нажимаем «Подтвердить»:

Если операция прошла успешно, на выбранном способе оплаты появится чек.

Давайте теперь загрузим несколько фиктивных криптовалют в наш тестовый кошелек, чтобы попробовать совершить платеж с помощью криптовалюты.
Давайте сначала вернемся в главное меню @CryptoTestnetBot и нажмем
Кошелёк > Пополнить> Tether - USDT:

Наконец, мы нажимаем TRON > Получить тестовые монеты USDT:

На этом этапе в наш кошелек будет добавлено 25 USDT, которые можно будет использовать для тестовых платежей:

Теперь, когда у нас есть несколько тестовых криптовалют, мы можем попробовать совершить платеж. Открываем наш магазин, нажав на «Опробовать магазин», добавляем товар в корзину и подтверждаем:

На этом этапе нас перенаправят на Crypto бот, где нас спросят, чем платить; выбираем добавленную ранее Криптовалюту и нажимаем «Оплатить»:

После оплаты Crypto бот подтвердит оплату, а наш бот отправит нам награду за только что приобретенный товар!

Мы только что увидели, как настроить оплату Криптовалютой в тестовом режиме, теперь нам также нужно настроить реальный режим, чтобы клиенты могли приобретать наши товары.
Для этого просто выполните ту же процедуру, только что описанную, но настройте бота @CryptoBot для реальных платежей Криптовалютой.

Наконец, после того, как все шаги будут выполнены и в @CryptoBot, рекомендуется переименовать ваш платеж в «Приложение», то есть имя, которое пользователи увидят во время покупки, следующим образом:

Нажав «Crypto Pay» > «Мои приложения» > «Изменить имя», отправьте имя вашего магазина.