Автоплатежи и Вывод Средств - общие сведения

❖ Определение понятий

Для того чтобы иметь возможность понять механику того как в ботах в целом работают Платежи, вам нужно чётко понимать что такое Переменные и как устроен Баланс в боте. Ознакомьтесь с ОСНОВНЫМИ ПОНЯТИЯМИ и ОПРЕДЕЛЕНИЯМИ в указанных руководствах прежде чем продолжать изучение данного материала - как-то отдельно пояснять или оговаривать эти понятия в дальнейшем мы не будем.

В контексте взаимодействия с платежами между юзером и ботом, можно выделить два направления:
1. От юзера к боту - Автоплатежи (Пополнения, Оплаты).
2. От бота к юзеру - Автовыводы (Снятия, Выплаты).
Данный раздел даст вам общее представление об обоих направлениях.

Ниже приведённый список понятий и терминов использующихся в существующей системе автоплатежей, на 100% актуален только для конструктора @MenuBuilderBot. В других системах, сферы определяющие понятия в платежах могут отличаться. Определения терминов даны таким образом, каким они будут использоваться в текстах, цель данных определений - обозначить границы понятий и упростить для вас понимание приведённых инструкций, однако нужно иметь в виду что данные определения не обязательно корректны с точки зрения экономической теории и возможно неприменимы для других конструкторов ботов или каких-либо платёжных систем, так же, нет причин считать их научно обоснованными. Другими словами представленные определения применимы только в контексте данных руководств.

Платёж - перевод средств в направлении от пользователя к боту (другие названия: Пополнение, Оплата). В общем случае, средства пользователя поступают на внешний (Third Party) кошелёк админа, в какой-либо платёжной системе. После чего их эквивалент должен быть зачислен на Баланс в боте.

В контексте сравнения видов платежей, говоря "Платёж" имеется ввиду скорее ситуация ручного пополнения Баланса юзера оператором в боте, посредством Форм обратной связи. Однако в общем случае приведённое выше определение платежа относится как к ручному, так и к автоматическому способам - больше описывая принцип, нежели указывая на какой-то конкретный из двух видов.

Автоплатёж - это Платёж, зачисление средств на Баланс в котором происходит автоматически при помощи идентификации аккаунта юзера (плательщика) каким-либо из доступных способов (возможные способы идентификации юзера будут приведены ниже).

Иногда, в группах или поддержке, для простоты, Автоплатежами называют всю систему Платежей и Выплат.

Вывод Средств - перевод средств в направлении от бота к пользователю (другие названия: Выплата, Вывод). В общем случае, средства имеющиеся на Балансе юзера в боте поступают на его внешний (Third Party) кошелёк, в какой-либо платёжной системе. При этом их эквивалент должен быть списан с Баланса в боте.

Полуавтоматический вывод средств - это Вывод Средств, списание с Баланса в боте при котором происходит автоматически (при заказе Вывода юзером), а перевод на кошелёк внешней (Third Party) платёжной системы юзера, после подтверждения админом, производится им же вручную. Данный способ реализован при помощи кнопки «Вывода Средств».

Автоматический вывод средств - это Вывод Средств при котором списание с Баланса в боте (в момент заказа вывода юзером) и перевод средств на кошелёк внешней (Third Party) платёжной системы юзера (с использованием API данной системы), происходят автоматически после подтверждения админом. Обратите внимание что даже при автоматическом выводе средств необходимо участие админа для подтверждения платежа (наше требование безопасности). Данный способ реализован при помощи кнопки «Вывода Средств».

❖ Важные особенности автоплатежей и автовыводов

При работе с автоплатежами и автовыводами все средства, всегда хранятся на ВАШИХ кошельках.

Автоплатежи

При использовании автоплатежей @MenuBuilderBot прямого доступа к вашим средствам - не имеет. Единственное что может обработчик платежей - это видеть Баланс вашего кошелька и его изменения, взаимодействовать же со средствами на балансе каким-либо другим способом он ТЕХНИЧЕСКИ - не может (запрет реализован средствами внешней платежной системы и не подразумевает вашего доверия конструктору). Данный способ является абсолютно безопасным по отношению к вашим средствам в аспекте взаимодействия с конструктором и потому предоставляется БЕЗ особых условий.

ВАЖНО: Единственным исключением в данном случае является автоматический платёж через «Perfect Money». По какой-то причине настраивать права в этой системе нельзя, поэтому, даже для организации получения платежей, необходим полный доступ к вашему кошельку.

Выводы Средств - ручные и полуавтоматические

