VibeCoderzVibeCoderz
Все статьи
Вайбкодинг: гайды2026/06/2911 мин чтения

Как подключить оплату на сайт через ЮKassa в 2026 году

Подключить ЮKassa к сайту в 2026 году можно за несколько дней: регистрируйтесь, получайте shopId и secretKey, настройте webhook и уже в первый вечер проведите тестовый платеж. Комиссия 2,8 % за карты, 0,4 % за СБП, плюс НДС 22 % от комиссии.

Содержание (13)+

Обновлено: октябрь 2026

Если собираете продукт в России и принимаете деньги от физлиц — ЮKassa один из самых очевидных выборов. Комиссия по СБП от 0,4%, карты от 2,8%, подключение бесплатное. Готовая интеграция при нормальном стеке делается за день: утром подаете документы, вечером проводите первый тестовый платеж.

В этом гайде — весь путь от регистрации до первого реального платежа. Разберем, как получить shopId и secretKey, настроить webhook и не наступить на классические грабли вроде CSRF и пересчета комиссии.

TL;DR: ЮKassa подключается в три шага: регистрация + договор (1–3 рабочих дня), тестовый магазин с API-ключами, настройка webhook. Комиссия за карты от 2,8%, СБП от 0,4%. С 1 января 2026 года к комиссии добавляется НДС 22% от суммы комиссии. Боевая интеграция отличается от тестовой только заменой ключей.

Шаг 1. Кто может подключить ЮKassa?

ЮKassa работает с ИП, ООО и самозанятыми. Для самозанятых — упрощенная схема, но есть потолок по доходу.

ЮKassa доступна для трех форм бизнеса: юрлицо (ООО), индивидуальный предприниматель и самозанятый. Выбор влияет на набор документов при заполнении анкеты.

Самозанятые подключаются проще всего — меньше документов, нет требований к бухгалтерии. Ограничение одно: годовой доход не может превышать 2,4 млн рублей. Если оборот больше — только ИП или ООО.

Важный момент для подрядчиков: если вы разработчик, которому заказчик сказал «подключи нам ЮKassa», регистрироваться должен сам заказчик. Потом он просто добавляет вас в личный кабинет как разработчика. Попытка зарегистрироваться на свои данные за чужой бизнес — это путь в никуда.

Изображение

Шаг 2. Как зарегистрироваться в ЮKassa?

Регистрация занимает 10–15 минут, но до реальных платежей пройдет 1–3 рабочих дня на проверку анкеты.

Переходите на yookassa.ru и жмете «Подключить». Порядок такой:

  1. Телефон + SMS-код.
  2. Пароль и email для уведомлений.
  3. Форма бизнеса — ИП, ООО или самозанятый.
  4. ИНН или название компании.

После этого попадаете в личный кабинет. На главной странице появится чеклист шагов для подключения.

Первым делом — заполнить анкету и заключить договор. Переходите в раздел «Данные договора» и указываете:

  • реквизиты расчетного счета (на него будут приходить деньги с продаж),
  • данные о государственной регистрации (ФНС часто предзаполняет их автоматически — проверьте),
  • паспорт руководителя или ИП (фото без бликов, не обрезанное),
  • для ООО — данные бенефициарных владельцев, то есть физлиц с долей больше 25%.

Последний пункт обязателен по закону и часто становится неожиданностью для новичков. Пропустить нельзя.

После отправки анкеты ждете проверки. Ответ приходит на email, в среднем это 3 рабочих дня. Но и тут есть лайфхак: пока идет проверка, уже можно начинать техническую интеграцию через тестовый магазин.

Договор подписывают онлайн или скан-копией — выбирайте онлайн, это экономит время.


Шаг 3. Где взять shopId и secretKey?

ShopId — в разделе «Операции», секретный ключ — в разделе «Интеграция» -> «Ключи API». Для теста нужен ключ с префиксом test_.

Это два параметра, без которых не обходится ни одна интеграция с платежными системами. Оба находятся в личном кабинете.

shopId — номер вашего магазина в системе ЮKassa. Отображается напротив названия магазина в разделе «Операции».

