Автоплатежи - Cryptomus [в Админке]
Руководство для самостоятельного подключения автоплатежей в Cryptomus.
CRYPTOMUS - позволяет вашему боту принимать автоплатежи и зачислять их суммы на баланс юзеров в боте, генерируя для каждого юзера индивидуальные адреса кошельков для оплаты.
● Адрес платёжной системы: https://cryptomus.com
● Идентификация: Адрес личного Криптокошелька.
● Валюты: BTC, ETH, BNB, USDT, USDC, TON, TRX, LTC, DOGE, DAI, DASH, BCH.
● Авто вывод средств: НЕдоступен.
📆 Оплата: ПРЕДОСТАВЛЯЕТСЯ БЕСПЛАТНО.
📞 Настройка подключения:🔐Админ | 💸Автоплатежи
ВАЖНО: Услуга обеспечивается Сторонним Сервисом и условия её предоставления зависят не от нас. В связи с этим, Услуга предоставляется "как есть" в БЕСПЛАТНОМ режиме, до тех пор пока мы сами получаем доступ к данному сервису на существующих условиях. В случае изменения условий на Третьей Стороне мы оставляем за собой право изменить и наши Условия предоставления.
Таким образом, Функция может быть отключена в любое время, условия и положения, которые мы в настоящее время используем для её предоставления, могут быть пересмотрены и изменены с уведомлением или без него.
Система Cryptomus имеет обязательную привязку доменов / ботов и премодерацию. При получении токена API имейте ввиду, что Система 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% к вашему индивидуальному «курсу валюты», чтобы покрыть разницу.
❖ Дополнительная информация
Вывод средств (полуавтоматический)
При наличии функционала автоматического приёма платежей вам возможно понадобится кнопка для осуществления Вывода Средств.
Подробнее о работе с кнопкой Вывода Средств смотри в руководстве.