Ручные и Полуавтоматические Выводы средств, также как и Пополнения, являются настолько же безопасными, насколько вы сами можете себе доверять, поскольку фактический перевод средств осуществляется вручную самим админом. Система лишь формирует запрос и списывает виртуальные средства с Баланса в боте при помощи специализированной кнопки. При использовании этих способов конструктор @MenuBuilderBot также ТЕХНИЧЕСКИ не имеет доступа к вашим средствам.

Автовыводы

Автоматический вывод средств в данном контексте стоит особняком. Это единственный способ при котором конструктору необходим полный доступ к средствам на вашем кошельке. По этой причине данный способ предоставляется НЕ ВСЕМ, а только тем кто в полной мере понимает механизмы работы автовыплат, средств обеспечения безопасности и в прямой беседе продемонстрировал собственную адекватность и интеллектуальную готовность. Автоматические выплаты предоставляются на ОСОБЫХ условиях которые будут озвучены после того как, в результате личной беседы, будет принято решение о возможности их подключения. Без согласия с ОСОБЫМИ Условиями подключение Автовыводов не осуществляется.

Автовыводы оплачиваются отдельно - независимо от всего остального.

❖ Дополнительные возможности Автоплатежей

Нижеприведенные опции доступны для всех видов автоматических платежей и оговариваются при первом подключении.

Дублирование суммы

Дублировать сумму пополнения в отдельную переменную или переменные, как индивидуальные так и глобальные.
Позволяет сохранить общую сумму пополнений - как индивидуально для каждого юзера так и общую для всех юзеров вместе.

Бонус реферальному родителю

Автоначисление бонусов реферальным родителям юзера пополняющего баланс - вверх по многоуровневой системе.
Позволяет создавать реферальные боты в которых прибыль рефералов напрямую зависит от пополнений. Сумма может указывается в процентах от суммы пополнения, количество возможных уровней будет зависеть от уровней Реферальной Системы приобретённой в вашем боте.

Автоконвертация суммы

Начисление поступающих средств с автоматическим переводом их по указанному курсу в другую условную валюту.
● Курс можно задавать постоянным, брать его из какой-либо переменной в вашем боте (предпочтительно) или использовать для конвертации Расширение текущие биржевые Курсы Обмена.
● Разные валюты (по курсу) можно начислять в одну переменную (например любые поступающие валюты конвертировать в Доллары США или Российские Рубли).

При расчёте курса в функциях автоплатежей, ВСЕГДА будут использованы самые быстрые 10-минутные курсы ЕСЛИ любой из вариантов Курсов Валют активирован в вашем боте.

Отчёты о поступлениях

Отчёты по автопополнениям можно пересылать в указанную группу или канал.
● В отчёте указываются суммы пополнения, данные переводящего, а также общая сумма на счету.

Начисления на разные переменные

Автоплатежи отправляемые на один и тот же кошелёк можно начислять на разные переменные - по выбору юзера.
● Доступно для систем идентификация платежей в которых происходит при помощи комментария (список возможных видов идентификации смотри ниже).
● Для начисления платежа на дополнительную переменную, при пополнении, можно указать свой префикс к идентификатору юзера в комментарии.

Префикс вы можете придумать сами. Обычно 3-4 буквы и черточка "-" для отделения его от самого Юзеркода.
Пример префикса: usd-, inv-
Пример комментария с префиксом: usd-8888888 (Префикс и Юзеркод в комментарии)

❖ Способы идентификации платежей

Для того чтобы платёж поступивший на внешнюю платёжную систему был начислен отправившему его пользователю в боте, этого пользователя нужно каким-либо образом идентифицировать.

На данный момент в системе автоплатежей используется три вида идентификации пользователя.
1. При помощи Комментария - Юзеркода (Usercode) или Telegram ID добавленных в виде комментария к платежу.
2. При помощи Адреса Плательщика - уникального адреса кошелька с которого поступил платёж.
3. При помощи Выставленных Счетов (Инвойсов) - бот генерирует ссылки.

Существуют и другие способы идентификации платежей, например при помощи генерации индивидуального кошелька для пополнения в криптовалютных платежах. Однако такой способ пополнения, одновременно являясь как более дорогим так и, вместе с этим, более сложным в исполнении и поддержании работоспособности, на данный момент не рассматривается нами как сколько-нибудь интересный к реализации.

У каждого из трёх применяемых в системе способов идентификации есть свои положительные и отрицательные стороны.

1. Идентификация по Комментарию (Юзеркод или ID)

Данный способ может быть использован только в тех платёжных системах которые поддерживают комментарии к платежам. Суть способа сводится к тому что пользователь получив в боте и скопировав свой Юзеркод или Telegram ID добавляет его в комментарий к своему платежу во внешней платёжной системе, в результате чего робот отслеживая по API входящие транзакции кошелька админа, по имеющемуся в комментарии Юзеркоду определяет пользователя которому нужно начислить поступивший платёж.