Секретный ключ — в разделе «Интеграция» -> «Ключи API». Тестовый ключ начинается с test_, боевой — без этого префикса.

Создать тестовый магазин можно сразу после регистрации: раздел «Интеграция» -> «Настройки интеграции», жмете «Добавить тестовый магазин». Через минуту появится отдельный shopId и тестовый ключ. В тестовом режиме деньги не списываются — все операции симулируются.

Базовая инициализация клиента выглядит одинаково на любом языке. Вот Python-пример из официального SDK:

from yookassa import Configuration

# Тест
Configuration.configure('ВАШ_SHOP_ID', 'test_XXXXXXXXXX')

# Бой — меняете только ключ
Configuration.configure('ВАШ_SHOP_ID', 'live_XXXXXXXXXX')

Node.js и PHP — та же логика: передаете shopId и secretKey при инициализации клиента. Весь остальной код не меняется при переключении с теста на бой.


Шаг 4. Как создать платеж через API ЮKassa?

Создание платежа — POST-запрос к api.yookassa.ru/v3/payments. В ответ получаете ссылку, на которую перенаправляете пользователя.

Изображение

Логика проведения оплаты простая: вы создаете платеж на стороне ЮKassa, получаете ссылку, перенаправляете пользователя. Он платит, ЮKassa уведомляет ваш сервер через webhook.

Пример curl-запроса из официальной документации ЮKassa (yookassa.ru/developers):

curl https://api.yookassa.ru/v3/payments \
  -X POST \
  -u <Shop ID>:<Secret Key> \
  -H 'Idempotence-Key: <Уникальный ключ>' \
  -H 'Content-Type: application/json' \
  -d '{
    "amount": {
      "value": "1000.00",
      "currency": "RUB"
    },
    "capture": true,
    "confirmation": {
      "type": "redirect",
      "return_url": "https://ваш-сайт.ru/success"
    },
    "description": "Заказ №123"
  }'

В ответ приходит объект платежа с полем confirmation.confirmation_url — это и есть ссылка для пользователя.

Есть нюанс, о котором часто не думают на старте: никогда не делайте запрос к ЮKassa напрямую с фронтенда. Если создавать платеж из браузера, сумму легко подделать — вместо 1000 рублей клиент заплатит 10. Запрос должен идти через бэкенд, который сам получает правильную цену из базы данных.

ПараметрОписание
amount.valueСумма в рублях строкой с двумя знаками после точки
capturetrue — одностадийная оплата, false — двухстадийная (сначала холд)
confirmation.return_urlКуда перенаправить пользователя после оплаты
descriptionТекст, который увидит покупатель на странице оплаты
Idempotence-KeyУникальный ключ запроса — защита от дублирования платежа

Шаг 5. Как настроить webhook для получения уведомлений?

Webhook — URL на вашем сервере, куда ЮKassa отправляет POST-запрос при изменении статуса платежа. Обязателен HTTPS.

Это самый важный шаг, который часто делают небрежно. Без webhook вы не узнаете, что пользователь оплатил — придется каждые несколько секунд дергать API вопросом «ну как там платеж?». Это и медленно, и неэффективно.

Настройка в личном кабинете: «Интеграция» -> «HTTP-уведомления» -> указываете URL. Формат: https://ваш-сайт.ru/webhook/yukassa.

Два ключевых события, на которые подписываетесь:

  • payment.succeeded — платеж прошел, деньги списаны
  • payment.canceled — платеж отменен или истекло время

Пример простого обработчика на Python/Django:

import json
from django.http import HttpResponse
from yookassa.domain.notification import (
    WebhookNotificationEventType,
    WebhookNotificationFactory
)
from yookassa.domain.common import SecurityHelper

def yukassa_webhook(request):
    # Проверяем IP — ЮKassa присылает с известных адресов
    ip = request.META.get('REMOTE_ADDR')
    if not SecurityHelper().is_ip_trusted(ip):
        return HttpResponse(status=400)

    event_json = json.loads(request.body)
    notification = WebhookNotificationFactory().create(event_json)

    if notification.event == WebhookNotificationEventType.PAYMENT_SUCCEEDED:
        payment = notification.object
        order_id = payment.metadata.get('order_id')
        # Обновляем статус заказа в базе
        update_order_status(order_id, 'paid')

    return HttpResponse(status=200)

