Оплата в Telegram боте

Платежи 2.0 — В мессенджере Telegram появилась возможность принимать платежи в любом чате, включая группы и каналы. Подключить свой магазин к платформе можно самостоятельно, без согласования с Telegram.

И в этом туториале мы создадим простого бота с Node.js на фреймворке Telegraf.js, который сможет принимать деньги с клиента и отправлять их на ваш счет через Сбербанк.

Платежи 2.0

Платёжные боты существуют в Telegram с 2017 года. С их помощью можно безопасно оплачивать товары и услуги вроде доставки пиццы, не покидая приложения.

С сегодняшнего дня продавцы могут принимать платежи кредитными картами с помощью 8-ми встроенных платёжных систем в любом чате, включая группы и каналы.

На данный момент поддерживаются платежи из более чем 200 стран через следующие платежные системы:

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

Для оплаты можно использовать любое приложение – в том числе Telegram для компьютеров. Покупатель также может оставить чаевые, чтобы поддержать любимого автора, кафе или магазин.

Создаём бота в Telegram

Бот в Telegram создается при помощи другого бота под названием @BotFather. Отправляем ему команду /newbot, выбираем имя, которое будет отображаться в списке контактов, и адрес. Например, Оплата в Telegram боте с адресом sber_pay_test_bot.

Если адрес не занят, а имя введено правильно, BotFather пришлет в ответ сообщение с токеном — «ключом» для доступа к созданному боту.

Внимание

Его нужно сохранить и никому не показывать.

Создаем проект Node.js

Далее создадим новый проект. Создаем папку.

Вводим в консоле:

mkdir sber_pay_test_bot && cd sber_pay_test_bot

Затем:

npm

npm init 

Yarn

yarn init

pnpm

pnpm init

Программа задаёт вам разные вопросы и создает package.json, который определяет настройки проекта, зависимости, скрипты, название и прочее. Для примера можно везде нажать enter

и добавим файл index.js в котором будет разрабатываться наш бот.

touch index.js    

Telegraf.js

Cтавим telegraf.js — это один из популярных фреймворков для создания телеграм бота.

npm

npm install telegraf@3.38 

Yarn

yarn add telegraf@3.38

pnpm

pnpm add telegraf@3.38

Ставим библиотеку dotenv - это модуль, который загружает переменные среды из файла .env в process.env., а также заодно поставим nodemon - инструмент, который помогает разрабатывать приложения на основе node.js путем автоматического перезапуска приложения node при обнаружении изменений файлов в каталоге.

npm

npm install dotenv nodemon

Yarn

yarn add dotenv nodemon

pnpm

pnpm add dotenv nodemon

Добавляем скрипт запуска в package.json

"scripts": {
    "start": "nodemon index"
}

Из документации telegraf.js, копируем в наш проект первоначальную настройку бота.

const { Telegraf } = require('telegraf')
require('dotenv').config()

const bot = new Telegraf(process.env.BOT_TOKEN) //сюда помещается токен, который дал botFather

bot.start((ctx) => ctx.reply('Welcome')) //ответ бота на команду /start
bot.help((ctx) => ctx.reply('Send me a sticker')) //ответ бота на команду /help
bot.on('sticker', (ctx) => ctx.reply('')) //bot.on это обработчик введенного юзером сообщения, в данном случае он отслеживает стикер, можно использовать обработчик текста или голосового сообщения
bot.hears('hi', (ctx) => ctx.reply('Hey there')) // bot.hears это обработчик конкретного текста, данном случае это - "hi"
bot.launch() // запуск бота

Создаем файл .env куда в переменную BOT_TOKEN кладем токен, который ранее нам выдал @BotFather

BOT_TOKEN='сюда'

Запускаем бот командой

npm

npm run start

Yarn

yarn run start

pnpm

pnpm run start

Проверяем работу бота

Получаем PROVIDER_TOKEN от @SberbankPaymentBot

