# Сбер

**Раздел:** **Онлайн-оплата витрины** (vitrina-oplata.md)

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Подробнее о назначении и настройке адресов: **URL уведомлений** (vitrina-oplata-notify.md).

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

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

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

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

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

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

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