Быстрый старт

1. Посмотрите сервис в действии#

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

2. Создайте аккаунт через Telegram#

После подтверждения входа в Telegram открывается личный кабинет. Раздел «Подключение сайта» находится по /account#applications; форма и индивидуальное отслеживание /account#applications/{id} остаются внутри приложения.

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

3. Настройте магазин#

1. 1

   Укажите название магазина, по которому покупатель узнает продавца.

2. 2

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

3. 3

   Выберите, какие уведомления вы хотите получать в Telegram.

4. 4

   Проверьте расчёт на типичной сумме заказа в калькуляторе.

4. Подготовьте платёжную ссылку#

Укажите понятное название заказа, сумму и валюту. Покупателю нужна отдельная страница с деталями покупки и итогом к оплате. Условия существующего счёта сохраняются при последующем изменении настроек магазина.

5. Проверьте доступность оплаты#

Управляйте счетами, API-ключами, виджетами и вебхуками в личном кабинете. Перед оплатой Kevmi проверяет настройки шлюза, одобрение магазина, сумму и условия счёта. Если выбранный способ недоступен, покупатель увидит причину на странице оплаты.

В интерфейсе для нового счёта USD доступны карты и Alipay, для RUB — СБП, для USDT — криптовалюта. API для совместимости может сохранить USD + crypto, но такая криптооплата не запускается и возвращает crypto_requires_usdt. USD и USDT различаются; автоматической конвертации или курса 1:1 нет. Для криптооплаты нужен отдельный счёт в USDT.

Для нового реального платежа картой или Alipay текущий шлюз поддерживает только feeCustomerPercent=0 и vatCustomerPercent=100: комиссию полностью покрывает магазин, НДС полностью добавляется покупателю. Остальные доли можно сохранить в счёте и рассчитать, но такой платёж не запускается и получает unsupported_allocation. Сервер не меняет сохранённые условия автоматически. Для СБП и USDT-криптооплаты доступны все доли комиссии; НДС у них отсутствует.