Главная Интеграции Эквайринг ЮKassa

ЮKassa

Обновлено Oct 21, 2026

Платёжная платформа для онлайн-оплаты на сайте и в приложении. Гостя перенаправляют на платёжный шлюз ЮKassa. Всё, что принято за банковский день, ЮKassa перечисляет на расчётный счёт заведения на следующий день за вычетом комиссии (тарифы — yookassa.ru/fees).

Для клиентов Смартомато действует спецпредложение: комиссия 2,5% на карты и готовые кошельки ЮMoney и SberPay. Условие — регистрация по реферальной ссылке https://yookassa.ru/joinups/?source=smartomato.

Новым клиентам ЮKassa доступны собственные чеки: ЮKassa передаёт данные о платежах в онлайн-кассу партнёра, а та отправляет чеки через ОФД в налоговую и покупателю. Комиссия — от 0,1% за чек сверх комиссии за платёж. Онлайн-касса, фискальный накопитель и регистрация в налоговой не нужны.

Сбербанк новых клиентов больше не подключает, их подключают через ЮKassa (см. СберОнлайн).

Что нужно до подключения

  • Зарегистрированный бизнес: ИП, ООО или НКО. К счёту физлица эквайринг не подключить.
  • Расчётный счёт для бизнеса в любом российском банке.
  • Сайт компании, страница в соцсетях или мобильное приложение.
  • Заявку подают только на конечный домен заведения.

Шаги на стороне ЮKassa

  1. Зарегистрироваться на yookassa.ru и заключить договор, выбрав приём платежей на сайте.
  2. Создать тестовый магазин: «Настройки» → «Магазин» → «Добавить магазин». Появятся shopId и тестовый секретный ключ API.
  3. Провести тестовый платёж и сообщить менеджеру ЮKassa, что тесты прошли и нужен перевод в боевой режим.
  4. После перевода в бой ЮKassa выдаёт новые shopId и секретный ключ: «Интеграция» → «Ключи API».
  5. Настроить HTTP-уведомления: «Интеграция» → «HTTP-уведомления».
    • «URL для уведомлений» — https://smartomato.ru/webhooks/yandex_checkout/event;
    • в «О каких событиях уведомлять» включить payment.succeeded и waiting_for_capture.
    • Зачем: по нему Смартомато узнаёт, что платёж прошёл, и отмечает заказ оплаченным — см. Онлайн-оплата заказа.
  6. Если заведение работает с двухстадийной оплатой, попросить ЮKassa включить автоклиринг по окончании срока холда. Зачем: по статье, без подтверждения ЮKassa возвращает удержанный платёж, а автоклиринг списывает его по окончании холда — см. Возвраты. Статья требует сказать об этом клиенту обязательно и даёт текст обращения: «Включите нам автоклиринг по окончании срока холда».

Дополнительные способы оплаты: SberPay, СБП и другие

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

Сохранение карт (рекуррентные платежи)

  1. Сначала на сайте должна появиться страница с инструкцией, как гостю удалить сохранённую карту. Это обязательное требование ЮKassa. Пример: https://delivery.portomykonos.ru/terms.
  2. Клиент пишет в ЮKassa и просит подключить рекуррентные платежи.
  3. В ответ ЮKassa просит скриншоты сайта, на которых видно, как пользователь сам отвязывает карту. URL сайта на скриншотах должен быть виден.
  4. Менеджер ЮKassa передаёт заявку в службу безопасности. Проверка занимает в среднем 1–2 дня.

Сплитование платежей (только фудмоллы)

От ЮKassa нужны account_id ресторанов-получателей, от клиента — процент комиссии с каждого блюда. Зачем: так оплата фудмолла разносится по счетам корнеров — см. Сплитование платежей по корнерам.

Признак агента и ИНН поставщика

В личном кабинете ЮKassa, в разделе «Настройки — Онлайн-касса», выбрать режим «Не связывать чек и платёж». Зачем: без него признак агента и данные поставщика в чек не передать — см. Фискальные параметры чека. Если клиент работает через «Безопасную сделку», этот сценарий уже подключён по умолчанию.

Тестовая карта

5555 5555 5555 4477, CVV 123, срок — любая дата в будущем. Если карта не проходит, актуальные тестовые карты — на странице ЮKassa.

Что передать в Смартомато

  • shopId и секретный ключ API: сначала тестовые, после перевода в бой — боевые.
  • Подтверждение, что включён демо-режим (тестовый магазин).
  • Ставку НДС и систему налогообложения.
  • Для сплитования — account_id ресторанов и процент комиссии.
  • Для агентской схемы — признак агента, ИНН, название и телефон поставщика.
  • Реквизиты юрлица для страницы с контактами, реквизитами и условиями на сайте.

Типовые ошибки и вопросы клиентов

  • В каких странах можно подключить ЮKassa? В любой стране, где есть хотя бы один банк, готовый работать с ЮKassa, чтобы она могла отправлять туда платежи. В основном это страны СНГ, Китай и Турция. В Абхазии главное — открыть счёт в банке, который работает с ЮKassa: PJSCB UNIVERSAL BANK, ЗАО «Аврора Банк», КБ «Гарант-банк», KB Kibit-Bank.
  • Эквайринг заблокирован после смены домена. В заявке был org.smartomato.ru, потом подключили org.ru: ЮKassa видит, что сайт из заявки недоступен, и подключение приходится проходить заново.
  • Не работает СБП. При двухстадийной оплате ЮKassa СБП не подключает.

Связанные статьи