Webhook должен отвечать кодом 200 OK. Любой другой код — и ЮKassa будет повторять запросы в течение 24 часов.

Есть нюанс с Django (и Flask тоже): если используете CSRF-защиту, webhook-обработчик нужно выводить из-под нее через декоратор @csrf_exempt. Это осознанное решение — ЮKassa не передает CSRF-токен. Для компенсации проверяйте IP из белого списка ЮKassa через SecurityHelper().is_ip_trusted(ip).


Шаг 6. Как пересчитать сумму с учетом комиссии?

ЮKassa снимает комиссию из суммы платежа, а не добавляет сверху. Если хотите получить ровно 1000 рублей, нужно выставить счет на большую сумму.

Это один из самых частых источников путаницы при первой интеграции с платежными системами. ЮKassa не «добавляет» комиссию к платежу — она вычитает ее из той суммы, которую вы выставляете.

Изображение

Пример для тарифа 3% по картам: если хотите получить 1000 рублей, клиент должен заплатить примерно 1030 рублей. Формула:

сумма для клиента = нужная сумма / (1 - комиссия)

С 1 января 2026 года к комиссии добавляется НДС 22% от суммы комиссии. То есть реальный вычет стал немного больше.

На практике есть два подхода. Первый — включить комиссию в расходы и выставлять цену без пересчета. Второй — явно добавлять комиссию к стоимости (тогда нужно знать тариф заранее, а ЮKassa не дает получить его в реальном времени через API). Для большинства небольших проектов первый вариант проще.


Тарифы и комиссии ЮKassa в 2026 году

Базовые ставки: карты от 2,8%, СБП от 0,4%. Итоговый тариф зависит от оборота и категории бизнеса.

ЮKassa — платежный сервис от Яндекса. Комиссия по картам стартует от 2,8%, СБП от 0,4%. Подключение бесплатное, абонентской платы нет. При обороте от 1 млн рублей в месяц доступны индивидуальные условия.

Способ оплатыБазовая комиссияПримечание
Карты (Visa, MC, МИР)от 2,8%Зависит от категории бизнеса
СБПот 0,4%Самый выгодный вариант
SberPayот 2,8%Оплата через Сбер Онлайн
T-Payот 3,8%Оплата через Т-Банк
ЮMoneyот 2,8%Электронный кошелек

Важное изменение 2026 года: с 1 января 2026 года НДС вычитается вместе с комиссией — 22% от суммы комиссии. Вычет НДС зависит от способа оплаты.

Чтобы получить сниженную комиссию, при подключении выбирайте сервис «Чеки от ЮKassa» — это встроенное решение для отправки чеков по 54-ФЗ, которое одновременно снижает ставку.

СБП — отдельная история. Подключить прием платежей через СБП можно только вместе с другими способами ЮKassa: банковскими картами, кошельком ЮMoney, SberPay. Зачисление на расчетный счет — в любом российском банке, подключение от одного рабочего дня.


Как протестировать интеграцию с ЮKassa?

Тестовый магазин с ключами test_ позволяет проводить платежи без списания реальных денег. Тестовые карты — в документации ЮKassa.

После создания тестового магазина в личном кабинете используйте тестовые карты из официальной документации ЮKassa (yookassa.ru/developers). Стандартный набор для теста:

  • Успешная оплата: номер карты 5555 5555 5555 4444, срок 12/26, CVV 000
  • Отклоненная оплата: 5555 5555 5555 4477

При тестировании webhook на локальной машине возникает проблема: ЮKassa не может достучаться до localhost. Решение — ngrok. Он создает временный HTTPS-адрес, который туннелирует запросы на ваш локальный сервер:

ngrok http 8000
# Получаете: https://abc123.ngrok.io
# Этот адрес вставляете в поле webhook в личном кабинете ЮKassa

Проверить, что webhook работает: провести тестовый платеж и убедиться, что в консоли сервера появился POST-запрос от ЮKassa с JSON-телом уведомления.

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


Готовые модули vs API — что выбрать?

