↩️ Auto Refund для Starvell — автоматические возвраты по вашим правилам

Auto Refund — модуль StarvellBot, который сам оформляет возврат средств на Starvell в ситуациях, где вы всё равно вернули бы деньги: покупатель поставил низкую оценку или товар оплатил человек из вашего чёрного списка. Бот реагирует за секунды, пока вы спите или заняты, и присылает отчёт в Telegram.

🎯 Какие задачи решает модуль

1. Конфликт после плохого отзыва. Покупатель недоволен и ставит 1–2 звезды. Быстрый возврат — самый простой способ закрыть конфликт и сохранить лояльность. На Starvell есть важная деталь: по правилам площадки при возврате по заказу дешевле 10 ₽ отзыв удаляется автоматически, а по более дорогим заказам отзыв остаётся — его можно убрать, только если покупатель сам изменит оценку или модерация признает отзыв некорректным. Поэтому модуль — это инструмент быстрого урегулирования, а не «кнопка удаления отзыва».

2. Покупка от нежелательного покупателя. Если пользователь из чёрного списка бота снова оплатил ваш лот, модуль вернёт деньги и отправит ему в чат ваше сообщение (например, «Вы в чёрном списке магазина»).

3. Защита от «качелей» с отзывами. Покупатель оставил отзыв, потом удалил его? По желанию бот сразу отправит такого покупателя в чёрный список.

⚙️ Возможности

⭐ Выбор оценок. Возврат срабатывает только на те оценки (от 1 до 5 ★), которые вы отметили. По умолчанию все оценки выключены — модуль ничего не вернёт, пока вы сами их не включите.
💰 Лимит суммы. Заказы дороже лимита (по умолчанию 500 ₽) бот не возвращает никогда — ни за отзыв, ни от ЧС. Для покупки от ЧС сверх лимита вы получите уведомление и решите сами.
🚫 ЧС при плохом отзыве (по умолчанию включено) — покупатель, получивший возврат за низкую оценку, попадает в общий чёрный список бота.
🕵️ ЧС при удалении отзыва (по умолчанию выключено) — покупатель, удаливший отзыв, попадает в ЧС. Не срабатывает, если по заказу уже был возврат, сумма выше лимита или категория в исключениях.
🔁 Возврат покупок от ЧС (по умолчанию включено) — если товар оплатил покупатель из чёрного списка бота, деньги возвращаются автоматически, независимо от настроек оценок.
🗂 Исключения по категориям. В категориях, где вы покупаете товар за свои деньги (донаты, гифты, пополнения), автовозврат не сработает ни при каких условиях.
🔔 Отчёты в Telegram — о каждом возврате, ошибке возврата и добавлении в ЧС.
🛡 Защита от двойного возврата — каждый заказ обрабатывается один раз, даже после перезапуска бота.

📖 Настройка по шагам

1. Включите модуль

/menu → 🧩 Функции (или команда /features) → Auto Refund → 🚀 Включить. После этого откройте панель командой /autoref или кнопкой ⚙️ Настройки → 🛡 Открыть настройки в карточке модуля. Пока модуль выключен, панель не открывается и возвраты не выполняются.

2. Отметьте оценки

В верхнем ряду панели — кнопки 1⭐ … 5⭐. Нажатие переключает оценку (🟢 — возврат включён, ⚪️ — выключен). Разумный вариант: 1 и 2 звезды; 3 — по ситуации; 4 и 5 обычно не требуют возврата.

3. Задайте лимит суммы

Кнопка 💰 Лимит суммы → пришлите число в рублях (например 300; дробные — через точку или запятую). Лимит действует на всё: заказы дороже него бот не вернёт ни за отзыв, ни от ЧС. 0 — фактически отключает автовозвраты. Пример: продаёте ключи по 100 ₽ и аккаунты по 3 000 ₽ — поставьте 300 ₽. Мелкие заказы бот урегулирует сам, дорогие оставит вам.

4. Настройте действия

ЧС при отзыве — ✅/❌.
ЧС при удалении — ✅/❌.
Возврат покупок от ЧС — ✅/❌.
Уведомления в Telegram — ✅/❌. По умолчанию отчёты приходят во все чаты администраторов бота. Если выключить и снова включить переключатель, отчёты будут приходить только в тот Telegram-чат, где вы его включили.

5. Текст для ЧС

Кнопка 📝 Текст для ЧС — пришлите одним сообщением текст, который бот отправит покупателю в чат Starvell, когда этот модуль добавит его в чёрный список и когда вернёт деньги за его покупку. По умолчанию: «Вы в черном списке магазина. ❌». Пустой текст сохранить нельзя. При ручном добавлении в ЧС через /menu покупателю ничего не отправляется.

6. Исключения

Кнопка 🚫 Исключения показывает категории из ваших лотов в виде «Игра > Категория (число лотов)» — нажмите на нужные, чтобы отметить (✅) или снять (⬜). Если категории нет в списке, нажмите 🔄 Обновить лоты со Starvell или ➕ Добавить ID вручную — пришлите ID категории Starvell числом (его видно в ссылке создания лота в этой категории, например starvell.com/offers/add/123 → 123). Добавленные вручную ID показываются кнопками «🗑️ Удалить ID».

💡 Чёрный список у модуля общий со всем ботом: /menu → ▶️ Далее → 🚫 Чёрный список. Там же можно убрать покупателя из ЧС.

🔍 Как бот принимает решение

На Starvell отзывы приходят системными уведомлениями в чат заказа. Бот видит уведомление и загружает страницу заказа с оценкой (отзыв появляется там с небольшой задержкой — бот ждёт и повторяет попытку).
Проверки: это ваша продажа? категория не в исключениях? сумма не выше лимита? оценка включена в настройках? деньги ещё не возвращены?
Если всё сходится — возврат (с повторной попыткой при сбое), затем при необходимости ЧС и сообщение покупателю.
Вам приходит отчёт: ник, номер заказа, сумма, текст отзыва и выполненные действия.

Покупка от ЧС-ника отслеживается двумя путями — по новому заказу и по системному «Заказ оплачен» в чате, поэтому возврат срабатывает, даже если одно из событий пришло с задержкой.

💡 Пример

Покупатель купил ключ за 80 ₽ и поставил 1 ★.
Бот видит уведомление об отзыве, открывает заказ: оценка 1 включена, 80 ₽ ниже лимита 300 ₽, категория не в исключениях.
Возврат выполнен → покупатель добавлен в ЧС → в чат ушло ваше сообщение.
В Telegram: «⭐ Плохой отзыв (1) · Заказ #… · 80 ₽ · ✅ Возврат выполнен, 🚫 Добавлен в ЧС».

⚠️ Правила Starvell запрещают необоснованные возвраты. Включайте только те оценки и суммы, по которым возврат действительно оправдан, а спорные случаи оставляйте на ручное решение.