Сбер

Настройки в Mercury

Откройте Розница → Интернет-витрина → Оплаты. Включите оплату заказов и выберите в поле «Платёжная система» вариант «Сбер». После выбора появятся параметры подключения.

Логин API (userName)

Это имя пользователя для доступа к API платёжного шлюза Сбера. Оно выдаётся банком при подключении интернет-эквайринга.

Укажите значение userName, полученное от банка.

Пароль API

Пароль для доступа к API платёжного шлюза. Он используется вместе с логином API.

Важно: это отдельный пароль, который выдаётся для интеграции с платёжным шлюзом. Пароль от СберБизнес здесь не подходит.

После сохранения пароль не отображается в форме. Если при повторном открытии поле пустое, это не означает, что пароль удалён. Пустое поле при повторном сохранении означает, что ранее сохранённый пароль нужно оставить без изменений. Вводите новое значение только при необходимости заменить старое.

Контур API

Выберите среду, с которой будет работать Mercury:

• Боевой — подключение к рабочему платёжному шлюзу. Используется для приёма настоящих платежей от покупателей.
• Тестовый — подключение к тестовому шлюзу. Предназначено для проверки интеграции без использования рабочего платёжного контура.

У этих режимов разные адреса подключения и учётные данные. Ключи, выданные для одного контура, не работают в другом. Поэтому выбирайте режим, соответствующий полученным от банка логину и паролю.

Сохранение

Перед сохранением проверьте:

• включена ли оплата заказов интернет-витрины;
• выбран ли провайдер «Сбер»;
• правильно ли указаны логин и пароль API;
• соответствует ли выбранный контур выданным банком учётным данным.

Нажмите «Сохранить» в блоке онлайн-оплаты.

Договор и режим подключения

Для подключения необходим действующий договор интернет-эквайринга Сбера и доступ к платёжному шлюзу.

1. Оформите подключение интернет-эквайринга Сбера.
2. Получите у банка логин API userName и пароль API для доступа к платёжному шлюзу.
3. Уточните, для какого контура выданы учётные данные: тестового или боевого.
4. Откройте в Mercury раздел Розница → Интернет-витрина → Оплаты.
5. Выберите платёжную систему «Сбер».
6. Введите логин и пароль API, выберите соответствующий контур.
7. Нажмите «Сохранить».

Не путайте учётные данные. Для подключения Mercury нужны именно логин и пароль API платёжного шлюза. Обычные данные для входа в СберБизнес не подходят.

Если вы переходите с тестового режима на боевой, проверьте, что в Mercury выбран боевой контур и указаны соответствующие ему учётные данные.

Уведомления об оплате (Callback)

После проведения платежа Сбер должен сообщить Mercury о его результате. Для этого в настройках платёжного шлюза используется адрес уведомлений — Callback URL.

Как настроить уведомления

1. Сохраните настройки Сбера в Mercury.
2. В блоке онлайн-оплаты найдите поле «URL уведомлений».
3. Нажмите «Копировать», чтобы скопировать адрес.
4. Откройте настройки платёжного шлюза Сбера.
5. Укажите скопированный адрес в качестве адреса уведомлений.
6. Сохраните настройки на стороне банка.

Адрес имеет вид HTTPS-ссылки, доступной из интернета. В частности, адрес для Сбера содержит путь вида /public/vitrina/sber/notification/….

Mercury также передаёт этот адрес при создании платежа. Поэтому используйте именно URL, скопированный из настроек витрины, и не составляйте его самостоятельно.

Подробнее о назначении и настройке адресов: URL уведомлений.

Оплата и возврат денег

После подключения Сбера оплату можно инициировать из карточки заявки или с планшета KDS, если соответствующий сценарий используется в вашей работе.

Отправка ссылки на оплату

1. Откройте нужный заказ на планшете KDS или карточку заявки.
2. Нажмите «Оплата» или «Отправить ссылку на оплату» — название команды зависит от места, из которого выполняется действие.
3. Mercury создаст платёж в Сбере и получит ссылку на страницу оплаты.
4. Ссылка отправляется покупателю в бот.
5. Покупатель переходит по ссылке и выполняет оплату.

Подтверждение оплаты

После завершения платежа Сбер отправляет уведомление в Mercury. Система дополнительно проверяет состояние операции.

Если платёж подтверждён, в заказе или заявке устанавливается статус «Оплачено». Если в заказе использовались бонусы, их автоматическая обработка выполняется после подтверждения оплаты.

Возврат оплаты

В карточке заявки предусмотрена команда «Вернуть оплату». Она позволяет оформить возврат через Сбер.

В зависимости от состояния платежа используется один из двух вариантов:

• Отмена холдирования — если средства были только заблокированы на карте покупателя, но ещё не списаны.
• Возврат списанных средств — если деньги уже были списаны.

После выполнения возврата Mercury снимает с заявки статус «Оплачено».