Виджет ЮKassa теперь обрабатывает неуспешные попытки платежа при оплате всеми способами, а Умный платеж — при оплате банковской картой, через SberPay, СБП и из кошелька ЮMoney. При самостоятельной интеграции неуспешные попытки теперь обрабатывают готовые платежные формы для оплаты банковской картой, из кошелька ЮMoney или через SberPay. Если вы хотите самостоятельно принимать решение, что сообщать пользователю при неуспешном платеже, напишите менеджеру ЮKassa.
Добавлен новый диапазон IP-адресов, с которых ЮKassa может присылать уведомления: 2a02:5180::/32
ЮKassa прекращает поддерживать немецкий язык в виджете. Если вы отображаете тексты в платежной форме на немецком, выберите другой язык — английский или русский.
Умный платеж теперь поддерживает сохранение способа оплаты для автоплатежей.
Максимальный размер платежа через СБП увеличен с 600 000 рублей до 1 млн рублей.
Теперь при оплате через Сбербанк Бизнес Онлайн в объекте платежа параметр
payer_bank_details.kpp
стал необязательным.- API ЮKassa больше не поддерживает способы оплаты Apple Pay (apple_pay) и Google Pay (google_pay).
- Изменения в виджете ЮKassa:
- Виджет теперь поддерживает оплату через СБП.
- Для тех, кто настраивает отображение способов оплаты: использовать комбинацию способов оплаты в виджете больше нельзя.
- В объекте возврата со статусомcanceledтеперь возвращается объектcancellation_detailsс комментарием, кто отменил возврат и по какой причине.
- Серверные SDK (PHP, Python) и мобильные SDK (iOS SDK, Android SDK) теперь размещены не на GitHub, а в репозитории ЮKassa.
Новые требования к URL для входящих уведомлений: для подписки на уведомления теперь подойдут только URL с TCP-портами 443 или 8443.
- Теперь при оплате через SberPay в объекте платежа со статусомsucceededмогут возвращаться объектыpayment_method.card(сведения о банковской карте) иauthorization_details(данные об авторизации платежа).
- Теперь, если вы пользуетесь решением ЮKassa для работы по 54-ФЗ, вы можете формировать чеки в соответствии с ФФД 1.2 и передавать в них реквизиты для товаров, которые подлежат маркировке. Подробнее про переход на ФФД 1.2 и то, какие онлайн-кассы поддерживаются
Добавлена возможность создать платеж с новым способом оплаты
sbp
(оплата через СБП — Систему быстрых платежей Банка России).В России приостановлены операции по картам Visa, MasterCard, JCB и AmericanExpress, поэтому в работе Apple Pay и Google Pay есть ограничения:
- Оплата через Apple Pay доступна только при использовании карты Мир.
- Прием платежей через Google Pay временно недоступен. Оплата с помощью этого способа оплаты будет доступна, если появится возможность добавить в Google Pay карту Мир.
Способ оплаты WebMoney (
webmoney
) отключен, так как у расчетного банка WebMoney отозвали лицензию. Платежи и возвраты этим способом недоступны.- Способ оплаты СберБанк Онлайн выведен из эксплуатации. Если вам понадобится вернуть платежи через СберБанк Онлайн, вы сможете сделать это до 10 апреля 2022 года включительно (до 23:59:59 по московскому времени). Для приема платежей через СберБанк используйте способ оплаты SberPay.
- Параметрtax_system_codeпри формировании чека стал обязательным для тех, кто использует онлайн-кассу АТОЛ и ФФД 1.2.
Теперь, если вы хотите в виджете ЮKassa настраивать отображение способов оплаты, вам сначала нужно подключить эту опцию — обратиться к менеджеру. Если этого не сделать, при инициализации виджета с переданным параметром
payment_methods
вернется ошибка customization_of_payment_methods_not_allowed
.Добавлена возможность сохранить способ оплаты SberPay для автоплатежей.
Теперь ЮKassa может присылать уведомления с двух новых IP-адресов:
- 77.75.156.11
- 77.75.156.35
Обновления в виджете ЮKassa:
- теперь вы можете обрабатывать события виджета для взаимодействия с пользователем после оплаты и при закрытии всплывающего окна с платежной формой;
- виджет больше не возвращает код ошибки — return_url_required(URL возврата не передан). Параметрreturn_urlстал необязательным, так как теперь взаимодействовать с пользователем после оплаты можно двумя способами: настроить переход наreturn_urlили обработать события процесса оплаты.
В ЮKassa добавлена поддержка ФФД 1.2 для работы с онлайн-кассами. Возможность передачи новых реквизитов для маркировки будет реализована позже.
В объект Payment добавлен параметр
authorization_details.three_d_secure
(данные о прохождении пользователем аутентификации по 3‑D Secure).Способ оплаты СберБанк Онлайн выводится из эксплуатации:
- Если вы хотите начать принимать платежи через СберБанк, используйте SberPay.
- Если вы уже принимаете платежи через СберБанк Онлайн, вы перейдете на SberPay автоматически.
Добавлена возможность отображать виджет ЮKassa во всплывающем окне.
Для тех, кто использует Безопасную сделку: добавлена возможность подписаться на уведомления о смене статусов созданных сделок и выплат.
При неуспешном платеже через Apple Pay и Google Pay виджет ЮKassa или страница Умного платежа отображает сообщение об ошибке и предлагает попробовать оплатить еще раз с выбором способа оплаты.
Добавлена возможность в запросе на создание чека передавать дополнительные реквизиты пользователя (
additional_user_props
) и предмета расчета (additional_payment_subject_props
). Доступно только тем, кто использует сценарий Сначала платеж, затем чек.Для тех, кто использует Безопасную сделку: минимальная сумма выплаты на банковскую карту продавца снижена со 100 рублей до 1 рубля. Подробнее о лимитах выплат
Для тестирования добавлена возможность создавать тестовый магазин из личного кабинета ЮKassa.
Для тех, кто использует Безопасную сделку: добавлена возможность при выплатах передавать в запросе номер банковской карты.
- В виджет ЮKassa добавлена возможность запоминать банковские карты, которыми пользователь расплачивался в вашем магазине, и отображать их при повторных платежах.
- Для тех, кто пользуется Безопасной сделкой:
- Теперь вы можете получить список всех созданных сделок.
- В объект сделки Deal добавлены параметры payout_balance(сумма вознаграждения продавца) иdescription(описание сделки).
Для тех, кто использует Безопасную сделку: добавлена возможность делать выплаты на кошельки ЮMoney.
Добавлено ограничение на создание чеков по сценарию Сначала платеж, потом чек: теперь к одному платежу или возврату можно привязать не более 15 чеков.
Для тестирования оплаты банковской картой добавлены тестовые банковские карты разных платежных систем.
В ЮKassa появилось новое решение для платформ — Безопасная сделка. С его помощью онлайн-площадки, на которых частные лица продают друг другу товары и оказывают услуги, могут принимать оплату от покупателя и делать выплату продавцу.
- Способы оплаты Apple Pay и Google Pay можно сохранить для автоплатежей.
- В виджет ЮKassa добавлена возможность сохранять способ оплаты Apple Pay и Google Pay для автоплатежей.
Виджет ЮKassa при оплате банковской картой теперь самостоятельно обрабатывает неуспешные попытки платежа и предлагает пользователю попробовать оплатить еще раз.
Вы можете отключить эту настройку через менеджера ЮKassa и обрабатывать неуспешные платежи самостоятельно.
Добавлена новая версия способа оплаты через СберБанк — SberPay. ЮKassa переводит на него тех, кто использует способ оплаты СберБанк Онлайн. Подробнее о SberPay
Онлайн-площадки, которые используют Сплитование платежей, теперь могут получить информацию о магазине продавца , подключенного к площадке.
В виджете ЮKassa больше нельзя настроить способ прохождения аутентификации по 3‑D Secure при оплате банковской картой. Пользователь теперь всегда подтверждает платеж во всплывающем окне, а не на отдельной странице.
- В виджет ЮKassa добавлена возможность настраивать отображение способов оплаты.
- ЮKassa больше не поддерживает веб библиотеку Checkout UI. Если хотите отобразить готовую форму для ввода данных банковской карты, используйте виджет ЮKassa. Если хотите сделать свой дизайн формы, используйте Checkout.js.
Онлайн-площадки, которые используют Сплитование платежей, теперь могут для каждого магазина передать дополнительную информацию о заказе .
Обновления в виджете ЮKassa:
- виджет теперь сообщает об отображении платежной формы: метод renderтеперь возвращает Promise;
- добавлена возможность перезагрузить инициализированный виджет.
Добавлено ограничение на возврат платежей: платежи через Сбербанк Онлайн (способ оплаты
sberbank
) можно вернуть только в течение одного года с момента их создания.Добавлена новая причина отмены платежа —
unsupported_mobile_operator
(ЮKassa не поддерживает оплату с указанного номера телефона).В реестр платежей добавлено три новых поля: Имя плательщика, Адрес плательщика и ИНН. Эти данные приходят только при оплате из кошелька ЮMoney, если сумма платежа больше 15 000 рублей.
Для тех, кто самостоятельно интегрирует способ оплаты Google Pay: параметр токенизации
gateway
теперь нужно передавать со значением yoomoney
.Обновлены веб SDK: виджет ЮKassa, Checkout.js, Checkout UI.
Запуск новой версии API. Что изменилось:
- Endpoint: запросы теперь нужно отправлять на https://api.yookassa.ru/v3.
- Комментарии к неуспешным платежам: если платеж отменила ЮKassa, в cancellation_details.partyвернется значениеyoo_money.
- Оплата из кошелька ЮMoney: код способа оплаты изменен на yoo_money.
- Серверные SDK: обновлены SDK для PHP и Python.
Обновлены мобильные SDK:
- iOS SDK: переименован модуль SDK, обновлены зависимости, прекращена поддержка версий iOS ниже 10.0. Подробнее о переходе на новую версию SDK
- Android SDK: переименован модуль SDK, обновлены зависимости, прекращена поддержка версий Android ниже 5.0. Подробнее об обновлении до новой версии SDK
Для партнеров: в ЮKassa изменился процесс получения OAuth-токенов. Подробнее об изменениях
В виджете ЮKassa обновлен дизайн платежной формы.
API ЮKassa больше не поддерживает способ оплаты
wechat
(оплата через приложение WeChat).Онлайн-площадки, которые используют Сплитование платежей, теперь могут отслеживать статус подключения магазинов в личном кабинете.
Изменен параметр
card.first6
объекта Payment :- параметр стал необязательным;
- значение параметра теперь зависит от способа ввода данных банковской карты.
Виджет ЮKassa теперь возвращает новый код ошибки —
invalid_return_url
(некорректный URL страницы завершения оплаты).- Добавлена возможность получить списки платежей и возвратов.
- Теперь можно запросить список всех чеков магазина, не привязываясь к конкретному платежу или возврату.
Теперь с помощью Сплитования платежей онлайн-площадки могут удерживать с магазинов комиссию за проданные товары и услуги.
Добавлены новые причины отмены платежа:
- expired_on_confirmation— пользователь не подтвердил платеж за отведенное время;
- expired_on_capture— истек срок списания оплаты;
- canceled_by_merchant— платеж отменен по API;
- internal_timeout— ЮKassa не удалось обработать запрос в течение 30 секунд.
Добавлено ограничение на возврат платежей: вернуть платежи можно только в течение трех лет с момента их создания.
В виджете ЮKassa теперь можно настраивать цветовую схему платежной формы.
Вышла новая версия мобильного SDK для iOS. Если вы уже используете библиотеку для приема платежей, обновите настройки зависимостей.
В ЮKassa появилось новое решение для платформ. Теперь онлайн-площадки, на которых магазины размещают товары и услуги, могут принимать платежи и автоматически распределять деньги между магазинами.
В виджете ЮKassa при оплате банковской картой пользователь может проходить аутентификацию по 3-D Secure во всплывающем окне, оставаясь при этом на вашем сайте.
В объект Payment добавлен параметр
income_amount
(сумма платежа за вычетом комиссии ЮKassa).Добавлена возможность тестировать работу с чеками.
Добавлен новый сценарий отправки чеков. Теперь передавать данные для формирования чека прихода и чека возврата прихода можно в запросе на создание чека .
Для партнеров:
- Добавлена возможность запрашивать права для создания возвратов.
- Добавлен объект payment_methods(список способов оплаты, доступных магазину) в объект Me .
В виджете Ю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
Добавлена возможность получить список чеков платежа или возврата.
- Добавлена возможность при создании платежа передавать для чека данные о пользователе (объект customer) и дополнительные данные о товаре (параметрыproduct_code,country_of_origin_code,customs_declaration_number,excise).
- Параметры receipt.emailиreceipt.phoneустарели. Их можно продолжать использовать, но рекомендуется передавать данные в объектеreceipt.customer(параметрыemailиphoneсоответственно).
Добавлена новая причина отмены платежа —
permission_revoked
(пользователь отозвал разрешение на повторы платежей).Добавлена возможность создать платеж с новым способом оплаты
wechat
(оплата через приложение WeChat).Теперь ЮKassa поддерживает работу с онлайн-кассами Кит Инвест.
API ЮKassa больше не поддерживает способ оплаты
psb
(интернет-банк Промсвязьбанка).Изменены параметры объекта
airline
:- passengersиlegsстали необязательными;
- ticket_number— обязательный параметр, но если его значение неизвестно, необходимо передаватьbooking_reference;
- в информации о перелетах (legs) появилась возможность указать код авиакомпании (carrier_code).
Запуск портала документации API ЮKassa для разработчиков.
- Для способа оплаты alfabank(Альфа-Клик) добавлена возможность провести платеж по сценариюredirect. Передавать при этом логин пользователя в Альфа-Клике необязательно.
- Теперь при создании платежа со способом оплаты qiwi(QIWI Кошелек) можно не передавать телефон пользователя (параметрphoneв объектеpayment_method_dataстал необязательным).
Добавлена возможность создать платеж с новым способом оплаты
tinkoff_bank
(интернет-банк Тинькофф).- ЮKassa теперь может уведомлять о двух новых событиях:
payment.canceled(платеж перешел в статусcanceled) иrefund.succeeded(возврат перешел в статусsucceeded).
- В личном кабинете теперь можно выбрать события, которые вы хотите отслеживать с помощью уведомлений.
Добавлена новая ставка НДС 20% для способа оплаты
b2b_sberbank
(Сбербанк Бизнес Онлайн).- Изменено время, в течение которого можно подтвердить платеж в статусе waiting_for_capture: теперь при оплате из кошелька ЮMoney, как и при оплате банковской картой, подтвердить платеж нужно за 7 дней, а при оплате любым другим способом — за 6 часов.
- После отмены платежа , оплаченного из кошелька ЮMoney, деньги возвращаются на счет плательщика мгновенно.
Ю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.