NimbleFlowNimbleFlowШустрый поток
Обратно на сайтПолучить

ЮKassa

Оплата тарифа Pro через ЮKassa.

Официально: yookassa.ru/my, документация.

1. Магазин и ключи

  1. Зарегистрируй магазин в ЮKassa.
  2. Возьми shopId и секретный ключ.
  3. В .env:
PAYMENT_PROVIDER=yookassa
YOOKASSA_SHOP_ID=...
YOOKASSA_SECRET_KEY=...
YOOKASSA_RETURN_URL=http://localhost:3000/payments/success
NEXT_PUBLIC_APP_URL=http://localhost:3000

На проде подставь свой домен в NEXT_PUBLIC_APP_URL и YOOKASSA_RETURN_URL.

2. HTTP-уведомления (webhook)

В кабинете ЮKassa укажи URL уведомлений:

{NEXT_PUBLIC_APP_URL}/api/webhooks/yookassa

Webhook должен быть на публичном HTTPS (VPS / PaaS) — см. deploy. С localhost ЮKassa не достучится.

На проде в webhook проверяются IP ЮKassa; статус платежа дополнительно перепроверяется через API.

3. Чеки 54-ФЗ (опционально)

Если в ЮKassa подключена онлайн-касса / отправка чеков, включи передачу receipt при создании платежа:

RECEIPT_ENABLED=true
RECEIPT_SNO=usn_income
RECEIPT_VAT=none
ПеременнаяСмысл
RECEIPT_SNOСистема налогообложения → tax_system_code в API
RECEIPT_VATСтавка НДС → vat_code (для УСН без НДС обычно none)

Нужен email или телефон у пользователя (профиль → подтверждение контакта). Иначе создание платежа вернёт ошибку.

Официально: чеки при платежах, справочник параметров.

Без кассы в ЛК ЮKassa оставляй RECEIPT_ENABLED=false.

4. Проверка сценария

  1. Живая БД + обычный OAuth-вход (не Dev Login).
  2. /pricing или кабинет → Оплатить Pro.
  3. Оплата в тестовом/боевом режиме ЮKassa.
  4. Возврат на /payments/success.
  5. После webhook в /profile план становится Pro.

Частые ошибки

  • Dev Login: оплата намеренно недоступна (нет БД).
  • Webhook не настроен → оплата прошла, Pro не появился.
  • Неверный YOOKASSA_RETURN_URL / NEXT_PUBLIC_APP_URL.
  • RECEIPT_ENABLED=true, но в профиле нет email/телефона → ошибка при создании платежа.
  • Чеки включены в коде, а касса в ЛК ЮKassa не подключена → ошибка API.
← VK IDRobokassa →