Руководство по плагину Пополнение Steam (NS.Gifts)

Пополнение Steam (NS.Gifts) пополняет Steam-кошельки покупателей без вашего участия. Покупатель оплачивает лот — бот берёт его логин Steam из параметров заказа или спрашивает в чате, проверяет, что такой аккаунт существует, просит подтвердить и пополняет кошелёк через оптовый кабинет NS.Gifts. Сумма пополнения считается из количества штук в заказе: например, 1 шт. = 100 ₽ на кошелёк — бот сам переводит её в доллары по курсу NS.

🎯 Для чего это нужно

1. Пополнение за минуты: покупатель получает деньги на кошелёк, даже когда вы спите.
2. Без ошибок в логине: бот проверяет аккаунт Steam и просит покупателя подтвердить логин до оплаты.
3. Любая сумма одним лотом: покупатель выбирает количество штук — сумма считается сама.

✨ Что умеет плагин

• Логин Steam: из параметров заказа (поле «логин») или вопросом в чате.
• Проверка аккаунта: несуществующий логин — бот просит прислать правильный (не ник и не ссылку).
• Подтверждение «да / нет»: покупатель подтверждает логин перед оплатой (выключается кнопкой).
• Сумма из количества: штук в заказе × сумма за штуку в RUB, KZT, UAH или USD, в доллары — по курсу NS.
• Лимит NS: пополнение от 0,13 до 500 $ — сумма вне лимита уходит вам на ручную выдачу.
• Один заказ — одна покупка в NS: номер заказа NS сохраняется до оплаты, после сбоя или перезапуска бот не платит второй раз.
• Предохранитель: сначала бронь с известной суммой — если закупка дороже оплаты покупателя больше чем в 1,2 раза (настраивается), бронь не оплачивается, а заказ уходит вам.
• Возврат: NS отменил или вернул заказ — по желанию бот вернёт деньги покупателю, иначе пришлёт вам уведомление (по умолчанию возврат выключен).
• До 5 заказов одновременно на все плагины NS, остальные ждут своей очереди.

⚡ Быстрый старт

1. Включите плагин и перезапустите бота (шаг 1 ниже).
2. Учётка NS: /ns_steam → «🔑 Учётка NS» → пришлите данные кабинета.
3. «🔗 Привязать лот» → пришлите ID лота и сумму: 12345678 100 RUB.
4. /ns_steam → «▶️ Включить».

🛠️ Пошаговая настройка

ШАГ 1. Включите плагин (обязательно перед настройкой)

1. Отправьте своему боту команду /menu.
2. Откройте 🔧 Система и Конфиги → 🧩 Плагины и найдите Пополнение Steam (NS.Gifts).
3. Нажмите «Включить».
4. ‼️ Перезапустите бота командой /restart — без перезапуска плагин не заработает.

ШАГ 2. Подключите учётку NS.Gifts

1. Получите доступ к оптовому кабинету wholesale.ns.gifts у менеджера NS.Gifts и пополните баланс (в долларах).
2. Попросите поддержку NS добавить IP вашего бота в белый список — иначе API отвечает ошибкой 403. IP бота подскажет поддержка MUVSell Bot.
3. /ns_steam (или «⚙️ Открыть настройки» в карточке плагина) → «🔑 Учётка NS» → пришлите одним сообщением user_id логин пароль api_secret — данные из кабинета (раздел API); пятым можно указать свой прокси. Бот сразу удалит сообщение и проверит вход.

💡 Учётка общая для всех плагинов NS: ввели её в одном — остальные тоже видят.

ШАГ 3. Привяжите лот

1. «🔗 Привязать лот» → пришлите 12345678 100 RUB — 1 шт. лота = 100 ₽ на кошелёк. Можно KZT, UAH или USD.
2. ID лота — число из ссылки на лот. Бот запомнит название лота — по нему он узнаёт заказы.
3. «🗑 Отвязать лот» → пришлите ID лота — отвязать.

💡 Добавьте в лот поле для логина Steam — тогда бот не будет спрашивать логин в чате.

