Руководство по плагину NS Gift Cards

NS Gift Cards продаёт гифт-карты и коды из каталога NS.Gifts — Apple, Google Play, PlayStation, Xbox и другие. После оплаты бот покупает нужное количество кодов и сразу отправляет их покупателю. Цены лотов считаются сами — закупка × курс × ваша наценка, но не выше максимальной, — а наличие на лоте подтягивается из остатка поставщика. Закончился товар — лот снимается с продажи и возвращается, когда товар появится.

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

1. Склад не нужен: коды покупаются у поставщика только после оплаты.
2. Цены не отстают от курса: автоцены пересчитываются по курсу NS каждые 20 минут.
3. Без продаж «в пустоту»: нет товара у поставщика — лот снимается сам.

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

• Поиск по каталогу: /ns_giftcards_find apple — товары, service_id, цена и остаток.
• Коды сразу после оплаты: по количеству штук в заказе (до 500 за заказ).
• Автоцены: закупка × курс NS × (1 + наценка), не выше максимальной цены; по умолчанию наценка 15%.
• Наличие на лоте = остаток у поставщика (до 9999); у лотов со встроенной автовыдачей FunPay наличие не меняется.
• Нет товара — лот снимается; товар появился — бот включает обратно только лоты, которые снимал сам.
• Один заказ — одна покупка в NS: номер заказа NS сохраняется до оплаты, после сбоя или перезапуска бот не платит второй раз.
• Предохранитель: сначала бронь с известной суммой — если закупка дороже оплаты покупателя больше чем в 1,2 раза (настраивается), бронь не оплачивается, а заказ уходит вам.
• Возврат: NS отменил или вернул заказ — по желанию бот вернёт деньги покупателю, иначе пришлёт вам уведомление (по умолчанию возврат выключен).
• До 5 заказов одновременно на все плагины NS, остальные ждут своей очереди.

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

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

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

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

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

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

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

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

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

1. «🔍 Поиск в каталоге» → пришлите apple — бот покажет service_id, цену и остаток.
2. «🔗 Привязать лот» → пришлите ID_лота service_id — привязать лот FunPay к товару.
3. «🗑 Отвязать лот» → пришлите ID лота — отвязать.

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

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

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

Панель /ns_giftcards

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

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

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

1. Оплачен привязанный лот — бот создаёт бронь в NS на количество штук из заказа.
2. Проверяет бронь предохранителем и оплачивает её.
3. Присылает покупателю коды одним сообщением, вам — уведомление с закупкой в $.
4. Отдельно раз в 20 минут (настраивается) пересчитывает цены и наличие, снимает и возвращает лоты по остатку.

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

Покупателю после оплаты

✅ Ваш товар:
XXXX-XXXX-XXXX-XXXX

⌨️ Команды

• /ns_giftcards — панель плагина
• /ns_giftcards_login — учётка NS (общая для плагинов NS)
• /ns_giftcards_find — поиск в каталоге NS
• /ns_giftcards_bind — привязать лот
• /ns_giftcards_unbind — отвязать лот
• /ns_giftcards_set — наценка 15 · предохранитель 1.2 · макс 5000 · интервал 30

💡 Важно знать

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

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

Лоты сами выключились

У поставщика закончился товар — бот снимает такие лоты и сам включит их обратно, когда товар появится. Лоты, выключенные вами вручную, бот не включает.

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

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

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

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

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

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

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

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

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

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