Heleket
Приём оплаты криптовалютой через Heleket (Хелекет): Heleket выставляет счёт в рублях, а покупатель платит его криптой на странице оплаты Heleket, монету и сеть он выбирает сам. Криптовалюта приходит на баланс вашего мерчанта Heleket: так Heleket называет ваш магазин в своём кабинете. Оплату подтверждает уведомление Heleket, после этого покупатель получает доступ к каналу или группе.
Heleket — отдельный способ оплаты, он подключается ключами вашего мерчанта Heleket. Способ «Оплата криптовалютой» в Mini App работает через CryptoBot и описан на своей странице: оплата криптовалютой через CryptoBot. Криптовалюту принимает и Cashera.
Кому подходит
- В Mini App Heleket помечен «Физ. / Юр. лица». Мерчанта Heleket проверяет на модерации. Список стран, жителей которых Heleket не обслуживает, приведён в AML Policy Heleket, пункт 6.1.
- Покупатель видит в боте одну кнопку «Heleket (криптовалюта)», а монету и сеть выбирает на странице оплаты Heleket. Счёт выставляется в рублях: сумма равна цене тарифа, а с промокодом цене со скидкой.
- Автопродления нет: за каждый срок подписки покупатель платит сам.
Сравнить с другими способами: сравнительная таблица платёжных систем.
Что нужно заранее
Для шагов ниже:
- Проект в Vanderu: как создать проект. Пока проекта нет, на главном экране Mini App нет раздела «Настройки».
- Мерчант Heleket, прошедший модерацию, и доступ к его настройкам. Для модерации Heleket просит адрес сайта и подтверждение того, что домен ваш. Если у вас только Telegram-канал, уточните у Heleket, подойдёт ли он. Как создать мерчанта, описано в документации Heleket.
- Запущенный
@vanderu_bot: в нём приходят сообщения о продажах и о сбоях способа оплаты. Если вы ещё не писали ему, откройте с ним чат и отправьте/start.
Чтобы покупатель увидел способ в боте: канал или группа (канал, группа) и платный тариф проекта (как создать тариф).
Откройте настройки мерчанта Heleket
- Откройте кабинет Heleket, затем «Business», «Merchants», ваш мерчант и «Settings». Кнопка «Кабинет Heleket» есть и на экране «Подключение Heleket» в Mini App.
- Если в настройках мерчанта включён «API Whitelist», добавьте в него адрес сервера Vanderu. Адрес написан на экране «Подключение Heleket» в Mini App, в разделе «Как получить ключи».
Подключите Heleket в Mini App
-
Откройте Mini App из чата с
@vanderu_botи прокрутите главный экран вниз. В разделе «Настройки» нажмите «Платежные системы». Откроется экран «Выберите платежную систему». -
Найдите в списке карточку «Heleket» и нажмите её. Откроется экран «Подключение Heleket» с разделами «Что понадобится» и «Как получить ключи».
-
В «Settings» мерчанта скопируйте Merchant UUID и вставьте его в поле «Merchant UUID» целиком, без пробелов.
-
Вернитесь в «Settings», скопируйте ключ для приёма оплат и вставьте его в поле «Платёжный API-ключ» целиком, без пробелов. В документации Heleket он называется «API key for payments». Ключ для выплат здесь не подходит.
-
Внизу экрана нажмите «Сохранить». Vanderu проверит ключи у Heleket. Если Heleket их примет, Mini App покажет «Ключи проверены, способ оплаты подключён» и откроет экран «Детали Heleket»: в строке «Статус» стоит «Принимает оплату».
Способ сразу появляется у покупателей во всех ваших проектах, в том числе в новых. Чтобы оставить его только в некоторых проектах, на экране «Детали Heleket» нажмите «Проекты».
Как покупатель платит
- Покупатель открывает бота проекта, нажимает «Тарифы» и выбирает тариф.
- Нажимает кнопку «Heleket (криптовалюта)». Бот показывает сумму в рублях, канал, тариф и срок и кнопки «Оплатить» и «Отменить платеж».
- «Оплатить» открывает страницу оплаты Heleket. Там покупатель выбирает монету и сеть и переводит криптовалюту. Счёт действует 1 час.
- Heleket засчитывает перевод после подтверждений в блокчейне, поэтому доступ приходит не сразу после перевода. Когда Heleket подтвердит оплату, бот проекта присылает покупателю дату окончания подписки и, если покупателя ещё нет в канале, ссылку на вход. Ссылка одноразовая и действует до конца подписки. Если тариф открывает доступ к нескольким каналам, бот пришлёт по ссылке на каждый канал, где покупателя нет.
- Оплата появляется в разделе «Продажи», а
@vanderu_botприсылает вам сообщение «Новая продажа», в строке «Способ оплаты» стоит «Heleket».
Если покупатель перевёл больше суммы счёта, доступ он получает так же, как при точной оплате. Если перевёл меньше и Heleket закрыл счёт как недоплаченный, доступа нет. Пока Heleket ждёт доплату, Vanderu тоже ждёт.
Адрес для уведомлений Vanderu передаёт Heleket в каждом счёте, вставлять его в кабинет Heleket не нужно. Если уведомление Heleket не пришло, Vanderu находит оплату сам, первый раз через 2 минуты после того, как покупатель нажал кнопку Heleket. Покупатель получает доступ после такой проверки, а не сразу после оплаты.
«Отменить платеж» возвращает покупателя к выбору способа оплаты, но счёт у Heleket не отменяет: если покупатель всё же оплатит уже выставленный счёт, Vanderu засчитает оплату.
Текст сообщения со ссылкой меняется в Mini App: на экране проекта нажмите «Сообщения бота», затем «После покупки». Ссылка стоит в тексте там, где написано {link}, а дата окончания подписки — там, где {date}. Если убрать их из текста, покупатель не получит ссылку или дату.
Как проверить
Вернитесь на экран «Выберите платежную систему»: у карточки «Heleket» стоит метка «Подключено».
Проверьте без оплаты:
- Откройте бота своего проекта и нажмите «Тарифы».
- Если бот попросит «Выбери ресурс», выберите канал. Затем выберите тариф.
- Нажмите «Heleket (криптовалюта)».
- Если бот прислал сообщение с кнопкой «Оплатить», ключи подходят.
- Нажмите «Отменить платеж».
На экране «Детали Heleket» эта оплата появится в списке оплат под кнопками со статусом «Отменено».
Выдачу доступа можно проверить только настоящей оплатой криптовалютой: криптовалюта придёт на баланс вашего мерчанта, а в «Продажи» запишется продажа. В списке оплат на экране «Детали Heleket» она будет со статусом «Оплачено».
Изменить, отключить или удалить Heleket
На главном экране Mini App в разделе «Настройки» нажмите «Платежные системы», затем «Heleket». Откроется экран «Детали Heleket».
- Чтобы заменить ключи, нажмите «Изменить ключи», вставьте Merchant UUID и ключ и нажмите «Сохранить». Сохранённые ключи Mini App не показывает: вставьте их заново.
- Чтобы оставить Heleket только в некоторых проектах, нажмите «Проекты», выключите лишние проекты и нажмите «Сохранить».
- Чтобы скрыть Heleket от покупателей во всех проектах, нажмите «Отключить» и подтвердите. Оплаты, начатые до отключения, засчитаются, а ключи и выбор проектов сохранятся. Вернуть способ можно кнопкой «Включить»: Vanderu снова проверит ключи у Heleket.
Если вы удалите Heleket, оплаты по счетам, выставленным до удаления, Vanderu сам не засчитает: покупатель заплатит, а доступ не получит. Если нужно только остановить приём, нажмите «Отключить».
Чтобы удалить Heleket, нажмите «Удалить», а затем в течение 5 секунд ещё раз, когда кнопка покажет «Нажмите ещё раз, чтобы удалить». Vanderu сотрёт ключи, продажи в разделе «Продажи» останутся.
Если не получилось
Mini App пишет «Heleket не принял Merchant UUID или платёжный API-ключ»
Проверьте по порядку:
- в поле «Платёжный API-ключ» вставлен ключ для приёма оплат, а не ключ выплат;
- мерчант прошёл модерацию Heleket;
- если в настройках мерчанта включён «API Whitelist», в нём есть адрес сервера Vanderu из этого сообщения.
Покупатель видит «Ошибка создания платежа»
Heleket не выставил счёт, например потому, что цена тарифа ниже минимальной суммы Heleket. Минимум у Heleket свой для каждой криптовалюты: уточните его у Heleket и поднимите цену тарифа.
Покупатель перевёл криптовалюту, а доступа нет
Откройте экран «Детали Heleket» и найдите оплату в списке под кнопками. «В ожидании» — Heleket ещё не подтвердил перевод: доступ придёт после подтверждения. «Отменено» — счёт истёк, покупатель недоплатил или Heleket отклонил перевод: проверьте счёт в кабинете Heleket. Если там оплата засчитана, а доступа нет, напишите в поддержку @vanderusupport_bot и назовите проект, дату и сумму счёта.
Покупатель пишет, что при создании ссылки произошла ошибка
Оплата прошла, подписка записана, но @vanderu_bot не смог создать ссылку на вход, например потому, что у него нет прав администратора в канале. Верните ему права, чтобы это не повторилось: для канала, для группы. Этому покупателю бот ссылку повторно не пришлёт: напишите в поддержку @vanderusupport_bot и назовите проект, дату и сумму оплаты из списка оплат на экране «Детали Heleket».
В боте нет кнопки Heleket
Проверьте по порядку:
- на экране «Детали Heleket» в строке «Статус» стоит «Отключён»: нажмите «Включить»;
- проект выключен в «Проекты»: на экране «Детали Heleket» нажмите «Проекты», включите проект и нажмите «Сохранить»;
- на экране «Детали Heleket» в строке «Статус» стоит «Ошибка» или есть блок «Способ не работает»: там же написано, что случилось и что сделать. Сломанный способ бот показывает, только если у проекта нет другого рабочего способа оплаты.
Если не помогло
Напишите в поддержку: @vanderusupport_bot.
Ограничения
- Счёт выставляется в рублях, а платит покупатель криптовалютой, которую выбрал на странице оплаты Heleket. Минимальную сумму счёта определяет Heleket. Сумма считается по цене со скидкой, если покупатель ввёл промокод.
- Счёт действует 1 час. Недоплаченный счёт доступа не даёт.
- Если тариф проекта бесплатный, способов оплаты у него нет: покупатель получает доступ кнопкой «Получить». Пробный тариф проекта (от 3 до 30 дней по цене ниже тарифа продления, затем автопродление) оплачивается только через ЮKassa с автопродлением, Heleket у него не показывается.
- Возвраты Vanderu не делает. Если вы вернёте криптовалюту покупателю через Heleket, доступ к каналу у него останется.
- Комиссию Heleket и от чего она зависит смотрите на сайте Heleket.
- Сколько вы платите Vanderu: тарифы Vanderu.