ЮKassa
Платёжная платформа для онлайн-оплаты на сайте и в приложении. Гостя перенаправляют на платёжный шлюз Ю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 СБП не подключает.
Связанные статьи
- Онлайн-оплата заказа
- Сохранённые карты гостя
- Сплитование платежей по корнерам
- Фудмолл: родительская точка и корнеры
- Возвраты
- Фискальные параметры чека
- Правовые документы как страницы сайта