Преимущества: данная концепция может быть легко объяснена пользователям в сообщениях бота, а также очень проста в реализации на практике.

Недостатки: не все системы поддерживают комментарии, иногда юзеры по невнимательности могут забыть указать, либо неправильно указать свои данные.

2. Идентификация по Адресу Плательщика (кошелёк)

Данный способ в большей мере относится к платежам в криптовалютной сфере, там где адрес кошелька отправителя играя важную роль, может быть легко найден в блокчейне и ассоциирован с суммой платежа. Суть данного способа состоит в том, что юзер сохраняет адрес кошелька с которого он будет проводить транзакции в какой-либо из переменных бота. Как бы говоря тем самым: "я буду платить с этого адреса". Бот в свою очередь отслеживая входящие транзакции на кошельке админа в публичном просмотрщике блокчейна, идентифицирует пользователя по сохранённому им адресу кошелька, если с этого адреса поступил платёж на кошелёк админа.

Преимущества: простота использования для юзера - всё что нужно сделать юзеру для пополнения - это просто отправить средства с того личного кошелька, адрес которого он сохранил в соответствующей переменной бота, на указанный админом адрес.

Недостатки: более сложен в реализации, требует наличия дополнительного функционала в самом боте, требует понимания и определённых знаний от админа создающего данный вид автоматического платежа, необходимы более сложные инструкции для пользователей, в большинстве случаев пользователи не понимают этих инструкций, невозможно проводить платежи путём перевода с бирж и обменников и кастодиальных кошельков, поскольку они используют свои собственные случайные адреса для переводов.

3. Идентификация по Выставленному Счёту (Инвойсу) (ссылка)

Суть способа сводится к тому что юзер из бота, инициирует создание индивидуальной платёжной ссылки и перейдя по ней в свою учётную запись во внешней платёжной системе проводит оплату путём простого подтверждения транзакции. Сумму платежа админ может указать заранее, равно как и оставить юзеру возможность указать свою.

Преимущества: простота использования для юзера, весь процесс сводится к переходу по ссылке и проведению оплаты знакомым ему способом во внешней платёжной системе.

Недостатки: не так много платёжных систем поддерживают этот способ. Создание кнопки в боте для такого платежа это несколько продолжительный процесс.

4. Идентификация по Личному Адресу Кошелька (адрес)

Суть метода заключается в том, что пользователь получает ПЕРСОНАЛЬНЫЙ криптоадрес, генерируемый в соответствии с выбранной сетью (блокчейном). Любая действительная транзакция (из любого места: криптовалютные биржи, боты, децентрализованные приложения, кастодиальные и некастодиальные кошельки), совершённая на этот адрес, будет автоматически начисляться на Баланс его Учетной записи.

Преимущества: простота использования для пользователя, ему не нужно учитывать откуда и как он отправляет свои средства, любая корректная транзакция будет обработана.

Недостатки: некоторые системы имеют ограничения по сумме "минимального получения".

❖ Доступные системы

● Payeer (Международный) - USD, RUB, EUR, BTC, ETH, LTC, USDT, TRX и любые доступные Монеты и Токены (по Юзеркоду)
● CoinBase (Международный) - BTC, ETH, LTC, USDC, USDT и любые доступные Монеты и Токены (по Юзеркоду)
● Perfect Money (Международный) - USD, EUR (по Юзеркоду)
● Tron (Крипто) - TRX, USDT и любые доступные Монеты и Токены (по Кошельку)
● TON (Крипто) - TON и любые доступные Монеты и Токены (по Кошельку, по Юзеркоду)
● Binance (BSC-BEP20) (Крипто) - BNB, USDT и любые доступные Монеты и Токены (по Кошельку)
● Polygon (Крипто) - MATIC
● CryptoBot (Крипто) - BTC, ETH, BNB, USDT, USDC, TON (по Инвойсу)
● xRocket (Крипто) - BNB, TRX, ETH, TON, USDT плюс любые Монеты и Токены доступные в кошельке (по Инвойсу)
● Cryptomus (Крипто) - BTC, ETH, BNB, USDT, USDC, TON, TRX, LTC, DOGE, DAI, DASH, SOL (по Адресу)
● PayOK (Российский) - Дебитовые карты (по Инвойсу)
● Telegram Stars - (по Инвойсу)

Что НЕ будет добавлено:
FaucetPay - в API отсутствуют необходимые возможности.
PayTM, OVO, DANA - региональные платёжные системы к которым у на нету доступа.

 

❖ Общие настройки автоплатежей

Общие настройки автоплатежей осуществляются в вашем боте:
🔐Админ | 💸Автоплатежи

Группа / Канал Пополнений

