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

Для тех, кто использует Чеки от ЮKassa: в параметре items чека теперь можно передать не более 80 товаров (раньше было не более 100 товаров).

Для способа оплаты «Покупки в кредит» от СберБанка изменился срок холдирования при платежах в две стадии. Теперь оплату нужно списать в течение 2 часов (раньше было 7 дней). Новый срок актуален для платежей, созданных с 21 февраля 2025 г.

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

Для тех, кто использует решения для работы по 54-ФЗ: ЮKassa теперь поддерживает ставки НДС 5% и 7%. В параметре vat_code можно передавать новые коды ставок. Что для этого нужно:

Изменилась логика проведения платежей за жилищно-коммунальные услуги. Теперь объект платежа  переходит в статус succeeded сразу после успешного приема оплаты от пользователя. Больше не нужно дожидаться результатов регистрации платежного поручения на стороне ГИС ЖКХ.

Для выплат самозанятым добавлена новая причина отмены выплаты — self_employed_annual_limit_exceeded (превышен лимит на годовой доход самозанятого).

Для тех, кто принимает платежи через СберБанк Бизнес Онлайн (b2b_sberbank): изменился список ставок НДС, которые можно указать для товаров с одинаковой ставкой (vat_data.type=calculated). Теперь в запросе можно передать новую ставку — 5%. Ставка 18% больше не поддерживается. Подробнее в Справочнике API .

Теперь в ЮKassa можно принимать платежи за жилищно-коммунальные услуги.

Теперь ЮKassa поддерживает работу с онлайн-кассами КОМТЕТ Касса и digitalkassa. Подробнее об отправке чеков сторонней онлайн-кассе

В объекте счета  со статусом canceled теперь возвращается объект cancellation_details с комментарием, кто отменил счет и по какой причине.

Для тех, кто принимает платежи через СБП и перенаправляет пользователя в приложение банка самостоятельно: теперь в запросе на создание платежа можно передать URL, на который пользователь вернется после оплаты. Для этого добавьте параметр return_url в объект confirmation.

В ЮKassa теперь можно выставлять счета по API.

Для платежей через СБП: в объекте платежа со статусом succeeded теперь возвращается объект payer_bank_details. Он содержит реквизиты счета, который использовался для оплаты.

Добавлен новый способ оплаты: теперь можно принимать принимать платежи по электронным сертификатам, привязанным к карте «Мир». Код способа в API — electronic_certificate.

Способ оплаты Tinkoff Pay теперь называется T-Pay. В API ничего не меняется, код остается прежний — tinkoff_bank.

В iOS SDK прекращена поддержка версий iOS ниже 14.0.

Для партнеров: теперь выдать доступ к магазину может не только Владелец, но и пользователь ЮKassa с ролью Управляющий. Подробнее о ролях в личном кабинете

Для тех, кто пополняет электронные кошельки, банковские счета и баланс телефонов:

API ЮKassa больше не поддерживает способ оплаты «Заплатить по частям» (installments):

Добавлена новая причина отмены возврата — rejected_by_timeout (технические неполадки на стороне инициатора отмены возврата).

Для тех, кто использует обычные выплаты: минимальная сумма выплаты на банковскую карту теперь 5 рублей (раньше была 100 рублей). Подробнее о лимитах выплат

Теперь при оплате через Tinkoff Pay в объекте платежа со статусом succeeded, waiting_for_capture и canceled могут возвращаться объекты payment_method.card (сведения о банковской карте) и authorization_details (данные об авторизации платежа).

Виджет ЮKassa теперь поддерживает оплату через «Покупки в кредит» от СберБанка.

Для платежей в две стадии: теперь при оплате через SberPay, Mir Pay, Tinkoff Pay и «Покупки в кредит» от СберБанка можно списать не только всю сумму, но и ее часть.

Для тех кто принимает платежи банковской картой или через Mir Pay: в объект Payment  добавлен объект card_product (карточный продукт платежной системы).

Для тех, кто делает обычные выплаты, обновились выписки из реестра выплат:

Обновлены мобильные SDK:

Способ оплаты QIWI Кошелек (qiwi) отключен, так как у КИВИ Банка отозвали лицензию. Платежи и возвраты этим способом недоступны.

