Меркурий-ИИ

Интернет-витрина

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

Покупатель платит напрямую вам — на ваш терминал в Т‑Банке, ЮKassa, Робокассе или Сбере. Меркурий не принимает деньги на свой счёт: программа только создаёт ссылку на оплату и узнаёт от платёжной системы, что платёж прошёл.

Как это работает

  1. Покупатель оформляет заказ в боте (WebApp витрины) или на сайте витрины с привязкой к Telegram/MAX.
  2. Вы собираете заказ (на KDS или в ERP) и при необходимости правите состав — сумма берётся текущая.
  3. Нажимаете «Оплата» (KDS) или «Отправить ссылку на оплату» (заявка) — покупателю в бот уходит ссылка выбранной платёжной системы (карта и СБП, если доступны у провайдера).
  4. Покупатель платит. Платёжная система шлёт уведомление на ваш URL в Меркурии — в заявке и на KDS статус становится «Оплачено».

Важно: деньги идут на ваш эквайринг. Ключи вводит каждый магазин в своих настройках витрины. Платформа Меркурий этими платежами не распоряжается.

Что нужно заранее

Выбор платёжной системы

В блоке онлайн-оплаты выберите одну систему. Одновременно активна только она: ключи остальных можно хранить, но ссылка создаётся у выбранного провайдера.

Т‑Банк ЮKassa Робокасса Сбер
Т‑Банк · ЮKassa · Робокасса · Сбер
  1. Войдите в личный кабинет Т‑Банка для бизнеса.
  2. Откройте раздел Интернет-эквайринг.
  3. Скопируйте Terminal Key и пароль терминала (не пароль входа в банк).
  4. В Меркурии выберите провайдер «Т‑Банк», вставьте ключи и сохраните.
  5. Скопируйте URL уведомлений и при необходимости укажите его в кабинете банка как Notification URL.
  1. Войдите в кабинет ЮKassa.
  2. Скопируйте shopId и секретный ключ (из настроек магазина / API).
  3. В Меркурии выберите «ЮKassa», вставьте ключи и сохраните.
  4. В кабинете ЮKassa добавьте HTTP-уведомления на URL из настроек витрины (событие успешного платежа).

Секретный ключ после сохранения в Меркурии не показывается — чтобы сменить, введите новый и сохраните снова.

  1. Войдите в кабинет Робокассы.
  2. Скопируйте идентификатор магазина (MerchantLogin), пароль #1 (для формирования ссылки) и пароль #2 (для ResultURL).
  3. В Меркурии выберите «Робокасса», вставьте данные и сохраните.
  4. В настройках технического магазина укажите ResultURL из блока онлайн-оплаты (тот же адрес Меркурий передаёт в платёжной ссылке).

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

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

  1. Оформите интернет-эквайринг Сбера (через менеджера или заявку в банке).
  2. После подключения банк выдаёт доступы к ПШ:
    • userName — логин API Партнёра;
    • password — пароль API Партнёра.
  3. Уточните у банка: боевой или тестовый контур. Боевой API по умолчанию: https://ecommerce.sberbank.ru/ecomm/gw/partner/api/v1. Тестовый хост задаётся на сервере Меркурия переменной SBER_API_URL (если банк просит тест).

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

  1. Откройте Розница → Интернет-витрина.
  2. Блок «Онлайн-оплата заказов»: включите галочку оплаты.
  3. В списке «Платёжная система» выберите Сбер.
  4. Вставьте Логин API (userName) и Пароль API → Сохранить.
  5. После сохранения (витрина должна быть включена) появится поле «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. После успеха статус заявки становится «отменено / возвращено», признак «Оплачено» снимается.

Важно: пароль API после сохранения в Меркурии не показывается снова — чтобы сменить, введите новый и сохраните. Сертификат НУЦ Минцифры на сервере (для TLS к шлюзу) обычно уже есть на современных системах; если банк пишет про сертификат — уточните у поддержки хостинга.

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

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

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

После оплаты провайдер должен сообщить Меркурию: «платёж прошёл». Адрес зависит от выбранной системы:

Он уже формируется программой и показывается в настройках витрины после сохранения. Адрес должен быть доступен из интернета по HTTPS.

Рабочий процесс: заказ → сборка → оплата

  1. Заказ. Покупатель оформляет заказ в боте.
  2. Кухня / сборка. Заказ появляется на KDS. Можно править состав — сумма обновится.
  3. Готовность. Когда заказ готов, покупателю уйдёт «Заказ собран».
  4. Оплата. Нажмите «Оплата» на карточке KDS (или в ERP — «Отправить ссылку на оплату»). В бот уйдёт ссылка на сумму текущей заявки.
  5. Факт оплаты. После успешной оплаты бейдж на KDS станет зелёным «Оплачено».

Ссылку можно отправить повторно, пока заказ не оплачен (создастся новая ссылка на актуальную сумму).

Что видно на KDS

Если онлайн-оплата включена в витрине, на карточке заказа:

Кнопка в заявке покупателя

  1. Откройте Расходы → Заявки покупателей → нужную заявку.
  2. Вкладка «Интернет-заказ».
  3. Кнопка «Отправить ссылку на оплату» — если оплата настроена, заказ с витрины и привязан к боту.
  4. Кнопка «Вернуть оплату» (Т‑Банк или Сбер) — если платёж создан по ссылке и ещё не отменён: деньги возвращаются через API банка, статус заявки снимается.

Сообщения покупателю в боте

Бонусы после оплаты

Если онлайн-оплата подключена, бонусы начисляются автоматически после подтверждения платежа — кнопку «Начислить бонусы» / «Бонусы» не показываем. Без платёжной системы бонусы по-прежнему начисляются вручную кнопкой в ERP или на KDS. Признак «Оплачено» виден на KDS и в журнале заявок: без ПС его ставят на KDS, в карточке заявки правят всегда.

Типичные проблемы

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

Связанные разделы