Прием платежей через ЮKassa: как запустить оплату и не ошибиться с настройками

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

Команда «Интернет Касса» помогает интернет-магазинам, сервисам и подписочным проектам собрать платежный и фискальный маршрут: подобрать облачную кассу, связать ее с оплатой, проверить состав чека и провести приемочные тесты. Это особенно полезно, когда сайт, CRM и касса уже работают раздельно.

Кому подходит прием платежей через ЮKassa

Интернет-магазин с разовыми заказами

Для магазина на CMS выбирайте готовый модуль, если он передает номер заказа, товарные позиции, скидки, доставку и контакт покупателя. Проведите тестовый заказ со скидкой и доставкой: если в чеке вместо позиций появляется строка «Заказ №123», интеграцию нужно дорабатывать.

Если сайт еще проектируется, сначала определите путь «каталог — корзина — оплата — чек — возврат». В материале «Сайт с онлайн-оплатой и кассой: лендинг, каталог или интернет-магазин» разобраны варианты для продаж без лишней разработки.

Услуги и оплата по ссылке

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

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

Подписка и регулярные списания

Для подписки настройте не только повторное списание, но и согласие клиента, периодичность, отмену, дату прекращения доступа и обработку неуспешного платежа. Связывайте каждое списание с периодом услуги и заказом; при обязательной фискализации предусмотрите для него фискальный документ.

Как устроена схема оплаты, кассы и ОФД

Рабочая цепочка выглядит так: покупатель подтверждает оплату → ЮKassa обрабатывает платеж картой или через СБП → сайт либо CRM получает подтвержденный статус → касса формирует чек → чек уходит покупателю, а фискальные данные передаются через ОФД в ФНС.

ЮKassa — платежный контур, а не замена ККТ. Если для вашего расчета требуется фискализация, заранее подключите отдельную поддерживаемую схему с ККТ и ОФД. До запуска проверьте на тестовом платеже, кто формирует чек, как он доставляется покупателю и какой документ появляется при возврате.

Разделите этапы расчета: предоплата, зачет аванса, полный расчет и передача товара — это разные события заказа. Схемы для этих этапов собраны в статье «Когда пробивать кассовый чек при оплате и отгрузке». Официальные разъяснения и сервисы по ККТ доступны на сайте ФНС России.

Модуль, платежная ссылка или API: сравнение вариантов

Критерий Готовый модуль или ссылка Интеграция по API
Когда выбирать CMS, лендинг, ручные продажи услуг, быстрый запуск без разработчика. Собственная CRM, приложение, нестандартная корзина или личный кабинет.
Скорость запуска Выше, если модуль поддерживает вашу CMS и передает состав заказа. Ниже: нужны разработка, тестирование и обработка сбоев.
Оплата по ссылке Подходит для разовой услуги или счета, который создает менеджер. Нужна, если ссылки автоматически создает CRM или приложение.
Товарные позиции и чек Проверьте передачу позиций, скидок, доставки и контакта покупателя. Передавайте данные из своей системы и проверяйте ответы API.
Подписка Берите только при наличии нужного сценария регулярных платежей. Подходит для собственных тарифов, пауз, пробного периода и правил доступа.
Возвраты Проверьте изменение статуса заказа и формирование чека возврата в вашей схеме. Настройте отдельный сценарий возврата, журнал событий и защиту от повторных запросов.
Ответственный за поддержку Менее гибкая схема, зато меньше технических точек отказа. Больше контроля, но нужен разработчик, который следит за интеграцией.

Выбирайте модуль или ссылку, когда сценарий укладывается в «заказ — оплата — чек — возврат». Выбирайте API, когда стоимость считает ваша система, доступ открывается по событию оплаты или подписке нужна собственная логика. Базовые различия платежных инструментов разобраны в статье «Что такое онлайн-эквайринг и как принимать оплату на сайте».

Как выбрать схему под ваш бизнес

Магазин с выдачей товара. Свяжите заказ, онлайн-оплату и выдачу. Для сотрудников сделайте разные статусы «оплачен онлайн» и «оплата при получении», чтобы не пробить один расчет дважды.

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

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

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

