Автоплатежи - TRON, TON, BSC [в Админке]
Руководство для самостоятельного подключения автоплатежей в сетях TRON, TON, BSC.
Сети TRON (TRC20), TON, BSC (Binance Smart Chain - BEP20) - позволяет вашему боту принимать автоплатежи и зачислять их суммы на баланс юзеров в боте.
● Адрес платёжных систем:
- TRON: https://tron.network/
- TON: https://ton.org/
- BSC: https://bscscan.com/
● Идентификация: Адрес плательщика (кошелёк).
● Доступные валюты:
- TRON: TRX, USDT (любые другие доступные Монеты и Токены, по запросу)
- TON: TON (любые другие доступные Монеты и Токены, по запросу)
- BSC: BNB, BUSD, USDT (любые другие доступные Монеты и Токены, по запросу)
● Авто вывод средств: НЕдоступен.
📆 Оплата ежемесячно (актуальную стоимость смотри при оплате).
📞 Настройка подключения:🔐Админ | 💸Автопополнения
ВАЖНО: Подключение автоплатежей для всех представленных сетей осуществляется аналогичным образом. По этой причине, а так же по причине нежелания дублировать информацию в отдельных документах, инструкции для всех представленных сетей были объединены в одно руководство. Однако, нужно иметь ввиду, что каждая из представленных сетей, являясь отдельным, самостоятельным проектом, подключается и оплачивается отдельно.
Начиная разговор об автоплатежах в этом руководстве, мы исходим из того что вы уже обладаете базовыми знаниями о том как работать с конструктором и нам не нужно пояснять вам, например, как добавляются кнопки и сообщения в меню вашего бота. Если всё же эти базовые вещи вам ещё нужно пояснять значит вы слишком рано перешли к созданию функционала автоплатежей.
❖ Автоплатежи
Как организовать автоматический приём платежей для сетей TRON, TON, BSC в вашем боте.
Необходимые функции
Функционал раздела «🧩Расширения»:
● если вы не используете переменную balance
, для начисления, то вам понадобятся дополнительные переменные.
● вам нужны дополнительные переменные для хранения адресов кошельков пользователей.
Доп. Переменные
Для подключения перейдите в вашем боте:☞ 🔐Админ | 🧩Расширения | 📂Переменные
Настройка автоплатежа
1. Настройки чекера
При помощи мастера настроек введите все запрашиваемые данные.
1.1 Адрес ВАШЕГО кошелька в одной из сетей
Адрес вашего кошелька в одной из сетей (TRON, TON, BSC) на который вы планируете получать платежи. Бот будет проверять входящие транзакции этого кошелька.
После ввода указанных выше данных вы увидите кнопки которых ранее не было в меню.
2. Оплатить чекер
Произведите оплату представленной суммы.
Оплата минимум за месяц. Обменяйте необходимую сумму в TMH на вашем аккаунте в @MenuBuilderBot исходя из количества месяцев подключения:☞ 🔐Админ | 🧩Расширения | 🏦Ваши Кошельки
3. Активировать чекер
Включите чекер чтобы продолжить настройку.
4. Адреса Юзеров
Необходимо указать переменную для хранения адреса кошелька пользователя, выбранной вами сети (TRON, TON, BSC), для идентификации его платежей.
РУКОВОДСТВО: Если не поняли для чего переменная - ещё раз читайте «Способы идентификации платежей».
5. Баланс в ХХХХ
Необходимо задать переменные - куда начислять средства для каждой из доступных валют.
Если у вас в боте только одна валюта, то обычно используют "balance
". Если несколько валют, то может быть индивидуальная переменная для каждой валюты или единая, но с конвертацией по курсу. Каждой валюте, доступной для автопополнений в конкретной сети, будет соответствовать отдельная кнопка указания Баланса.
5.1 Укажите переменную для начисления.
Для выбора, вам будет представлен список доступных в Боте ЦИФРОВЫХ переменных.
Если у вас нету переменных - вам нужно их ДОБАВИТЬ в бот и СОЗДАТЬ - ссылку на руководство мы дали выше.
Количество имеющихся у вас в боте переменных должно соответствовать количеству валют которые вы планируете принимать на разные балансы в боте.
5.2 Укажите курс начисления.
Сумма пополнения будет умножена на заданный Курс. Вы можете использовать Выражения и макросы Автоматических Курсов валют (приобретать их отдельно - нет необходимости).
Для чего нужен курс начисления и как его использовать.
● Вы можете использовать свой собственный токен внутри вашего проекта и его курс может напрямую не соответствовать валюте пополнения, таким образом вы можете задавать свои собственные курсы и начислять пополнение сразу во внутреннем токене.
● При помощи курса можно задавать комиссию на пополнение в той или иной валюте и комиссия может быть разной для каждой из валют.
● Если у вас единый баланс, а пополнение производится при помощи разных валют, то указав одну переменную вы можете начислять туда разные валюты - автоматически конвертируя их при помощи курсов и приводя к некому единому виду (например конвертируя всё в USDT).
6. Показ общей суммы
При автопополнении в указанную вами группу (смотри ниже) будут приходить отчёты с данными конкретного пополнения. Если вы хотите чтобы при этом отдельным сообщением вам показывали общую сумму на балансе вашего кошелька, то оставьте включённой данную опцию.
Включает показ общей суммы на балансе кошелька при автопополнениях.
Режимы:Выкл ⏹️
- функция выключена (сумма не показывается).Вкл ▶️
- функция включена (общая сумма показывается).
Настройка группы отчетов для автоплатежей
Как было сказано выше, при автопополнении в указанную вами группу будут приходить отчёты с данными конкретного пополнения. Для того чтобы бот знал в какую группу присылать отчёты - её нужно указать в настройках.
Для указания группы перейдите вашем боте:
☞ 🔐Админ | 💸Автопополнения | Группа/Канал Пополнений
Задать Группу/Канал пополнений
О том как добавлять группу смотри в руководстве по группам - принцип один и тот же.
Группа/Канал Публичная
Опция определяет какого рода данные будут присутствовать в отчёте. В отчётах для публичных групп отсутствует персональные данные пользователей.
Определяет тип группы указанной для отправки отчётов.
Режимы:Выкл ⏹️
- группы приватная (все данные).Вкл ▶️
- группа публичная (без личных данных).
Задать Сообщение при Пополнении
Тут можно задать своё собственное сообщение для отчёта об автопополнении. В сообщении доступны все макросы вашего бота, а также есть список дополнительных макросов который указан в инструкции при входе в настройку.
❖ Как организовать Автоплатежи в меню вашего бота
Как организовать автоплатёж для сетей TRON, TON, BSC.
Если вы уже активировали автоматическую оплату TRON, TON или BSC в своем боте, вам необходимо создать способ для людей (ваших пользователей) для автоматического пополнения. Что для этого нужно:
Практически всё что вам нужно в боте, это кнопка с формой «Ввод Переменной» куда ваши юзеры сохранят адрес ИХ кошелька - с которого будут платить (для идентификации) и сообщение с адресом ВАШЕГО кошелька (чтобы они знали куда платить). Кнопку назовите как хотите, например «Ввести Адрес Вашего Кошелька», а сообщение желательно либо показывать после формы ввода, либо создать для него отдельную кнопку защищённую условием проверяющим введён ли адрес кошелька юзера для идентификации. Тут мы опишем второй способ.
1. Создайте общую кнопку. Назовите её: «Пополнить Баланс».
2. Внутри кнопки «Пополнить Баланс» создайте ещё две кнопки:
● «Адрес для Платежа»
● «Ввести Адрес Вашего Кошелька»
2.1 В сообщении кнопки «Адрес для Платежа», покажите адрес ВАШЕГО кошелька (который вы указали в пункте 2 при заказе автоплатежа). На этот адрес юзеры должны будут сделать перевод.
Самой кнопке можно добавить Условие для показа содержимого, проверяющее наличие введенного адреса кошелька вашего юзера - который будет использован для идентификации платежа.
Например: {%wallet% != ""}
Где %wallet%
- макрос переменной указанной вами в пункте 4 при заказе автоплатежа.
Условие нужно для того чтобы юзер не получил адрес и не мог совершить перевод, до того как введёт адрес своего кошелька для идентификации платежа.
2.2 В кнопке «Ввести Адрес Вашего Кошелька» создайте форму «Ввод Переменной». В начальном сообщении формы попросите юзера ввести адрес кошелька с которого он будет производить оплату (и который будет использован для идентификации платежа).
Так же, для удобства юзера, в этом сообщении можно показать текущий, сохранённый адрес кошелька (возможно введённый юзером ранее) - это даст ему возможность проверить какой кошелёк был введён и не вводить его повторно.
ОБЯЗАТЕЛЬНО объясните вашим юзерам что они не могут платить путем вывода средств с обменников и бирж - такие платежи не будут идентифицированы, потому как биржи используют свои собственные кошельки для вывода и они не совпадают с теми адресами на которые юзеры делают переводы при вводе средств на биржи. В БОЛЬШОМ КОЛИЧЕСТВЕ СЛУЧАЕВ САМИ ОНИ ДО ЭТОГО НЕ ДОДУМАЮТСЯ - НАШИ НЕ ДОДУМЫВАЮТСЯ. Удачи вам с этим. 😁
Вводимый юзером адрес кошелька можно проверять (НЕ ОБЯЗАТЕЛЬНО). Для этого используется расширенный функционал форм.
Функционал раздела «🧩Расширения»: вводимые данные проверяются на соответствие Условию.
Условия Форм
Для подключения перейдите в вашем боте:☞ 🔐Админ | 🧩Расширения | 📂Формы
ПОСОБИЕ: Подробнее о том как проверять адрес кошелька для каждой из сетей смотри в пособии «Примеры Условий в формах».
• • •
Естественно, всё это можно сделать и красивее, но мануал пишется для тех кто без посторонней помощи не может создать данный функционал и дополнительные сложности при создании им ни к чему. Остальные и сами могут создать форму в том виде в котором им нужно.
• • •
ДЛЯ СПРАВКИ: посмотрите, как в нашей системе организована автооплата для сетей TRON, TON, BSC.
Для этого перейдите в свой бот:🔐Админ | 🧩Расширения | 🏦Ваши кошельки | 💳Пополнить
❖ Сообщения об ошибках
FAILED❗️ 🆘 No user comment
Подобная ошибка появляется если юзер не идентифицирован.
И так, еще раз: пользователь может быть идентифицирован ТОЛЬКО по адресу кошелька. Если адрес кошелька в ТРАНЗАКЦИИ (в блокчейне) не совпадает с адресом кошелька, сохраненным им в ПЕРЕМЕННОЙ - бот покажет ошибку и ничего не будет добавлено на Баланс.
Чтобы удостовериться в том что адреса кошельков не совпадают, вы должны:
1. Найти транзакцию в блокчейне при помощи TXID (hash) транзакции (его можно взять прямо в сообщении об ошибке).
2. Посмотреть адрес кошелька с которого в действительности была отправлено эта транзакция.
3. При помощи команды «/varget variable userid
» Вы должны посмотреть какой адрес кошелька юзер сохранил в своей переменной.
4. Если эти адреса не совпадают вы объясняете юзеру всё то, что мы только что объяснили вам.
❖ Дополнительная информация
Вывод средств (полуавтоматический)
При наличии функционала автоматического приёма платежей вам возможно понадобится кнопка для осуществления Вывода Средств.
Подробнее о работе с кнопкой Вывода Средств смотри в руководстве.