Готовые модули для WordPress, Tilda, 1С — быстрее на 80%. Прямая интеграция через API — гибче, нужна при нестандартной логике.

В ЮKassa есть готовые модули для самых популярных систем: Tilda, Wix, AmoCRM, WordPress и других. Для каждой системы есть инструкция и документация.

Когда выбирать модуль: вы на стандартной CMS, нет нестандартной бизнес-логики, хотите запустить прием платежей за день без написания кода.

Когда нужна прямая интеграция через API: у вас своя платформа, кастомный флоу оплаты (например, двухстадийный: сначала холд, подтверждение после выполнения услуги), нужно передавать metadata для связи платежа с заказом, или строите мобильное приложение.

Изображение
ПараметрГотовый модульAPI
Скорость запускаЧасыДень-два
ГибкостьНизкаяВысокая
Нужен разработчикНетДа
Кастомный флоуНетДа
Metadata в платежеОграниченоДа
Максим Наговицын: «Когда делали GoBanana — веб-версию собрали за 3 часа после выхода модели. Платежи подключили через API, потому что нужна была своя логика: холд при создании заказа, подтверждение после генерации. Готовый модуль тут не справился бы. Но если бы это был просто лендинг с одним продуктом — взяли бы модуль для Tilda и закрыли вопрос за 20 минут.»

Двухстадийная оплата — когда и зачем?

Двухстадийная схема: сначала деньги блокируются на карте (холд), потом вы их подтверждаете или отменяете. Удобно для услуг с отложенным выполнением.

Это особенность, которая отличает ЮKassa от многих конкурентов. При создании платежа с capture: falseденьги блокируются, но не списываются. Пока транзакция в статусе waiting_for_capture, вы можете:

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

Классический кейс: заказ такси. Клиент оплатил, такси не приехало — просто отменяете транзакцию, деньги возвращаются без бюрократии.

Или сервис с моделированием: клиент оплачивает генерацию, если она упала с ошибкой — отменяете холд автоматически. Логика опроса вебхука при этом не меняется — просто вместо capture: true отправляете запрос на подтверждение после выполнения задачи.


Ошибки, которые тормозят при интеграции ЮKassa

Три самых частых проблемы: CSRF на webhook, забыли указать HTTPS, неправильный расчет суммы.

Ошибка 1: CSRF блокирует webhook

Django и Flask по умолчанию проверяют CSRF-токен на POST-запросах. ЮKassa его не присылает, поэтому webhook падает с ошибкой 403 Forbidden. Решение — декоратор @csrf_exempt на обработчике. Компенсируете это проверкой IP: ЮKassa шлет уведомления с фиксированного диапазона адресов, их можно проверить через SecurityHelper().is_ip_trusted(ip).

Ошибка 2: webhook на HTTP

ЮKassa требует HTTPS для доставки уведомлений. Если указали http:// вместо https:// — уведомления не придут. На проде это обычно закрыто автоматически, а для локального тестирования нужен ngrok.

Ошибка 3: не сохранили payment_id

При создании платежа ЮKassa возвращает уникальный id платежа. Его нужно сохранить в базе рядом с заказом. Когда придет webhook с уведомлением об успехе — вы свяжете его с конкретным заказом по этому id. Без этого непонятно, что именно оплатили.

Изображение

Часто задаваемые вопросы

Сколько стоит подключить ЮKassa? Подключение бесплатное. Комиссия берется только за успешно проведенные платежи: карты от 2,8%, СБП от 0,4%. Абонентской платы нет.

Можно ли подключить ЮKassa как самозанятый? Да. Самозанятые подключаются по упрощенной схеме. Ограничение — годовой доход не более 2,4 млн рублей. Чеки формируются автоматически.

Что такое webhook в ЮKassa и зачем он нужен? Webhook — это URL на вашем сервере, на который ЮKassa отправляет уведомление, когда платеж прошел или отклонен. Без него вы не узнаете об успешной оплате без постоянных запросов к API.

Где взять shopId и secretKey для ЮKassa? ShopId отображается напротив названия магазина в разделе «Операции». Секретный ключ — в разделе «Интеграция» -> «Ключи API». Для теста нужен ключ с префиксом test_.

