UDS · инструкция

Подключение ЮKassa к интернет-магазину на UDS

Чтобы покупатель платил картой прямо в вашем магазине, а деньги приходили на ваш счёт, ЮKassa и UDS нужно связать между собой. Ниже десять шагов со скриншотами каждого экрана: что нажать в кабинете ЮKassa, что в профиле UDS Бизнес и в каком порядке.

10 шагов скриншот каждого экрана оплата картой и СБП чеки по 54-ФЗ
Удобнее в PDF? Та же инструкция одним файлом: можно открыть на телефоне и настраивать на компьютере.
Скачать PDF PDF, 1,2 МБ
Ещё нет профиля на платформе? Инструкция рассчитана на тех, у кого уже есть UDS Бизнес с подключённым модулем «Интернет-магазин». Если профиля нет, начните с пробного доступа: начать бесплатно, а потом возвращайтесь к шагу 1.

Что будем делать

Первые четыре шага проходят в кабинете ЮKassa, дальше подключение идёт из профиля UDS Бизнес и один раз возвращает нас обратно в ЮKassa.

Обратите особое внимание на шаги 9 и 10. Именно они отвечают за обмен данными между ЮKassa и UDS: если их пропустить, платежи будут проходить, а заказ в магазине так и останется неоплаченным и без чека.

Десять шагов

1

Регистрация в ЮKassa

Зарегистрируйтесь в сервисе или войдите, если аккаунт уже есть.

Зарегистрироваться в ЮKassa

2

Договор в личном кабинете

Кабинет проведёт вас по шагам сам: заполнить данные для договора, дождаться проверки, подписать. Пока договор не подписан, ключи для подключения не выдаются.

Личный кабинет ЮKassa: прогресс подключения и блок «Заключите договор»
3

Приём платежей «На сайте»

В графе «Приём платежей» выберите «На сайте». В поле «Адрес вашего сайта» укажите доменное имя из раздела «Веб-сайт» профиля UDS Бизнес.

Выбор способа приёма платежей «На сайте» и поле для адреса сайта

Заодно в описании компании в профиле UDS Бизнес добавьте юридическую информацию в свободной форме: наименование юридического лица, ИНН, ОГРН. ЮKassa сверяет эти данные при проверке.

4

Чеки

В разделе «Чеки» выберите «Включить чеки от ЮKassa» и заполните форму. Если у вас уже есть своя онлайн-касса, здесь же можно выбрать её вместо чеков от ЮKassa.

Раздел «Чеки» в ЮKassa: выбор между чеками от ЮKassa и своей онлайн-кассой
5

Онлайн-оплата в профиле UDS

Когда кабинет ЮKassa готов принимать платежи, переходите в профиль UDS Бизнес.

Настройки → модуль «Интернет-магазин» → вкладка «Способы оплаты» → «Подключить»

Профиль UDS Бизнес: настройка интернет-магазина, вкладка «Способы оплаты»
6

Выбор сервиса

В открывшемся окне выберите провайдера «ЮKassa».

Окно выбора платёжного провайдера в UDS: Cloudpayments и ЮKassa
7

ShopID и секретный ключ

На открывшейся странице заполните поля «ShopID (идентификатор магазина)» и «Секретный ключ» и нажмите «Отправить».

Карточка ЮKassa в UDS: поля ShopID и секретный ключ, кнопка «Отправить»

ShopID лежит в кабинете ЮKassa: «Настройки» → «Магазин», блок «О магазине».

Кабинет ЮKassa, раздел «Магазин»: поле shopId

Секретный ключ выпускается там же: «Интеграция» → «Ключи API» → «Секретный ключ». Ключ показывается один раз, скопируйте его сразу.

Кабинет ЮKassa, раздел «Ключи API»: секретный ключ

Не находится ключ, нужна помощь

8

URL для уведомлений

После того как ShopID и секретный ключ приняты, скопируйте URL для уведомлений соответствующей кнопкой и нажмите «Отправить». Этот адрес понадобится на следующем шаге, держите его под рукой.

Карточка ЮKassa в UDS: кнопка копирования URL для уведомлений
9

HTTP-уведомления

Ключевой шаг: без него UDS не узнает об оплате

