ПОДКЛЮЧЕНИЕ ИНТЕРНЕТ-ЭКВАЙРИНГА ЮКАССА ДЛЯ ЮРИДИЧЕСКОГО ЛИЦА
переход на эквайринг Юкасса с эквайринга СБЕР (Ecom)
подключение эквайринга Юкасса с сохранением инфраструктуры продаж
технический гайд
ОБЩАЯ ИНФОРМАЦИЯ
ЧТО ПОДГОТОВИТЬ ЗАРАНЕЕ
ПОСЛЕДОВАТЕЛЬНОСТЬ ДЕЙСТВИЙ
ПЕРЕХОД НА ЮКАССА ОТ СБЕР / ПОДКЛЮЧЕНИЕ И НАСТРОЙКА ЮКАССА
В 2023-2024 гг. СБЕР активно принуждает клиентов переходить на интернет-эквайринг своего дочернего предприятия - Юкасса
(ООО НКО "ЮМани". Лицензия Банка России №3510-К).
В этом гайде описано, как в платформе BIL24 осуществить переход на Юкасса с сохранением инфраструктуры продаж (агент, интерфейсы, фискальные данные, интеграция с сайтом), как минимизировать
время простоя при таком переходе. Гайд содержит информацию о том, какие проблемы и неожиданности могут возникнуть в процессе подключения Юкасса, как все правильно настроить,
как сохранить интеграцию с ОФД и действующую онлайн-кассу.
Для перехода или подключения Юкасса в BIL24 понадобится:
1. Доступ в СБЕР бизнес-онлайн (ЛК для юридических лиц) и доступ в СБЕР-онлайн для физических лиц по СБЕР-ID для руководителя предприятия.
2. Адрес электронной почты (e-mail).
3. Сайт, доменное имя которого будет указано в Юкассе.
4. Доступ в личный кабинет Оператора Фискальных Данных (ОФД), в котором зарегистрирована онлайн-касса (ОФД из данного руководства - ofd.ru,
ИНН 7841465198, ООО «ПЕТЕР-СЕРВИС Спецтехнологии»). Необходимо знать настройки онлайн-кассы, такие как: признак расчета, налоговая система, политика по НДС и др.
5. Доступ в Приложение Manager платформы BIL24.
Если все вышеперечисленное есть, можно двигаться дальше.
1. Останавливаем работу с эквайрингом Ecom от СБЕР (если не используется, пропускаем этот шаг).
2. В Личном Кабинете (ЛК) СБЕР Бизнес-Онлайн выполняем подключение к платежному сервису Юкасса.
3. Выполняем переход в ЮКасса с переносом данных из СБЕР Бизнес-Онлайн и СБЕР-Онлайн для руководителя. Получаем доступ в ЛК ЮКасса.
4. Заполняем данные в ЛК Юкасса для тестового магазина ЮКасса. В тестовой зоне BIL24 создаем событие. В Приложение Manager BIL24 (Тестовая зона) создаем новый эквайринг ЮКасса для вашего Агента.
Подписываем договор с ЮКасса. Выполняем тестовый платеж: покупаем билеты на тестовое событие.
5. Повторяем действия из п.4. в реальной зоне BIL24, с реальным (не тестовым) магазином Юкасса. Дополнительно выполняем интеграцию с ОФД, делаем настройки для корректной работы онлайн-кассы.
6. Выполняем реальный платеж, покупаем билеты на реальное событие. Контролируем корректность работы сервисов ЮКасса, ОФД, BIL24.
ПЕРЕХОД НА ЮКАССА ОТ СБЕР / ПОДКЛЮЧЕНИЕ И НАСТРОЙКА ЮКАССА
Сервис Юкасса входит в экосистему Сбер. Заходим в веб банк-клиент (ЛК) СБЕР-Бизнес. На странице «Все продукты и услуги» в разделе «Прием платежей» находим "Интернет-эквайринг ЮKassa. Прием платежей онлайн." Заходим и нажимаем "Подключить" (рис.1).
рис.1
Соглашаемся с условиями предоставления сервиса. Свое согласие нужно подтвердить кодом из смс, которое поступит на зарегистрированный в СБЕР-Бизнес телефон (рис.2).
рис.2
На следующем шаге будет предложено перенести в ЮКассу данные руководителя. Нужно зайти в ЛК физического лица СБЕР-онлайн по СБЕР ID (рис.3).
рис.3
Далее, тем или иным способом, нужно продолжить регистрацию в ЮКассе. Например, можно нажать кнопку "Перейти к регистрации" в полученном письме (рис.4).
рис.4
При входе в ЮКассу оказываемся на странице, где пока есть только тестовый магазин. Выбираем внизу слева «Вернуться к регистрации» (рис.5).
рис.5
Дальше необходимо указать, что регистрируетесь как Юридическое лицо и ввести его ИНН (рис.6).
рис.6
На следующей странице выбираем Онлайн. Платежи на сайте (рис.7).
рис.7
Здесь необходимо указать адрес своего сайта (строка типа "https://yoursite111.ru/"). ЮКасса будет проводить проверку указанного сайта. Внимательно прочитайте, что должно быть на вашем сайте. Помните - пока все действия происходят в тестовой зоне. Рекомендуем указывать доменное имя для тестового сайта отличное от реального (рис.8).
рис.8
Пока ЮКасса проводит проверку вашего сайта, перейдем слева в позицию "Интеграция". Выбираем ниже "Интеграция при переходе из Сбера" (рис.9).
рис.9
По умолчанию переходим на интеграцию по API ЮКасса. Выбирать API Сбера не рекомендуем по целому ряду причин. Например, будет необходимо переделать авторизацию, решить проблемы с временем жизни заказа, не будет возможности использовать некоторые популярные методы платежей (рис.10).
рис.10
После выполнения регистрационных действий в ЛК ЮКасса, необходимо немного подождать, пока проводится проверка. После окончании проверки приедет письмо, и появится возможность подписать договор. Подписание договора и другие юридически значимые действия, например, выпуск секретного ключа для реальной зоны, подтверждаются через ввод кода, полученного смс сообщением на номер телефона, указанный при регистрации (рис.11).
рис.11
Первый этап заканчивается после получения письма подтверждающего заключение договора. Следующий этап - выполнение тестового платежа в тестовых зонах ЮКасса и BIL24 (рис.12). Если, по каким-то причинам, регистрация в ЮКасса прервется - то слева в меню ЛК будет пункт о продолжении заполнения Анкеты и регистрации.
рис.12
Целью следующего этапа является проведение тестовой покупки билетов на событие из тестовой зоны BIL24. Все действия необходимо совершать с тестовым магазином Юкасса с одной стороны,
и в тестовой зоне BIL24 с другой.
Необходимо войти в Личный кабинет пользователя Юкасса (рис.13) и войти в тестовый магазин. Попасть на экран с синим фоном (рис.13) можно нажав "галочку" вниз у названия организации вверху слева.
рис.13
1. Меню Личного кабинета.
2. Данные пользователя (ИНН, ФИО).
3. Выбор тестового магазина с идентификатором shopid. При нажатии на это поле откроется раздел Настройки, где будет секретный ключ для API.
4. Реальный (основной) магазин, функционально аналогичный тестовому магазину, но для реальных продаж.
Магазинов с разными shopid здесь может быть несколько. Нажимаем на поле тестового магазина и получаем доступ к Секретному ключу API для тестов (рис.14).
рис.14
Секретный ключ начинается со подстроки "test_", его нужно скопировать и вставить в соответствующее поле при добавлении эквайринга в приложении Менеджер платформы BIL24 (рис.15).
Также нужно скопировать и вставить shopid. Выберите Платежный шлюз: [11] Юкасса. Обратите внимание, что надпись «Тестовая зона» в заголовке окна указывает на то,
что Менеджер подключен к тестовой зоне платформы BIL24. Для входа в тестовую зону платформы BIL24 необходимо в окне авторизации нажать Alt-Z. В левом нижнем углу окна появятся красные буквы «ТЗ».
рис.15
Получение Секретного ключа для реальной зоны будет незначительно отличаться: его выпуск нужно будет подтвердить кодом из смс, и он показывается на экране не полностью,
но его точно также можно скопировать и вставить в поле приложения Менеджер платформы BIL24. После выпуска реального секретного ключа приходит соответствующее сообщение.
На последнем шаге настройки тестового магазина Юкасса выберите слева "Онлайн-касса" и отключите справа "Режим проверки чеков" (рис.16).
рис.16
Итак - тестовый эквайринг Юкасса ДОБАВЛЕН к учетной записи Агента в тестовой зоне BIL24. В приложении Менеджер привяжите этот Эквайринг к Организатору (вкладка Дов. агенты), сконфигурируйте подписки. Зайдите на указанную Вами страницу тестового магазина и выполните тестовый платеж в Юкассу, купив билет на тестовое событие.
На рис.17, 18, 19 показано, как будет выглядеть для клиента платежная страница ЮКассы, и последующие страницы при выполнение тестового платежа. Используйте для платежа данные тестовой карты, например:
4111 1111 1111 1111
12/2025
123
Код подтверждения: 12345678
рис.17
рис.18
рис.19
Следующий этап - настройка интернет-эквайринга, ОФД и онлайн-кассы в реальной зоне BIL24 и ЮКасса.
На этом этапе в ЛК ЮКассы выполняются все действия, которые ранее выполнялись в тестовой зоне. Необходимо создать реальный магазин, задать данные сайта, на котором будут производиться реальные продажи.
Важно, чтобы домен сайта для реальных продаж, отличался от домена тестового сайта (тестового магазина). Нужно скопировать в ЛК ЮКассы данные реального магазине: shopid и секретный ключ
(необходимо выпустить и подтвердить кодом из смс сообщения), и вставить эти данные в соответствующие поля вкладки "Эквайринги" приложения Менеджер, подключенного к реальной зоне BIL24.
Далее дополнительно в ЛК Юкассы для реального магазина необходимо настроить разделы: "Интеграция" --> "HTTP-уведомления" и "Настройка" --> "Онлайн-касса".
Для быстрой и стабильной обработки заказов покупателей необходимо настроить отправку HTTP-уведомлений.
Крайне важно правильно указать URL для уведомлений: https://api.bil24.pro/callback/yookassa
Действие выполняется на странице «Интеграция / HTTP-уведомления». Указываете URL для уведомлений и в разделе "О каких событиях уведомлять" включаете все события (рис.20).
рис.20
На последнем шаге в ЛК Юкасса (раздел «Настройки / Онлайн-касса») необходимо настроить интеграцию с ОФД и зарегистрированной онлайн-кассой, если таковая есть. Если рабочей онлайн-кассы нет, можно попробовать воспользоваться сервисом, который предлагает ЮКасса (рис.21). В рамках этого гайда рассмотрен случай, когда существует зарегистрированная в ФНС и оплаченная онлайн-касса с действующим и незаполненным фискальным накопителем. Касса подключена к ofd.ru, и необходимо настроить интеграцию Юкассы и данного ОФД.
рис.21
После ответа, что онлайн-касса есть, на следующем экране предлагается выбрать сервис (ОФД), где онлайн-касса установлена. Важно, что настроить автоматическую отправку данных для чеков можно только с партнером ЮКассы. Ознакомиться со списком партнеров можно на сайте https://yookassa.ru/54fz/ в разделе "Облачные онлайн-кассы". В нашем примере популярного сервиса FERMA от OFD.RU (рекомендованного СБер) в списке нет. Это значит, что придется использовать имеющийся в списке сервис-посредник RocketR (рис.22) Забегая вперёд - параметры подключения берем из ЛК ROCKETR.RU (рис.26).
рис.22
Регистрируемся в сервисе RocketR указывая нужный ОФД - Ferma OFD.ru, и платежный сервис ЮКасса (рис.23). Для регистрации необходим почтовый ящик, на который придет письмо для активации сервиса. Внимание - сообщение об активации приходит не на все почтовые домены! После активации вас ждет стандартная процедура установки пароля для доступа к ЛК RocketR.
рис.23
В личном кабинете RocketR выполняем настройку онлайн-кассы, перенося, как указано на рис.24 параметры из ЛК сервиса Ferma OFD.ru в соответствующие поля для настройки онлайн-кассы в RocketR. Далее указываем настройки кассы - ИНН предприятия, налоговую систему (в нашем случае УСН), платеж за товар или услугу, с НДС или без, признак расчета (в нашем случае "Полный расчет", рис.25).
рис.24
рис.25
Подобным образом выполняем настройки платежной системы ЮКасса, перенося (копируя) данные из соответствующих полей сервиса RocketrR в поля платежного сервиса ЮКасса (рис.23, рис.26).
рис.26
Внимание!
Настройки онлайн-кассы для фискализации в личном кабинете ЮКассы применяются не моментально. Обычно, применение настроек происходит в течение 3-10 минут, поэтому после того, как все настроено, нужно немного подождать,
прежде чем выполнять покупку билетов.
Финальные настройки в Юкассе:
Параметр "Что делать с платежом если чек не доставлен" в ЛК ЮКасса должен быть установлен в позиция "Не связывать платеж и чек" (рис.27).
рис.27
Следует отметить, что платформа BIL24 ожидает, что чек будет сформирован (зарегистрирован) и доставлен покупателю.
В противном случае BIL24 отменит покупку и автоматически оформит возврат полученных средств и билета.
Чтобы связать эквайринг с событиями, заведенными под учетной записью организатора в платформу BIL24, необходимо войти в приложение Менеджер используя данные пользователя с ролью Организатор, открыть вкладку
«Дов. Агенты» (доверенные агенты), и выбрать в строке Базовый агент (эквайринг) того Агента, которому добавили эквайринг Юкасса.
После этого действия, эквайринг Юкасса добавлен в платформу BIL24 и готов к работе!
Выполните реальный платеж в реальной зоне для реального события.
Контролируйте, что покупателю поступит чек и билет, после выполнения платежа загрузиться страница успешного выполнения платежа,
в приложение Отчеты платформы BUK24 статус операции продажи станет «оплачен». Также можно проконтролировать логи в Личных кабинетах ОФД, ЮКассы и сервиса ROCKETR.