Docs
Инструкции
Помощь
Подключить ЮKassa
История изменений API
2022 год
9 декабря
Для тех, кто делает выплаты: теперь ЮKassa списывает комиссию с вашего баланса не за все успешные операции раз в сутки, а отдельно за каждую выплату сразу после ее проведения.
5 декабря
Платежи через СБП больше нельзя проводить в две стадии. Теперь в запросе на создание платежа через СБП нужно всегда передавать параметр
capture
со значением
true
. Если вы используете Умный платеж или виджет ЮKassa, то при проведении платежей в две стадии способ оплаты СБП не отобразится.
1 декабря
21 ноября
15 ноября
Для партнеров, которые используют OAuth-токен, добавлена возможность проводить автоплатежи.
11 ноября
В ЮKassa появился особый тестовый режим для тех, кто хочет оценить возможности API. Указывать данные компании и подписывать договор не нужно. Доступно для обычных платежей, выплат и партнерской программы. Для тестирования Безопасной сделки и Сплитования платежей нужно регистрироваться как обычно, с указанием данных компании.
9 ноября
В ЮKassa появилась возможность передавать номер пополняемого телефона в запросе на создание платежа . Подробнее о пополнении баланса
20 октября
12 октября
Для тех, кто делает выплаты на банковские карты с использованием виджета для сбора данных: вышла новая версия виджета — 3.0.0. В этой версии изменился набор параметров, которые возвращает библиотека при успехе. Подробнее об изменениях
7 октября
Изменился процесс тестирования оплаты кошельком: вы можете протестировать оплату в тестовом магазине без выхода из аккаунта своего кошелька ЮMoney.
6 октября
Для тех, кто использует автоплатежи: теперь вы можете протестировать неуспешный сценарий, в котором платеж с сохранением способа оплаты проходит успешно, а повторный платеж с использованием полученного идентификатора завершается ошибкой.
29 сентября
При оплате через СБП временно недоступна возможность проводить двухстадийные платежи.
27 сентября
Самозанятые теперь могут проводить платежи с автоматической регистрацией чека в сервисе Мой налог.
14 сентября
Добавлена возможность сохранить способ оплаты СБП для автоплатежей.
21 июля
Checkout.js больше не возвращает коды ошибок
expired_card
(карта просрочена) и 
card_declined
(карта отклонена).
11 июля
30 июня
Онлайн-площадки, которые используют Сплитование платежей, теперь могут в запросе на создание платежа  для каждого магазина передавать описание транзакции (
transfers.description
). Продавец увидит это описание в личном кабинете ЮKassa.
29 июня
Для тех, кто пользуется решением ЮKassa для работы по 54-ФЗ: теперь онлайн-кассы Кит Инвест и МодульКасса поддерживают формирование чеков по ФФД 1.2.
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 апреля
14 апреля
  • В объекте возврата  со статусом
    canceled
    теперь возвращается объект
    cancellation_details
    с комментарием, кто отменил возврат и по какой причине.
  • Серверные SDK (PHP, Python) и мобильные SDK (iOS SDK, Android SDK) теперь размещены не на GitHub, а в репозитории ЮKassa.
11 апреля
Новые требования к URL для входящих уведомлений: для подписки на уведомления теперь подойдут только URL с TCP-портами 443 или 8443.
25 марта
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 августа
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 марта
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. Что изменилось:
1 декабря
Обновлены мобильные 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 марта
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.