Что делать при ошибке 402 Payment Required

Что означает 402

HTTP 402 в CDP — это не ошибка frontend. Это бизнес-блокировка операции: текущий тариф не разрешает функцию или лимит закончился.

[ТУТ СКРИНШОТ: toast или ошибка 402 на странице CDP]

Порядок проверки

1. Скопируйте текст ошибки полностью.
2. Откройте раздел лимитов.
3. Найдите service key из ошибки.
4. Проверьте, входит ли услуга в тариф.
5. Проверьте remaining.
6. Проверьте активность подписки.
7. После изменения тарифа повторите операцию.

Типовые причины

• услуга не включена в текущий тариф;
• remaining = 0;
• бесплатный тариф не был выдан при bootstrap;
• платёж прошёл, но subscription ещё не обновилась;
• self-hosted license неактивна.

Пример сообщения:
  Услуга 'link' не включена в текущий тариф.

Что делать:
  1. открыть /me/limits
  2. найти услугу link
  3. проверить included/remaining
  4. обновить тариф или включить услугу в payment seed

Важно. Не обходите 402 на frontend. Проверка лимитов должна оставаться в payment/gateway/backend-контуре, иначе пользователь сможет выполнить операцию сверх тарифа.

Контрольный чек-лист

• Проверьте, что вы находитесь в правильном проекте, а не в соседнем тестовом проекте.
• Проверьте роль пользователя: часть кнопок видна только администратору.
• Откройте DevTools → Network и найдите запрос к /v1/....
• Скопируйте точный текст ошибки, HTTP-статус и время возникновения.
• Если операция связана с лимитом, откройте страницу лимитов до повторного запуска.

Что приложить к задаче разработчику

Чтобы проблему можно было быстро воспроизвести, приложите URL страницы, projectUuid, время ошибки, скриншот интерфейса, скриншот Network-запроса и архив логов. Для ошибок bootstrap отдельно проверьте, были ли в gateway.log не только GET, но и POST/PUT запросы.

[ТУТ СКРИНШОТ: Network-запрос с route, HTTP-статусом и response body]