Оплата мерчанта (ЮKassa / Robokassa)
Для шаблонов E‑com в кабинете агента можно указать провайдера оплаты и ключи магазина без изменения кода на стороне MrSmit. Это действие **необязательное**: если ключи не задать, витрина и сценарий оформления заказа продолжат работать, но у покупателя **не будет онлайн-оплаты в приложении** (заказ оформляется в чате и передаётся владельцу, обычно письмом через SMTP). Платформа не списывает деньги с клиента из чата: ключи хранятся зашифрованно, попадают в системный промпт ассистента (чтобы он знал о настроенной оплате) и в публичный JSON витрины в виде краткого резюме без секретов. Приём платежей и возвраты реализуются в вашем Mini App или на вашем сервере по официальным API ЮKassa или Robokassa.
1. Зачем это нужно
Мини‑приложение или ваш бэкенд создаёт платёж и ведёт клиента на оплату; ассистент в чате может подтверждать состав заказа и направлять к оплате, опираясь на инструкции и на то, что в кабинете выбран провайдер и заданы ключи.
Если оплату не подключать, ассистент оформит заказ «до оплаты»: сформирует понятную сводку заказа и отправит владельцу магазина уведомление (например, письмом через SMTP).
Секретные ключи в ответе публичного API и в ответах ассистента пользователю не показываются.
2. ЮKassa (Яндекс Касса)
В личном кабинете ЮKassa (yookassa.ru) создайте магазин и выпустите секретный ключ API; при необходимости уточните shopId в интерфейсе.
В кабинете агента E‑com откройте блок оплаты мерчанта, выберите «ЮKassa», введите shopId и секретный ключ и сохраните. Пустое поле секрета при повторном сохранении не затирает уже сохранённый ключ.
Интеграция приёма платежей на вашем сайте или в Mini App — по документации ЮKassa (создание платежа, redirect, webhooks на ваш URL). Платформа MrSmit не подставляет ваш секрет в запросы к API ЮKassa от своего имени.
3. Robokassa
В мерчанте Robokassa возьмите идентификатор магазина (логин), пароль #1 и пароль #2 для подписи запросов и уведомлений — как указано в личном кабинете Robokassa.
В кабинете агента выберите «Robokassa», введите все три значения и сохраните. Пустые поля паролей при повторном сохранении не затирают уже сохранённые значения.
Оплата на стороне клиента и обработка Result URL — по документации Robokassa на вашем сервере или во фронтенде Mini App.
4. Отключение и проверка
Чтобы не передавать данные оплаты в промпт и публичный JSON, выберите режим «Выкл» и сохраните.
Публичный GET /api/public/ecom/{ключ}/theme содержит merchant_payments: provider, configured и offline_checkout_only (true, если ключей нет).
Если offline_checkout_only=true, то онлайн-оплаты в витрине нет: сценарий заказа в чате — только до согласования без списания с карты; ассистент помечает это как «заказ без онлайн-оплаты» и отправляет владельцу уведомление (обычно через SMTP). Секреты в ответе API не возвращаются.