Автоплатежи - TON Jetton [в Админке]

Руководство для самостоятельного подключения автоплатежей в Jetton (Токены) сети TON.

Функция позволяет вашему боту принимать автоплатежи в Jetton сети TON и зачислять их суммы на баланс юзеров в боте.
● Адрес платёжной системы: https://ton.org/
● Идентификация: Адрес плательщика (кошелёк).
● Доступные валюты: TON: Jetton (любые Токены на ваш выбор - до 10 штук)
● Авто вывод средств: НЕдоступен.
📆 Оплата ежемесячно (актуальную стоимость смотри при оплате).
📞 Настройка подключения: 🔐Админ | 💸Автоплатежи

Jetton в сети TON имеют свой собственный чекер и оплачиваются отдельно от самого TON.

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

❖ Автоплатежи

Как организовать автоматический приём платежей для JETTON сети TON в вашем боте.

Необходимые функции

Функционал раздела «🧩Расширения»:
● если вы не используете переменную balance, для начисления, то вам понадобятся дополнительные переменные.
● вам нужны дополнительные переменные для хранения адресов кошельков пользователей.

Доп. Переменные
Для подключения перейдите в вашем боте:
☞ 🔐Админ | 🧩Расширения | 📂Переменные

Руководство по Переменным.

Настройка автоплатежа

1. Настройки чекера

При помощи мастера настроек введите все запрашиваемые данные.

1.1 Адрес ВАШЕГО кошелька в сети TON

Адрес вашего кошелька в сети TON на который вы планируете получать платежи. Бот будет проверять входящие транзакции этого кошелька.

После ввода указанных выше данных вы увидите кнопки которых ранее не было в меню.

2. Оплатить чекер

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

Оплата минимум за месяц. Обменяйте необходимую сумму в TMH на вашем аккаунте в @MenuBuilderBot исходя из количества месяцев подключения:
☞ 🔐Админ | 🧩Расширения | 🏦Ваши Кошельки

3. Активировать чекер

Включите чекер чтобы продолжить настройку.

4. Адреса Юзеров

Необходимо указать переменную для хранения адреса кошелька пользователя в сети TON, для идентификации его платежей.

РУКОВОДСТВО: Если не поняли для чего переменная - ещё раз читайте «Способы идентификации платежей».

5. Добавить Jetton

Позволяет добавить любой Jetton (токен) сети TON на ваш выбор.

ВАЖНО: Добавить можно не более 10 Жетонов (Токенов).

5.1 Укажите Тикер (Символ) Жетона.

Дальнейшая настройка производится производится аналогично пункту «Баланс ХХХХ» в руководстве для TRON.

После ввода указанных выше данных вы увидите саму кнопку «Баланс ХХХХ» (см. ниже) с настройками данного Жетона. Последующие возможные настройки для данного Жетона будут проходить в ней.

6. Баланс в ХХХХ

Кнопка появится в разделе, только после добавления соответствующего Жетона в пункте «5. Добавить Jetton».

Это настройки уже добавленного вами Жетона. Шаги по настройке в нём совпадают с теми что были описаны в руководстве для TRON.

7. Показ общей суммы

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

Подробнее о показе общей суммы смотри в руководстве для TRON.

Настройка группы отчетов для автоплатежей

При автопополнении в указанную вами группу будут приходить отчёты с данными конкретного пополнения.

Подробнее о настройке группы отчётов смотри в руководстве для TRON.

❖ Как организовать Автоплатежи в меню вашего бота

Как организовать автоплатёж для Jetton сети TON.

Если вы уже активировали автоматическую оплату TON Jettons в своем боте, вам необходимо создать способ для людей (ваших пользователей) для автоматического пополнения. Что для этого нужно:

Настройка производится производится аналогично тому как описано в руководстве для TRON.

❖ Сообщения об ошибках

FAILED❗️ 🆘 No user comment

Подобная ошибка появляется если юзер не идентифицирован.

И так, еще раз: пользователь может быть идентифицирован ТОЛЬКО по адресу кошелька. Если адрес кошелька в ТРАНЗАКЦИИ (в блокчейне) не совпадает с адресом кошелька, сохраненным им в ПЕРЕМЕННОЙ - бот покажет ошибку и ничего не будет добавлено на Баланс.

Причины почему юзер не был идентифицирован:
1. Юзер вообще не задал адрес кошелька.
2. Юзер задал адрес кошелька ПОСЛЕ того как совершил транзакцию.
3. Юзер совершил транзакцию с биржи или другого обменника.

Самая частая причина состоит в том что пользователи отправляют переводы с бирж или другого рода обменников поэтому адреса кошельков - не совпадают.

Чтобы удостовериться в том что адреса кошельков не совпадают, вы должны:
1. Найти транзакцию в блокчейне при помощи TXID (hash) транзакции (его можно взять прямо в сообщении об ошибке).
2. Посмотреть адрес кошелька с которого в действительности была отправлено эта транзакция.
3. При помощи команды «/varget var_name user_id» Вы должны посмотреть какой адрес кошелька юзер сохранил в своей переменной.
4. Если эти адреса не совпадают вы объясняете юзеру всё то, что мы только что объяснили вам.

❖ Дополнительная информация

Вывод средств (полуавтоматический)

При наличии функционала автоматического приёма платежей вам возможно понадобится кнопка для осуществления Вывода Средств.

Подробнее о работе с кнопкой Вывода Средств смотри в руководстве.