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

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

2022 год

20 июня

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

3 июня

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

20 мая

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

6 мая

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

1 мая

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

29 апреля

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

payer_bank_details.kpp

стал необязательным.

20 апреля

API ЮKassa больше не поддерживает способы оплаты Apple Pay (
apple_pay
) и Google Pay (
google_pay
).
Изменения в виджете ЮKassa:
- Виджет теперь поддерживает оплату через СБП.
- Для тех, кто настраивает отображение способов оплаты: использовать комбинацию способов оплаты в виджете больше нельзя.

14 апреля

В объекте возврата со статусом
canceled
теперь возвращается объект
cancellation_details
с комментарием, кто отменил возврат и по какой причине.
Серверные SDK (PHP, Python) и мобильные SDK (iOS SDK, Android SDK) теперь размещены не на GitHub, а в репозитории ЮKassa.

11 апреля

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

25 марта

Теперь при оплате через SberPay в объекте платежа со статусом
succeeded
могут возвращаться объекты
payment_method.card
(сведения о банковской карте) и
authorization_details
(данные об авторизации платежа).
Теперь, если вы пользуетесь решением ЮKassa для работы по 54-ФЗ, вы можете формировать чеки в соответствии с ФФД 1.2 и передавать в них реквизиты для товаров, которые подлежат маркировке. Подробнее про переход на ФФД 1.2 и то, какие онлайн-кассы поддерживаются

16 марта

Добавлена возможность создать платеж с новым способом оплаты

sbp

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

11 марта

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

Оплата через Apple Pay доступна только при использовании карты Мир.
Прием платежей через Google Pay временно недоступен. Оплата с помощью этого способа оплаты будет доступна, если появится возможность добавить в Google Pay карту Мир.

11 февраля

Способ оплаты WebMoney (

webmoney

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

7 февраля

Способ оплаты СберБанк Онлайн выведен из эксплуатации. Если вам понадобится вернуть платежи через СберБанк Онлайн, вы сможете сделать это до 10 апреля 2022 года включительно (до 23:59:59 по московскому времени). Для приема платежей через СберБанк используйте способ оплаты SberPay.
Параметр
tax_system_code
при формировании чека стал обязательным для тех, кто использует онлайн-кассу АТОЛ и ФФД 1.2.

2021 год

25 ноября

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

payment_methods

вернется ошибка

customization_of_payment_methods_not_allowed

23 ноября

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

19 ноября

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

77.75.156.11
77.75.156.35

11 ноября

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

теперь вы можете обрабатывать события виджета для взаимодействия с пользователем после оплаты и при закрытии всплывающего окна с платежной формой;
виджет больше не возвращает код ошибки —
return_url_required
(URL возврата не передан). Параметр
return_url
стал необязательным, так как теперь взаимодействовать с пользователем после оплаты можно двумя способами: настроить переход на
return_url
или обработать события процесса оплаты.

8 ноября

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

8 октября

В объект Payment добавлен параметр

authorization_details.three_d_secure

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

6 октября

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

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

29 сентября

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

24 сентября

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

17 сентября

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

15 сентября

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

additional_user_props

) и предмета расчета (

additional_payment_subject_props

). Доступно только тем, кто использует сценарий Сначала платеж, затем чек.

13 сентября

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

8 сентября

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

25 августа

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

18 августа

В виджет ЮKassa добавлена возможность запоминать банковские карты, которыми пользователь расплачивался в вашем магазине, и отображать их при повторных платежах.
Для тех, кто пользуется Безопасной сделкой:
- Теперь вы можете получить список всех созданных сделок.
- В объект сделки Deal добавлены параметры
  payout_balance
  (сумма вознаграждения продавца) и
  description
  (описание сделки).

2 августа

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

27 июля

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

13 июля

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

30 июня

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

8 июня

Способы оплаты Apple Pay и Google Pay можно сохранить для автоплатежей.
В виджет ЮKassa добавлена возможность сохранять способ оплаты Apple Pay и Google Pay для автоплатежей.

21 мая

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

12 мая

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

2 апреля

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

31 марта

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

15 марта

В виджет ЮKassa добавлена возможность настраивать отображение способов оплаты.
ЮKassa больше не поддерживает веб библиотеку Checkout UI. Если хотите отобразить готовую форму для ввода данных банковской карты, используйте виджет ЮKassa. Если хотите сделать свой дизайн формы, используйте Checkout.js.

1 февраля

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

2020 год

23 декабря

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

виджет теперь сообщает об отображении платежной формы: метод
render
теперь возвращает Promise;
добавлена возможность перезагрузить инициализированный виджет.

22 декабря

Добавлено ограничение на возврат платежей: платежи через Сбербанк Онлайн (способ оплаты

sberbank

) можно вернуть только в течение одного года с момента их создания.

21 декабря

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

unsupported_mobile_operator

(ЮKassa не поддерживает оплату с указанного номера телефона).

18 декабря

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

15 декабря

Для тех, кто самостоятельно интегрирует способ оплаты Google Pay: параметр токенизации

gateway

теперь нужно передавать со значением

yoomoney

10 декабря

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

7 декабря

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

Endpoint: запросы теперь нужно отправлять на
https://api.yookassa.ru/v3
.
Комментарии к неуспешным платежам: если платеж отменила ЮKassa, в
cancellation_details.party
вернется значение
yoo_money
.
Оплата из кошелька ЮMoney: код способа оплаты изменен на
yoo_money
.
Серверные SDK: обновлены SDK для PHP и Python.

1 декабря

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

