Как принимать оплату в криптовалюте прямо в Telegram

Канал оплаты в Paymos принадлежит проекту, а не отдельному счёту, и выбирается один раз. У проекта на боте платёжная ссылка ведёт не на страницу, а в чат — плательщик открывает её в Telegram, выбирает актив и сеть, получает адрес пополнения и QR-код и там же видит, как меняется состояние счёта.

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

Аккаунт Paymos плательщику при этом не нужен. Со стороны выглядит так, будто у продажи что-то отняли, — пока не спросить, что платёжная страница вообще делала в продаже, которая целиком идёт перепиской. Выбор способа, когда сайт уже есть, разобран в отдельном руководстве; здесь — слой под ним: что такое канал Telegram, что он убирает и что оставляет ровно на месте.

Что значит принимать оплату в Telegram?

Принимать оплату в Telegram — значит проводить платёж в переписке с ботом, а не на веб-странице. Telegram описывает ботов как «небольшие приложения, которые работают целиком внутри Telegram», поэтому плательщику нечего устанавливать и не нужно осваивать второй продукт ради одного перевода.

Сама последовательность у Paymos короткая. Мерчант отправляет платёжную ссылку, плательщик открывает её в Telegram, дальше всё ведёт бот: сначала актив и сеть, потом адрес пополнения и QR-код, потом состояние счёта. От плательщика требуется только Telegram и кошелёк, в котором лежит нужный актив.

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

Где выбирается канал оплаты?

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

У самого счёта Paymos канала поэтому нет. При создании счёта канал не выбирают, и поля для него в запросе не существует — вопрос закрыт проектом ещё до того, как счёт появился. Всему, что обращается к API Paymos, это стоит знать до первого счёта, а не после.

Тело запроса и форма ответа при этом остаются документированными, но payment_url внутри ответа ведёт в разные места в зависимости от того, какой проект выставил счёт. Письмо о заказе, написанное в расчёте на веб-страницу, у проекта на Telegram-боте описывает не то, что произойдёт: текст вокруг ссылки принадлежит мерчанту и должен совпадать с каналом.

Что открывается вместо платёжной страницы?

У проекта на Telegram-боте payment_url счёта — это диплинк в бота Paymos. Ссылка как ссылка: её так же отправляют, так же нажимают и так же пересылают, — просто открывается по ней Telegram, а не браузер.

Формат за этим поведением Telegram описывает сам. Ссылка на бота выглядит как https://t.me/<bot_username>, вместе с ней передаётся параметр start длиной до 64 символов, и бот получает его в тот момент, когда пользователь нажал ссылку. Отдельного шага для передачи не требуется.

Отправляет ссылку мерчант так же, как любую другую: в диалог, в канал или в тот самый ответ, который он и так писал. А под ней ничего нет — у проекта на Telegram-боте платёжной страницы не существует, поэтому бот не оболочка над кассой, которая живёт ещё и в вебе: для такого проекта веб-версию просто не создавали.

Что делает плательщик внутри бота?

Сначала плательщик выбирает актив и сеть. Бот Paymos отвечает адресом пополнения и QR-кодом, и эти два выбора идут первыми потому, что вместе они и составляют маршрут платежа: по отдельности ни один из них не полон. Порядок здесь не про удобство, а про адрес.

Один актив адрес не определяет — поэтому бот Paymos и спрашивает про оба. USDT в Tron и USDT в Ethereum — разные переводы на разные адреса, и чем различаются стандарты переводов объясняет, от чего защищает выбор в два шага.

QR-код бот Paymos показывает рядом с адресом, потому что кошелёк обычно — второе приложение на том же телефоне. Сканирование убирает шаг, где адрес переносят руками между двумя окнами, а потом сверяют посимвольно. Дальше плательщик отправляет перевод из кошелька, и счёт меняет состояние.

Где плательщик следит за состоянием счёта?

У проекта на Telegram-боте плательщик следит за состоянием счёта внутри Telegram. Это та же поверхность, которая спросила про актив и сеть и выдала адрес пополнения, — пока платёж подтверждается, ничего из него не лежит в другом месте. Отдельного экрана ожидания у такого проекта не появляется.

На любом канале платить — значит уйти с экрана оплаты. Плательщик переключается в кошелёк, отправляет перевод и возвращается — а у проекта на Telegram-боте вернуться значит открыть переписку с ботом Paymos и прочитать текущее состояние там. Другого места для этого не заводится.

