Автоплатежи - 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, USDT (любые другие доступные Монеты и Токены, по запросу)
● Авто вывод средств: Доступен в сети TRON, НЕдоступен в сетях TON, BSC.
📆 Оплата ежемесячно (актуальную стоимость смотри при оплате).
📞 Настройка подключения:🔐Админ |💸Автоплатежи
ВАЖНО: Подключение автоплатежей для всех представленных сетей осуществляется аналогичным образом. По этой причине, а так же по причине нежелания дублировать информацию в отдельных документах, инструкции для всех представленных сетей были объединены в одно руководство. Однако, нужно иметь ввиду, что каждая из представленных сетей, являясь отдельным, самостоятельным проектом, подключается и оплачивается отдельно.
Начиная разговор об автоплатежах в этом руководстве, мы исходим из того что вы уже обладаете базовыми знаниями о том как работать с конструктором и нам не нужно пояснять вам, например, как добавляются кнопки и сообщения в меню вашего бота. Если всё же эти базовые вещи вам ещё нужно пояснять значит вы слишком рано перешли к созданию функционала автоплатежей.
❖ Автоплатежи
Как организовать автоматический приём платежей для сетей 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).
5.3 Укажите реферальный бонус.
Размер реферального бонуса определяется ПОСЛЕ расчёта суммы фактического начисления с учётом указанного ранее Курса.
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. Юзер вообще не задал адрес кошелька.
2. Юзер задал адрес кошелька ПОСЛЕ того как совершил транзакцию.
3. Юзер совершил транзакцию с биржи или другого обменника.
Самая частая причина состоит в том что пользователи отправляют переводы с бирж или другого рода обменников поэтому адреса кошельков - не совпадают.
Чтобы удостовериться в том что адреса кошельков не совпадают, вы должны:
1. Найти транзакцию в блокчейне при помощи TXID (hash) транзакции (его можно взять прямо в сообщении об ошибке).
2. Посмотреть адрес кошелька с которого в действительности была отправлено эта транзакция.
3. При помощи команды «/varget var_name user_id» Вы должны посмотреть какой адрес кошелька юзер сохранил в своей переменной.
4. Если эти адреса не совпадают вы объясняете юзеру всё то, что мы только что объяснили вам.
FAILED❗️ 🆘 Multiple users found
Подобная ошибка появляется если НЕСКОЛЬКО аккаунтов в вашем боте указали ОДИН и тот же кошелёк для идентификации их платежа. Бот не знает кому из них начислять.
Иногда юзеры указывают адреса бирж с которых биржи осуществляют выводы.
Иногда юзеры указывают один и тот же кошелёк для нескольких своих аккаунтов.
Чтобы исправить ситуацию выясните у пользователя какой адрес он указал, где он его взял и не использовал ли он его для другого своего аккаунта. Удалите совпадающие адреса в переменных у всех кроме одно аккаунта.
❖ Дополнительная информация
Вывод средств (полуавтоматический)
При наличии функционала автоматического приёма платежей вам возможно понадобится кнопка для осуществления Вывода Средств.
Подробнее о работе с кнопкой Вывода Средств смотри в руководстве.
Автоматический вывод средств
Для платёжной системы в сети TRON доступен функционал автоматического вывода средств.
Функционал полностью автоматического вывода средств предоставляется НЕ ВСЕМ.
ВАЖНО: Не пытайтесь договариваться о подключении автоматических выводов до тех пор пока полностью не разберётесь с тем как работает кнопка Выводов в полуавтоматическом режиме.
Если вы полностью разобрались с тем как работает кнопка вывода можете обратиться в бот для попытки подключить автовыводы.
ВАЖНО: для работы автоматических выплат в сети TRON необходим «Приватный Ключ» кошелька, это единственный способ получить доступ к средствам и осуществить вывод от имени системы. По этой причине вам будет необходимо завести ОТДЕЛЬНЫЙ ПУСТОЙ КОШЕЛЁК с отдельным приватным ключом.
Мы подчеркиваем: АВТОМАТИЧЕСКИЕ ВЫВОДЫ НАДО СОВЕРШАТЬ ИЗ ОТДЕЛЬНОГО ПУСТОГО КОШЕЛЬКА НА КОТОРЫЙ ВЫ БУДЕТЕ ПЕРЕВОДИТЬ НЕБОЛЬШИЕ, НЕОБХОДИМЫЕ СУММЫ.
Никогда не подключайте автоматические выплаты на свой основной кошелёк, на котором хранятся основные средства вашего проекта.
ОБЩЕЕ ПРАВИЛО: Никогда, никому и ни при каких условиях, не предоставляете Приватных Ключей и Сид Фраз от своих основных кошельков. Именно поэтому мы требуем и в очередной раз подчёркиваем - для автоматических выплат вам нужно будет завести ОТДЕЛЬНЫЙ ПУСТОЙ кошелёк на котором вы будете хранить незначительные суммы только для целей автоматических выводов.
Проект @MenuBuilderBot никогда не попросит Приватных Ключей от ваших основных кошельков. Тот кто это делает-мошенник.
То есть вы заводите отдельный кошелёк для выводов и пополняете его по мере необходимости небольшими суммами. Если вы не знаете как получить Приватный Ключ нового кошелька, мы можем завести подобный кошелёк для вас. В любом случае системе ДОЛЖЕН БЫТЬ известен Приватный Ключ, поэтому такой кошелек нельзя считать надежным хранилищем и использовать для каких-то других целей, в связи с этим не имеет большого значения кто его заведёт мы или вы сами.
📞 Узнать о возможности подключения функции автовывода средств: @MenuBuilderSupportBot