Автоплатежи - OxaPay [Бесплатно - до 31.07.2025]
Руководство для самостоятельного подключения автоплатежей в OxaPay.
OXAPAY - позволяет вашему боту принимать автоплатежи и зачислять их суммы на баланс юзеров в боте, генерируя для каждого юзера индивидуальные адреса кошельков для оплаты.
● Адрес платёжной системы: https://oxapay.com
АВТОПЛАТЕЖИ (приём платежей)
● Идентификация: Адрес личного Криптокошелька.
● Валюты: BTC, ETH, BNB, USDT, USDC, TON, TRX, LTC, DOGE, DAI, BCH, SOL, POL, XMR, SHIB.
📆 Оплата: БЕСПЛАТНО (До 31.07.2025)
🔧 Настройка подключения:🔐Админ | 💸Автоплатежи
АВТОВЫВОДЫ (выплаты)
● Авто вывод средств: Доступен (оплачивается отдельно✱)
● Выплаты происходят на внешние кошельки (юзеру не нужно иметь аккаунт в OxaPay).
📆 Оплата: ежемесячно (актуальную стоимость смотри при оплате).
📞 Запрос подключения: через бот @MegaHubSupportBot раздел: «🤑 Подключить «Автоматический Вывод» в Боте».
✱На данный момент подключение и оплата Автовыводов осуществляется вручную (возможно в будущем этот процесс будет автоматизирован).
ВНИМАНИЕ: Система НЕ требует прохождения KYC для работы с платежами и НЕ требует модерации Мерчанта.
Начиная разговор об автоплатежах в этом руководстве, мы исходим из того, что вы уже обладаете базовыми знаниями о том, как работать с конструктором, и нам не нужно пояснять вам, например, как добавляются кнопки и сообщения в меню вашего бота. Если всё же эти базовые вещи вам ещё нужно пояснять, значит вы слишком рано перешли к созданию функционала автоплатежей.
Валидация Мерчанта
Система OxaPay НЕ ТРЕБУЕТ модерации для получения Ключа API.
❖ Автоплатежи (приём платежей)
Как организовать автоматический приём платежей OXAPAY в вашем боте.
Необходимые функции
ПЕРЕМЕННЫЕ ДЛЯ ХРАНЕНИЯ АДРЕСОВ
При работе с автоматическим пополнением балансов при помощи платёжной системы OxaPay желательно использовать переменные для хранения адресов, запрошенных и полученных пользователями.
Для каждого пользователя платёжная система OxaPay генерирует индивидуальный адрес кошелька для пополнения Баланса. Адрес этого кошелька для каждого пользователя может сохраняться в отдельной переменной адреса. Если ваш пользователь забыл адрес своего индивидуального кошелька - вы всегда сможете мгновенно показать его в Боте в сообщении или в кнопке запроса Адреса. Однако, эти адреса можно и не сохранять. В этом случае платежи будут по прежнему начисляться корректно, но чтобы узнать свой сгенерированный ранее адрес пользователю нужно будет либо искать его в истории бота, либо сделать новый запрос и подождать 2-5 минуты, поскольку запрос опять пойдёт через платёжную систему.
Функционал раздела «🧩Расширения»:
● если вы не используете переменную balance для начисления, то вам понадобятся дополнительные переменные.
● (НЕОБЯЗАТЕЛЬНО) дополнительные переменные для хранения адресов кошельков пользователей.
Доп. Переменные
Для подключения перейдите в вашем боте:☞ 🔐Админ | 🧩Расширения | 📂Переменные
Настройка автоплатежа
1. Настройки чекера
При помощи мастера настроек введите все запрашиваемые данные.
1.1 Идентификатор Мерчанта - MERCHANT_API_KEY
1.2 (НЕ ОБЯЗАТЕЛЬНО) Общий Ключ API - GENERAL_API_KEY
ВАЖНО: В системе есть несколько типов API_KEY, нам нужны следующие:
● Первый - «MERCHANT_API_KEY» - нужен для приёма платежей получается при создании Мерчанта.
● Второй - это «GENERAL_API_KEY» - нужен только для показа общего баланса кошелька после получения платежа (и является НЕ ОБЯЗАТЕЛЬНЫМ).
Чтобы получить MERCHANT_API_KEY:
• Зайдите на https://oxapay.com, нажмите:
• «Сервис для продавцов» (Merchant Service) (левая панель)
• В правой панели заполните раздел «Создать API-ключ продавца» (Generate Merchant API Key)
• Введите название нового Мерчанта
• Выберите поддерживаемые валюты
• Расширенные Настройки: Определитесь кто оплачивает комиссии
• Расширенные Настройки: Заполните остальные данные значение которых вам понятно (всё что не понятно или ЯВНО находится вне вашей компетенции ОСТАВЬТЕ КАК ЕСТЬ)
• Создайте новый Мерчант, нажав кнопку внизу правой панели «Создать API-ключ продавца» (Generate Merchant API Key)
• После создания в средней панели в разделе «Список API-ключей продавца» (Merchant API Keys List) появится ключ с именем нового Мерчанта.
Один Мерчант может быть использован только в ОДНОМ боте. Один Мерчант - Один Бот.
Чтобы получить GENERAL_API_KEY (НЕ ОБЯЗАТЕЛЬНО):
• «Настройки аккаунта» (Account Settings) (левая панель)
• в правой панели, следуя инструкциям активируйте 2FA (двухфакторную аутентификацию)
• в правой панели в разделе «Создать общий API-ключ» (Generate General API Key) следуя инструкциям создайте Общий Ключ (Введите название Ключа и код 2FA)
2. Добавить время
Нажмите «Добавить Время» чтобы включить чекер и продолжить настройку.
Поскольку платёжная система OxaPay предоставляется БЕСПЛАТНО (до 31.07.2025) - оплачивать её не нужно, но нужно периодически продлевать. Сделано это для того, чтобы исключить из обработки неиспользуемые подключения, заброшенные их владельцами. Если вы забыли продлить автоплатёж и он был отключён по этой причине - просто нажмите «Добавить Время» ещё раз.
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.
Как организовать Автоплатежи OxaPay в меню вашего бота
Как организовать автоплатёж через OxaPay.
Если вы уже активировали автоматическую оплату OXAPAY в своем боте, вам необходимо создать способ для людей (ваших пользователей) для автоматического пополнения. Что для этого нужно:
Все, что вам нужно в боте, это создать меню с кнопками типа «Адрес» для генерации индивидуальных Адресов крипто-кошельков, для каждой СЕТИ в которой вы принимаете платежи.
Поскольку адреса кошельков в одной сети (блокчейне) одинаковы, независимо от того, сколько валют (токенов) фактически представлено в блокчейне, вы можете использовать одну кнопку для каждой СЕТИ - то есть нет необходимости создавать отдельную кнопку для каждой валюты (токена) - если конечно такая необходимость не обусловлена особенностями вашего проекта.
Например:
в сети Tron TRX и USDT-TRC20 используют один и тот же крипто-адрес, поэтому вам не нужно создавать отдельные кнопки. То же самое относится к Binance Smart Chain (BEP20) и Ethereum (ERC20).
В целом, вам достаточно создать ОДНУ кнопку на каждую СЕТЬ (блокчейн).
1. Создайте в боте нужное вам количество кнопок для генерации Адресов крипто-кошельков, по количеству сетей или валют, из тех, которые вы указали при активации автоплатежей и планируете принимать к оплате. Для этого вашему боту будет добавлено соответствующее количество слотов для таких кнопок. Каждой из указанных вами валют (сетей) будет присвоен собственный «PayID».
Обычно количество добавленных по умолчанию «кнопок адреса» достаточно и соответствует количеству валют которые вы принимаете в своем боте. Если по каким-то причинам вам нужно больше кнопок, то просто обратитесь в службу поддержки через специальную форму для вопросов об Автоплатежах и попросите добавить нужное количество.
2. Чтобы создать кнопки для генерации Адресов кошельков, создайте обычную кнопку, затем перейдите в ее настройки и нажмите:
• «Назначить Адрес».
• Затем следуйте инструкциям мастера настройки.
3. Создайте кнопки в нужном количестве, назначив каждой соответствующий, выданный вам PayID.
Переменные для начисления и хранения адресов кошельков УЖЕ привязаны к соответствующим PayID.
ДЛЯ СПРАВКИ: посмотрите, как в нашей системе организована автооплата OxaPay.
Для этого перейдите в свой бот:🔐Админ | 🧩Расширения | 🏦Ваши кошельки | 💳Пополнить | Использовать Личный Крипто Адрес
Особенности OxaPay
● Все депозиты в OxaPay осуществляются через созданный вами «Мерчант» (тот, у которого есть ключ API).
● OxaPay (НАСКОЛЬКО НАМ ИЗВЕСТНО) НЕ имеет минимальных сумм для пополнения (если это не так, то в будущем это сообщение будет исправлено).
● За пополнение баланса «Мерчанта» OxaPay сам берет 2%, поэтому фактическая сумма всегда будет меньше той, которую вы видите при пополнении. Вы можете заплатить эту комиссию самостоятельно или добавить 2% к вашему индивидуальному «курсу валюты», чтобы покрыть разницу.
❖ Сообщения об ошибках
Список ВСЕХ сообщений об ошибках смотри в руководстве «Автоплатежи и Вывод Средств - общие сведения»
❖ Автовыводы (выплаты)
Вывод средств (полуавтоматический)
При наличии функционала автоматического приёма платежей вам возможно понадобится кнопка для осуществления Вывода Средств. Кнопка позволяет автоматически списывать средства с указанной вами переменной где хранится Баланс пользователя. Непосредственно перевод средств на внешний кошелёк юзера осуществляется админом вручную. Кнопка позволяет частично облегчить процесс выводов ограничившись лишь непосредственно переводами, а так же вести своеобразную историю (Лог) выводов в отдельной группе куда будут поступать запросы на вывод.
Подробнее о работе с кнопкой Вывода Средств смотри в руководстве.
Вывод средств (автоматический с подтверждением админа)
Для платёжной системы OXAPAY доступен функционал автоматического вывода средств.
ВАЖНО: Не пытайтесь договариваться о подключении Автоматических Выводов до тех пор пока полностью не разберётесь с тем как работает кнопка «Вывод Средств» в полуавтоматическом режиме.
Если вы полностью разобрались с тем как работает кнопка Вывода Средств - у вас подключена, настроена и некоторое время уже работает хотя бы одна такая кнопка, вы можете рассматривать вариант активации автоматических выводов.
Данные необходимые для работы функции Автовыводов
Для системы OXAPAY:
• Сгенерировать отдельный «PAYOUT_API_KEY».
Как подключить Вывод Средств в автоматическом режиме
1. Зайдите в свой кошелёк OXAPAY который вы используете для Автоплатежей.
2. Сгенерируйте отдельный «PAYOUT_API_KEY» токен.
• В левой панели «Сервис выплат» (Payout Service)
• В правой панели «Создать API-ключ для выплат» (Generate Payout API Key) заполните необходимые данные.
• Создайте новый Ключ, нажав кнопку внизу правой панели «Создать API-ключ для выплат» (Generate Payout API Key)
3. Перейдите в бот @MegaHubSupportBot раздел: «🤑 Подключить «Автоматический Вывод» в Боте».
4. Прочтите и согласитесь со всеми Условиями (делается один раз).
5. Выберите нужную систему чтобы оформить заказ на активацию Автовыводов.
6. Пополните кошелёк TMH своего аккаунта на указанную сумму (оплата производится ежемесячно, пока в ручном режиме. Оплата за первый месяц является оплатой за подключение и НЕ возвращается, даже если вы передумали использовать Автовыводы).
7. Введите все необходимые для подключения данные и отправьте запрос на активацию Автовыводов.
8. Ожидайте ответа Админов об активации Автовыводов (признаком активации может являться появление списка PayID для каждой из указанных вами валют в раздел «💸 Автоплатежи» для выбранной вами системы).
9. После активации перейдите, в раздел «💸 Автоплатежи».
10. Выберите раздел только что активированной для Автовыводов платёжной системы.
11. Для каждой используемой вами валюты в кнопке «Баланс XXX» укажите МАКСИМАЛЬНУЮ сумму доступную для выводов (выплат) в автоматическом режиме.
Указание максимальной суммы доступной для автоматических выплат необходимо для того чтобы минимизировать возможные последствия ошибок при случайных либо необдуманных подтверждениях выводов. Автовыводы - необратимы. То есть, большие суммы мы всё-таки предлагаем вам выводить вручную в полуавтоматическом режиме.
12. В настройках кнопки «Вывод Средств» появится раздел «Задать PayID» - позволяющий ассоциировать конкретную кнопку Вывод Средств с отдельной валютой. Одна кнопка работает с одной валютой.
13. После настройки ОБЯЗАТЕЛЬНО протестируйте работу кнопки на незначительной сумме.
14. Напоминание о ежемесячной оплате придёт в бот @MegaHubSupportBot и\или в головной бот @MenuBuilderBot проекта.
ВАЖНО: В случае если функционал Автовыводов был отключён за неуплату, повторное подключение оплачивается отдельно от ежемесячной платы.