ШАГ 4. Запустите

1. «💰 Баланс NS» — проверьте баланс кабинета.
2. «✅ Подтверждение логина: ✅» — спрашивать ли покупателя «да / нет» перед пополнением.
3. Нажмите «▶️ Включить».

🕹️ Меню и кнопки

Панель /ns_steam

Сверху — включена ли автовыдача, учётка NS, предохранитель, возврат, подтверждение логина, сколько выдано и привязанные лоты.

• ▶️ Включить / ⏸ Выключить — автовыдача по привязанным лотам
• ↩️ Возврат: ✅ / ❌ — возвращать ли деньги покупателю, если NS отменил или вернул заказ
• ✅ Подтверждение логина: ✅ / ❌ — спрашивать ли покупателя «да / нет» перед пополнением
• 🔗 Привязать лот — ID лота и товар NS, например 12345678 100 RUB — 1 шт. лота = 100 ₽ на кошелёк (RUB, KZT, UAH или USD)
• 🗑 Отвязать лот — пришлите ID лота
• 🛡 Предохранитель — во сколько раз закупка может быть дороже оплаты покупателя (не меньше 1): дороже — бот не платит, заказ ваш
• 🔑 Учётка NS — данные кабинета wholesale.ns.gifts — общие для всех плагинов NS; сообщение бот удалит
• 💰 Баланс NS — баланс кабинета NS.Gifts в $
• ⬅️ Назад — к карточке плагина

🔄 Как это работает

1. Оплачен привязанный лот — бот берёт логин из параметров заказа или просит «Для выполнения заказа пришлите логин Steam».
2. Проверяет, что аккаунт Steam существует; нет — просит правильный логин (до 3 попыток, потом заказ — вам).
3. Спрашивает «Пополняю Steam-аккаунт «логин». Всё верно? Ответьте «да» или «нет»».
4. Считает сумму в долларах, создаёт бронь в NS и проверяет её предохранителем.
5. Оплачивает и сообщает покупателю, что кошелёк пополнен; вам — уведомление с закупкой в $.

💬 Как это выглядит

Покупателю перед пополнением

Пополняю Steam-аккаунт «login123». Всё верно? Ответьте «да» или «нет».

Покупателю после пополнения

✅ Steam-аккаунт login123 пополнен. Средства поступят в течение нескольких минут.

⌨️ Команды

• /ns_steam — панель плагина
• /ns_steam_login — учётка NS (общая для плагинов NS)
• /ns_steam_bind — привязать лот
• /ns_steam_unbind — отвязать лот
• /ns_steam_set — предохранитель 1.2 — во сколько раз закупка может быть дороже оплаты покупателя

💡 Важно знать

• ⚠️ В кабинете NS выключите 2FA на покупки — с ней бот не может оплачивать заказы и передаёт их вам.
• Держите баланс NS с запасом: при нехватке заказ уходит на ручную выдачу.
• Если сообщение покупателю не ушло в чат FunPay, бот пришлёт вам его текст — отправьте вручную.

❓ Частые вопросы

Покупатель прислал ник или ссылку вместо логина

Бот проверит аккаунт и, если такого логина нет, попросит прислать правильный логин — не ник и не ссылку. После трёх неудачных попыток заказ уходит вам.

Плагин включён, но заказы не обрабатываются

Проверьте по порядку: в /ns_steam автовыдача включена; учётка NS введена (✅ в панели); лот привязан командой /ns_steam_bind; IP бота в белом списке NS — без него API отвечает 403.

Как бот понимает, какой лот купили?

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

Бот прислал «не выдан автоматически — … Выдайте вручную»

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

Бот перезапустился во время покупки

Если оплата в NS ещё не ушла — заказ передаётся вам, в NS ничего не списано. Если ушла — бот проверит заказ в NS и выдаст его, когда он выполнится; повторно не покупает.

Можно ли пользоваться несколькими плагинами NS сразу?

Да: учётка NS общая, а лоты каждый плагин привязывает свои — они не мешают друг другу.