docs(payment): tip and note

This commit is contained in:
BADtochka
2026-06-04 16:35:52 +03:00
committed by GitHub
parent 976c81c11c
commit a456718193
+14 -24
View File
@@ -12,8 +12,8 @@
6. Выполните тестовый платеж. 6. Выполните тестовый платеж.
7. Проверьте логи `backend`. 7. Проверьте логи `backend`.
> [!TIP] > [!NOTE]
> URL вебхука отображается вверху раздела каждого провайдера в админ-панели. > Если URL возврата не задан явно, используется ссылка на Telegram-бота.
## Общие ссылки ## Общие ссылки
@@ -23,6 +23,8 @@
- [Логи](../troubleshooting/logs.md) — проверка webhook и создания платежных ссылок. - [Логи](../troubleshooting/logs.md) — проверка webhook и создания платежных ссылок.
## Webhook URL провайдеров ## 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` + путь из таблицы. Все платежные 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`. 1. Включите `PLATEGA_ENABLED`.
2. Укажите `PLATEGA_BASE_URL`, `PLATEGA_MERCHANT_ID` и `PLATEGA_SECRET`. 3. Укажите `PLATEGA_MERCHANT_ID` и `PLATEGA_SECRET`.
3. Скопируйте URL вебхука из админ-панели и укажите его в кабинете Platega. 2. Включите необходимые кнопки `PLATEGA_SBP_ENABLED`, `PLATEGA_CRYPTO_ENABLED`.
4. Проверьте `PLATEGA_RETURN_URL` и `PLATEGA_FAILED_URL`. 4. Скопируйте URL вебхука из админ-панели и укажите его в кабинете Platega.
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-кнопки.
### Справочник ### Справочник
@@ -104,9 +96,8 @@ SeverPay подключается как отдельный платежный
1. Включите `SEVERPAY_ENABLED`. 1. Включите `SEVERPAY_ENABLED`.
2. Укажите `SEVERPAY_BASE_URL`. 2. Укажите `SEVERPAY_BASE_URL`.
3. Заполните `SEVERPAY_MID` и `SEVERPAY_TOKEN`. 3. Заполните `SEVERPAY_MID` и `SEVERPAY_TOKEN`.
4. Проверьте `SEVERPAY_RETURN_URL`. 4. Скопируйте URL вебхука из админ-панели и укажите его в кабинете SeverPay.
5. Скопируйте URL вебхука из админ-панели и укажите его в кабинете SeverPay. 5. При необходимости задайте `SEVERPAY_LIFETIME_MINUTES`.
6. При необходимости задайте `SEVERPAY_LIFETIME_MINUTES`.
### Справочник ### Справочник
@@ -120,12 +111,11 @@ Wata подключается как отдельный провайдер с be
1. Включите `WATA_ENABLED`. 1. Включите `WATA_ENABLED`.
2. Укажите `WATA_BASE_URL` и `WATA_API_TOKEN`. 2. Укажите `WATA_BASE_URL` и `WATA_API_TOKEN`.
3. Проверьте `WATA_RETURN_URL` и `WATA_FAILED_URL`. 3. Настройте `WATA_LINK_TTL_MINUTES`.
4. Настройте `WATA_LINK_TTL_MINUTES`. 4. Скопируйте URL вебхука из админ-панели и укажите его в кабинете Wata.
5. Скопируйте URL вебхука из админ-панели и укажите его в кабинете Wata. 5. При необходимости включите `WATA_WEBHOOK_VERIFY_SIGNATURE`.
6. При необходимости включите `WATA_WEBHOOK_VERIFY_SIGNATURE`. 6. Если используется проверка подписи, задайте `WATA_PUBLIC_KEY`.
7. Если используется проверка подписи, задайте `WATA_PUBLIC_KEY`. 7. Для IP-фильтрации заполните `WATA_TRUSTED_IPS`.
8. Для IP-фильтрации заполните `WATA_TRUSTED_IPS`.
### Ограничения ### Ограничения