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

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

31.10.2026

Платежи

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

28.10.2026

Выплаты

• Новое. Добавлен метод получения баланса счёта Сбера. Он возвращает сводную выписку за день: входящий и исходящий остаток, обороты и количество операций. Исходящий остаток за текущий день — текущий баланс счёта и выпущенных к нему корпоративных карт.
• Новое. Добавлен метод получения лимитов корпоративной карты Сбера. Он возвращает установленные лимиты на снятие наличных, переводы и расходные операции и их остатки.
• Изменено. В ответе списка корпоративных карт появилось поле account_number — номер счёта карты для получения баланса.

23.10.2026

Платежи

• Изменено. В ответе возврата платежа появилось поле operation — операция возврата со своим статусом new, success или declined. Если банк не подтвердил возврат сразу, статус платежа не меняется, а результат возврата нужно отслеживать по операции — подробнее в разделе «Отложенный возврат».

Транзакции

• Новое. В получении статуса транзакции появился необязательный query-параметр with_operations: при true в ответе возвращается массив operations с возвратами, отменами и подтверждениями авторизации и их результатами, включая отклонённые банком.

02.10.2026

Покупатели

• Изменено. В ответе получения карты по транзакции появились поля bank_id, bank_name и bank_url — данные банка-эмитента карты.

25.09.2026

Транзакции

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

21.09.2026

Платежи

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

Фискализация

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

18.09.2026

Платежи

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

11.09.2026

Документация

• Новое. Документация доступна на английском языке.

10.09.2026

Платежи

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

Выплаты

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

27.08.2026

Выплаты

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

26.08.2026

Самозанятые

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

24.08.2026

Самозанятые

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

20.08.2026

Криптограмма

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

11.08.2026

Выплаты

• Изменено. Переработано описание проверки возможности выплаты через СБП.
• Изменено. Переработано описание списка банков по номеру телефона.
• Изменено. Переработано описание общего списка банков СБП.

10.08.2026

Платежи

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

Выплаты

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

Транзакции

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

Документация

• Новое. Добавлены тестовые сценарии для платежей и выплат.
• Новое. Добавлен общий справочник ошибок API платежей и выплат.
• Новое. Добавлен справочник ошибок BAAS API.