iOS SDK: переименован модуль SDK, обновлены зависимости, прекращена поддержка версий iOS ниже 10.0. Подробнее о переходе на новую версию SDK
Android SDK: переименован модуль SDK, обновлены зависимости, прекращена поддержка версий Android ниже 5.0. Подробнее об обновлении до новой версии SDK

18 ноября

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

17 ноября

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

10 сентября

API ЮKassa больше не поддерживает способ оплаты

wechat

(оплата через приложение WeChat).

28 августа

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

26 августа

Изменен параметр

card.first6

объекта Payment :

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

31 июля

Виджет ЮKassa теперь возвращает новый код ошибки —

invalid_return_url

(некорректный URL страницы завершения оплаты).

24 июля

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

23 июля

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

17 июля

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

expired_on_confirmation
— пользователь не подтвердил платеж за отведенное время;
expired_on_capture
— истек срок списания оплаты;
canceled_by_merchant
— платеж отменен по API;
internal_timeout
— ЮKassa не удалось обработать запрос в течение 30 секунд.

5 июня

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

3 июня

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

2 июня

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

21 мая

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

14 мая

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

5 мая

В объект Payment добавлен параметр

income_amount

(сумма платежа за вычетом комиссии ЮKassa).

2 апреля

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

27 марта

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

6 марта

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

Добавлена возможность запрашивать права для создания возвратов.
Добавлен объект
payment_methods
(список способов оплаты, доступных магазину) в объект Me .

14 февраля

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

6 февраля

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

2019 год

11 декабря

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

10 декабря

Теперь при создании платежа со способом оплаты Google Pay не нужно передавать параметр

google_transaction_id

(идентификатор транзакции Google).

19 ноября

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

12 ноября

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

27 сентября

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

26 сентября

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

5 сентября

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

14 августа

В объект Payment добавлены параметры

card.issuer_country

(код страны, в которой выпущена банковская карта) и

card.issuer_name

(наименование эмитента).

12 июля

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

5 июля

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

1 июля

Добавлена возможность при создании платежа передавать для чека данные о пользователе (объект
customer
) и дополнительные данные о товаре (параметры
product_code
,
country_of_origin_code
,
customs_declaration_number
,
excise
).
Параметры
receipt.email
и
receipt.phone
устарели. Их можно продолжать использовать, но рекомендуется передавать данные в объекте
receipt.customer
(параметры
email
и
phone
соответственно).

27 июня

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

permission_revoked

(пользователь отозвал разрешение на повторы платежей).

25 июня

Добавлена возможность создать платеж с новым способом оплаты

wechat

(оплата через приложение WeChat).

27 мая

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

21 мая

API ЮKassa больше не поддерживает способ оплаты

psb

(интернет-банк Промсвязьбанка).

16 мая

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

airline

passengers
и
legs
стали необязательными;
ticket_number
— обязательный параметр, но если его значение неизвестно, необходимо передавать
booking_reference
;
в информации о перелетах (
legs
) появилась возможность указать код авиакомпании (
carrier_code
).

4 апреля

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

26 марта

Для способа оплаты
alfabank
(Альфа-Клик) добавлена возможность провести платеж по сценарию
redirect
. Передавать при этом логин пользователя в Альфа-Клике необязательно.
Теперь при создании платежа со способом оплаты
qiwi
(QIWI Кошелек) можно не передавать телефон пользователя (параметр
phone
в объекте
payment_method_data
стал необязательным).

14 февраля

Добавлена возможность создать платеж с новым способом оплаты

tinkoff_bank

(интернет-банк Тинькофф).

6 февраля

ЮKassa теперь может уведомлять о двух новых событиях:
payment.canceled
(платеж перешел в статус
canceled
) и
refund.succeeded
(возврат перешел в статус
succeeded
).
В личном кабинете теперь можно выбрать события, которые вы хотите отслеживать с помощью уведомлений.

2018 год

28 декабря

Добавлена новая ставка НДС 20% для способа оплаты

b2b_sberbank

(Сбербанк Бизнес Онлайн).

17 декабря

Изменено время, в течение которого можно подтвердить платеж в статусе
waiting_for_capture
: теперь при оплате из кошелька ЮMoney, как и при оплате банковской картой, подтвердить платеж нужно за 7 дней, а при оплате любым другим способом — за 6 часов.
После отмены платежа , оплаченного из кошелька ЮMoney, деньги возвращаются на счет плательщика мгновенно.

19 ноября

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

payment_mode

(признак способа расчета) и

payment_subject

(признак предмета расчета).

15 октября

Добавлена возможность создать платеж с новым способом оплаты

b2b_sberbank

(Сбербанк Бизнес Онлайн).

12 сентября

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

7 сентября

Добавлен способ оплаты

psb

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

31 июля

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

locale

в объекте

confirmation

20 июля

Добавлен объект

authorization_details

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

17 июля

Добавлена возможность создать платеж с новым способом оплаты

google_pay

(Google Pay).

4 июня

Добавлен объект

cancellation_details

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

17 апреля

Добавлена возможность создать платеж с новым способом оплаты

installments

(«Заплатить по частям»).

10 апреля

Добавлен параметр

first6

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

4 апреля

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

airline

15 января

Добавлен признак

test

в объект Payment .

2017 год

30 ноября

Добавлен параметр

description

в объект Payment .

22 ноября

Добавлен
id
ошибки в объект Error.
Добавлен параметр
captured_at
в объект Payment .

30 октября

Добавлен параметр

expires_at

в объект Payment .

15 октября

Запуск API ЮKassa.