Подарочный сертификат на сайте агенты добавляют с учётом остатка и защитой от двойного списания

Промокод меняет цену покупки. Сертификат с сохраняемым остатком оплачивает покупку из отдельной суммы. Если оформить его как скидку на весь номинал, магазин не получит историю, сколько денег уже использовано и сколько ещё можно потратить.

В нашем учебном примере заказ дешевле сертификата. Код после покупки остаётся пригодным для следующего заказа, но уже на меньшую сумму. Если корзина дороже доступного остатка, покупатель видит, сколько покрывает сертификат и сколько нужно доплатить.

Такое поведение описано, например, в справке Shopify: остаток можно использовать в нескольких заказах, а нехватку покрыть другим способом оплаты. Для существующего магазина сначала стоит проверить его штатную функцию. Затем записать задачу для агента через ожидаемые суммы и статусы, а не через расположение поля.

Покупатель может нажать оплату повторно, а платёжная система может прислать то же уведомление ещё раз. В документации Stripe оба повтора описаны отдельно. Сервер должен узнать уже выполненную операцию и вернуть её результат, не уменьшать остаток снова.

Но два заказа имеют разные номера. Защита от повтора одного заказа не мешает обоим прочитать старый остаток 5 000 ₽ и попросить по 3 000 ₽. В сумме получится 6 000 ₽. Нужна ещё одна защита: проверка доступной суммы, её занятие и запись операции выполняются вместе на сервере.

Инженер выбирает механизм под базу магазина. Например, PostgreSQL позволяет блокировать запись на время её изменения в транзакции. Результат для владельца проще: разные заказы не расходуют один остаток дважды. Кто проверяет это и принимает выпуск, определяют заранее; ответственность за ошибки агенту не передают.

Следующий риск появляется при доплате. Покупатель применил сертификат, перешёл в платёжную систему и закрыл вкладку. Закрытие страницы не доказывает ни оплату, ни отмену. Если сразу вернуть сумму в доступный остаток, её можно потратить снова, пока первый платёж ещё подтверждается.

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

Состояние «неизвестно» требует сверки с платёжной системой. Stripe предупреждает, что уведомления могут приходить в другом порядке. Поэтому позднее событие не должно возвращать заказ в старое состояние или повторно менять сертификат. Повтор подтверждения остаётся безопасным.

Если сертификат покрывает заказ целиком, внешней доплаты может не быть. Тогда сервер магазина сам подтверждает завершение по согласованному правилу. Возврат товара и восстановление суммы тоже требуют явного правила владельца; здесь мы обсуждаем техническое исполнение, а не правовые условия продажи.

Демонстрация «ввели код, цена уменьшилась» проверяет только удачную покупку. Она ничего не говорит о повторе уведомления, конкурирующем заказе или потерянном ответе сервера. Эти попытки нужны в задаче до начала разработки.

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

Агенты добавляют код и автоматические проверки; инженер сверяет их с согласованным результатом и принимает работу. В отчёте заказчик получает ветку с изменениями, результаты сценариев и найденные ограничения. Непройденная проверка не превращается в «готово» из-за удачного показа на экране.

Систему сертификатов для клиента мы здесь не показываем: такого кейса у машины пока нет. Наш опыт относится к оплате курса vibecoding.ru и письму доступа. Работу нашей машины можно проследить публично; разбор ниже основан на журнале ревью нашей платёжной цепочки.

В ревью от 9 сентября 2026 нашлась связка: доступ уже создан, письмо упало, повторное уведомление больше не пыталось его отправить. Успешная отметка в одном месте цепочки скрывала неуспех в другом. Для сертификата аналогичный вопрос на приёмке: если ответ потерян, можно ли восстановить результат без второго списания?

Это пример способа работы, а не доказательство внедрённого сертификата. В курсе об агентной разработке есть урок «Одиннадцать шагов одной задачи»: правила, исполнение и проверка связаны в один процесс. В этой доработке процесс должен закончиться доказанным остатком и повторяемыми проверками.

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

У нас разработка по подписке на тарифе «Один проект» стоит 250 000 ₽ в месяц, по состоянию на 8 октября 2026. Инженер ведёт машину агентов, одна задача в работе, код остаётся в вашем репозитории, пауза доступна в любой месяц. Это цена месяца, а не обещание сделать любой сертификат за фиксированный срок.

Для первого обсуждения достаточно описать магазин, текущую оплату и правила остатка. Зафиксируйте, какие события подтверждают списание, а какие освобождают резерв. С этим описанием можно обсудить следующую задачу. Правовые условия продажи сертификата в эту разработку не входят.