From a456718193578ff57bfc6a51d12783ac22eed59b Mon Sep 17 00:00:00 2001
From: BADtochka <75701093+BADtochka@users.noreply.github.com>
Date: Thu, 4 Jun 2026 16:35:52 +0300
Subject: [PATCH] docs(payment): tip and note

---
 docs/features/payments.md | 38 ++++++++++++++------------------------
 1 file changed, 14 insertions(+), 24 deletions(-)

diff --git a/docs/features/payments.md b/docs/features/payments.md
index ab2ae05..ab1f37d 100644
--- a/docs/features/payments.md
+++ b/docs/features/payments.md
@@ -12,8 +12,8 @@
 6. Выполните тестовый платеж.
 7. Проверьте логи `backend`.
 
-> [!TIP]
-> URL вебхука отображается вверху раздела каждого провайдера в админ-панели.
+> [!NOTE]
+> Если URL возврата не задан явно, используется ссылка на Telegram-бота.
 
 ## Общие ссылки
 
@@ -23,6 +23,8 @@
 - [Логи](../troubleshooting/logs.md) — проверка webhook и создания платежных ссылок.
 
 ## Webhook URL провайдеров
+> [!TIP]
+> Готовый URL вебхука отображается вверху раздела каждого провайдера в админ-панели.
 
 Все платежные webhook URL строятся от `WEBHOOK_BASE_URL` - публичного HTTPS-адреса backend/webhook-домена. Это должен быть домен, который проксируется на backend-сервер вебхуков (`backend:8080`), а не `SUBSCRIPTION_MINI_APP_URL` frontend/Mini App. Если `WEBHOOK_BASE_URL=https://bot.example.com`, то полный адрес получается как `https://bot.example.com` + путь из таблицы.
 
@@ -77,19 +79,9 @@ Platega подключается как отдельный платежный п
 ### Настройка
 
 1. Включите `PLATEGA_ENABLED`.
-2. Укажите `PLATEGA_BASE_URL`, `PLATEGA_MERCHANT_ID` и `PLATEGA_SECRET`.
-3. Скопируйте URL вебхука из админ-панели и укажите его в кабинете Platega.
-4. Проверьте `PLATEGA_RETURN_URL` и `PLATEGA_FAILED_URL`.
-5. При необходимости укажите `PLATEGA_PAYMENT_METHOD`.
-
-### Дополнительные кнопки
-
-- `PLATEGA_SBP_ENABLED` — отдельная кнопка СБП/карта.
-- `PLATEGA_SBP_METHOD` — ID метода для СБП/карты.
-- `PLATEGA_CRYPTO_ENABLED` — отдельная crypto-кнопка Platega.
-- `PLATEGA_CRYPTO_METHOD` — ID метода для crypto-кнопки.
-- `PAYMENT_PLATEGA_SBP_*` — текст и иконка кнопки СБП/карта.
-- `PAYMENT_PLATEGA_CRYPTO_*` — текст и иконка crypto-кнопки.
+3. Укажите `PLATEGA_MERCHANT_ID` и `PLATEGA_SECRET`.
+2. Включите необходимые кнопки `PLATEGA_SBP_ENABLED`, `PLATEGA_CRYPTO_ENABLED`.
+4. Скопируйте URL вебхука из админ-панели и укажите его в кабинете Platega.
 
 ### Справочник
 
@@ -104,9 +96,8 @@ SeverPay подключается как отдельный платежный 
 1. Включите `SEVERPAY_ENABLED`.
 2. Укажите `SEVERPAY_BASE_URL`.
 3. Заполните `SEVERPAY_MID` и `SEVERPAY_TOKEN`.
-4. Проверьте `SEVERPAY_RETURN_URL`.
-5. Скопируйте URL вебхука из админ-панели и укажите его в кабинете SeverPay.
-6. При необходимости задайте `SEVERPAY_LIFETIME_MINUTES`.
+4. Скопируйте URL вебхука из админ-панели и укажите его в кабинете SeverPay.
+5. При необходимости задайте `SEVERPAY_LIFETIME_MINUTES`.
 
 ### Справочник
 
@@ -120,12 +111,11 @@ Wata подключается как отдельный провайдер с be
 
 1. Включите `WATA_ENABLED`.
 2. Укажите `WATA_BASE_URL` и `WATA_API_TOKEN`.
-3. Проверьте `WATA_RETURN_URL` и `WATA_FAILED_URL`.
-4. Настройте `WATA_LINK_TTL_MINUTES`.
-5. Скопируйте URL вебхука из админ-панели и укажите его в кабинете Wata.
-6. При необходимости включите `WATA_WEBHOOK_VERIFY_SIGNATURE`.
-7. Если используется проверка подписи, задайте `WATA_PUBLIC_KEY`.
-8. Для IP-фильтрации заполните `WATA_TRUSTED_IPS`.
+3. Настройте `WATA_LINK_TTL_MINUTES`.
+4. Скопируйте URL вебхука из админ-панели и укажите его в кабинете Wata.
+5. При необходимости включите `WATA_WEBHOOK_VERIFY_SIGNATURE`.
+6. Если используется проверка подписи, задайте `WATA_PUBLIC_KEY`.
+7. Для IP-фильтрации заполните `WATA_TRUSTED_IPS`.
 
 ### Ограничения