Пошаговый запуск приема платежей через ЮKassa

  1. Подготовьте сайт или страницу продажи. Разместите реквизиты продавца, контакты, описание товара или услуги, оферту и правила возврата.
  2. Нарисуйте карту расчетов. Отдельно отметьте разовую оплату, предоплату, зачет аванса, доставку, подписку, отмену и возврат.
  3. Выберите фискальный маршрут. Определите, нужна ли ККТ для ваших расчетов, какая касса формирует документы и как она связана с ОФД. Не включайте оплату, пока не протестируете чек и возврат.
  4. Подключите способ оплаты. Для CMS установите совместимый модуль; для услуг настройте выпуск ссылок из заказа; для API создавайте платеж на сервере, а не в браузере клиента.
  5. Настройте безопасную обработку webhook. Примите уведомление, проверьте его подлинность способом, предусмотренным провайдером, и запросите актуальный статус платежа через API. Затем дедуплицируйте событие по идентификатору платежа и идемпотентному ключу, запишите результат в журнал и только после этого меняйте статус заказа или выдавайте товар и доступ.
  6. Сопоставьте заказ и чек. Проверьте сумму, позиции, скидки, доставку, признак способа расчета и контакт для электронного чека.
  7. Проведите приемку. Сделайте тестовую оплату и возврат. Сверьте платеж, статус заказа в CRM, чек, уведомление, выдачу доступа и его отключение после отмены.

Для API сохраните журнал входящих уведомлений и результат их обработки. При повторной доставке webhook система должна увидеть, что событие уже обработано, и не создавать новый платеж, новый заказ или повторный доступ.

Типичные ошибки при подключении

  • Оплату включили, но не выбрали кассовую схему. Чеки не формируются или содержат неверные данные. Назначьте кассу и ответственного за фискализацию, затем протестируйте каждый вид расчета до первых продаж.
  • Проверили возврат только в банке. Деньги ушли клиенту, но заказ и чек остались в статусе оплаты. Настройте одну цепочку: возврат платежа → изменение заказа → фискальный документ, если он предусмотрен вашей схемой.
  • Сайт доверяет странице успеха. Клиент может закрыть ее после успешной оплаты или открыть без подтвержденного платежа. Меняйте заказ только после webhook, проверки подлинности и сверки статуса платежа через API.
  • Корзина не совпадает с чеком. В чеке появляется общая позиция, неверная сумма или пропадает доставка. Проверьте поля заказа и фискализации на тестовой покупке со скидкой и доставкой.
  • У подписки нет понятной отмены. Это увеличивает обращения и возвраты. Добавьте видимую отмену, записывайте дату отключения и проверяйте, что после нее новое списание не создалось.

Частые вопросы

Нужна ли онлайн-касса для приема платежей через ЮKassa?

Да, если ваш расчет с физлицом подпадает под требования 54-ФЗ. ЮKassa обеспечивает платежный контур и не заменяет ККТ: до старта выберите поддерживаемую схему фискализации, назначьте кассу, которая формирует чек, и протестируйте оплату и возврат.

Можно ли принимать платежи через ЮKassa без интернет-магазина?

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

Подходит ли ЮKassa для подписок и регулярных списаний?

Да, если подключенный сценарий поддерживает рекуррентные платежи. До первой оплаты настройте согласие клиента на списания, отмену подписки, дату отключения доступа и обработку неуспешного платежа.

Что проверить перед запуском приема платежей через ЮKassa?

Сделайте тестовую оплату, возврат и проверку чека. Затем сверьте сумму и позиции заказа, статус в CRM, серверное уведомление, статус платежа в личном кабинете и прекращение или выдачу доступа.

Хотите получить готовую карту запуска? Перед обращением подготовьте адрес сайта, CMS или CRM, способы оплаты, тип продаж — товары, услуги или подписка — и текущую кассовую схему. Специалисты «Интернет Касса» разберут, нужен ли модуль или API, где подключить фискализацию и какие тесты провести до старта. Связаться с нами.