Подключение YooKassa: документы, проверка, настройки и быстрый старт

Подключение YooKassa: документы, проверка, настройки и быстрый старт

Введение и кому подойдет YooKassa

YooKassa — один из самых распространенных эквайрингов и платежных агрегаторов в России. Он подходит интернет‑магазинам, сервисам, SaaS‑проектам, подпискам и маркетплейсам. Через него вы принимаете карты, СБП, электронные кошельки и другие методы оплаты, а также автоматизируете чек от онлайн‑кассы по 54‑ФЗ.

Если вы впервые изучаете сервис, начните с краткого обзора возможностей на странице Обзор YooKassa.

![Схема подключения YooKassa по шагам]

Пошаговая схема: как подключить YooKassa и пройти youkassa ru регистрация

1. Регистрация. Создайте аккаунт и укажите тип бизнеса: юрлицо, ИП или самозанятый. Для доступа к настройкам используйте Личный кабинет или раздел для ИП — Личный кабинет ИП.
2. Анкета мерчанта. Заполните сведения о компании, сайте, товарах и рисках — это основа для комплаенс‑проверки.
3. Загрузка документов. Подготовьте пакет документов YooKassa согласно вашему типу регистрации.
4. Тестовая интеграция. Проверьте платежи в песочнице, подключите CMS‑модуль или API, проведите оплату, возврат и чек.
5. Модерация. Дождитесь проверки; при необходимости ответьте на уточняющие вопросы.
6. Юкасса активация магазина. Получите идентификатор магазина и секретный ключ, включите платежные методы.
7. Подключение платежей на сайт. Перейдите на прод, включите вебхуки, выполните контрольные операции и запустите трафик.

Документы YooKassa: что подготовить юрлицам, ИП и самозанятым

Подготовьте документы заранее — это самый частый стоп‑фактор на этапе подключения YooKassa.

Тип бизнеса	Что подготовить
ООО/АО	Учредительные документы, ИНН/КПП/ОГРН, устав или выписка ЕГРЮЛ, решение/приказ о назначении директора, банковские реквизиты, паспорт руководителя, сведения о бенефициарах, лицензии при необходимости
ИП	Свидетельство ОГРНИП, ИНН, выписка ЕГРИП, паспорт ИП, банковские реквизиты, лицензии для регулируемых видов деятельности
Самозанятый	Паспорт, ИНН, подтверждение статуса плательщика НПД в приложении Мой налог, банковские реквизиты

Плюс к юридическим документам подготовьте цифровую витрину:

• Домен и сайт с корректными страницами товара и корзиной
• Пользовательское соглашение, оферта, политика возвратов и обмена
• Контакты: полное наименование, ИНН, адрес, телефон, e‑mail
• Политика конфиденциальности и сведения о доставке

С вопросами по законодательству и чекам поможет раздел Фискализация 54‑ФЗ.

Yookassa анкета: как заполнить без ошибок

Анкета — это не просто формальность. От полноты и точности зависит скорость модерации.

Рекомендации:

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

Частые ошибки: несоответствие описания сайта и анкеты, отсутствующие документы, нерабочие ссылки, неполные реквизиты.

Проверка и модерация: сроки, что смотрят и как ускорить

Что проверяют:

• Правовой статус и благонадежность: учредители, лицензии, ограничения по видам деятельности
• Контент сайта: прозрачность условий, полнота информации, отсутствие запрещенных товаров
• Риски: chargeback‑профиль, схема оплаты, возвраты, рекуррентные списания

Типовые сроки и ориентиры:

Этап	Оценочный срок	Комментарии
Предрегистрация и анкета	15–30 минут	Приготовьте материалы заранее
Первичная комплаенс‑проверка	1–3 рабочих дня	Могут запросить доп. сведения
Доработки по сайту/докам	1–5 рабочих дней	Срок зависит от вашей скорости
Техническая проверка интеграции	0,5–1 день	Тесты в песочнице ускоряют активизацию
Активация магазина	В день одобрения	Получаете доступ к боевым ключам

Как ускорить: дайте полный пакет, заранее подготовьте сайт, сделайте тестовые платежи в песочнице и отправьте результаты менеджеру или через тикет.

Юкасса активация магазина и подключение платежей на сайт

После одобрения вы получаете идентификатор магазина и секретный ключ. Дальше — несколько финальных шагов:

• Включите нужные методы оплаты в кабинете и на стороне сайта
• Проверьте корректность редиректов и статусов платежа
• Настройте уведомления об успешных и неуспешных платежах
• Проведите контрольную оплату реальной картой на минимальную сумму

Если нужен двухэтапный сценарий оплаты с последующим списанием — настройте режим подтверждения платежа capture после оплаты через API.

