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

Прямое пополнение (NS.Gifts) пополняет игры и сервисы напрямую по данным покупателя — ID игрока, сервер, ник. Бот берёт их из параметров заказа или спрашивает в чате по одному, проверяет формат по требованиям поставщика и только потом оформляет пополнение в NS.Gifts. Постоянные значения (например, сервер одного лота) можно задать при привязке, тогда покупателя о них не спросят.

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

1. Пополнение без кодов: валюта приходит прямо на аккаунт игрока.
2. Без ошибок в данных: каждый ответ покупателя проверяется по требованиям поставщика.
3. Цены по курсу: автоцены и снятие лота, когда услуга недоступна.

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

• Поля услуги: из параметров заказа или вопросом в чате, по одному.
• Проверка ответа: число, вариант из списка или формат — по схеме поставщика; подсказка, если не подходит.
• Постоянные поля на лот: /ns_games_bind ID service_id server=eu — их покупатель не заполняет.
• Автоцены: закупка × курс NS × (1 + наценка), не выше максимальной цены.
• Услуга недоступна — лот снимается и возвращается сам.
• Один заказ — одна покупка в NS: номер заказа NS сохраняется до оплаты, после сбоя или перезапуска бот не платит второй раз.
• Предохранитель: сначала бронь с известной суммой — если закупка дороже оплаты покупателя больше чем в 1,2 раза (настраивается), бронь не оплачивается, а заказ уходит вам.
• Возврат: NS отменил или вернул заказ — по желанию бот вернёт деньги покупателю, иначе пришлёт вам уведомление (по умолчанию возврат выключен).
• До 5 заказов одновременно на все плагины NS, остальные ждут своей очереди.

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

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

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

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

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

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

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

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

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

1. «🔍 Поиск в каталоге» → пришлите pubg — бот покажет услуги, цены и какие данные спросит у покупателя.
2. «🔗 Привязать лот» → пришлите ID_лота service_id; постоянные поля дописываются как ключ=значение (например, server=eu).
3. «🗑 Отвязать лот» → пришлите ID лота — отвязать.

ШАГ 4. Цены и запуск

1. «💹 Наценка» — наценка для автоцен; «🔝 Макс. цена» — потолок цены; «⏱ Интервал цен» — как часто пересчитывать, минут (не меньше 20).
2. «⚡ Автоцены: ✅» — включены по умолчанию; «🔄 Обновить цены» — пересчитать сейчас.
3. Нажмите «▶️ Включить».

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

Панель /ns_games

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

• ▶️ Включить / ⏸ Выключить — автовыдача по привязанным лотам
• ↩️ Возврат: ✅ / ❌ — возвращать ли деньги покупателю, если NS отменил или вернул заказ
• ⚡ Автоцены: ✅ / ❌ — пересчитывать цены привязанных лотов
• 🔄 Обновить цены — пересчитать цены прямо сейчас
• 🔗 Привязать лот — ID лота и товар NS, например 12345678 service_id server=eu — постоянные поля через ключ=значение, если нужны
• 🗑 Отвязать лот — пришлите ID лота
• 🔍 Поиск в каталоге — найти товар NS по названию — бот покажет ID для привязки
• 💹 Наценка — наценка к закупке в %, для автоцен
• 🛡 Предохранитель — во сколько раз закупка может быть дороже оплаты покупателя (не меньше 1): дороже — бот не платит, заказ ваш
• 🔝 Макс. цена — автоцены не поднимут лот выше этой цены, ₽
• ⏱ Интервал цен — как часто пересчитывать цены, минут (не меньше 20)
• 🔑 Учётка NS — данные кабинета wholesale.ns.gifts — общие для всех плагинов NS; сообщение бот удалит
• 💰 Баланс NS — баланс кабинета NS.Gifts в $
• ⬅️ Назад — к карточке плагина

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

1. Оплачен привязанный лот — бот берёт поля услуги из параметров заказа.
2. Чего не хватает — спрашивает в чате по одному: «Для выполнения заказа пришлите …».
3. Проверяет каждый ответ; не подходит — «Не подходит: … Пришлите ещё раз» (до 3 попыток).
4. Создаёт бронь, проверяет предохранителем, оплачивает и сообщает покупателю результат.

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

Покупателю, если данных нет в заказе

Для выполнения заказа пришлите ID игрока.

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

✅ Пополнение выполнено.

⌨️ Команды

• /ns_games — панель плагина
• /ns_games_login — учётка NS (общая для плагинов NS)
• /ns_games_find — поиск в каталоге NS
• /ns_games_bind — привязать лот
• /ns_games_unbind — отвязать лот
• /ns_games_set — наценка 15 · предохранитель 1.2 · макс 5000 · интервал 30

💡 Важно знать

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

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

Как не спрашивать покупателя о сервере?

Задайте его при привязке: /ns_games_bind ID_лота service_id server=eu — постоянные поля покупатель не заполняет.

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

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

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

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

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

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

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

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

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

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