Для SberPay срок холдирования при платежах в две стадии теперь 5 дней (раньше был 7 дней). Новый срок актуален для платежей, созданных с 25 января 2024 г.

Для самозанятых, кто пользуется автоотправкой чеков: теперь отключить опцию можно в личном кабинете ЮKassa — отзывать права у ЮMoney в сервисе Мой налог не обязательно.

Для тех, кто делает выплаты на банковские карты с использованием виджета для сбора данных:

Для тех, кто запрашивает настройки магазина : изменились ограничения для параметра itn объекта Me . Теперь ИНН может содержать до 20 символов.

Для партнеров: параметр fiscalization_enabled объекта Me  устарел, информация о настройках отправки чеков в налоговую теперь возвращается в объекте fiscalization.

Теперь ЮKassa поддерживает работу с онлайн-кассами Первый ОФД, LIFE PAY, Mertrade, RocketR. Подробнее об отправке чеков сторонней онлайн-кассе

В платежах увеличились разовые лимиты. Теперь при оплате через СберБанк Бизнес Онлайн, СБП, Tinkoff Pay, SberPay максимальный разовый платеж — 700 000 рублей; при оплате через Mir Pay или банковской картой — 350 000 рублей. Подробнее о лимитах

Вместо способа оплаты Тинькофф теперь используется способ Tinkoff Pay. Код в API прежний — tinkoff_bank. Основные отличия:

Если вы уже использовали способ Тинькофф, вы перейдете на Tinkoff Pay автоматически.

Для тех, кто делает выплаты самозанятым: добавлен новый статус объекта самозанятого  — unregistered (самозанятый с таким ИНН не зарегистрирован в сервисе Мой налог, или пользователь потерял статус самозанятого).

Для тех, кто отправляет чеки по сценарию Сначала платеж, потом чек: максимальное количество чеков, которые можно привязать к одному платежу или возврату, увеличено до 30.

Для тех, кто делает выплаты: теперь в личном кабинете ЮKassa можно подписаться на уведомления о смене статусов выплат.

Теперь, если пользователь пополняет свой банковский счет, открытый в вашей системе, в запросе на создание платежа нужно передавать данные пополняемого счета. Подробнее о пополнении счета, открытого в вашей системе

Для платежей через СБП: теперь объекты платежа и возврата могут содержать идентификатор операции в СБП — payment_method.sbp_operation_id (в объекте платежа ) и refund_method.sbp_operation_id (в объекте возврата ).

Добавлен новый способ оплаты — «Покупки в кредит» от Сбербанка, код в API — sber_loan.

API ЮKassa больше не поддерживает способ оплаты alfabank (Альфа-Клик).

В ЮKassa появилось новое решение для работы по 54-ФЗ — Чеки от ЮKassa. С его помощью вы можете отправлять чеки в налоговую без аренды онлайн-кассы и покупки фискального накопителя.

Виджет ЮKassa теперь поддерживает оплату через Mir Pay.

Для тех, кто использует Безопасную сделку: добавлена новая причина отмены выплаты — identification_required (пополнение анонимного кошелька запрещено, пользователю необходимо идентифицировать кошелек).

Для тех, кто использует iOS SDK: больше нельзя установить демо-приложение, которое показывает, как выглядят платежные инструменты и как проходит процесс оплаты.

Добавлен новый способ оплаты Mir Pay. Этот способ отображается на платежной форме при оплате с мобильных устройств на Android. Доступно тем, кто использует Умный платеж или готовую страницу ЮKassa для оплаты банковской картой.

Для тех, кто делает выплаты: теперь ЮKassa списывает комиссию с вашего баланса не за все успешные операции раз в сутки, а отдельно за каждую выплату сразу после ее проведения.

Платежи через СБП больше нельзя проводить в две стадии. Теперь в запросе на создание платежа через СБП нужно всегда передавать параметр capture со значением true. Если вы используете Умный платеж или виджет ЮKassa, то при проведении платежей в две стадии способ оплаты СБП не отобразится.

Для партнеров, которые используют OAuth-токен, добавлена возможность проводить автоплатежи.

