Настройки DonateX

Что это за страница

«Подключения → Монетизация → DonateX» — место, где DonateX получает API-токен, чтобы донаты доходили до приложения. Здесь два предмета: тумблер «Приём донатов» и сам токен.

Как это настроить

1. Откройте «Подключения → Монетизация» и нажмите на карточке «Подключить DonateX». У уже подключённой карточки та же страница открывается кнопкой «Настроить». Стрелка слева вверху, «Назад», возвращает к списку.
2. Страница называется «Настройки DonateX», под заголовком стоит «Настройте интеграцию с DonateX для получения уведомлений о донатах.».
3. Первая строка — «Приём донатов» с подписью DonateX, бейджем и тумблером. Тумблер срабатывает в момент нажатия — кнопки сохранения он не ждёт. Выключенный даёт бейдж «Выключено», и не приходит ничего.
4. Нажмите «Открыть кабинет DonateX». Откроется donatex.gg в вашем обычном браузере. Подсказка говорит, где смотреть: «Токен выдаёт DonateX в кабинете, в разделе «Настройки → Api».».
5. Скопируйте токен оттуда и вставьте в поле «API-токен». Поле скрывает набранное, пустое подсказывает «Вставьте API-токен DonateX».
6. Нажмите «Сохранить» справа вверху. Кнопка отчитывается о себе сама — «Сохраняю…», затем «Сохранено» или «Ошибка», если токен не записался. После успешного сохранения страница закрывается сама и возвращает к списку сервисов.
7. Сохранение с пустым полем, когда токена ещё нет, отклоняется словами «Введите API-токен DonateX.».
8. Откройте страницу заново для проверки. Поле токена пустое намеренно — сохранённый токен обратно не показывают никогда. О том, что он есть, говорит подсказка внутри поля: «Токен сохранён — оставьте поле пустым, чтобы не менять». Пустое поле при сохранении оставляет прежний токен нетронутым; чтобы заменить, наберите новый поверх.
9. Бейдж рядом с тумблером говорит, где сейчас подключение: «Не подключено» (токена ещё нет), «Выключено» (тумблер снят), «Подключение…», «Нужен новый токен», «Ошибка соединения» или «Подключено как {username}». Пока страница открыта, он обновляется сам каждые несколько секунд.
10. «Нужен новый токен» означает, что сохранённый токен больше не работает. Получите свежий в кабинете DonateX и сохраните поверх старого.

Что приходит и как считается

• Донат DonateX приходит обычным событием доната, поэтому алерты, сбор средств, аукцион и озвучка подхватывают его, ничего не зная про DonateX.
• Сумма переводится в вашу базовую валюту так же, как у остальных сервисов.
• Донат, отправленный из кабинета DonateX как тестовый, приходит наравне с прочими и учитывается в сборе средств и аукционе. Так задумано: тест, проходящий мимо накопителей, не годился бы для их проверки. Удалите его потом в «Статистике» — и вклад вычтется обратно.
• Имя донатера приходит вместе с донатом. Отправленный анонимно показывается анонимным.

Чего здесь нельзя

• Токен нельзя прочитать обратно из приложения — поле ничего не показывает, кнопки «показать» нет.
• Входа через браузер здесь нет: токен переносится руками. Кнопка только открывает кабинет DonateX, сама она ничего не забирает.
• Имя аккаунта не вписывается. Оно приезжает с подключением, и бейдж показывает его как «Подключено как {username}», как только токен заработал.
• Тумблер распоряжается только приёмом донатов DonateX. Это не включение и выключение модуля в каталоге, и ничего другого он не отключает.
• Отключение и «Удалить подключение» (значок корзины) живут на карточке DonateX в разделе «Подключения → Монетизация», а не на этой странице.
• Донаты, суммы и история здесь не показываются — страница только про доступ.
• Донаты, пришедшие при закрытом приложении, не подтягиваются задним числом. Приложение добирает только за то время, когда оно было подключено: если живое соединение замолчало на какое-то время, пропущенное восстановится, а часы без запущенного приложения не заполняются.