В ЮKassa появилось новое решение для работы по 54-ФЗ — Чеки от ЮKassa.
С его помощью вы можете отправлять чеки в налоговую без аренды онлайн-кассы и покупки фискального накопителя.
Виджет ЮKassa теперь поддерживает оплату через Mir Pay.
Для тех, кто использует Безопасную сделку: добавлена новая причина отмены выплаты —
identification_required
(пополнение анонимного кошелька запрещено, пользователю необходимо идентифицировать кошелек).Для тех, кто использует iOS SDK: больше нельзя установить демо-приложение, которое показывает, как выглядят платежные инструменты и как проходит процесс оплаты.
Добавлен новый способ оплаты Mir Pay. Этот способ отображается на платежной форме при оплате с мобильных устройств на Android. Доступно тем, кто использует Умный платеж или готовую страницу ЮKassa для оплаты банковской картой.
Для тех, кто делает выплаты: теперь ЮKassa списывает комиссию с вашего баланса не за все успешные операции раз в сутки, а отдельно за каждую выплату сразу после ее проведения.
Платежи через СБП больше нельзя проводить в две стадии.
Теперь в запросе на создание платежа через СБП нужно всегда передавать параметр
capture
со значением true
.
Если вы используете Умный платеж или виджет ЮKassa, то при проведении платежей в две стадии способ оплаты СБП не отобразится.- Добавлен новый инициатор отмены возврата —
refund_network
(участники процесса возврата, кроме вас и ЮKassa). - Добавлена новая причина отмены возврата —
rejected_by_payee
(эмитент платежного средства отклонил возврат по неизвестным причинам).
- Теперь при оплате через SberPay ЮKassa дополнительно отображает QR-код, который пользователь может просканировать в приложении СберБанка для подтверждения платежа. Доступно в виджете ЮKassa, Умном платеже и при самостоятельной интеграции с перенаправлением на страницу ЮKassa.
- Для тех, кто самостоятельно интегрирует способ оплаты SberPay: теперь вы можете реализовать сценарий подтверждения QR-код.
Для партнеров, которые используют OAuth-токен, добавлена возможность проводить автоплатежи.
В ЮKassa появился особый тестовый режим для тех, кто хочет оценить возможности API.
Указывать данные компании и подписывать договор не нужно.
Доступно для обычных платежей, выплат и партнерской программы.
Для тестирования Безопасной сделки и Сплитования платежей нужно регистрироваться как обычно, с указанием данных компании.
В ЮKassa появилась возможность передавать номер пополняемого телефона в запросе на создание платежа . Подробнее о пополнении баланса
- Для тех, кто пользуется решением ЮKassa для работы по 54-ФЗ: теперь онлайн-касса Эвотор поддерживает формирование чеков по ФФД 1.2.
- Для тех, кто делает выплаты через СБП: в объект участника СБП добавлен параметр
bic
(банковский идентификационный код банка или платежного сервиса).
Для тех, кто делает выплаты на банковские карты с использованием виджета для сбора данных: вышла новая версия виджета — 3.0.0. В этой версии изменился набор параметров, которые возвращает библиотека при успехе. Подробнее об изменениях
Изменился процесс тестирования оплаты кошельком:
вы можете протестировать оплату в тестовом магазине без выхода из аккаунта своего кошелька ЮMoney.
Для тех, кто использует автоплатежи: теперь вы можете протестировать неуспешный сценарий, в котором платеж с сохранением способа оплаты проходит успешно, а повторный платеж с использованием полученного идентификатора завершается ошибкой.
При оплате через СБП временно недоступна возможность проводить двухстадийные платежи.
Самозанятые теперь могут проводить платежи с автоматической регистрацией чека в сервисе Мой налог.
Добавлена возможность сохранить способ оплаты СБП для автоплатежей.
Checkout.js больше не возвращает коды ошибок
expired_card
(карта просрочена) и card_declined
(карта отклонена).- С помощью API ЮKassa теперь можно делать выплаты. Деньги можно переводить на банковские карты, кошельки ЮMoney и через СБП. Получателями могут быть физические лица и самозанятые. Подробнее о выплатах
- Для тех, кто использует автоплатежи: идентификатор сохраненного способа оплаты теперь можно использовать не только для проведения безакцептных платежей, но и для проведения выплат. Подробнее о выплатах с использованием идентификатора сохраненного способа оплаты
Онлайн-площадки, которые используют Сплитование платежей, теперь могут в запросе на создание платежа для каждого магазина передавать описание транзакции (
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
стал необязательным.- 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.