Вернитесь в кабинет ЮKassa: «Интеграция» → «HTTP-уведомления» → «Изменить настройки».

Кабинет ЮKassa: раздел HTTP-уведомления, кнопка «Изменить настройки»

В поле «URL для уведомлений» вставьте адрес, скопированный на шаге 8, и включите три события:

  • успешный платёж;
  • отмена платежа или ошибка оплаты;
  • успешный возврат денег покупателю.

Нажмите «Сохранить».

Окно «Настройки уведомлений» в ЮKassa: URL и выбранные события

Уведомления не приходят, нужна помощь

10

Электронные чеки

Ключевой шаг: без него чек покупателю не уйдёт

Последняя настройка снова в профиле UDS Бизнес.

Модуль «Интернет-магазин» → вкладка «Чеки»

Заполните «Информация о компании», «Информация о товарах», «Информация о доставке» и нажмите «Сохранить».

Профиль UDS Бизнес: вкладка «Чеки» модуля интернет-магазина

Обратите внимание на подсказки справа: товары с маркировкой пока не поддерживаются, а возврат по операции делается через кабинет ЮKassa и дублируется в UDS Бизнес.

Чеки не формируются, нужна помощь

Как проверить, что всё связалось

Сделайте пробный заказ в своём магазине на минимальную сумму и оплатите его картой. Правильно настроенная связка выглядит так:

1
Платёж прошёл, деньги видны в кабинете ЮKassa.
2
Заказ в UDS Бизнес сменил статус на оплаченный сам, без ручного подтверждения.
3
Покупателю пришёл электронный чек.
4
Возврат по этому заказу проходит и отражается в обеих системах.

Заказ оплачен, а в UDS висит неоплаченным - вернитесь к шагу 9. Заказ оплачен, но чека нет - к шагу 10.

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

Что сделать в первую очередь: завести ЮKassa или настроить магазин на UDS?

Начните с ЮKassa. Пока кабинет не готов принимать платежи, подключить оплату в профиле UDS не получится: на шаге 7 понадобятся ShopID и секретный ключ, они появляются только после заключения договора.

Какой адрес сайта указывать в ЮKassa?

Доменное имя из раздела «Веб-сайт» профиля UDS Бизнес. Туда же, в описание компании, добавьте наименование юридического лица, ИНН и ОГРН, иначе ЮKassa попросит это при проверке.

Где взять ShopID и секретный ключ?

ShopID лежит в кабинете ЮKassa в разделе «Настройки» - «Магазин», блок «О магазине». Секретный ключ выпускается в разделе «Интеграция» - «Ключи API». Ключ показывается один раз, сохраните его сразу: если потеряете, придётся выпускать заново.

Почему не проходит обмен данными между ЮKassa и магазином?

В девяти случаях из десяти дело в шаге 9. В ЮKassa должен быть прописан ровно тот URL для уведомлений, который вы скопировали в профиле UDS на шаге 8, и включены три события: успешный платёж, отмена платежа или ошибка оплаты, успешный возврат денег покупателю.

Обязательно ли подключать чеки от ЮKassa?

Чеки нужны по 54-ФЗ. Можно взять их у ЮKassa на шаге 4, а можно подключить свою онлайн-кассу. Если берёте чеки от ЮKassa, на шаге 10 останется заполнить в UDS информацию о компании, товарах и доставке, иначе чек не сформируется.

Сколько стоит приём платежей?

Ставку назначает сама ЮKassa, она зависит от оборота и способов оплаты и видна в вашем кабинете при заключении договора. UDS за продажи через ваш магазин комиссию не берёт.

Товары с маркировкой поддерживаются?

Нет, на момент выпуска инструкции товары с маркировкой в электронных чеках не поддерживаются. Об этом предупреждает и сам кабинет на вкладке «Чеки».

Застряли на каком-то шаге?

Оставьте заявку и напишите номер шага: подключим ЮKassa за вас и проверим, что заказы оплачиваются и чеки уходят. Если вопрос короткий, быстрее написать боту.

Настроили оплату - дальше нужны продажи В канале разбираем, как владельцу вернуть покупателя без скидок: что включить в программе лояльности, какие рассылки работают, что нового в платформе. Коротко, по делу, с цифрами из живых магазинов.
Читать канал