Автоплатежи - TRON, TON, BSC, POLYGON [в Админке]
Руководство для самостоятельного подключения автоплатежей в сетях TRON, TON, BSC, POLYGON.
Сети TRON (TRC20), TON, BSC (Binance Smart Chain - BEP20), POLYGON - позволяет вашему боту принимать автоплатежи и зачислять их суммы на баланс юзеров в боте.
● Адрес платёжных систем:
- TRON: https://tron.network/
- TON: https://ton.org/
- BSC: https://bscscan.com/
- POLYGON: https://polygon.technology/
АВТОПЛАТЕЖИ (приём платежей)
● Идентификация: Адрес плательщика (кошелёк).
● Доступные валюты:
- TRON: TRX, USDT (любые другие доступные Монеты и Токены, по запросу)
- TON: TON (любые другие доступные Монеты и Токены, по запросу)
- BSC: BNB, USDT (любые другие доступные Монеты и Токены, по запросу)
- POLYGON: MATIC, USDT, USDC, BUSD, BTC, ETH, BNB, DAI (любые другие доступные Монеты и Токены, по запросу)
📆 Оплата ежемесячно (актуальную стоимость смотри при оплате).
🔧 Настройка подключения:🔐Админ | 💸Автоплатежи
АВТОВЫВОДЫ (выплаты)
● Автовывод средств: Доступен в сети TRON (оплачивается отдельно✱), НЕдоступен в сетях TON, BSC, POLYGON.
● Выплаты происходят внутри самой сети (у юзера должен личный кошелёк Tron).
📆 Оплата: ежемесячно (актуальную стоимость смотри при оплате).
📞 Запрос подключения: через бот @MegaHubSupportBot раздел: «🤑 Подключить «Автоматический Вывод» в Боте».✱На данный момент подключение и оплата Автовыводов осуществляется вручную (возможно в будущем этот процесс будет автоматизирован).
ВАЖНО: Подключение автоплатежей для всех представленных сетей осуществляется аналогичным образом. По этой причине, а так же по причине нежелания дублировать информацию в отдельных документах, инструкции для всех представленных сетей были объединены в одно руководство. Однако, нужно иметь ввиду, что каждая из представленных сетей, являясь отдельным, самостоятельным проектом, подключается и оплачивается отдельно.
Начиная разговор об автоплатежах в этом руководстве, мы исходим из того что вы уже обладаете базовыми знаниями о том как работать с конструктором и нам не нужно пояснять вам, например, как добавляются кнопки и сообщения в меню вашего бота. Если всё же эти базовые вещи вам ещё нужно пояснять значит вы слишком рано перешли к созданию функционала автоплатежей.
❖ Автоплатежи (приём платежей)
Как организовать автоматический приём платежей для сетей TRON, TON, BSC, POLYGON в вашем боте.
Необходимые функции
Функционал раздела «🧩Расширения»:
● если вы не используете переменную balance, для начисления, то вам понадобятся дополнительные переменные.
● вам нужны дополнительные переменные для хранения адресов кошельков пользователей.
Доп. Переменные
Для подключения перейдите в вашем боте:☞ 🔐Админ | 🧩Расширения | 📂Переменные
Настройка автоплатежа
1. Настройки чекера
При помощи мастера настроек введите все запрашиваемые данные.
1.1 Адрес ВАШЕГО кошелька в одной из сетей
Адрес вашего кошелька в одной из сетей (из указанных выше) на который вы планируете получать платежи. Бот будет проверять входящие транзакции этого кошелька.
ВАЖНО: Для подключения функционала Автоплатежей (приёма платежей) мы рекомендуем вам изначально завести ОТДЕЛЬНЫЙ пустой кошелёк и НЕ использовать ваше основное хранилище средств для этих целей. На данном этапе это не так критично и вы в принципе можете использовать любой кошелёк, однако если в будущем вы захотите подключить Автовыводы (выплаты), то там вам точно понадобится ОТДЕЛЬНЫЙ НОВЫЙ КОШЕЛЁК и систему приёма платежей тогда придётся повторно переподключать на новый адрес.
После ввода указанных выше данных вы увидите кнопки которых ранее не было в меню.
2. Оплатить чекер
Произведите оплату представленной суммы.
Оплата минимум за месяц. Обменяйте необходимую сумму в TMH на вашем аккаунте в @MenuBuilderBot исходя из количества месяцев подключения:☞ 🔐Админ | 🧩Расширения | 🏦Ваши Кошельки
3. Активировать чекер
Включите чекер чтобы продолжить настройку.
4. Адреса Юзеров
Необходимо указать Переменную для хранения адреса кошелька пользователя, выбранной вами сети, для идентификации его платежей.
РУКОВОДСТВО: Если не поняли для чего переменная - ещё раз читайте «Способы идентификации платежей».
5. Баланс в ХХХХ
Необходимо задать Переменные - куда начислять средства для каждой из доступных валют.
Если у вас в боте только одна валюта, то обычно используют "balance". Если несколько валют, то может быть индивидуальная переменная для каждой валюты или единая, но с конвертацией по курсу. Каждой валюте, доступной для автопополнений в конкретной сети, будет соответствовать отдельная кнопка указания Баланса.
5.1 Укажите переменную для начисления.
Для выбора, вам будет представлен список доступных в Боте ЦИФРОВЫХ переменных.
Если у вас нету переменных - вам нужно их ДОБАВИТЬ в бот и СОЗДАТЬ - ссылку на руководство мы дали выше.
Количество имеющихся у вас в боте переменных должно соответствовать количеству валют которые вы планируете принимать на разные балансы в боте.
5.2 Укажите курс начисления.
Сумма пополнения будет умножена на заданный Курс. Вы можете использовать Выражения и макросы Автоматических Курсов валют (приобретать их отдельно - нет необходимости).
Для чего нужен курс начисления и как его использовать.
● Вы можете использовать свой собственный токен внутри вашего проекта и его курс может напрямую не соответствовать валюте пополнения, таким образом вы можете задавать свои собственные курсы и начислять пополнение сразу во внутреннем токене.
● При помощи курса можно задавать комиссию на пополнение в той или иной валюте и комиссия может быть разной для каждой из валют.
● Если у вас единый баланс, а пополнение производится при помощи разных валют, то указав одну переменную вы можете начислять туда разные валюты - автоматически конвертируя их при помощи курсов и приводя к некому единому виду (например конвертируя всё в USDT).
5.3 Укажите реферальный бонус.
Размер реферального бонуса определяется ПОСЛЕ расчёта суммы фактического начисления с учётом указанного ранее Курса.
6. Показ общей суммы
При автопополнении в указанную вами группу (смотри ниже) будут приходить отчёты с данными конкретного пополнения. Если вы хотите чтобы при этом отдельным сообщением вам показывали общую сумму на балансе вашего кошелька, то оставьте включённой данную опцию.
Включает показ общей суммы на балансе кошелька при автопополнениях.
Режимы:Выкл ⏹️ - функция выключена (сумма не показывается).Вкл ▶️ - функция включена (общая сумма показывается).
Настройка группы отчётов для автоплатежей
Как было сказано выше, при автопополнении в указанную вами группу будут приходить отчёты с данными конкретного пополнения. Для того чтобы бот знал в какую группу присылать отчёты - её нужно указать в настройках.
Для указания группы перейдите вашем боте:
☞ 🔐Админ | 💸Автопополнения | Группа/Канал Пополнений
Задать Группу/Канал пополнений
О том как добавлять группу смотри в руководстве по группам - принцип один и тот же.
Группа/Канал Публичная
Опция определяет какого рода данные будут присутствовать в отчёте. В отчётах для публичных групп отсутствует персональные данные пользователей.
Определяет тип группы указанной для отправки отчётов.
Режимы:Выкл ⏹️ - группы приватная (все данные).Вкл ▶️ - группа публичная (без личных данных).
Задать Сообщение при Пополнении
Тут можно задать своё собственное сообщение для отчёта об автопополнении. В сообщении доступны все макросы вашего бота, а также есть список дополнительных макросов который указан в инструкции при входе в настройку.
Как организовать Автоплатежи в меню вашего бота
Как организовать автоплатёж для сетей TRON, TON, BSC, POLYGON.
Если вы уже активировали автоматическую оплату (для сетей указанных выше) в своем боте, вам необходимо создать способ для людей (ваших пользователей) для автоматического пополнения. Что для этого нужно:
Практически всё что вам нужно в боте, это кнопка с формой «Ввод Переменной» куда ваши юзеры сохранят адрес ИХ кошелька - с которого будут платить (для идентификации) и сообщение с адресом ВАШЕГО кошелька (чтобы они знали куда платить). Кнопку назовите как хотите, например «Ввести Адрес Вашего Кошелька», а сообщение желательно либо показывать после формы ввода, либо создать для него отдельную кнопку защищённую условием проверяющим введён ли адрес кошелька юзера для идентификации. Тут мы опишем второй способ.
1. Создайте общую кнопку. Назовите её: «Пополнить Баланс».
2. Внутри кнопки «Пополнить Баланс» создайте ещё две кнопки:
● «Адрес для Платежа»
● «Ввести Адрес Вашего Кошелька»
2.1 В сообщении кнопки «Адрес для Платежа», покажите адрес ВАШЕГО кошелька (который вы указали в пункте 2 при заказе автоплатежа). На этот адрес юзеры должны будут сделать перевод.
Самой кнопке можно добавить Условие для показа содержимого, проверяющее наличие введённого адреса кошелька вашего юзера - который будет использован для идентификации платежа.
Например: {%wallet% != ""}
Где %wallet% - макрос переменной указанной вами в пункте 4 при заказе автоплатежа.
Условие нужно для того чтобы юзер не получил адрес и не мог совершить перевод, до того как введёт адрес своего кошелька для идентификации платежа.
2.2 В кнопке «Ввести Адрес Вашего Кошелька» создайте форму «Ввод Переменной». В начальном сообщении формы попросите юзера ввести адрес кошелька с которого он будет производить оплату (и который будет использован для идентификации платежа).
Так же, для удобства юзера, в этом сообщении можно показать текущий, сохранённый адрес кошелька (возможно введённый юзером ранее) - это даст ему возможность проверить какой кошелёк был введён и не вводить его повторно.
ОБЯЗАТЕЛЬНО объясните вашим юзерам что они не могут платить путем вывода средств с обменников и бирж - такие платежи не будут идентифицированы, потому как биржи используют свои собственные кошельки для вывода и они не совпадают с теми адресами на которые юзеры делают переводы при вводе средств на биржи. В БОЛЬШОМ КОЛИЧЕСТВЕ СЛУЧАЕВ САМИ ОНИ ДО ЭТОГО НЕ ДОДУМАЮТСЯ - НАШИ НЕ ДОДУМЫВАЮТСЯ. Удачи вам с этим. 😁
Вводимый юзером адрес кошелька можно проверять (НЕ ОБЯЗАТЕЛЬНО). Для этого используется расширенный функционал форм.
Функционал раздела «🧩Расширения»: вводимые данные проверяются на соответствие Условию.
Условия Форм
Для подключения перейдите в вашем боте:☞ 🔐Админ | 🧩Расширения | 📂Формы
ПОСОБИЕ: Подробнее о том как проверять адрес кошелька для каждой из сетей смотри в пособии «Примеры Условий в формах».
• • •
Естественно, всё это можно сделать и красивее, но мануал пишется для тех кто без посторонней помощи не может создать данный функционал и дополнительные сложности при создании им ни к чему. Остальные и сами могут создать форму в том виде в котором им нужно.
• • •
ДЛЯ СПРАВКИ: посмотрите, как в нашей системе организована автооплата для доступных сетей.
Для этого перейдите в свой бот:🔐Админ | 🧩Расширения | 🏦Ваши кошельки | 💳Пополнить
❖ Сообщения об ошибках
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 никогда не попросит Приватных Ключей от ваших основных кошельков. Тот кто это делает -мошенник.
То есть вы заводите отдельный кошелёк для выводов и пополняете его по мере необходимости небольшими суммами. Если вы не знаете как получить Приватный Ключ нового кошелька, мы можем завести такой кошелёк для вас. В любом случае системе ДОЛЖЕН БЫТЬ известен Приватный Ключ, поэтому такой кошелёк нельзя считать надёжным хранилищем и использовать для каких-то других целей, в связи с этим не имеет большого значения кто его заведёт мы или вы сами.
В дальнейших инструкциях по подключению Автовыводов (выплат) мы исходим из того что Автоплатежи (приём платежей) у вас УЖЕ подключены на какой-то ваш собственный отдельный кошелёк не являющийся хранилищем для основных средств проекта. Если это не так, то вам будет нужно вернуться к началу этого руководства провести подключение Автоплатежей на новый пустой кошелёк и затем продолжить создание функционала Автовыводов.
Данные необходимые для работы функции Автовыводов
Для системы Tron:
• Приватный Ключ кошелька
Как подключить Вывод Средств в автоматическом режиме
1. Зайдите в свой кошелёк в сети Tron который вы используете для Автоплатежей.
2. Скопируйте его «Приватный Ключ».
3. Перейдите в бот @MegaHubSupportBot раздел: «🤑 Подключить «Автоматический Вывод» в Боте».
4. Прочтите и согласитесь со всеми Условиями (делается один раз).
5. Выберите нужную систему чтобы оформить заказ на активацию Автовыводов.
6. Пополните кошелёк TMH своего аккаунта на указанную сумму (оплата производится ежемесячно, пока в ручном режиме. Оплата за первый месяц является оплатой за подключение и НЕ возвращается, даже если вы передумали использовать Автовыводы).
7. Введите все необходимые для подключения данные и отправьте запрос на активацию Автовыводов.
8. Ожидайте ответа Админов об активации Автовыводов (признаком активации может являться появление списка PayID для каждой из указанных вами валют в раздел «💸 Автоплатежи» для выбранной вами системы).
9. После активации перейдите, в раздел «💸 Автоплатежи».
10. Выберите раздел только что активированной для Автовыводов платёжной системы.
11. Для каждой используемой вами валюты в кнопке «Баланс XXX» укажите МАКСИМАЛЬНУЮ сумму доступную для выводов (выплат) в автоматическом режиме.
Указание максимальной суммы доступной для автоматических выплат необходимо для того чтобы минимизировать возможные последствия ошибок при случайных либо необдуманных подтверждениях выводов. Автовыводы - необратимы. То есть, большие суммы мы всё-таки предлагаем вам выводить вручную в полуавтоматическом режиме.
12. В настройках кнопки «Вывод Средств» появится раздел «Задать PayID» - позволяющий ассоциировать конкретную кнопку Вывод Средств с отдельной валютой. Одна кнопка работает с одной валютой.
13. После настройки ОБЯЗАТЕЛЬНО протестируйте работу кнопки на незначительной сумме.
14. Напоминание о ежемесячной оплате придёт в бот @MegaHubSupportBot и\или в головной бот @MenuBuilderBot проекта.
ВАЖНО: В случае если функционал Автовыводов был отключён за неуплату, повторное подключение оплачивается отдельно от ежемесячной платы.