Ожидание между этими двумя действиями мерчанту не сократить: глубина подтверждения выводится из сети и суммы платежа, поэтому длительность принадлежит блокчейну, а из чего складывается это ожидание, канал не меняет. Стоит оно при этом ничего — неоплаченный, истёкший и отменённый счёт комиссии Paymos не несут.

Нужен ли плательщику аккаунт Paymos?

Нет. Чтобы оплатить счёт Paymos в Telegram, аккаунт не нужен, и незаметно его в этом сценарии никто не заводит: тот, кто открыл ссылку, остаётся покупателем на время одного платежа. На стороне кассы Paymos правило то же — адрес электронной почты у плательщика не спрашивают и проверку личности для оплаты не проводят.

В канале Telegram это весит больше, чем на сайте. Продажа в переписке — обычно короткое решение, и регистрация посреди него становится вторым решением, за которым покупатель не приходил, — притом что кошелёк у него уже открыт и ждёт.

Всё, что мерчант знает о платеже, приходит из счёта и вебхука, а не из профиля покупателя. Поиск по счетам и карточка счёта в панели Paymos — это и есть запись о продаже; учётной записи плательщика за ней не появляется ни на одном шаге.

Куда попадает плательщик после оплаты?

Ссылки возврата у проекта на Telegram-боте ведут в Telegram, если они вообще заданы. Плательщик, пришедший из переписки, возвращается в мессенджер, а не наружу из приложения, в котором прошёл платёж. Что это будет ссылка в Telegram — задано; какая именно, решает мерчант.

Какая именно это будет ссылка, настраивается на проекте — ровно как ссылки успеха и отказа настраиваются на любом другом канале. Задавать её при этом не обязательно: без ссылки возврата плательщик остаётся в той же переписке, и продажа заканчивается там же, где началась.

Результат мерчант читает всё равно не по возврату плательщика, а по вебхуку. Восемь событий счёта Paymos, каждое с подписью HMAC-SHA256, сообщают об изменении состояния; ссылка возврата сообщает только, что человек куда-то перешёл, и для сверки заказа не годится.

Чем это отличается от платёжной ссылки в чате?

Платёжная ссылка, отправленная в Telegram, — это способ доставки. Канал Telegram — это место, где проходит сам платёж. Путают их постоянно, и по-своему логично: и там и там счёт Paymos приходит покупателю сообщением в чат.

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

Ссылка проекта на Telegram-боте вместо страницы открывает бота, и сообщение при этом выглядит точно так же — то же окно, тот же отправитель. Проверка поэтому не вид сообщения, а то, что случилось после нажатия: открылся браузер — счёт выставил проект на другом канале; платёж продолжился в переписке — проект стоит на канале Telegram.

Что канал Telegram оставляет без изменений?

Канал решает, где платёж показан, а не как он обрабатывается. Под ботом работает та же механика, что и на остальных каналах, и её стоит назвать: фраза «платёжной страницы нет» читается шире, чем есть на самом деле. Счёт Paymos — один и тот же объект на любом канале.

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

Баланс Paymos пополняется в том активе, который отправил плательщик, и хранится по активу, а не по сети прихода; комиссия — 1,0 % с оплаченного счёта по стандартному тарифу. Контракт вебхука — та же подписанная доставка с теми же именами событий, а глубина подтверждения по-прежнему читается из сети и суммы.

Какому проекту подходит канал Telegram?

Развилка проходит там, где покупатель стоит в момент решения: проект на Telegram-боте подходит витрине, которая и есть переписка, а покупатель на странице или у прилавка в переписке не находится. Выбор делается один раз и у проекта, а не под рекламную кампанию, и четырёх вопросов хватает, чтобы его закрыть.

1. Где покупатель в момент решения — в переписке, в канале или на странице вашего сайта?
2. Нужна ли продаже страница оплаты с вашим логотипом и цветами? У проекта на Telegram-боте такой страницы нет.
3. Какой проект несёт этот трафик? Канал — свойство проекта, поэтому ответ здесь проект, а не рекламный источник.
4. Что читает результат? Тот же адрес вебхука, что и везде, поднятый до первой живой ссылки.

Если ответить на них честно, канал Telegram перестаёт выглядеть уменьшенной кассой. Это одна настройка проекта, которая переносит весь платёж в приложение, где покупатель уже был, а всё, что происходит с деньгами дальше, от неё не зависит.