ТЗ на платную подписку: billing-spec.md для агента

Просишь агента «добавь подписку за 990 ₽ в месяц», и через час у тебя кнопка оплаты, которая работает. Вопросы появляются потом: человек оплатил, а доступ не открылся, потому что уведомление от платёжки пришло дважды. Карта не прошла при продлении, и непонятно, закрывать доступ сразу или дать три дня. Клиент попросил вернуть деньги, а в базе нет поля, куда это записать.

Всё это решается заранее, на бумаге. Промпт ниже соберёт файл billing-spec.md: тарифы, статусы подписки и переходы между ними, какие уведомления от платёжной системы обрабатываем и что делаем при повторе, правила отмены и возврата. Агент получает описание, по которому можно написать код и тесты.

Что получишь

• 💳Тарифы и доступы

  Что входит в каждый план, что происходит при смене тарифа посреди месяца, есть ли пробный период.

• 🔁Статусы и переходы

  Пробный, активный, просрочен платёж, отменён, истёк. Для каждого — что видит пользователь и что ему доступно.

• 📨Webhooks без сюрпризов

  Какие события ловим, как проверяем подпись, что делаем, если событие пришло дважды или раньше другого.

• ↩️Отмена и возврат

  До какого числа работает отменённая подписка, кто и как оформляет возврат, что пишется в базу.

Как использовать

1. 1Реши, какая платёжная система

   Если не выбрал, ИИ спросит про страну, юрлицо и рекуррентные платежи и предложит варианты. Документацию выбранной системы держи под рукой.

2. 2Отправь шаг 1 и ответь на вопросы

   Самые важные — что происходит при неудачном продлении и можно ли вернуть деньги.

3. 3Получи billing-spec.md

   Шаг 2 выдаёт файл целиком. Сохрани его в папку docs проекта.

4. 4Сверь события с документацией

   Названия событий и полей webhooks бери из документации платёжки. Где не совпадает — поправь.

5. 5Отдай агенту по частям

   Сначала модель данных и статусы, потом webhooks, потом экраны. Каждую часть — с критериями приёмки из файла.

Про повторы, задержки и потерю уведомлений подробно — в гайде «Вебхуки оплаты: сценарии повторов, задержек и потери событий». Его стоит открыть перед шагом 4.

Рядом по теме: ТЗ на личный кабинет, Скилл: тест-кейсы из PRD — чтобы проверить оплату по списку, статья Как написать ТЗ для ИИ-агента и бесплатный чек-лист «Перед запуском».

Что дальше

• ТЗ на webhooks — отдельное ТЗ, если интеграций больше одной.
• Матрица ролей и прав для SaaS — что видит пользователь в каждом тарифе и роли.
• Юнит-экономика без финансового образования — посчитать, сходится ли цена тарифа.
• Собрать продукт с агентом от идеи до работающего экрана помогает курс Первый экран за 990 ₽.