Автоплатежи - Cryptomus [в Админке]
Руководство для самостоятельного подключения автоплатежей в Cryptomus.
CRYPTOMUS - позволяет вашему боту принимать автоплатежи и зачислять их суммы на баланс юзеров в боте, генерируя для каждого юзера индивидуальные адреса кошельков для оплаты.
● Адрес платёжной системы: https://cryptomus.com
АВТОПЛАТЕЖИ (приём платежей)
● Идентификация: Адрес личного Криптокошелька.
● Валюты: BTC, ETH, BNB, USDT, USDC, TON, TRX, LTC, DOGE, DAI, DASH, BCH, SOL.
📆 Оплата: ПРЕДОСТАВЛЯЕТСЯ БЕСПЛАТНО.
🔧 Настройка подключения:🔐Админ | 💸Автоплатежи
АВТОВЫВОДЫ (выплаты)
● Авто вывод средств: Доступен (оплачивается отдельно✱)
● Выплаты происходят на внешние кошельки (юзеру не нужно иметь аккаунт в Cryptomus).
📆 Оплата: ежемесячно (актуальную стоимость смотри при оплате).
📞 Запрос подключения: через бот @MegaHubSupportBot раздел: «🤑 Подключить «Автоматический Вывод» в Боте».
✱На данный момент подключение и оплата Автовыводов осуществляется вручную (возможно в будущем этот процесс будет автоматизирован).
ВАЖНО: Услуга обеспечивается Сторонним Сервисом и условия её предоставления зависят не от нас. В связи с этим, Услуга предоставляется "как есть" в БЕСПЛАТНОМ режиме, до тех пор пока мы сами получаем доступ к данному сервису на существующих условиях. В случае изменения условий на Третьей Стороне мы оставляем за собой право изменить и наши Условия предоставления.
Таким образом, Функция может быть отключена в любое время, условия и положения, которые мы в настоящее время используем для её предоставления, могут быть пересмотрены и изменены с уведомлением или без него.
Начиная разговор об автоплатежах в этом руководстве, мы исходим из того, что вы уже обладаете базовыми знаниями о том, как работать с конструктором, и нам не нужно пояснять вам, например, как добавляются кнопки и сообщения в меню вашего бота. Если всё же эти базовые вещи вам ещё нужно пояснять, значит вы слишком рано перешли к созданию функционала автоплатежей.
Валидация Мерчанта
Система Cryptomus имеет обязательную привязку доменов/ботов и премодерацию для получения Ключа API.
При получении Токена API имейте ввиду, что Система Cryptomus, по информации представителей, ориентирована на ПОЛНУЮ ЛЕГАЛЬНОСТЬ ПРОЕКТОВ, поэтому для неоднозначных проектов максимально высока вероятность отказа в получении Ключа API. Что именно они хотят при этом видеть и какими правилами руководствуются - однозначно сказать невозможно.
В качестве адреса проекта, при проверке, МОЖНО указывать ССЫЛКУ на ваш бот - понятно что содержимое бота должно соответствовать неким усреднённым представлениям о нормальности, а так же бот должен оформлен и находится в той степени готовности чтобы МОДЕРАТОР Cryptomus мог оценить его содержимое и предназначение.
Как минимум:
• У бота должна быть АДЕКВАТНАЯ КАРТИНКА (не нужно помещать туда своё "любимое растение" и филейные части ваших тянок).
• У бота должно быть ВНЯТНОЕ ОПИСАНИЕ (чтобы модератор мог понять его предназначение).
• В описании должны присутствовать КОНТАКТЫ ПОДДЕРЖКИ для юзера, на случай затруднений (не спрашивайте - зачем в боте контакты - если бот и сам средство связи - мы не знаем зачем, но есть информация что НАДО - поэтому просто добавьте).
• В боте должно быть заполнено сообщение "About" (наличие соответствующей картинки будет только плюсом) - там тоже поместите информацию которая УПРОСТИТ задачу модератору в понимании того с чем он имеет дело - может тогда он даже и не запустит сам бот - ограничится описанием.
• Убедитесь что СТАРТ-овая страница вашего бота и содержимое Главного Меню - тоже можно показывать здоровым людям.
Надо понимать что модератор Cryptomus - тоже человек и у него нету ни желания, ни цели изучать ваш проект под микроскопом, поэтому чем проще ему будет оценить внешнее состояние вашего проекта, тем скорее будет принято решение о прохождении вами модерации.
❖ Автоплатежи (приём платежей)
Как организовать автоматический приём платежей CRYPTOMUS в вашем боте.
Необходимые функции
ПЕРЕМЕННЫЕ ДЛЯ ХРАНЕНИЯ АДРЕСОВ
При работе с автоматическим пополнением балансов при помощи платёжной системы Cryptomus желательно использовать переменные для хранения адресов, запрошенных и полученных пользователями.
Для каждого пользователя платёжная система Cryptomus генерирует индивидуальный адрес кошелька для пополнения Баланса. Адрес этого кошелька для каждого пользователя может сохраняться в отдельной переменной адреса. Если ваш пользователь забыл адрес своего индивидуального кошелька - вы всегда сможете мгновенно показать его в Боте в сообщении или в кнопке запроса Адреса. Однако, эти адреса можно и не сохранять. В этом случае платежи будут по прежнему начисляться корректно, но чтобы узнать свой сгенерированный ранее адрес пользователю нужно будет либо искать его в истории бота, либо сделать новый запрос и подождать 2-5 минуты, поскольку запрос опять пойдёт через платёжную систему.
Функционал раздела «🧩Расширения»:
● если вы не используете переменную balance для начисления, то вам понадобятся дополнительные переменные.
● (НЕОБЯЗАТЕЛЬНО) дополнительные переменные для хранения адресов кошельков пользователей.
Доп. Переменные
Для подключения перейдите в вашем боте:☞ 🔐Админ | 🧩Расширения | 📂Переменные
Настройка автоплатежа
1. Настройки чекера
При помощи мастера настроек введите все запрашиваемые данные.
1.1 Идентификатор Аккаунта - MERCHANT_ID
1.2 Ключ Платежей - Payment API_KEY
ВАЖНО: В системе есть два типа API_KEY.
● Первый - «Payment API_KEY» - нужен для приёма платежей и настраивается в свойствах Мерчанта.
● Второй - это «Payout API_KEY» - нужен для выплат и генерируется в настройках профиля.
На данный момент разговор идёт о ПЕРВОМ типе ключа.
Чтобы получить эти данные:
1.2.1 Зайдите на https://cryptomus.com, раздел
• «Мерчанты» (левая нижняя панель)
• Создайте новый Мерчант, нажав «+»
• Выберите «Payment by API»
• Следуйте инструкциям мастера и введите все необходимые данные.
1.2.2 Перейдите в «Настройки» вашего Мерчанта, чтобы получить MERCHANT_ID .
• Затем сгенерируйте Payment API_KEY, следуя инструкциям.
В качестве адреса веб-сайта для создания Payment API_KEY вы можете использовать адрес вашего бота в формате:https://t.me/NameOfMyBot
Описание придумайте любое, более или менее адекватное - можно 1-2 слова.
Официальное видео: https://youtu.be/MqdfrZgfoBo
Один Мерчант может быть использован только в ОДНОМ боте. Один Мерчант - Один Бот.
2. Добавить время
Нажмите «Добавить Время» чтобы включить чекер и продолжить настройку.
Поскольку платёжная система Cryptomus предоставляется БЕСПЛАТНО - оплачивать её не нужно, но нужно периодически продлевать. Сделано это для того, чтобы исключить из обработки неиспользуемые подключения, заброшенные их владельцами. Если вы забыли продлить автоплатёж и он был отключён по этой причине - просто нажмите «Добавить Время» ещё раз.
3. Активировать чекер (Отключить чекер)
При первом Добавлении Времени, Чекер будет активирован автоматически. Его можно включать и отключать при необходимости.
4. Баланс в ХХХХ
Необходимо задать переменные - куда начислять средства для каждой из доступных валют.
4.1 Укажите переменную для начисления.
Подробнее об указании переменных для начисления смотри в руководстве для TRON.
4.2 (НЕОБЯЗАТЕЛЬНО) Укажите переменную для хранения адреса кошелька пользователя или нажмите «Не Использовать» если не будете хранить адреса кошельков в боте.
Если вы решили использовать переменные для автоплатежей, то тут необходимо указать переменную для хранения адреса кошелька пользователя для настраиваемой вами сети (BTC, ETH, LTC, TRON, BSC, DASH).
Адреса для каждой из сетей должны храниться в отдельной индивидуальной ТЕКСТОВОЙ переменной - для каждого пользователя.
Поскольку адреса кошельков в одной Сети (блокчейне) одинаковы, независимо от того, сколько валют (токенов) фактически представлено в блокчейне, вы можете использовать ОДНУ переменную для каждой Сети.
Например:
в сети Tron TRX и USDT-TRC20 используют один и тот же крипто-адрес, поэтому вам не нужно создавать отдельные переменные для хранения адресов кошельков. То же самое относится к Binance Smart Chain (BEP20) и Ethereum (ERC20).
В целом, вам нужно создать ОДНУ переменную для каждой сети (блокчейна).
4.3 Укажите курс начисления.
Подробнее об указании курса для начисления смотри в руководстве для TRON.
ВАЖНО: PayID для каждой из валют будет сгенерирован после завершения установки переменной и показан в информационном сообщении при входе в настройки автоплатежей для этой системы.
5. Показ общей суммы
Включает и выключает показ общей суммы на балансе кошелька при автопополнениях.
Подробнее о показе общей суммы смотри в руководстве для TRON.
Настройка группы отчётов для автоплатежей
При автопополнении в указанную вами группу будут приходить отчёты с данными конкретного пополнения.
Подробнее о настройке группы отчётов смотри в руководстве для TRON.
Как организовать Автоплатежи Cryptomus в меню вашего бота
Как организовать автоплатёж через Cryptomus.
Если вы уже активировали автоматическую оплату CRYPTOMUS в своем боте, вам необходимо создать способ для людей (ваших пользователей) для автоматического пополнения. Что для этого нужно:
Все, что вам нужно в боте, это создать меню с кнопками типа «Адрес» для генерации индивидуальных Адресов крипто-кошельков, для каждой СЕТИ в которой вы принимаете платежи.
Поскольку адреса кошельков в одной сети (блокчейне) одинаковы, независимо от того, сколько валют (токенов) фактически представлено в блокчейне, вы можете использовать одну кнопку для каждой СЕТИ - то есть нет необходимости создавать отдельную кнопку для каждой валюты (токена) - если конечно такая необходимость не обусловлена особенностями вашего проекта.
Например:
в сети Tron TRX и USDT-TRC20 используют один и тот же крипто-адрес, поэтому вам не нужно создавать отдельные кнопки. То же самое относится к Binance Smart Chain (BEP20) и Ethereum (ERC20).
В целом, вам достаточно создать ОДНУ кнопку на каждую СЕТЬ (блокчейн).
1. Создайте в боте нужное вам количество кнопок для генерации Адресов крипто-кошельков, по количеству сетей или валют, из тех, которые вы указали при активации автоплатежей и планируете принимать к оплате. Для этого вашему боту будет добавлено соответствующее количество слотов для таких кнопок. Каждой из указанных вами валют (сетей) будет присвоен собственный «PayID».
Обычно количество добавленных по умолчанию «кнопок адреса» достаточно и соответствует количеству валют которые вы принимаете в своем боте. Если по каким-то причинам вам нужно больше кнопок, то просто обратитесь в службу поддержки через специальную форму для вопросов об Автоплатежах и попросите добавить нужное количество.
2. Чтобы создать кнопки для генерации Адресов кошельков, создайте обычную кнопку, затем перейдите в ее настройки и нажмите:
• «Назначить Адрес».
• Затем следуйте инструкциям мастера настройки.
3. Создайте кнопки в нужном количестве, назначив каждой соответствующий, выданный вам PayID.
Переменные для начисления и хранения адресов кошельков УЖЕ привязаны к соответствующим PayID.
ДЛЯ СПРАВКИ: посмотрите, как в нашей системе организована автооплата Cryptomus.
Для этого перейдите в свой бот:🔐Админ | 🧩Расширения | 🏦Ваши кошельки | 💳Пополнить | Использовать Личный Крипто Адрес
Особенности Cryptomus
● Все депозиты в Cryptomus осуществляются через созданный вами «Мерчант» (тот, у которого есть ключ API). Таким образом, чтобы вывести средства из вашего «Бизнес-кошелька», вы должны сначала перевести их в «Личный кошелек» внутри Cryptomus.
● Cryptomus имеет минимальные суммы для пополнения, и они разные для каждой валюты - просто проверьте их и сообщите своим пользователям.
● За пополнение баланса «Мерчанта» Cryptomus сам берет 2%, поэтому фактическая сумма всегда будет меньше той, которую вы видите при пополнении. Вы можете заплатить эту комиссию самостоятельно или добавить 2% к вашему индивидуальному «курсу валюты», чтобы покрыть разницу.
❖ Сообщения об ошибках
Список ВСЕХ сообщений об ошибках смотри в руководстве «Автоплатежи и Вывод Средств - общие сведения»
❖ Автовыводы (выплаты)
Вывод средств (полуавтоматический)
При наличии функционала автоматического приёма платежей вам возможно понадобится кнопка для осуществления Вывода Средств. Кнопка позволяет автоматически списывать средства с указанной вами переменной где хранится Баланс пользователя. Непосредственно перевод средств на внешний кошелёк юзера осуществляется админом вручную. Кнопка позволяет частично облегчить процесс выводов ограничившись лишь непосредственно переводами, а так же вести своеобразную историю (Лог) выводов в отдельной группе куда будут поступать запросы на вывод.
Подробнее о работе с кнопкой Вывода Средств смотри в руководстве.
Вывод средств (автоматический с подтверждением админа)
Для платёжной системы CRYPTOMUS доступен функционал автоматического вывода средств.
ВАЖНО: Не пытайтесь договариваться о подключении Автоматических Выводов до тех пор пока полностью не разберётесь с тем как работает кнопка «Вывод Средств» в полуавтоматическом режиме.
Если вы полностью разобрались с тем как работает кнопка Вывода Средств - у вас подключена, настроена и некоторое время уже работает хотя бы одна такая кнопка, вы можете рассматривать вариант активации автоматических выводов.
Данные необходимые для работы функции Автовыводов
Для системы CRYPTOMUS:
• Сгенерировать отдельный "payout" токен.
Как подключить Вывод Средств в автоматическом режиме
1. Зайдите в свой кошелёк CRYPTOMUS который вы используете для Автоплатежей.
2. Сгенерируйте отдельный "payout" токен.
3. Перейдите в бот @MegaHubSupportBot раздел: «🤑 Подключить «Автоматический Вывод» в Боте».
4. Прочтите и согласитесь со всеми Условиями (делается один раз).
5. Выберите нужную систему чтобы оформить заказ на активацию Автовыводов.
6. Пополните кошелёк TMH своего аккаунта на указанную сумму (оплата производится ежемесячно, пока в ручном режиме. Оплата за первый месяц является оплатой за подключение и НЕ возвращается, даже если вы передумали использовать Автовыводы).
7. Введите все необходимые для подключения данные и отправьте запрос на активацию Автовыводов.
8. Ожидайте ответа Админов об активации Автовыводов (признаком активации может являться появление списка PayID для каждой из указанных вами валют в раздел «💸 Автоплатежи» для выбранной вами системы).
9. После активации перейдите, в раздел «💸 Автоплатежи».
10. Выберите раздел только что активированной для Автовыводов платёжной системы.
11. Для каждой используемой вами валюты в кнопке «Баланс XXX» укажите МАКСИМАЛЬНУЮ сумму доступную для выводов (выплат) в автоматическом режиме.
Указание максимальной суммы доступной для автоматических выплат необходимо для того чтобы минимизировать возможные последствия ошибок при случайных либо необдуманных подтверждениях выводов. Автовыводы - необратимы. То есть, большие суммы мы всё-таки предлагаем вам выводить вручную в полуавтоматическом режиме.
12. В настройках кнопки «Вывод Средств» появится раздел «Задать PayID» - позволяющий ассоциировать конкретную кнопку Вывод Средств с отдельной валютой. Одна кнопка работает с одной валютой.
13. После настройки ОБЯЗАТЕЛЬНО протестируйте работу кнопки на незначительной сумме.
14. Напоминание о ежемесячной оплате придёт в бот @MegaHubSupportBot и\или в головной бот @MenuBuilderBot проекта.
ВАЖНО: В случае если функционал Автовыводов был отключён за неуплату, повторное подключение оплачивается отдельно от ежемесячной платы.