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

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

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

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

• Договор и кабинет в одной из систем: Т‑Банк, ЮKassa, Робокасса или Сбер.
• Включённая и опубликованная интернет-витрина.
• Включённая дисконтная программа и подключённый бот Telegram и/или MAX — ссылка на оплату уходит в бот.
• Заказы оформляются через WebApp в боте (чтобы в заявке был chat_id / max_id). Заказ «только с сайта без бота» ссылку в мессенджер не получит.

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

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

• Т‑Банк — интернет-эквайринг банка (бывший Тинькофф).
• ЮKassa — платежи ЮMoney / ЮKassa (shopId + секретный ключ).
• Робокасса — логин магазина и пароли #1 / #2.
• Сбер — платёжный шлюз Сбера (логин и пароль API, ссылка formUrl).
• Статический QR — ваша постоянная ссылка и картинка QR; покупатель вводит сумму сам; «Оплачено» ставит оператор.

Т‑Банк

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

Режим «СБП — своя страница»

Если на стандартной странице Т‑Банка клиенту показываются карты и другие способы с высокой комиссией, переключите в Меркурии способ оплаты на «СБП — своя страница». Клиент получит ссылку на страницу Меркурий с QR-кодом СБП — без редиректа на форму банка.

1. Напишите в Т‑Банк на acq_help@tbank.ru с просьбой подключить «Свою платежную форму» для вашего терминала.
2. В личном кабинете эквайринга включите на терминале только СБП (остальные способы отключите).
3. В Меркурии: Витрина → Оплаты → Т‑Банк → способ оплаты «СБП — своя страница» → сохраните.
4. URL уведомлений (NotificationURL) тот же — webhook не меняется.

ЮKassa

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»): боевой — 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. После успеха статус заявки становится «отменено / возвращено», признак «Оплачено» снимается.

Статический QR

Вариант без эквайрингового API: у вас уже есть постоянная ссылка или QR (СБП в приложении банка, «платёж по реквизитам» и т.п.). Покупатель сам вводит сумму.

1. В Меркурии выберите провайдер «Статический QR».
2. Вставьте ссылку на оплату (http/https).
3. Загрузите картинку QR-кода (PNG/JPG) — её увидит покупатель в боте.
4. Сохраните настройки. URL уведомлений для этого режима не нужен.

При нажатии «Оплата» на KDS покупатель получает в бот:

• ссылку и картинку QR;
• по умолчанию — финальную сумму заказа и инструкцию оплатить её и прислать чек;
• если в настройках включена галочка «Не указывать сумму в сообщении бота» — сумма в тексте не пишется (её можно сказать в чате).

Заказ помечается как «Ожидает оплаты». Оператор после проверки платежа нажимает «Оплачено» — бонусы начислятся автоматически.

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

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

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

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

• Т‑Банк: …/public/vitrina/tbank/notification/…
• ЮKassa: …/public/vitrina/yookassa/notification/…
• Робокасса: …/public/vitrina/robokassa/result/…
• Сбер: …/public/vitrina/sber/notification/…

Для статического QR webhook не используется — поле URL уведомлений скрыто.

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

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

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

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

Что видно на KDS

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

• бейдж «Не оплачено» / «Ожидает оплаты» / «Оплачено»;
• кнопка «Оплата» — пока не оплачено и заказ из бота;
• при статическом QR — ещё кнопка «Оплачено» (после проверки платежа оператором).

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

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

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

• После оформления: «Заказ успешно получен».
• После готовности: «Заказ собран».
• После отправки ссылки: сумма и ссылка «Оплатить картой или СБП».

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

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

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

• Можно ли принимать оплату на счёт Меркурия? — Нет, используются только ваши ключи выбранного провайдера.
• Можно ли подключить сразу Т‑Банк и ЮKassa? — Ключи можно сохранить у нескольких, но активен один выбранный провайдер.
• Карта и СБП? — Зависят от настроек вашего терминала/магазина у провайдера.
• Чеки 54‑ФЗ? — Для ЮKassa при включённой онлайн-кассе Меркурий передаёт состав чека в платёж; пробитие выполняет касса, подключённая в кабинете ЮKassa. Для остальных провайдеров фискализацию настраивайте у них.

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

• Интернет-витрина
• Дисконтная программа и боты
• KDS — кухня доставки
• Заявки покупателей