Для отчётов по автоплатежам предоставляется одна БЕСПЛАТНАЯ группа. Группа может работать как публичная, так и как приватная. Если группа не подключена то отчёты о платежах будут приходить в сам бот. Вы можете задать свое собственное сообщение для отчёта.

Сообщение Юзеру

Вы можете задать своё собственное сообщение, которое будет отправлено пользователю при успешном начислении средств.

Если сообщение не задано - юзер не получит никакого дополнительного оповещения.

❖ Сообщения об ошибках

FAILED❗️ 🆘 No user comment

Подобная ошибка появляется если юзер не идентифицирован.

И так, ещё раз: пользователь может быть идентифицирован ТОЛЬКО по адресу кошелька. Если адрес кошелька в ТРАНЗАКЦИИ (в блокчейне) не совпадает с адресом кошелька, сохранённым им в ПЕРЕМЕННОЙ - бот покажет ошибку и ничего не будет добавлено на Баланс.

Причины почему юзер не был идентифицирован:
1. Юзер вообще не задал адрес кошелька.
2. Юзер задал адрес кошелька ПОСЛЕ того как совершил транзакцию.
3. Юзер совершил транзакцию с биржи или другого обменника.

Самая частая причина состоит в том что пользователи отправляют переводы с бирж или другого рода обменников поэтому адреса кошельков - не совпадают.

Чтобы удостовериться в том что адреса кошельков не совпадают, вы должны:
1. Найти транзакцию в блокчейне при помощи TXID (hash) транзакции (его можно взять прямо в сообщении об ошибке).
2. Посмотреть адрес кошелька с которого в действительности была отправлено эта транзакция.
3. При помощи команды «/varget var_name user_id» Вы должны посмотреть какой адрес кошелька юзер сохранил в своей переменной.
4. Если эти адреса не совпадают вы объясняете юзеру всё то, что мы только что объяснили вам.

При сравнении адресов JetTon в сети TON, нужно иметь в виду один момент. Адреса кошельков могут иметь разные форматы.
• base64 (с цифрами, заглавными и строчными латинскими буквами, «/» и «+»)
• base64url (с «_» и «-» вместо «/» и «+»)
То есть адреса типа: EQxx/xxx+xxxx и EQxx_xxx-xxxx - это адреса ОДНОГО кошелька.

• • •

FAILED❗️ 🆘 Multiple users found

Подобная ошибка появляется если НЕСКОЛЬКО аккаунтов в вашем боте указали ОДИН и тот же кошелёк для идентификации их платежа. Бот не знает кому из них начислять.

Иногда юзеры указывают адреса бирж с которых биржи осуществляют выводы.
Иногда юзеры указывают один и тот же кошелёк для нескольких своих аккаунтов.

Чтобы исправить ситуацию выясните у пользователя какой адрес он указал, где он его взял и не использовал ли он его для другого своего аккаунта. Удалите совпадающие адреса в переменных у всех кроме одно аккаунта.

• • •

❌ Счёт не может быть создан.
Код Ошибки: XXX
ℹ️ Сообщите о проблеме Администратору бота.

❌ Адрес не может быть создан.
Код Ошибки: XXX
ℹ️ Сообщите о проблеме Администратору бота.

Коды Ошибок:
1 - PayID не соответствует какой-либо переменной Баланса этой валюты (проверьте заданный PayID для этой валюты).
2 - Нет Чекера для этого PayID (проверьте заданный PayID для этой валюты или активен ли Чекер).
3 - Не корректный PayID для переменной Баланса этой валюты (проверьте какой указан и укажите верный).
4 - Чекер не активен (включите или оплатите Чекер для этой платёжной системы).
5 - PayID соответствует чекеру, но не тому, по которому запрошен инвойс (проверяйте какие PayID вы указывали для каких валют).

• • •

Неизвестная ошибка:
BOT_PRECHECKOUT_TIMEOUT

После настройки Чекера вы не сделали рестарт вашего бота.

• • •

Включено: ⏳

Может возникать при активации Чекера.
1. Проверьте заданы ли все необходимые переменные (балансов, хранения адресов кошельков и т.д.)
2. Сама активация может занять больше времени (просто подождите 1-2 минуты).
3. Если настраиваете Cryptomus, он может возвращать ошибку: "Cryptomus check exception. Code: -5, Message: You are restricted to access the site." Что-то не так в настройках Cryptomus. Скорее всего, вы установили что-то вроде "only allowed IPs" (только разрешённые IP), поэтому IP-адрес чекера не может получить доступ.

• • •

FAILED❗️ 🆘 Variable not found

Настроенная вами Переменная начинает работать не сразу. Настраивайте переменные заранее или подождите немного. (Это давний баг - однажды будет исправлен.)