Для получения PROVIDER_TOKEN вам необходимо получить merchantLogin в Сбербанке. Для этого необходимо подключить услугу интерент-эквайринг в Сбербанке.

После того как вы его получили переходим в @BotFather и вызываем команду /mybots, где выбираем вашего бота.

Далее Payments

Где выбираем Сбербанк

Выбираем Connect Сбербанк Live

После этого вас перекинет на @SberbankPaymentBot, где нужно ввести ваш merchantLogin, который необходимо вводить без всяких префиксов -api или -operator. Например так: P71XXXXXXX21. Из-за того что я этого не знал, у меня ушло на переписку с техподдержкой Сбербанка неделя времени.

После @BotFather выдаст вам токен, который нужно вставить в переменную PROVIDER_TOKEN файла .env

PROVIDER_TOKEN='41018XXXX:LIVE:XXXXXXXXXXXXXXXXXXXXXXXXXXXXX'

Подключаем оплату в приложении

Пишем в index.js следующий код:

index.js

const { Telegraf  } = require('telegraf')
require('dotenv').config()

const bot = new Telegraf(process.env.BOT_TOKEN) //сюда помещается токен, который дал botFather

const getInvoice = (id) => {
  const invoice = {
    chat_id: id, // Уникальный идентификатор целевого чата или имя пользователя целевого канала
    provider_token: process.env.PROVIDER_TOKEN, // токен выданный через бот @SberbankPaymentBot 
    start_parameter: 'get_access', //Уникальный параметр глубинных ссылок. Если оставить поле пустым, переадресованные копии отправленного сообщения будут иметь кнопку «Оплатить», позволяющую нескольким пользователям производить оплату непосредственно из пересылаемого сообщения, используя один и тот же счет. Если не пусто, перенаправленные копии отправленного сообщения будут иметь кнопку URL с глубокой ссылкой на бота (вместо кнопки оплаты) со значением, используемым в качестве начального параметра.
    title: 'InvoiceTitle', // Название продукта, 1-32 символа
    description: 'InvoiceDescription', // Описание продукта, 1-255 знаков
    currency: 'RUB', // Трехбуквенный код валюты ISO 4217
    prices: [{ label: 'Invoice Title', amount: 100 * 100 }], // Разбивка цен, сериализованный список компонентов в формате JSON 100 копеек * 100 = 100 рублей
    payload: { // Полезные данные счета-фактуры, определенные ботом, 1–128 байт. Это не будет отображаться пользователю, используйте его для своих внутренних процессов.
      unique_id: `${id}_${Number(new Date())}`,
      provider_token: process.env.PROVIDER_TOKEN 
    }
  }

  return invoice
}

bot.use(Telegraf.log())

bot.hears('pay', (ctx) => { . // это обработчик конкретного текста, данном случае это - "pay"
  return ctx.replyWithInvoice(getInvoice(ctx.from.id)) //  метод replyWithInvoice для выставления счета  
})

bot.on('pre_checkout_query', (ctx) => ctx.answerPreCheckoutQuery(true)) // ответ на предварительный запрос по оплате

bot.on('successful_payment', async (ctx, next) => { // ответ в случае положительной оплаты
  await ctx.reply('SuccessfulPayment')
})

bot.launch()

Метод Telegraf replyWithInvoice это метод telegram.sendInvoice.

Используйте этот метод для отправки счетов. В случае успеха отправленное сообщение возвращается.

Запускаем бот командой yarn start и проверяем проходит ли оплата.

Проверить как работает оплата можно в наших телеграм ботах JavaScript Bot - это бот с тестовыми вопросами по нашим курсам JavaScript, React Native, TypeScript, а также проверить платежи можно боте по изучению английских слов по эмодзи Englishmoji

Проблемы или вопросы?

Задавайте их в телеграм сообществе Боты на Telegraf

Подписывайтесь на наши новости и социальные сети.