ЮKassa
Подключите ЮKassa, чтобы покупатели могли оплачивать заказы интернет-витрины онлайн. Для настройки понадобятся идентификатор магазина и секретный API-ключ из личного кабинета ЮKassa. Если в ЮKassa используется онлайн-касса, Mercury также передаёт данные для формирования чека. Ниже описаны настройки и порядок подключения.
Настройки в Mercury
Откройте Розница → Интернет-витрина → Оплаты. Включите оплату заказов, выберите в поле «Платёжная система» вариант «ЮKassa». После выбора появятся поля для подключения.
shopId
Идентификатор вашего магазина в ЮKassa. Он указывает, от имени какого магазина будут создаваться платежи.
Скопируйте значение из личного кабинета ЮKassa и вставьте его в поле shopId.
Секретный ключ
Секретный API-ключ, который используется для взаимодействия Mercury с ЮKassa. Это конфиденциальные данные: не передавайте ключ посторонним и не публикуйте его.
Вставьте ключ из личного кабинета в поле «Секретный ключ».
После сохранения значение не отображается в форме. Если при повторном открытии поле пустое, это не означает, что ключ удалён. Пустое поле при повторном сохранении означает, что ранее сохранённый ключ нужно оставить без изменений. Вводите новый ключ только при необходимости заменить старый.
Сохранение
Перед сохранением проверьте, что:
- включён параметр «Включить оплату заказов витрины»;
- в качестве платёжной системы выбрана ЮKassa;
- указан правильный shopId;
- введён секретный ключ.
Нажмите «Сохранить» в блоке онлайн-оплаты.
После сохранения настройте уведомления в личном кабинете ЮKassa. Для этого понадобится URL уведомлений из настроек интернет-витрины. Подробнее — в разделе URL уведомлений.
Где получить данные в ЮKassa
- Откройте сайт ЮKassa и войдите в личный кабинет.
- Откройте настройки нужного магазина и найдите раздел с параметрами API.
- Скопируйте идентификатор магазина shopId.
- Получите секретный ключ и скопируйте его.
- Вернитесь в Mercury: Розница → Интернет-витрина → Оплаты.
- Выберите ЮKassa, вставьте идентификатор и секретный ключ в соответствующие поля.
- Нажмите «Сохранить».
Настройка HTTP-уведомлений
Чтобы Mercury получал информацию об успешных платежах, укажите адрес уведомлений в настройках ЮKassa:
- Скопируйте URL уведомлений в блоке оплаты интернет-витрины Mercury.
- Откройте настройки HTTP-уведомлений в личном кабинете ЮKassa.
- Добавьте скопированный адрес.
- Включите уведомление об успешном платеже.
Адрес берётся из настроек Mercury, а не вводится вручную. Подробная инструкция: URL уведомлений.
Онлайн-касса и чеки
Если в ЮKassa подключена и настроена онлайн-касса, Mercury передаёт данные для формирования кассового чека при создании платежа.
Какие данные передаются
- Состав заказа — товары и позиции, которые покупатель оплачивает.
- Телефон или электронная почта покупателя — контактные данные для чека.
Телефон покупателя обязателен при оформлении заказа через интернет-витрину и бот. Убедитесь, что покупатель указывает корректный номер.
Ставка НДС
По умолчанию в передаваемых данных для чека используется ставка «Без НДС».
Если ваша организация должна применять другую ставку НДС, согласуйте её настройку в личном кабинете ЮKassa до начала приёма платежей.