TELEGRAM BLOG
Платежи через ботов в телеграм
Обновление Telegram v.4.0 включает в себя две другие основные функции в дополнение к платежам. Не пропустите новый сервис видео сообщений — телескоп и Instant View Platform !
Представьте себе мир, где вы можете заказать пиццу, заплатить за пару обуви, такси, или заплатить и тут же войти в метро — все в несколько нажатий кнопок прямо в телеграмм.
Для того, чтобы создать этот мир, сегодня мы запускаем Bot платежи. Теперь боты могут принимать платежи от своих пользователей по всему миру:
Если у вас установлена Телеграмм 4.0 (или более поздняя версия), то вы можете заказать товары или услуги от ботов и тут же оплатить их если бот предоставил кнопку оплаты. При нажатии кнопки оплаты, вам будет предложено заполнить данные вашей кредитной карты и подтвердить платеж. Вуаля! И всё это не выходя из любимого мессенджера!
Если ваша учетная запись защищена 2-двухэтапной авторизацией, то вы можете сохранить вашу карту для будущих покупок.
Оплатить прямо сейчас
Попробуйте наш демо @ShopBot, чтобы получить пример счёта на оплату (этот демо — продает машины времени, которые не существуют) . Если вы хотите, проверить реальный процесс оплаты с реальными деньгами, то попробуйте нашего @TelegramDonate бота.
Телеграмм является открытой платформой, так что разработчики ботов могут смело внедрять необходимые интерфейсы и принимать платежи от пользователей прямо сейчас, без длительных процедур утверждения платежных систем. Если вы разработчик бота, посмотрите документацию и приступайте!
В настоящее время большинство платежей обрабатывается системой stripe.com, но Bot Pay — это платформа для оплаты поставщиков услуг по всему миру, поэтому при приеме платежа от пользователя, разработчик бота может предоставить ему выбор между всеми доступными платежными системами (например выбрав один уже используемый покупателем метод оплаты или с наименьшей комиссией)
Stripe — это только начало. В ближайшие дни, бот-платежи будут доступны для разработчиков в Индии через RazorPay, в Нигерии, Кении, Ганы, Южной Африки и Уганды через FlutterWave, и в более чем 190 других странах через Paymentwall.
Наберитесь терпения, так как вскоре Yandex.Money и Qiwi также будут доступны для оплаты из России и Payme из Узбекистана будут подключены чуть позже. Следите за обновлениями нашего канала @Tblog, чтобы первыми узнать о подключении новых способов оплаты.
Если вы являетесь платежной системой или поставщиком оплаты (особенно в развивающихся странах), то нажмите здесь, чтобы узнать, как попасть на борт Telegram Payments.
Как происходит оплата в Телеграм
Телеграмм при приёме платежей выступает в качестве посредника между плательщиком-пользователем, разработчиком бота, и выбранной платежной системой. Пользователь отправляет свои данные кредитной карты непосредственно к платежной системе. После чего ответ платежной системы и необходимые технические данные, введенные пользователем, передаются разработчику бота, так что они могут обработать и завершить заказ.
Телеграм не участвует напрямую в проведении платежей, поэтому любые спорные платежи возлагаются на ответственность разработчиков ботов, провайдеров платежных систем и банков, которые участвовали в заказе. Телеграм лишь будет выступать в роли шерифа — стрелять плохих роботов и награждать хороших значком. Мы уверены, что хороших ботов будет больше.
Поскольку Телеграмм не обрабатывает платежи, мы не храним и не можем получить доступ к любым конфиденциальным данным. Мы также не берем комиссию с платежей и не получаем прибыль от этих сделок.
- … один из наших прекрасных пользователей, то вскоре ты увидишь, какие чудо боты появятся на свет благодаря нашим разработчикам, используя эту новую платформу. В то же время, уже сейчас Вы можете попробовать демо @ShopBot, чтобы получить представление о том, что будет происходить при оплате или попробуйте потратить реальные деньги через @TelegramDonate.
- … разработчик бота, ознакомьтесь с Введением в платежи и PAYMENT API , чтобы увидеть то, что вы можете создать на этой платформе.
- … провайдер платежей, то узнайте, как попасть на борт Телеграм.
Вас по какой-то странной причине не оказалось в списке указанном выше ? Не расстраивайтесь, присоединяйтесь к Телеграм сейчас!
Удачных покупок всем, и до скорых обновлений!
Май 18, 2017
Телеграмм команда
Платежи для ботов
Представьте, как было бы здорово, если бы можно было оплачивать что угодно нажатием всего одной кнопки, без возни с переписыванием номера карты или кошелька.
Именно такую кнопку мы добавили в Telegram в этом обновлении: теперь вы можете как покупать любой товар или услугу в один клик, так и продавать что угодно при помощи ботов. Вот, как это выглядит:
При первой покупке вам потребуется указать данные своей карты (да, один раз повозиться с этим всё же придётся) и адрес для доставки. Если ваш аккаунт защищён с помощью двухэтапной авторизации, то вы сможете сохранить всю эту информацию для будущих покупок. Ну и, само собой, вы можете оплатить товар с помощью Apple Pay или Android Pay.
Кто же будут обрабатывать платежи? Ответ прост: любой банк или сервис, который захочет. В частности, в России обработкой платежей будут заниматься Яндекс. Деньги и QIWI, а в Узбекистане — Payme.
Если к системе решат подключиться другие сервисы, мы напишем об этом на специальном канале @BotNewsRu. Подписывайтесь!
Во всей этой системе Telegram выступает в роли посредника между пользователем, разработчиком бота и платёжной системой, которую этот бот использует. Все платёжные данные, которые вы вводите, отправляются напрямую в платёжную систему. Дальше, если система увидела ваш платёж и даёт добро, ваши контактные данные (адрес для доставки) отправляется боту, чтобы он мог завершить оформление заказа.
У такой системы есть как преимущества, так и недостатки.
Из плюсов: ваши данные будут находиться в безопасности, поскольку Telegram не хранит и не обрабатывает их.
Из минусов: Telegram не сможет обрабатывать жалобы и возвраты средств. Все эти проблемы вам придётся решать самостоятельно: с владельцем бота, платёжной системой или вашим банком.
Однако, Telegram будет контролировать ситуацию в целом и будет блокировать ботов, которые занимаются мошенничеством, вымогательством или прочими нехорошими вещами.
- . обычный пользователь: просто ждите, пока разработчики ботов напишут что-нибудь интересное. А пока можете поиграть с демо-ботом, который продаёт несуществующие вещи: @ShopBot.
- . разработчик ботов: как обычно, читайте документацию и делайте ботов.
- . платёжный сервис: подключайтесь к нашему API.
Как настроить платежи через бота в Telegram
Чтобы принимать платежи в Telegram, нужно сделать три вещи:
Для настройки платежей через бота потребуется параметр shopId — он появится у вас после подключения к Яндекс.Кассе.
Как создать бота
1. В Telegram откройте диалог с @BotFather, отправьте ему команду /start, затем — /newbot.
2. Придумайте боту имя (name) и юзернейм (username). Имя бота будет в списке контактов и наверху чата, оно может быть неуникальным. Юзернейм будет в короткой ссылке на бота, он должен быть уникальным.
Яндекс.Касса — имя бота
YandexCheckoutPaymentBot — это юзернейм бота
4. Если юзернейм не занят, BotFather пришлет в ответ сообщение с токеном — «ключом» для доступа к созданному боту, его нельзя сообщать посторонним (даже службе поддержки Кассы или Telegram).
Когда ключ у вас, бот готов: теперь можно добавить иконку и настроить диалог с клиентами. Одновременно можно настраивать платежи через бота.
Как подключить своего бота к боту Кассы
1. Отправьте @BotFather команду /mybots. Нажмите на имя своего бота.
2. Откроется панель управления ботом. Выберите BotSettings — Payments.
3. Если хотите сразу настроить настоящие платежи, в открывшемся меню выберите Connect Яндекс.Касса: платежи. Если хотите сначала протестировать — выберите Connect Яндекс.Касса: тест.
4. Откроется диалог с ботом Яндекс.Кассы.Отправьте ему команду /start, затем ваш shopId (его можно скопировать в личном кабинете Яндекс.Кассы).
5. Бот спросит ваш shopArticleId. Если не знаете этот параметр, отправьте в ответ 0 (ноль).
4. Откроется диалог с тестовым ботом Яндекс.Кассы. Отправьте ему команду /start. В ответ бот пришлёт вам число — идентификатор тестового магазина (он заменяет shopId, который будет нужен при настройке настоящих платежей). Отправьте это число боту в ответ.
5. После этого бот пришлёт тестовый shopArticleId. Отправьте это число боту в ответ. В следующем сообщении бот пришлёт настройки тестового магазина и данные тестовой карты для оплаты.
6. Вернитесь к диалогу с @BotFather. Он пришлёт вам токен, который нужен для выставления счетов. Токен всегда можно посмотреть через BotSettings — Payments.
Как настроить бота для работы с платежами
Обратите внимание: дальше речь пойдёт о настройке бота через API Telegram. Если вы используете конструктор ботов (Manybot, Botobot, Botmaker или любой другой), следуйте его инструкциям.
1. Реализуйте метод sendinvoice из платёжного API Telegram: в ответ на этот запрос ваш бот будет отправлять клиенту счёт на оплату. В счёте должна быть стоимость, название, описание товара, параметр payload и параметр provider_token — это тот самый токен, который выдал @BotFather после подключения вашего бота к боту Кассы.
Если вы настраивали фискализацию через Яндекс.Кассу, нужно передавать в Кассу данные для фискализации. Для этого добавьте в запрос следующие параметры:
Телефон или почту вы можете запросить у клиента раньше, в диалоге с ботом. Тогда первые два параметра не нужны, достаточно provider_data с объектом receipt.
Если вам нужно получить от клиента адрес для доставки, реализуйте метод Shipping Query. Когда пользователь укажет адрес, на этот запрос нужно ответить методом answerShippingQuery. В этом методе нужно передать способы доставки и их цены.
2. Когда пользователь подтвердит платёж, Telegram пришлёт вам webhook с Update, который содержит объект PreCheckoutQuery. На этот запрос нужно ответить в течение 10 секунд, вызвав метод answerPreCheckoutQuery.
3. Если платёж пройдёт успешно, вы получите два уведомления: от Telegram (webhook с объектом SuccessfulPayment) и от Яндекс.Кассы (email). Бота можно запрограммировать так, чтобы после успешного платежа он совершал определённое действие: например, подключал покупателю услугу или отправлял контент.
В объекте SuccessfulPayment из уведомления от Telegram найдите параметр provider_payment_charge_id: там будет номер транзакции в Яндекс.Кассе. Этот номер лучше сохранить: по нему можно будет найти платёж в личном кабинете.
Как выглядит платёж через бота в Telegram
Обратите внимание: оплата через бота не поддерживается в десктопной и веб-версии Telegram — только в приложении.
Для примера возьмём оплату через тестовый бот Кассы — @YandexCheckoutTestShopBot.
1. Нажмите Запустить (команда /start). Вам придёт сообщение с инструкцией и кнопкой оплаты. В тестовом боте оно выглядит так:
2. Нажмите Заплатить.
3. Откроется платежая форма:
4. Введите данные карты и нажмите Заплатить.
5. На странице Checkout нажмите Pay.
6. После успешной оплаты @YandexCheckoutTestShopBot отправит в чат номер транзакции (для своего бота вы сможете запрограммировать другое действие).
Как настроить платежи через бота в Telegram
Чтобы принимать платежи в Telegram, нужно сделать три вещи:
Для настройки платежей через бота потребуется параметр shopId — он появится у вас после подключения к Яндекс.Кассе.
Как создать бота
1. В Telegram откройте диалог с @BotFather, отправьте ему команду /start, затем — /newbot.
2. Придумайте боту имя (name) и юзернейм (username). Имя бота будет в списке контактов и наверху чата, оно может быть неуникальным. Юзернейм будет в короткой ссылке на бота, он должен быть уникальным.
Яндекс.Касса — имя бота
YandexCheckoutPaymentBot — это юзернейм бота
4. Если юзернейм не занят, BotFather пришлет в ответ сообщение с токеном — «ключом» для доступа к созданному боту, его нельзя сообщать посторонним (даже службе поддержки Кассы или Telegram).
Когда ключ у вас, бот готов: теперь можно добавить иконку и настроить диалог с клиентами. Одновременно можно настраивать платежи через бота.
Как подключить своего бота к боту Кассы
1. Отправьте @BotFather команду /mybots. Нажмите на имя своего бота.
2. Откроется панель управления ботом. Выберите BotSettings — Payments.
3. Если хотите сразу настроить настоящие платежи, в открывшемся меню выберите Connect Яндекс.Касса: платежи. Если хотите сначала протестировать — выберите Connect Яндекс.Касса: тест.
4. Откроется диалог с ботом Яндекс.Кассы.Отправьте ему команду /start, затем ваш shopId (его можно скопировать в личном кабинете Яндекс.Кассы).
5. Бот спросит ваш shopArticleId. Если не знаете этот параметр, отправьте в ответ 0 (ноль).
4. Откроется диалог с тестовым ботом Яндекс.Кассы. Отправьте ему команду /start. В ответ бот пришлёт вам число — идентификатор тестового магазина (он заменяет shopId, который будет нужен при настройке настоящих платежей). Отправьте это число боту в ответ.
5. После этого бот пришлёт тестовый shopArticleId. Отправьте это число боту в ответ. В следующем сообщении бот пришлёт настройки тестового магазина и данные тестовой карты для оплаты.
6. Вернитесь к диалогу с @BotFather. Он пришлёт вам токен, который нужен для выставления счетов. Токен всегда можно посмотреть через BotSettings — Payments.
Как настроить бота для работы с платежами
Обратите внимание: дальше речь пойдёт о настройке бота через API Telegram. Если вы используете конструктор ботов (Manybot, Botobot, Botmaker или любой другой), следуйте его инструкциям.
1. Реализуйте метод sendinvoice из платёжного API Telegram: в ответ на этот запрос ваш бот будет отправлять клиенту счёт на оплату. В счёте должна быть стоимость, название, описание товара, параметр payload и параметр provider_token — это тот самый токен, который выдал @BotFather после подключения вашего бота к боту Кассы.
Если вы настраивали фискализацию через Яндекс.Кассу, нужно передавать в Кассу данные для фискализации. Для этого добавьте в запрос следующие параметры:
Телефон или почту вы можете запросить у клиента раньше, в диалоге с ботом. Тогда первые два параметра не нужны, достаточно provider_data с объектом receipt.
Если вам нужно получить от клиента адрес для доставки, реализуйте метод Shipping Query. Когда пользователь укажет адрес, на этот запрос нужно ответить методом answerShippingQuery. В этом методе нужно передать способы доставки и их цены.
2. Когда пользователь подтвердит платёж, Telegram пришлёт вам webhook с Update, который содержит объект PreCheckoutQuery. На этот запрос нужно ответить в течение 10 секунд, вызвав метод answerPreCheckoutQuery.
3. Если платёж пройдёт успешно, вы получите два уведомления: от Telegram (webhook с объектом SuccessfulPayment) и от Яндекс.Кассы (email). Бота можно запрограммировать так, чтобы после успешного платежа он совершал определённое действие: например, подключал покупателю услугу или отправлял контент.
В объекте SuccessfulPayment из уведомления от Telegram найдите параметр provider_payment_charge_id: там будет номер транзакции в Яндекс.Кассе. Этот номер лучше сохранить: по нему можно будет найти платёж в личном кабинете.
Как выглядит платёж через бота в Telegram
Обратите внимание: оплата через бота не поддерживается в десктопной и веб-версии Telegram — только в приложении.
Для примера возьмём оплату через тестовый бот Кассы — @YandexCheckoutTestShopBot.
1. Нажмите Запустить (команда /start). Вам придёт сообщение с инструкцией и кнопкой оплаты. В тестовом боте оно выглядит так:
2. Нажмите Заплатить.
3. Откроется платежая форма:
4. Введите данные карты и нажмите Заплатить.
5. На странице Checkout нажмите Pay.
6. После успешной оплаты @YandexCheckoutTestShopBot отправит в чат номер транзакции (для своего бота вы сможете запрограммировать другое действие).