Автоплатежи - 2328-io [Бесплатно]
Руководство для самостоятельного подключения автоплатежей в 2328-io.
2328-IO - позволяет вашему боту принимать автоплатежи и зачислять их суммы на баланс юзеров в боте, генерируя для каждого юзера индивидуальные адреса кошельков для оплаты или выставление счета (Инвойс).
● Адрес платёжной системы: https://2328.io
АВТОПЛАТЕЖИ (приём платежей)
● Идентификация 1: Адрес личного Криптокошелька.
● Идентификация 2: Выставленный Счёт (Инвойс) (ссылка).
● Валюты: BTC, ETH, BNB, USDT, USDC, TON, TRX, LTC, DASH, AVAX, POL.
📆 Оплата: ПРЕДОСТАВЛЯЕТСЯ БЕСПЛАТНО.
🔧 Настройка подключения:🔐Админ | 💸Автоплатежи
АВТОВЫВОДЫ (выплаты)
● Авто вывод средств: Доступен (оплачивается отдельно✱)
● Выплаты происходят на внешние кошельки (юзеру не нужно иметь аккаунт в 2328-io).
📆 Оплата: ежемесячно (актуальную стоимость смотри при оплате).
📞 Запрос подключения: через бот @MegaHubSupportBot раздел: «🤑 Подключить «Автоматический Вывод» в Боте».
✱На данный момент подключение и оплата Автовыводов осуществляется вручную (возможно в будущем этот процесс будет автоматизирован).
ВАЖНО: Услуга обеспечивается Сторонним Сервисом и условия её предоставления зависят не от нас. В связи с этим, Услуга предоставляется "как есть" в БЕСПЛАТНОМ режиме, до тех пор пока мы сами получаем доступ к данному сервису на существующих условиях. В случае изменения условий на Третьей Стороне мы оставляем за собой право изменить и наши Условия предоставления.
Таким образом, ПО НЕЗАВИСЯЩИМ ОТ НАС ПРИЧИНАМ, функция может быть отключена в любое время, условия и положения, которые мы в настоящее время используем для её предоставления, могут быть пересмотрены и изменены с предварительным уведомлением или постфактум.
Начиная разговор об автоплатежах в этом руководстве, мы исходим из того, что вы уже обладаете базовыми знаниями о том, как работать с конструктором, и нам не нужно пояснять вам, например, как добавляются кнопки и сообщения в меню вашего бота. Если всё же эти базовые вещи вам ещё нужно пояснять, значит вы слишком рано перешли к созданию функционала автоплатежей.
Валидация Мерчанта
Система 2328-io имеет обязательную привязку доменов/ботов и премодерацию для получения Ключа API.
При получении Токена API имейте ввиду, что Система 2328-io, по информации представителей, ориентирована на ПОЛНУЮ ЛЕГАЛЬНОСТЬ ПРОЕКТОВ, поэтому для неоднозначных проектов максимально высока вероятность отказа в получении Ключа API.
ЧТО ТОЧНО ЗАПРЕЩЕНО И НЕ ПРОЙДЁТ МОДЕРАЦИЮ: вещества, оружие, когда проект выдаёт себя за кого-то другого. Платёжная система не работает с проектами связанными с США. Всё остальное нелегальное о чем лучше не упоминать здесь.
В качестве адреса проекта, при проверке, МОЖНО указывать ССЫЛКУ на ваш бот - понятно что содержимое бота должно соответствовать неким усреднённым представлениям о нормальности, а так же бот должен быть оформлен и находится в той степени готовности чтобы МОДЕРАТОР мог оценить его содержимое и предназначение.
Как минимум:
• У бота должна быть АДЕКВАТНАЯ КАРТИНКА (не нужно помещать туда своё "любимое растение" и филейные части ваших тянок).
• У бота должно быть ВНЯТНОЕ ОПИСАНИЕ (чтобы модератор мог понять его предназначение).
• В боте должно быть заполнено сообщение "About" (наличие соответствующей картинки будет только плюсом) - там тоже поместите информацию которая УПРОСТИТ задачу модератору в понимании того с чем он имеет дело - может тогда он даже и не запустит сам бот - ограничится описанием.
• Убедитесь что СТАРТ-овая страница вашего бота и содержимое Главного Меню - тоже можно показывать здоровым людям.
Надо понимать что модератор - тоже человек и у него нету ни желания, ни цели изучать ваш проект под микроскопом, поэтому чем проще ему будет оценить внешнее состояние вашего проекта, тем скорее будет принято решение о прохождении вами модерации.
❖ Автоплатежи (приём платежей)
Как организовать автоматический приём платежей 2328-IO в вашем боте.
Необходимые функции
ПЕРЕМЕННЫЕ ДЛЯ ХРАНЕНИЯ АДРЕСОВ
При работе с автоматическим пополнением балансов при помощи платёжной системы, желательно использовать переменные для хранения адресов, запрошенных и полученных пользователями.
Для каждого пользователя платёжная система генерирует индивидуальный адрес кошелька для пополнения Баланса. Адрес этого кошелька для каждого пользователя может сохраняться в отдельной переменной адреса. Если ваш пользователь забыл адрес своего индивидуального кошелька - вы всегда сможете мгновенно показать его в Боте в сообщении или в кнопке запроса Адреса. Однако, эти адреса можно и не сохранять. В этом случае платежи будут по прежнему начисляться корректно, но чтобы узнать свой сгенерированный ранее адрес пользователю нужно будет либо искать его в истории бота, либо сделать новый запрос и подождать 2-5 минуты, поскольку запрос опять пойдёт через платёжную систему.
Функционал раздела «🧩Расширения»:
● если вы не используете переменную balance для начисления, то вам понадобятся дополнительные переменные.
● (НЕОБЯЗАТЕЛЬНО) дополнительные переменные для хранения адресов кошельков пользователей.
Доп. Переменные
Для подключения перейдите в вашем боте:☞ 🔐Админ | 🧩Расширения | 📂Переменные
Настройка автоплатежа
1. Настройки чекера
При помощи мастера настроек введите все запрашиваемые данные.
1.1 Идентификатор Аккаунта - PROJECT_ID
1.2 Ключ Платежей - PAYMENT_API_KEY
ВАЖНО: В системе есть три типа API_KEY.
● Первый - «PROJECT_ID» - нужен для идентификации Проекта (мерчанта).
● Второй- «PAYMENT__API_KEY» - нужен для приёма платежей.
● Третий - это «PAYOUT_API_KEY» - нужен для выплат (подключаются отдельно см. выше).
На данный момент разговор идёт о ПЕРВОМ и ВТОРОМ типе ключей.
Для получения этих данных у вас должен быть создан Проект (Project):
• Зайдите на https://2328.io, нажмите:
• «Проекты» (Projects) (левая панель)
• Создайте новый Проект, нажав «Новый проект» (New Project)
- Введите Категорию (НАЗВАНИЕ) нового Проекта
- Введите ССЫЛКУ на ваш Проект - Сайт или Бот.
- Введите ваш Telegram для связи.
• Нажмите «Отправить» (Submit)
• После проверки Проекта (возможно с вами свяжется оператор) ваш проект появится в разделе «Проекты».
Один Проект может быть использован только в ОДНОМ боте. Один Проект - Один Бот.
Все необходимые ключи будут в свойствах Проекта.
2. Добавить время
Нажмите «Добавить Время» чтобы включить чекер и продолжить настройку.
Поскольку платёжная система 2328-io предоставляется БЕСПЛАТНО - оплачивать её не нужно, но нужно периодически продлевать. Сделано это для того, чтобы исключить из обработки неиспользуемые подключения, заброшенные их владельцами. Если вы забыли продлить автоплатёж и он был отключён по этой причине - просто нажмите «Добавить Время» ещё раз.
3. Активировать чекер (Отключить чекер)
При первом Добавлении Времени, Чекер будет активирован автоматически. Его можно включать и отключать при необходимости.
4. Баланс в ХХХХ
Необходимо задать переменные - куда начислять средства для каждой из доступных валют.
4.1 Укажите переменную для начисления.
Подробнее об указании переменных для начисления смотри в руководстве для TRON.
4.2 (НЕОБЯЗАТЕЛЬНО) Укажите переменную для хранения адреса кошелька пользователя или нажмите «Не Использовать» если не будете хранить адреса кошельков в боте.
Если вы решили использовать переменные для автоплатежей, то тут необходимо указать переменную для хранения адреса кошелька пользователя для настраиваемой вами сети (BTC, ETH, LTC, TRON, BSC, DASH).
Адреса для каждой из сетей должны храниться в отдельной индивидуальной ТЕКСТОВОЙ переменной - для каждого пользователя.
На данный момент в платёжной системе 2328-io для каждой валюты в любой сети генерируется ОТДЕЛЬНЫЙ АДРЕС КОШЕЛЬКА.
4.3 Укажите курс начисления.
Подробнее об указании курса для начисления смотри в руководстве для TRON.
ВАЖНО: PayID для каждой из валют будет сгенерирован после завершения установки переменной и показан в информационном сообщении при входе в настройки автоплатежей для этой системы.
5. Показ общей суммы
Включает и выключает показ общей суммы на балансе кошелька при автопополнениях.
Подробнее о показе общей суммы смотри в руководстве для TRON.
Настройка группы отчётов для автоплатежей
При автопополнении в указанную вами группу будут приходить отчёты с данными конкретного пополнения.
Подробнее о настройке группы отчётов смотри в руководстве для TRON.
Как организовать Автоплатежи 2328-io в меню вашего бота
Как организовать автоплатёж через 2328-io.
Вариант 1: генерация статического кошелька пополнения (Адрес)
Если вы уже активировали автоматическую оплату в своем боте, вам необходимо создать способ для людей (ваших пользователей) для автоматического пополнения. Что для этого нужно:
Все, что вам нужно в боте, это создать меню с кнопками типа «Адрес» для генерации индивидуальных Адресов крипто-кошельков, для каждой СЕТИ в которой вы принимаете платежи.
ВАЖНЫЕ ОСОБЕННОСТИ:
- На данный момент в платёжной системе 2328-io для каждой валюты в любой сети генерируется ОТДЕЛЬНЫЙ АДРЕС КОШЕЛЬКА.
1. Создайте в боте нужное вам количество кнопок для генерации Адресов крипто-кошельков, по количеству сетей или валют, из тех, которые вы указали при активации автоплатежей и планируете принимать к оплате. Для этого вашему боту будет добавлено соответствующее количество слотов для таких кнопок. Каждой из указанных вами валют (сетей) будет присвоен собственный «PayID».
Обычно количество добавленных по умолчанию «кнопок адреса» достаточно и соответствует количеству валют которые вы принимаете в своем боте. Если по каким-то причинам вам нужно больше кнопок, то просто обратитесь в службу поддержки через специальную форму для вопросов об Автоплатежах и попросите добавить нужное количество.
2. Чтобы создать кнопки для генерации Адресов кошельков, создайте обычную кнопку, затем перейдите в ее настройки и нажмите:
• «Назначить Адрес».
• Затем следуйте инструкциям мастера настройки.
3. Создайте кнопки в нужном количестве, назначив каждой соответствующий, выданный вам PayID.
Переменные для начисления и хранения адресов кошельков УЖЕ привязаны к соответствующим PayID.
ДЛЯ СПРАВКИ: посмотрите, как в нашей системе организована автооплата Heleket.
Для этого перейдите в свой бот:🔐Админ | 🧩Расширения | 🏦Ваши кошельки | 💳Пополнить | Использовать Личный Крипто Адрес
Вариант 2: выставление счета (Инвойс)
Если вы уже активировали автоматическую оплату в своем боте, вам необходимо создать способ для людей (ваших пользователей) для автоматического пополнения. Что для этого нужно:
Всё что вам нужно в боте, это создать меню с кнопками «Выставления Счёта (инвойс)» по количеству валют которые вы хотите принимать. По ссылке можно почитать полное Руководство по настройке Инвойс кнопки. Ниже - представлены основные моменты.
ВАЖНЫЕ ОСОБЕННОСТИ:
- Инвойсы выставляются в фиатной валюте, а оплачиваются в Крипте. На данный момент Инвойс ВСЕГДА выставляется в USD, а валюта оплаты указывается при помощи PayID.
- Инвойс будут считаться оплаченным, если юзер оплатил его в заданном размере ИЛИ в превышающем. В обоих случаях вы получите стандартное уведомление. Все остальные кейсы - либо будут считаться не оплаченными, либо будут проигнорированы системой как не валидные.
1. Создайте в боте кнопки для генерации Инвойсов (invoice) для каждой валюты из тех что вы указали при активации автоплатежей и планируете принимать к оплате. Для этого в ваш бот будет добавлено соответствующее количество слотов для таких кнопок. Каждой из указанных вами валют будет присвоен свой "PayID".
Обычно количество добавленных «Инвойс Кнопок» соответствует количеству валют доступных в системе на момент добавления. Если со временем будут добавлены новые валюты и вы захотите их принимать - то просто обратитесь в поддержку используя специальную форму для вопросов по Автоплатежам и попросите добавить вам недостающее количество.
2. Для того чтобы создать кнопки генерации инвойсов, создайте обычную кнопку и перейдя в её настройки нажмите:
• «Назначить Счёт».
• После чего следуйте указаниям Мастера Установок.
3. Создайте кнопки для каждой из указанных вами валют, присвоив каждой соответствующий выданный вам PayID.
Переменная для начисления УЖЕ ассоциирована с соответствующим PayID.
ДЛЯ СПРАВКИ: посмотрите, как в нашей системе организована авто-оплата CryptoBot.
Для этого перейдите в свой бот:🔐Админ | 🧩Расширения | 🏦Ваши кошельки | 💳Пополнить
Особенности 2328-io
● О каких-то особенностях пока не известно. Раздел будет дополнятся по мере появления информации.
❖ Сообщения об ошибках
Список ВСЕХ сообщений об ошибках смотри в руководстве «Автоплатежи и Вывод Средств - общие сведения»
❖ Автовыводы (выплаты)
Вывод средств (полуавтоматический)
При наличии функционала автоматического приёма платежей вам возможно понадобится кнопка для осуществления Вывода Средств. Кнопка позволяет автоматически списывать средства с указанной вами переменной где хранится Баланс пользователя. Непосредственно перевод средств на внешний кошелёк юзера осуществляется админом вручную. Кнопка позволяет частично облегчить процесс выводов ограничившись лишь непосредственно переводами, а так же вести своеобразную историю (Лог) выводов в отдельной группе куда будут поступать запросы на вывод.
Подробнее о работе с кнопкой Вывода Средств смотри в руководстве.
Вывод средств (автоматический с подтверждением админа)
Для платёжной системы 2328-IO доступен функционал автоматического вывода средств.
ВАЖНО: Не пытайтесь договариваться о подключении Автоматических Выводов до тех пор пока полностью не разберётесь с тем как работает кнопка «Вывод Средств» в полуавтоматическом режиме.
Если вы полностью разобрались с тем как работает кнопка Вывода Средств - у вас подключена, настроена и некоторое время уже работает хотя бы одна такая кнопка, вы можете рассматривать вариант активации автоматических выводов.
Данные необходимые для работы функции Автовыводов
Для системы 2328-IO:
• Отдельный «PAYOUT_API_KEY» токен.
Как подключить Вывод Средств в автоматическом режиме
1. Зайдите в свой кошелёк 2328-IO который вы используете для Автоплатежей.
2. Скопируйте «PAYOUT_API_KEY» токен.
3. Перейдите в бот @MegaHubSupportBot раздел: «🤑 Подключить «Автоматический Вывод» в Боте».
4. Прочтите и согласитесь со всеми Условиями (делается один раз).
5. Выберите нужную систему чтобы оформить заказ на активацию Автовыводов.
6. Пополните кошелёк TMH своего аккаунта на указанную сумму (оплата производится ежемесячно, пока в ручном режиме. Оплата за первый месяц является оплатой за подключение и НЕ возвращается, даже если вы передумали использовать Автовыводы).
7. Введите все необходимые для подключения данные и отправьте запрос на активацию Автовыводов.
8. Ожидайте ответа Админов об активации Автовыводов (признаком активации может являться появление списка PayID для каждой из указанных вами валют в раздел «💸 Автоплатежи» для выбранной вами системы).
9. После активации перейдите, в раздел «💸 Автоплатежи».
10. Выберите раздел только что активированной для Автовыводов платёжной системы.
11. Для каждой используемой вами валюты в кнопке «Баланс XXX» укажите МАКСИМАЛЬНУЮ сумму доступную для выводов (выплат) в автоматическом режиме.
Указание максимальной суммы доступной для автоматических выплат необходимо для того чтобы минимизировать возможные последствия ошибок при случайных либо необдуманных подтверждениях выводов. Автовыводы - необратимы. То есть, большие суммы мы всё-таки предлагаем вам выводить вручную в полуавтоматическом режиме.
12. В настройках кнопки «Вывод Средств» появится раздел «Задать PayID» - позволяющий ассоциировать конкретную кнопку Вывод Средств с отдельной валютой. Одна кнопка работает с одной валютой.
13. После настройки ОБЯЗАТЕЛЬНО протестируйте работу кнопки на незначительной сумме.
14. Напоминание о ежемесячной оплате придёт в бот @MegaHubSupportBot и\или в головной бот @MenuBuilderBot проекта.
ВАЖНО: В случае если функционал Автовыводов был отключён за неуплату, повторное подключение оплачивается отдельно от ежемесячной платы.