Настройки магазина

Название магазина#

Укажите короткое узнаваемое имя, которое покупатель ожидает увидеть рядом с заказом. Длина — от 1 до 80 символов после удаления пробелов по краям.

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

Плательщик НДС#

По умолчанию выбран покупатель. Налог применяется только к картам и Alipay. Для СБП и криптовалюты итог не меняется при переключении этого параметра.

Созданные счета сохраняют прежние условия. Для каждого нового счёта можно задать независимые доли НДС и комиссии покупателя от 0 до 100%; правило магазина служит исходным значением.

Сохранённое предпочтение не расширяет возможности шлюза. В текущем карточном и Alipay-канале реальный платёж требует 100% НДС покупателя и 0% комиссии покупателя; другое распределение остаётся сохранённым расчётом.

Telegram-уведомления#

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

Тестовое сообщение проверяет доставку в привязанный личный чат. Статус виден под колокольчиком в центре уведомлений и через GET /api/notifications. Постановка в очередь ещё не означает доставку; отдельно проверьте появление сообщения в Telegram.

Сохранение и ошибки#

Форма должна подтвердить успешное сохранение. Если сеть прервалась, введённые данные остаются в форме для повторной попытки; нельзя считать изменение сохранённым по одному нажатию кнопки.

При истёкшей сессии войдите снова. Сервер не принимает изменение чужого магазина по ID из браузера: пользователь определяется сессией.

Тема и демо-данные#

Тема оформления сохраняется локально на устройстве. Демо-кабинет использует отдельные браузерные данные и не изменяет серверный аккаунт.

Сброс демо удаляет только тестовые записи в этом браузере. Экспорт демо не является банковской выпиской или документом об оплате.

Несколько магазинов и единая цена в USD#

В меню магазина выберите «Все магазины» для общего обзора и операций или конкретный магазин для его данных. Каждый магазин имеет собственный storeId, название, правило НДС, счета, API-ключи, вебхуки, журнал событий и заявку на проверку сайта. Уведомления и обращения принадлежат аккаунту. Можно создать до 100 магазинов. Ранее созданные данные сохранены в первом магазине.

Новые ссылки из кабинета используют pricingMode="universal": базовая цена хранится в USD. Any включает card, alipay, sbp и crypto; при необходимости магазин выбирает подмножество. Карты и Alipay оплачиваются в USD, СБП — в RUB по официальному курсу USD/RUB Банка России, криптовалюта — в USDT по явно установленному соотношению 1 USD = 1 USDT. Это правило расчёта счёта, а не рыночная котировка USDT. Курс другой монеты и точные реквизиты предоставляет шлюз перед переводом.

Курс ЦБ и обе суммы сохраняются при создании. Ссылки с рублёвой конвертацией действуют не более 24 часов. Если курс получить не удалось, создание возвращает FX_UNAVAILABLE; выдуманный или старый запасной курс не применяется. amountMinor и quotes в ответе владельцу выражены в базовой валюте USD; quotes[method].settlement содержит сумму и валюту конкретного способа. Публичный checkout возвращает выбранную валюту оплаты в currency, исходную цену в baseAmountMinor/baseCurrency и курс в fx. Возврат к другой валюте после отправки платежа запрещён: у счёта одна операция шлюза.

Для серверной интеграции создайте API-ключ внутри выбранного магазина и передавайте Authorization: Bearer <key>. Привязка ключа к магазину неизменна: заголовок X-Kevmi-Store не позволяет получить данные другого магазина. Для браузерной сессии передавайте X-Kevmi-Store: <storeId>; без заголовка используется первый магазин. Значение all разрешено только для GET /api/account/dashboard и GET /api/payment-links. Изменения требуют выбранного магазина, Origin и X-CSRF-Token. ID аккаунта и ID магазина — разные идентификаторы.

Без pricingMode="universal" API сохраняет прежний режим native и исходные ограничения валют для совместимости. Старые ссылки не пересчитываются. Подтверждённые поступления в обзоре — это проверенные платежи за вычетом расходов по сохранённому расчёту, а не доступный остаток для вывода. Валюты старых счетов учитываются раздельно; выплаты согласуются с поддержкой. Подтверждение исполнения заказа проверяйте через payment.fulfillmentReady=true и payment.status="succeeded" в серверном API, журнале событий или подписанном вебхуке.