Вебхуки оплаты: тест-план на дубли, задержки и потери

Ты собрал подписку с агентом, тестовая оплата прошла, доступ открылся. Только на одной тестовой карте не видно того, что случается в проде. Провайдер присылает одно и то же уведомление дважды, если твой сервер ответил медленно. Событие «оплата не прошла» приходит после «подписка продлена». Воркер падает между записью в базу и выдачей доступа. В итоге доступ выдан два раза, бонус начислен дважды или человек заплатил и сидит без доступа.

Промпт превращает описание твоей интеграции в тест-план: какие события подделать, в каком порядке их отправить и что должно лежать в базе после каждого. Код он не пишет и к провайдеру не обращается. План ты прогоняешь на staging сам или отдаёшь агенту.

Что получишь

• 🗺️Карту состояний

  Какое событие переводит подписку из какого статуса в какой, и какие переходы запрещены: например, «продлена» после «возвращена».

• 🧪Тест-кейсы

  Минимум 12: повтор одного события, обратный порядок, ответ 500, таймаут, падение воркера, неверная подпись. Для каждого — что отправить и что проверить.

• 🔒Инварианты

  Правила, которые не должны нарушаться ни в одном кейсе: один платёж — одно продление, доступ только по подтверждённому статусу.

• ❓Вопросы к документации

  Что нужно уточнить у провайдера: как он повторяет доставку, какое поле уникально, как проверять подпись.

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

1. 1Выпиши события провайдера

   Открой его документацию по уведомлениям и скопируй названия событий: оплата, продление, отмена, возврат, ошибка. Найди, какое поле у события уникальное и как провайдер повторяет доставку.

2. 2Опиши свой обработчик

   Вставь код или попроси агента описать его словами: когда он отвечает 200, пишет ли ID события в базу, есть ли очередь. Чего не знаешь, так и помечай: «не знаю».

3. 3Шаг 1: карта и вопросы

   ИИ строит карту состояний и задаёт вопросы по дырам в описании. Ответь на них, прежде чем идти дальше.

4. 4Шаг 2: тест-план

   Прогоняй кейсы на staging с тестовыми ключами. Каждый упавший кейс отдавай агенту отдельной задачей.

Если обработчика ещё нет и ты только ставишь задачу агенту, начни с шаблона ТЗ на webhooks, а этот тест-план приложи к ТЗ как критерии приёмки.

Рядом по теме: ТЗ на платную подписку: billing-spec.md для агента, Матрица ролей и прав для SaaS, Своя обучающая платформа с AI-кодером, статья «Что такое вайбкодинг» и Аудит копий проекта (бесплатно).

Что дальше

• Упавшие кейсы чини по одному с проверкой: схема в гайде исправить ошибку в проекте и доказать, что она решена.
• Как убедиться, что агент написал тесты, которые реально что-то ловят: как тестировать код, который написал агент.
• Вторая половина подписки, которую тоже стоит проверить: отмена подписки без ловушек.
• Перед релизом пройди бесплатный Чек-лист «Перед запуском».