В ЮKassa появился особый тестовый режим для тех, кто хочет оценить возможности API. Указывать данные компании и подписывать договор не нужно. Доступно для обычных платежей, выплат и партнерской программы. Для тестирования Безопасной сделки и Сплитования платежей нужно регистрироваться как обычно, с указанием данных компании.

В ЮKassa появилась возможность передавать номер пополняемого телефона в запросе на создание платежа . Подробнее о пополнении баланса

Для тех, кто делает выплаты на банковские карты с использованием виджета для сбора данных: вышла новая версия виджета — 3.0.0. В этой версии изменился набор параметров, которые возвращает библиотека при успехе. Подробнее об изменениях

Изменился процесс тестирования оплаты кошельком: вы можете протестировать оплату в тестовом магазине без выхода из аккаунта своего кошелька ЮMoney.

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

При оплате через СБП временно недоступна возможность проводить двухстадийные платежи.

Самозанятые теперь могут проводить платежи с автоматической регистрацией чека в сервисе Мой налог.

Добавлена возможность сохранить способ оплаты СБП для автоплатежей.

Checkout.js больше не возвращает коды ошибок expired_card (карта просрочена) и card_declined (карта отклонена).

Онлайн-площадки, которые используют Сплитование платежей, теперь могут в запросе на создание платежа  для каждого магазина передавать описание транзакции (transfers.description). Продавец увидит это описание в личном кабинете ЮKassa.

Для тех, кто пользуется решением ЮKassa для работы по 54-ФЗ: теперь онлайн-кассы Кит Инвест и МодульКасса поддерживают формирование чеков по ФФД 1.2.

Виджет ЮKassa теперь обрабатывает неуспешные попытки платежа при оплате всеми способами, а Умный платеж — при оплате банковской картой, через SberPay, СБП и из кошелька ЮMoney. При самостоятельной интеграции неуспешные попытки теперь обрабатывают готовые платежные формы для оплаты банковской картой, из кошелька ЮMoney или через SberPay. Если вы хотите самостоятельно принимать решение, что сообщать пользователю при неуспешном платеже, напишите менеджеру ЮKassa.

Добавлен новый диапазон IP-адресов, с которых ЮKassa может присылать уведомления: 2a02:5180::/32

ЮKassa прекращает поддерживать немецкий язык в виджете. Если вы отображаете тексты в платежной форме на немецком, выберите другой язык — английский или русский.

Умный платеж теперь поддерживает сохранение способа оплаты для автоплатежей.

Максимальный размер платежа через СБП увеличен с 600 000 рублей до 1 млн рублей.

Теперь при оплате через Сбербанк Бизнес Онлайн в объекте платежа параметр payer_bank_details.kpp стал необязательным.

Новые требования к URL для входящих уведомлений: для подписки на уведомления теперь подойдут только URL с TCP-портами 443 или 8443.

Добавлена возможность создать платеж с новым способом оплаты sbp (оплата через СБП — Систему быстрых платежей Банка России).

В России приостановлены операции по картам Visa, MasterCard, JCB и AmericanExpress, поэтому в работе Apple Pay и Google Pay есть ограничения:

Способ оплаты WebMoney (webmoney) отключен, так как у расчетного банка WebMoney отозвали лицензию. Платежи и возвраты этим способом недоступны.

Теперь, если вы хотите в виджете ЮKassa настраивать отображение способов оплаты, вам сначала нужно подключить эту опцию — обратиться к менеджеру. Если этого не сделать, при инициализации виджета с переданным параметром payment_methods вернется ошибка customization_of_payment_methods_not_allowed.

Добавлена возможность сохранить способ оплаты SberPay для автоплатежей.

Теперь ЮKassa может присылать уведомления с двух новых IP-адресов:

Обновления в виджете ЮKassa:

В ЮKassa добавлена поддержка ФФД 1.2 для работы с онлайн-кассами. Возможность передачи новых реквизитов для маркировки будет реализована позже.

В объект Payment  добавлен параметр authorization_details.three_d_secure (данные о прохождении пользователем аутентификации по 3‑D Secure).

Способ оплаты СберБанк Онлайн выводится из эксплуатации:

Добавлена возможность отображать виджет ЮKassa во всплывающем окне.

Для тех, кто использует Безопасную сделку: добавлена возможность подписаться на уведомления о смене статусов созданных сделок и выплат.