Подробнее о доступных способах и их особенностях читайте в разделе Платежные методы. Актуальные ставки — в разделе Тарифы и эквайринг.

Настройки в личном кабинете: методы оплаты, тарифы, фискализация

Личный кабинет — центр управления подключением YooKassa:

• Методы оплаты. Включите карты, СБП и другие каналы. Для части методов может потребоваться отдельное согласование.
• Фискализация. Подключите вашу онлайн‑кассу или облачный сервис, задайте перечень признаков предмета расчета и НДС. Подробно — в разделе Фискализация 54‑ФЗ.
• Статусы и уведомления. Проверьте URL‑ы, куда приходят нотификации, и e‑mail для алертов.
• Финансы. Посмотрите комиссии и расписание выплат. Детали по зачислениям — в разделе Выплаты.

Чтобы быстрее освоиться с навигацией, воспользуйтесь путеводителем по кабинету: Личный кабинет и Личный кабинет ИП.

Интеграция: CMS, API, песочница и настройка вебхуков YooKassa

Способы интеграции:

• Готовые модули. Для популярных CMS и конструкторов есть готовые плагины. Установка обычно сводится к вводу shopId и секретного ключа и включению чеков. См. подборку в разделе CMS‑интеграции.
• Прямое API. Если нужна гибкость, используйте REST‑методы создания и подтверждения платежей, рекуррентные списания, возвраты и вебхуки. Документация — в разделе API.
• Песочница. Перед запуском проверяйте сценарии в безопасной среде — Sandbox: оплата, отмена, частичный и полный возврат, фискальные чеки.

Настройка вебхуков YooKassa:

1. Включите вебхуки в кабинете, укажите URL вашего обработчика на HTTPS
2. Выберите события: payment.succeeded, payment.waiting_for_capture, payment.canceled, refund.succeeded, payout.succeeded — под нужные сценарии
3. Сохраните секрет для уведомлений и храните его в защищенном хранилище
4. На стороне сервера проверяйте подлинность уведомления и состояние платежа через API по идентификатору из уведомления
5. Логируйте все запросы, реализуйте повторную обработку при временных ошибках

Лучшие практики:

• Принимайте только POST JSON, ограничьте методы и длину тела запроса
• Отвечайте 200 OK только после успешной обработки
• Не полагайтесь на IP‑списки, сверяйте статус платежа через API и подпись

![Пример уведомления вебхука YooKassa]

Мобильные SDK: iOS и Android

Для нативных приложений используйте готовые библиотеки — это ускоряет внедрение платежей, токенизацию карт и безопасное хранение данных. Детали и примеры — в разделе Mobile SDK.

Возвраты, выплаты и отчеты

• Возвраты. Делайте полные или частичные возвраты из кабинета или по API. Следите за статусами и чеками возврата. Подробнее — в разделе Возвраты и диспуты.
• Выплаты. Если вы маркетплейс или сервис с балансами у исполнителей — настройте массовые выплаты на карты/кошельки, подключите расписание и нотификации: Выплаты.
• Отчеты и сверки. Экспортируйте реестры, акты и сверяйте платежи с банком и кассой. Руководство по сверке — в разделе Отчеты и реконсиляция.

Безопасность и соблюдение требований

YooKassa сертифицирована по PCI DSS, использует шифрование и 3‑D Secure где это применимо. На вашей стороне:

• Не храните и не логируйте полные номера карт и CVV
• Ограничьте доступ к ключам, используйте секреты окружений
• Включите антифрод‑настройки и лимиты в кабинете
• Регулярно обновляйте CMS‑модуль и зависимости

Подробности — в разделе Безопасность и соблюдение.

Быстрый чек‑лист запуска

• Зарегистрируйтесь и заполните yookassa анкету без пропусков
• Подготовьте документы, страницы оферты, возвратов и контактов
• Проверьте сайт с чек‑листом комплаенса
• Настройте интеграцию через CMS‑интеграции или API
• Прогоните сценарии в Sandbox: оплата, отмена, возврат, чек 54‑ФЗ
• Включите вебхуки и проверьте обработку событий
• Активируйте магазин и методы оплаты, проведите боевую оплату
• Настройте отчеты и расписание выплат

Итоги и следующий шаг

Подключение YooKassa — это понятная последовательность шагов: регистрация, анкета и документы, техническая интеграция и активация. Чем тщательнее вы подготовите сайт и информацию заранее, тем быстрее пройдет модерация, а запуск займет дни, а не недели.

Готовы начать Приступайте к настройке и следуйте по разделам: от Платежных методов и Тарифов до API и Фискализации. Если нужен короткий путь — используйте CMS‑интеграции и стартуйте сегодня.