beast docs

Кастомизация

Страница оплаты выглядит как часть вашего магазина. Имя, логотип, цвет, тема, скругления, подвал. И кнопка «Вернуться в магазин» после оплаты.

Страница оплаты с фиолетовым акцентом в тёмной теме

Попробовать вживую можно на главной: там же цвет, тема и название меняются на лету.

Настройки

Всё задаётся в файле настроек /etc/beast-kluk.env и читается при старте. Неверное значение не даёт сервису запуститься и пишет в лог, что не так. Так ошибка не доедет до покупателя.

ПеременнаяЧто делаетПо умолчанию
BRAND_NAMEНазвание магазина в шапке. 1-60 печатных символов.«Оплата USDT»
BRAND_LOGOПуть к файлу логотипа на сервере: PNG, JPEG, WebP или SVG, до 256 КиБ. Читается один раз при старте.без логотипа
BRAND_ACCENTФирменный цвет #rrggbb: полоска, кнопки, таймер.#ff5a1f
BRAND_THEMElight, dark или auto (как на устройстве покупателя).auto
BRAND_RADIUSСкругление карточки в пикселях, 0-28. Кнопки и поля скругляются пропорционально.20
BRAND_FOOTERСтрока в подвале, до 200 символов. Например, «Вопросы по заказу пишите в поддержку».пусто
BRAND_SUPPORT_URLСсылка «Поддержка магазина» в подвале. Только https://.без ссылки
BRAND_NAME=Северный магазин
BRAND_LOGO=/etc/beast-kluk/logo.svg
BRAND_ACCENT=#6d4aff
BRAND_THEME=dark
BRAND_RADIUS=12
BRAND_FOOTER=Вопросы по заказу пишите в поддержку
BRAND_SUPPORT_URL=https://shop.example/help
sudo systemctl restart beast-kluk
journalctl -u beast-kluk -n 20   # при ошибке здесь будет имя переменной
  • Только файл на сервере, не ссылка. Страница не грузит ничего чужого, поэтому адрес https://… в BRAND_LOGO отклоняется при старте. Скачайте файл и укажите путь.
  • Тип определяется по содержимому, не по расширению. GIF, текст и всё прочее отклоняются.
  • SVG чистится: без <script>, <foreignObject>, <style>, внешних ссылок, обработчиков on*, javascript:. Файл с DOCTYPE или ENTITY не принимается.
  • Отдаётся по /pay/brand/logo с точным Content-Type, nosniff и для SVG своей строгой CSP.
  • В шапке логотип занимает до 36 px в высоту и до 160 px в ширину. Горизонтальный логотип с прозрачным фоном смотрится лучше всего.

Логотип уже содержит название? Всё равно задайте BRAND_NAME: его прочитает экранный диктор и покажет вкладка браузера.

Цвет и тема

Цвет текста на кнопках подбирается сам: белый или почти чёрный, что контрастнее по WCAG. Светлый жёлтый акцент получит тёмный текст, тёмно-синий получит белый.

Стили собираются при старте в отдельный файл /pay/brand.css только из проверенных значений. Инлайн-стилей и инлайн-скриптов на странице нет, CSP остаётся строгой: style-src 'self'; script-src 'self'.

Возврат в магазин

Передайте return_url при создании счёта. После оплаты на странице появится кнопка «Вернуться в магазин».

curl -s https://pay.example.com/v1/invoices \
  -H "Authorization: Bearer $BEAST_TOKEN" \
  -d '{"network":"trc20","amount":"49.90","external_id":"order-1042",
       "return_url":"https://shop.example/orders/1042"}'
  • Только абсолютный https:// адрес с хостом, до 512 байт, без user:password@, пробелов и управляющих символов. Иначе 400 bad_request с именем поля в message.
  • Своя ссылка на каждый счёт: удобно вести на страницу заказа.
  • Есть в объекте счёта и в вебхуке, только если задан.
  • Повтор с тем же external_id вернёт тот же счёт. Действует первый return_url.

Кнопка возврата не подтверждает оплату. Заказ отмечайте только по вебхуку invoice.paid или по статусу из GET /v1/invoices/{id}. Подробно в Вебхуках.

Значки сетей

USDTTRONBNB Chain

Официальные логотипы Tether, TRON и BNB Chain встроены в сервис и не меняются. Откуда они взяты и на каких условиях, записано в SOURCES.md.