Онлайн-оплата витрины

Сбер — как подключить

Нужен договор интернет-эквайринга Сбера и доступ к платёжному шлюзу (ПШ). Это отдельный логин/пароль API, не пароль от СберБизнес Онлайн.

1. Договор и доступ к шлюзу

1. Оформите интернет-эквайринг Сбера (через менеджера или заявку в банке).
2. После подключения банк выдаёт доступы к ПШ:
   • userName — логин API Партнёра;
   • password — пароль API Партнёра.
3. Уточните у банка: боевой или тестовый контур. В Меркурии контур выбирается в настройках оплаты (поле «Контур API»): боевой — ecommerce.sberbank.ru, тестовый — ecomtest.sberbank.ru.

2. Настройка в Меркурии

1. Откройте Розница → Интернет-витрина.
2. Блок «Онлайн-оплата заказов»: включите галочку оплаты.
3. В списке «Платёжная система» выберите Сбер.
4. Вставьте Логин API (userName) и Пароль API.
5. Выберите Контур API — боевой или тестовый (как сказал банк) → Сохранить.
6. После сохранения (витрина должна быть включена) появится поле «URL callback Сбера» — скопируйте его.

3. Callback в кабинете шлюза

1. В личном кабинете / настройках ПШ укажите URL уведомлений о платеже (callback) — тот же адрес, что показал Меркурий.
2. Адрес выглядит так: …/api/public/index.php?route=public/vitrina/sber/notification/ВАШ_ТОКЕН и должен открываться из интернета по HTTPS.
3. Меркурий дополнительно передаёт этот URL в каждый платёж как dynamicCallbackUrl, поэтому даже если в кабинете забыли прописать URL, уведомление всё равно уйдёт на нужный адрес (если шлюз поддерживает динамический callback).

4. Как работает оплата

1. На KDS или в заявке нажимаете «Оплата» / «Отправить ссылку на оплату».
2. Меркурий вызывает register.do в шлюзе Сбера и получает formUrl — ссылку на платёжную страницу.
3. Ссылка уходит покупателю в Telegram/MAX.
4. После успешной оплаты шлюз шлёт callback (operation=deposited). Меркурий сверяет статус через getOrderStatusExtended и ставит заявке «Оплачено»; бонусы начисляются автоматически.

5. Возврат денег

1. В Расходы → Заявки покупателей откройте заявку → вкладка «Интернет-заказ».
2. Кнопка «Вернуть оплату Сбер» доступна, если оплата шла по ссылке Сбера (есть orderId шлюза) и статус «ожидает» или «оплачено».
3. Меркурий сам выбирает операцию:
   • ещё холд / незавершённое списание → reverse.do (отмена);
   • деньги уже списаны → refund.do (возврат).
4. После успеха статус заявки становится «отменено / возвращено», признак «Оплачено» снимается.