При неуспешном платеже через Apple Pay и Google Pay виджет ЮKassa или страница Умного платежа отображает сообщение об ошибке и предлагает попробовать оплатить еще раз с выбором способа оплаты.

Добавлена возможность в запросе на создание чека  передавать дополнительные реквизиты пользователя (additional_user_props) и предмета расчета (additional_payment_subject_props). Доступно только тем, кто использует сценарий Сначала платеж, затем чек.

Для тех, кто использует Безопасную сделку: минимальная сумма выплаты на банковскую карту продавца снижена со 100 рублей до 1 рубля. Подробнее о лимитах выплат

Для тестирования добавлена возможность создавать тестовый магазин из личного кабинета ЮKassa.

Для тех, кто использует Безопасную сделку: добавлена возможность при выплатах передавать в запросе номер банковской карты.

Для тех, кто использует Безопасную сделку: добавлена возможность делать выплаты на кошельки ЮMoney.

Добавлено ограничение на создание чеков по сценарию Сначала платеж, потом чек: теперь к одному платежу или возврату можно привязать не более 15 чеков.

Для тестирования оплаты банковской картой добавлены тестовые банковские карты разных платежных систем.

В ЮKassa появилось новое решение для платформ — Безопасная сделка. С его помощью онлайн-площадки, на которых частные лица продают друг другу товары и оказывают услуги, могут принимать оплату от покупателя и делать выплату продавцу.

Виджет ЮKassa при оплате банковской картой теперь самостоятельно обрабатывает неуспешные попытки платежа и предлагает пользователю попробовать оплатить еще раз. Вы можете отключить эту настройку через менеджера ЮKassa и обрабатывать неуспешные платежи самостоятельно.

Добавлена новая версия способа оплаты через СберБанк — SberPay. ЮKassa переводит на него тех, кто использует способ оплаты СберБанк Онлайн. Подробнее о SberPay

Онлайн-площадки, которые используют Сплитование платежей, теперь могут получить информацию о магазине продавца , подключенного к площадке.

В виджете ЮKassa больше нельзя настроить способ прохождения аутентификации по 3‑D Secure при оплате банковской картой. Пользователь теперь всегда подтверждает платеж во всплывающем окне, а не на отдельной странице.

Онлайн-площадки, которые используют Сплитование платежей, теперь могут для каждого магазина передать дополнительную информацию о заказе .

Обновления в виджете ЮKassa:

Добавлено ограничение на возврат платежей: платежи через Сбербанк Онлайн (способ оплаты sberbank) можно вернуть только в течение одного года с момента их создания.

Добавлена новая причина отмены платежа — unsupported_mobile_operator (ЮKassa не поддерживает оплату с указанного номера телефона).

В реестр платежей добавлено три новых поля: Имя плательщика, Адрес плательщика и ИНН. Эти данные приходят только при оплате из кошелька ЮMoney, если сумма платежа больше 15 000 рублей.

Для тех, кто самостоятельно интегрирует способ оплаты Google Pay: параметр токенизации gateway теперь нужно передавать со значением yoomoney.

Обновлены веб SDK: виджет ЮKassa, Checkout.js, Checkout UI.

Запуск новой версии API. Что изменилось:

Обновлены мобильные SDK:

Для партнеров: в ЮKassa изменился процесс получения OAuth-токенов. Подробнее об изменениях

В виджете ЮKassa обновлен дизайн платежной формы.

API ЮKassa больше не поддерживает способ оплаты wechat (оплата через приложение WeChat).

Онлайн-площадки, которые используют Сплитование платежей, теперь могут отслеживать статус подключения магазинов в личном кабинете.

Изменен параметр card.first6 объекта Payment :

Виджет ЮKassa теперь возвращает новый код ошибки — invalid_return_url (некорректный URL страницы завершения оплаты).

Теперь с помощью Сплитования платежей онлайн-площадки могут удерживать с магазинов комиссию за проданные товары и услуги.

Добавлены новые причины отмены платежа:

Добавлено ограничение на возврат платежей: вернуть платежи можно только в течение трех лет с момента их создания.

В виджете ЮKassa теперь можно настраивать цветовую схему платежной формы.

