Платежи и идемпотентные вебхуки

В чём суперсила создателя

Подключаешь ЮKassa с проверкой подписи, повторными попытками и защитой от двойного списания.

Превращает код в бизнес. Вы учитесь безопасно принимать рубли и валюту, обрабатывать асинхронные уведомления от банков (Webhooks) и сохранять подписки пользователей в базе данных без риска двойных начислений.

Термины и понятия (Глоссарий)

Нажмите на термин для объяснения

Ступени мастерства (L1 → L2 → L3)

Наблюдаемые возможности создателя

Базовый

Создание платежной ссылки

Интеграция с API ЮKassa для генерации счета и редиректа на оплату
Фиксация статуса 'pending' в таблице заказов

Рабочий

Идемпотентные вебхуки и фискализация

Обработка POST webhook /api/billing/webhook с проверкой IP и подписи
Атомарное переключение роли пользователя в 'PRO' через Prisma Transaction
Защита от дубликатов запросов через уникальный paymentId

Продвинутый

Рекуррентные подписки и автосписания

Сохранение payment_method_id для автопродления подписок раз в месяц
Обработка сбоев списания и отправка напоминаний в Telegram

Готовые промпты и команды для Cursor

Обработчик вебхука ЮKassa

Безопасный Server Action / Route Handler для Next.js с Prisma

Напиши POST route handler для /api/billing/webhook: валидация события payment.succeeded, поиск пользователя по metadata.userId, обновление роли в транзакции с логированием.