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

Попробовать вживую можно на главной: там же цвет, тема и название меняются на лету.
Настройки
Всё задаётся в файле настроек /etc/beast-kluk.env и читается при старте. Неверное значение не даёт сервису запуститься и пишет в лог, что не так. Так ошибка не доедет до покупателя.
| Переменная | Что делает | По умолчанию |
|---|---|---|
BRAND_NAME | Название магазина в шапке. 1-60 печатных символов. | «Оплата USDT» |
BRAND_LOGO | Путь к файлу логотипа на сервере: PNG, JPEG, WebP или SVG, до 256 КиБ. Читается один раз при старте. | без логотипа |
BRAND_ACCENT | Фирменный цвет #rrggbb: полоска, кнопки, таймер. | #ff5a1f |
BRAND_THEME | light, 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}. Подробно в Вебхуках.
Значки сетей
Официальные логотипы Tether, TRON и BNB Chain встроены в сервис и не меняются. Откуда они взяты и на каких условиях, записано в SOURCES.md.