Вышла новая версия мобильного SDK для iOS. Если вы уже используете библиотеку для приема платежей, обновите настройки зависимостей.

В ЮKassa появилось новое решение для платформ. Теперь онлайн-площадки, на которых магазины размещают товары и услуги, могут принимать платежи и автоматически распределять деньги между магазинами.

В виджете ЮKassa при оплате банковской картой пользователь может проходить аутентификацию по 3-D Secure во всплывающем окне, оставаясь при этом на вашем сайте.

В объект Payment  добавлен параметр income_amount (сумма платежа за вычетом комиссии ЮKassa).

Добавлена возможность тестировать работу с чеками.

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

Для партнеров:

В виджете ЮKassa теперь можно выбрать язык (русский, английский или немецкий), на котором будут отображаться тексты в платежной форме.

Возможность подключить способ оплаты Сбербанк Бизнес Онлайн теперь доступна клиентам любых банков.

Виджет ЮKassa теперь поддерживает оплату картами, привязанными к кошельку ЮMoney.

Теперь при создании платежа со способом оплаты Google Pay не нужно передавать параметр google_transaction_id (идентификатор транзакции Google).

Виджет ЮKassa теперь поддерживает оплату через Сбербанк Онлайн.

Виджет ЮKassa теперь поддерживает оплату из кошелька ЮMoney и сохранение способа оплаты для автоплатежей.

Добавлена возможность встроить платежную форму в ваш сайт с помощью виджета ЮKassa.

Добавлена возможность получить информацию о чеке  платежа или возврата.

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

В объект Payment  добавлены параметры card.issuer_country (код страны, в которой выпущена банковская карта) и card.issuer_name (наименование эмитента).

Добавлена возможность авторизации по протоколу OAuth 2.0: разработчики приложений (например, CMS, CRM) могут взаимодействовать с API ЮKassa от лица пользователей ЮKassa. Подробнее о партнерской программе ЮKassa

Добавлена возможность получить список чеков  платежа или возврата.

Добавлена новая причина отмены платежа — permission_revoked (пользователь отозвал разрешение на повторы платежей).

Добавлена возможность создать платеж с новым способом оплаты wechat (оплата через приложение WeChat).

Теперь ЮKassa поддерживает работу с онлайн-кассами Кит Инвест.

API ЮKassa больше не поддерживает способ оплаты psb (интернет-банк Промсвязьбанка).

Изменены параметры объекта airline:

Запуск портала документации API ЮKassa для разработчиков.

Добавлена возможность создать платеж с новым способом оплаты tinkoff_bank (интернет-банк Тинькофф).

Добавлена новая ставка НДС 20% для способа оплаты b2b_sberbank (Сбербанк Бизнес Онлайн).

ЮKassa теперь поддерживает ФФД 1.05: добавлена возможность при создании платежа  передавать для чека параметры payment_mode (признак способа расчета) и payment_subject (признак предмета расчета).

Добавлена возможность создать платеж с новым способом оплаты b2b_sberbank (Сбербанк Бизнес Онлайн).

ЮKassa больше не возвращает код ответа HTTP 202 («запрос обрабатывается») — в ответ придет либо «успех», либо «неудача».

Добавлен способ оплаты psb (интернет-банк Промсвязьбанка) в объект Payment . Этот способ оплаты пользователь может выбрать только на странице ЮKassa.

Добавлена возможность при создании платежа  задать язык, на котором пользователю будет выводиться информация для подтверждения оплаты (параметр locale в объекте confirmation).

Добавлен объект authorization_details (данные об авторизации платежа) в объект Payment .

Добавлена возможность создать платеж с новым способом оплаты google_pay (Google Pay).

Добавлен объект cancellation_details (комментарий к отмене платежа) в объект Payment .

Добавлена возможность создать платеж с новым способом оплаты installments («Заплатить по частям»).

Добавлен параметр first6 (BIN номера банковской карты, первые 6 цифр) в объект card .

Добавлена возможность при создании платежа передать длинную запись для оплаты авиабилетов (объект airline).

Добавлен признак test в объект Payment .

Добавлен параметр description в объект Payment .

Добавлен параметр expires_at в объект Payment .

Запуск API ЮKassa.