Нужен ли HTTPS для интеграции ЮKassa? HTTPS обязателен для webhook-уведомлений — ЮKassa не отправит POST-запрос на HTTP-адрес. Для тестирования на локальной машине используют ngrok, который создает временный HTTPS-адрес.

Как ЮKassa не включает комиссию — надо пересчитывать сумму? Именно. ЮKassa списывает комиссию из суммы платежа. Если хотите получить 100 рублей, нужно выставить счет на 102-103 рубля в зависимости от тарифа. Или просто принять это в расходы.

Сколько времени занимает проверка анкеты ЮKassa? В среднем 3 рабочих дня, но нередко быстрее. Пока ждете, можно начинать техническую интеграцию через тестовый магазин.


Что дальше

Интеграция с платежными системами — один из базовых навыков при создании любого коммерческого продукта. ЮKassa закрывает российский рынок, и логика работы схожа с другими эквайрингами — разобравшись здесь, подключить, например, Тинькофф Бизнес будет намного проще.

Если строите что-то на Next.js или другом современном стеке, посмотрите каталог AI-инструментов — там есть обзоры инструментов, которые помогут ускорить разработку. А если нужна помощь с архитектурой или выбором стека для вашего проекта, запишитесь на консультацию к Максиму.


Данные по тарифам актуальны на июнь 2026. Источники: yookassa.ru/fees, yookassa.ru/developers. Перед подключением уточняйте условия в личном кабинете ЮKassa — тарифы могут зависеть от категории бизнеса и оборота.

Обновлено: октябрь 2026 — команда VibeCoderz

Автор

Максим Наговицын

Маркетинг-стратег, IT-предприниматель, ментор по вайбкодингу

2026/06/29

10+ лет в маркетинге, 300+ клиентских проектов: сайты, реклама, боты. Создатель GoBanana (228K+ пользователей, 11.6 млн ₽ выручки) и VibeCoderz. Делаю AI-продукты сам через Claude Code, Cursor, Windsurf и консультирую тех, кто хочет так же.

Об авторе →
All Posts

Читать далее

📄 Статья

Повысить качество фото онлайн бесплатно без регистрации

[ { "@context": "https://schema.org", "@type": "BlogPosting", "headline": "Повысить качество фото онлайн бесплатно без регистрации в 2026", "description": "В октябре 2026 повысить качество фото онлайн бесплатно можно через GoBanana, Qwen, Seedream и…

2026/10/1210 мин
📄 Статья

ИИ на телефоне Самсунг, Гугл и айфон в России в 2026 году

Встроенный ИИ в смартфонах 2026: Galaxy AI, Gemini, Apple

2026/10/0611 мин
📄 Статья

Создать песню ИИ на телефон в 2026 и поставить на звонок

Создать песню ИИ на телефон можно без студии и нот: ставите приложение Suno, описываете трек словами и через минуту слушаете два варианта. Дальше файл режется до 30 секунд и превращается в рингтон. Ниже разбираем Android и iPhone, что поменял запуск…

2026/10/0611 мин
📄 Статья

Миграции базы данных для новичка: как менять схему без потери данных

Миграции базы данных — это версионированные скрипты, которые переводят схему БД из одного состояния в другое без ручных правок и без потери данных. Разберем, зачем они нужны, чем отличаются Alembic, Drizzle и Prisma migrate, и что делать, если миграц…

2026/10/0610 мин
📄 Статья

Локальный ИИ на телефоне без интернета в 2026 честные цифры

Локальный ИИ на телефоне без интернета ставится примерно за десять минут: одно приложение из трех, модель весом 1-4 ГБ, авиарежим. На флагмане 2025-2026 годов это 15-26 токенов в секунду, на бюджетнике около трех, и разница чувствуется сразу. Ниже ра…

2026/10/0112 мин
📄 Статья

SonarQube в 2026: что это, редакции и как запустить первый анализ кода

SonarQube это платформа автоматического ревью кода, которую вы ставите на свой сервер. Она прогоняет исходники через набор правил и показывает баги, уязвимости и запахи кода в 30+ языках, а потом встраивается в CI и блокирует сборку, если новый код х…

2026/10/019 мин