История изменений

Здесь публикуются изменения API и документации KVELL.

25.09.2026

Новое. В коды ошибок транзакции добавлены bnpl-rejected, ip-blocked, merchant-configuration-error, refund-amount-exceeds-payment и rejected-by-merchant. Если интеграция обрабатывает error_code по списку известных значений, добавьте новые коды.

Изменено. В платеже с предавторизацией появился необязательный параметр bind_card — привязка карты в KVELL при успешной предавторизации. Для привязки обязателен customer_key.

Новое. В фискализации появилась агентская схема: в позиции чека можно передать признак агента agent_info (тег 1222) и данные поставщика supplier_info (тег 1224) — чек пробивается с указанием другой организации в качестве поставщика. Параметры необязательные и поддерживаются только провайдером АТОЛ Онлайн.

Изменено. В платеже с предавторизацией появился необязательный параметр customer_key — идентификатор покупателя.

Новое. Добавлено описание работы с цифровым рублем: кого касается, требования по приёму и как принимать такие платежи.

Новое. Добавлен обзор номинальных счетов: выбор методов Сбера и Альфа-Банка.
Новое. Добавлены методы выплаты через СБП с конвертацией в валюту магазина: проверка возможности выплаты и совершение выплаты.

Новое. Добавлен метод выплаты по реквизитам через номинальный счёт Альфа-Банка: перевод на банковский счёт получателя по наименованию или ФИО, ИНН, номеру счёта и БИК банка. Получателем может быть физическое лицо, индивидуальный предприниматель или юридическое лицо.

Новое. В аннулировании чека появилось необязательное тело запроса с параметром reason — можно указать причину: REGISTRATION_MISTAKE (чек сформирован ошибочно) или REFUND (возврат средств). Без тела запроса используется REGISTRATION_MISTAKE, подпись по-прежнему формируется только по receipt_id.
Изменено. Аннулировать чек теперь можно не только в статусе ready, но и в статусе await_confirm — когда чек зарегистрирован и ожидает подтверждения дохода самозанятым.
Изменено. В описание статусов чека в методах формирования и получения чека добавлен статус await_confirm.
Изменено. В справочник ошибок BAAS API добавлена ошибка 35 — чек в статусе await_confirm ещё нельзя аннулировать, запрос нужно повторить позже.

Изменено. В ответ методов формирования чека и получения чека добавлен параметр act_id — идентификатор акта, с которым связан чек.

Новое. Добавлено описание метода получения публичного ключа для криптограммы: формат криптограммы карточных данных, правила кэширования ключа и его ротация.

Новое. Добавлено описание оплаты картой через H2H без использования платёжной страницы KVELL, включая требования PCI DSS.
Изменено. Переработано описание создания платёжной сессии.
Изменено. Расширено описание оплаты через СБП: добавлен сценарий интеграции, описаны варианты ответов и особенности привязки счёта.

Изменено. Переработано описание совершения выплаты на карту.
Изменено. Переработано описание подтверждения выплаты на карту по OTP.
Изменено. Переработано описание совершения выплаты через СБП.
Изменено. Формирование подписи для выплат на карту и через СБП вынесено в общий раздел и дополнено примерами.
Изменено. Дополнено описание статуса проверки возможности выплаты по СБП: добавлены ошибки, получаемые от банков и НСПК, логика обработки статусов и маска счёта получателя.
Изменено. Уточнено назначение списка банков по номеру телефона: список формируется на основе истории переводов и носит справочный характер.

Изменено. Переработано описание метода получения списка транзакций: уточнены параметры, форматы ответа и обработка ошибок.
Изменено. Расширено описание статуса транзакции, включая статусы операций и банковские причины отклонения.