История изменений
Это старая версия API. Переходите на API ЮKassa.
2025 год
3 февраля
Для тех, кто при платежах и возвратах отправляет данные для чеков: ЮKassa теперь поддерживает ставки НДС 5% и 7%. Новые коды ставок можно передавать, только если ваша онлайн-касса тоже их поддерживает. Подробнее о новых кодах ставок и особенностях работы с ними
2024 год
3 октября
Теперь при пополнении баланса телефона (МСС 4814) нужно передавать параметр
topped_up_phone
с номером пополняемого телефона. Это обязательно при оплате с банковской карты (paymentType="AC"
), из кошелька ЮMoney (paymentType="PC"
), при выборе способа оплаты на стороне ЮKassa (paymentType=""
) и при повторе платежа (метод repeatCardPayment
).1 июля
Протокол больше не поддерживает способ оплаты «Заплатить по частям» (
CR
):- Платежи этим способом недоступны.
- Возвраты можно делать до 31 декабря 2024 года включительно (до 23:59:59 по московскому времени). Если с момента платежа прошло 30 дней и больше, лучше уведомить менеджера перед возвратом — он поможет оформить всё правильно.
21 февраля
Способ оплаты QIWI Кошелек (
QW
) отключен, так как у КИВИ Банка отозвали лицензию. Платежи и возвраты этим способом недоступны.2023 год
15 июня
Протокол больше не поддерживает способы оплаты Альфа-Клик и ЕРИП (Беларусь).
2022 год
16 декабря
Добавлен новый способ оплаты через Mir Pay.
19 августа
Протокол больше не поддерживает способ оплаты MasterPass.
20 апреля
Протокол больше не поддерживает способы оплаты Apple Pay и Google Pay.
25 марта
При оплате наличными через терминалы больше нельзя выдавать многоразовые коды платежа. Уже выпущенные коды можно продолжать использовать.
Если хотите принимать платежи наличными, запросите генерацию одноразового кода: в платежной форме укажите способ оплаты
paymentType=GP
и передайте сумму платежа в параметре sum
.11 марта
В России приостановлены операции по картам Visa, MasterCard, JCB и AmericanExpress, поэтому в работе Apple Pay и Google Pay есть ограничения:
- Оплата через Apple Pay доступна только при использовании карты Мир.
- Прием платежей через Google Pay временно недоступен. Оплата с помощью этого способа оплаты будет доступна, если появится возможность добавить в Google Pay карту Мир.
11 февраля
Способ оплаты WebMoney (
WM
) отключен, так как у расчетного банка WebMoney отозвали лицензию. Платежи и возвраты этим способом недоступны.7 февраля
Способ оплаты СберБанк Онлайн выведен из эксплуатации. Если вам понадобится вернуть платежи через СберБанк Онлайн, вы сможете сделать это до 10 апреля 2022 года включительно (до 23:59:59 по московскому времени).
Для приема платежей через СберБанк используйте способ оплаты SberPay.
2021 год
6 октября
Способ оплаты СберБанк Онлайн выводится из эксплуатации:
- Если вы хотите начать принимать платежи через СберБанк, используйте способ оплаты SberPay.
- Если вы уже принимаете платежи через СберБанк Онлайн, вы перейдете на SberPay автоматически.
21 мая
Добавлена ошибка с кодом 616, которая приходит в ответе на запрос
returnPayment
при попытке вернуть перевод с истекшим сроком возврата.12 мая
Добавлен новый способ оплаты через СберБанк — SberPay. ЮKassa переводит на него тех, кому доступен способ оплаты СберБанк Онлайн.
2020 год
22 декабря
Добавлено ограничение на возврат переводов: успешный перевод с оплатой через СберБанк Онлайн (код способа оплаты —
SB
) можно вернуть только в течение одного года с момента регистрации заказа в ЮKassa (orderCreatedDatetime
в уведомлении о проверке заказа).10 декабря
- Для аутентификации соединений с серверами ЮKassa теперь нужен сертификат, выданный удостоверяющим центром ООО НКО «ЮМани» (NBCO YooMoney). В инструкции для получения сертификата обновлены заявка на сертификат, цепочка сертификации для проверки сертификата конечного сервера и список отозванных сертификатов (CRL).
- Платежную форму теперь нужно отправлять на новый адрес:
https://yoomoney.ru/eshop.xml
- Запросы по Протоколу управления заказами теперь нужно отправлять по новому адресу:
https://shop.yookassa.ru
- Адрес электронной почты для связи с менеджерами ЮKassa изменен на merchants@yoomoney.ru, адрес для связи по техническим вопросам изменен на b2b_support@yoomoney.ru.
5 июня
Добавлено ограничение на возврат переводов: вернуть успешный перевод можно только в течение трех лет с момента регистрации заказа в ЮKassa (
orderCreatedDatetime
в уведомлении о проверке заказа).6 февраля
Возможность принимать платежи от юрлиц через Сбербанк Бизнес Онлайн теперь доступна клиентам любых банков.
2019 год
11 октября
Добавили возможность принимать оплату с баланса мобильного телефона.
1 июля
- Добавили возможность при создании и возврате платежа передавать для чека данные о пользователе (параметр
customer
) и дополнительные данные о товаре (параметрыproductCode
,countryOfOriginCode
,customsDeclarationNumber
иexcise
). - Параметр
customerContact
устарел. Его всё еще можно использовать, но рекомендуется передавать данные в параметреcustomer
.
11 июня
Демо-среда ЮKassa выводится из эксплуатации. Для тестирования платежей используйте тестовый магазин.
2018 год
13 ноября
Добавили поддержку ФФД 1.05 для работы с онлайн-кассами: в платежной форме вместе с данными для чека можно передавать два новых параметра — признак предмета расчета (
paymentSubjectType
) и признак способа расчета (paymentMethodType
), оба параметра необязательные.26 апреля
Способ оплаты «КупиВкредит» (
paymentType=KV
) больше не поддерживается.2017 год
12 сентября
- Добавили описание ошибки 425 (техническая ошибка при ответе на запрос
createInvoice
). - Исправили несколько важных мелочей.
25 августа
- Добавили описание ошибки 428 (запрещен возврат для этого способа оплаты).
- В платежной форме HTTP и Email в параметре
cps_email
можно передавать только адрес электронной почты, иначе запрос проходит с ошибкой.
14 августа
- Появилась оплата через мобильное приложение СберБанка: покупатель переходит к выставленному счету по deeplink.
- В paymentAviso теперь передаются параметры для формирования чека. С их помощью можно отправлять электронный чек покупателю.
- При отправке параметров для чека название товара (параметр
text
) увеличилось до 128 символов. См. например Параметры для чека в платежной форме.
28 июля
Добавили пояснение про отправку данных для чека при холдировании. Данные для чека отправляются в онлайн-кассу на первом этапе: при успешной авторизации. Если при подтверждении оплаты сумма меняется, отправляется чек возврата, а потом — чек для новой операции. Если оплата на второй стадии отменяется, отправляется чек возврата.
11 июня
- В методе listOrders добавился параметр environment, который позволяет различать тестовые и настоящие операции.
- Если вы отправляете параметры для чека в методе returnPayment и не можете получить точную сумму (только на копейку меньше или на копейку больше), следует передавать вариант с суммой на копейку больше.
- Уточнили: время платежа в реестрах принятых переводов — это время создания операции в ЮKassa.
5 июня
Добавили пояснения в описание параметров для формирования чека. Примеры тоже поменялись.
1 июня
Добавили возможность передавать фискальные данные в онлайн-кассу подключенного магазина. Эти данные онлайн-касса передает в ОФД (оператор фискальных данных), из них можно сформировать чек для покупателя (в рамках этого протокола чек для покупателя не формируется).
Все изменения описаны в отдельном разделе: Изменения в протоколе для работы по 54-ФЗ
Добавлены разделы:
- Отправка данных для чека — описание сценария оплаты с отправкой фискальных данных
- Параметры для формирования чека — дополнительные параметры для передачи фискальных данных в платежной форме
Внесены изменения на страницы:
- Описание процесса оплаты
- Форма для HTTP-уведомлений
- Форма для Email-уведомлений
- Метод returnPayment
- Метод repeatCardPayment
- Метод createInvoice
- Коды ошибок
17 мая
Уточнили:
- отложенные платежи можно проводить только для
paymentType=AC
(оплата с банковской карты); - при оплате через КупиВкредит (
paymentType=KV
) все параметры с префиксом goods_ необязательные. Параметрseller_id
не передается. (см. Платежная форма).
6 апреля
Уточнили:
- параметры
customerNumber
иorderNumber
во всех случаяхnormalizedString
; - при оплате через КупиВкредит (
paymentType=KV
)category_code_N
иgoods_description_N
передавать не обязательно (см. Платежная форма).
14 марта
Поменяли:
- платежный метод Куппи.ру (
QP
) перестал работать (сервис закрылся); - способ подключения к ЮKassa Модуль в CMS теперь называется в Платежный модуль.
28 февраля
Уточнили:
- в параметрах метода listReturns должны быть одновременно указаны
invoiceId
иshopId
илиfrom
,till
иshopId
; - в заявке на SSL-сертификат добавилась причина запроса — плановая замена;
- если можно сделать возврат по платежному поручению, то автоматически его тоже можно сделать;
- в запросе createInvoice в параметре
payMethod
по умолчанию передаетсяoffline
.
26 января
При отложенной оплате с банковской карты после успешной блокировки денег на карте плательщика магазин получает уведомление
paymentAviso
.2016 год
14 декабря
Добавили:
- описание запроса для генерации QR-кода: можно отправить запрос с данными платежной формы для оплаты заказа, получить в ответ QR-код в формате SVG и отобразить пользователю (или распечатать и наклеить на коробку с товаром);
- коды ошибок, которые приходят в ответ на запрос
createInvoice
(614
и615
).
Уточнили:
- процесс пополнения тестового кошелька (поменялась ссылка на форму пополнения);
- в разделе Взаимодействие по SSL поменялся файл с цепочкой сертификации.
21 октября
Уточнили:
- порядок действий в процессе приема платежей: в большинстве сценариев сначала магазину приходит запрос проверки заказа, а потом уже пользователь подтверждает платеж;
- при использовании динамических адресов для возврата покупателя в магазин со страницы успешной оплаты (
successUrl
иfailUrl
), необходимо указывать оба адреса; - срок блокировки при отложенных платежах — до 7 дней, его можно продлить до 30 дней, но без гарантии, что банк-эмитент не разблокирует деньги в любой момент.
29 сентября
Добавили:
- описание оплаты через СберБанк Онлайн без перехода в сервис ЮKassa (в примечании к сценарию оплаты через внешние платежные системы);
- дополнительные параметры для этого способа оплаты (в описание метода createInvoice);
- коды ошибок, которые приходят в ответе на
createInvoce
иconfirmInvoice
; - новый способ оплаты — через ЕРИП в Беларуси (в разделе Оплата наличными через терминалы и в списке способов оплаты).
17 мая
Добавили:
- описание оплаты по счету в смс;
- описание двух методов, которые используются при оплате по смс — createInvoice и
confirmInvoice
; - и новые коды ошибок для этого способа оплаты.
12 апреля
Дополнили:
- в описание процесса оплаты добавили информацию про Умный платеж;
- дополнили описание оплаты в кредит;
- поправили описание нескольких параметров и добавили пару важных примечаний.
2 марта
Добавили:
- описание отложенной оплаты с банковской карты;
- описание повтора оплаты с банковской карты.
Дополнили:
- в списке способов оплаты появилась информация о времени жизни счета при оплате через внешние платежные системы;
- исправили несколько мелких неточностей.
2015 год
25 декабря
Дополнили новый платежный сценарий, с выбором способа оплаты на стороне ЮKassa (описание двух сценариев, примеры платежных форм).
23 ноября
Дополнили:
- особенности работы с repeatCardPayment (дополнительные параметры платежной формы, запросов
checkOrder
иpaymentAviso
); - описание работы с тестовыми кошельками при тестировании оплаты.
1 октября
Дополнили:
- новые коды ошибок;
- особенности оплаты наличными через терминалы за пределами РФ.
1 сентября
Добавили:
- защищенное взаимодействие по PKCS#7;
- взаимодействие при оплате заказа в кредит (новый способ оплаты: «КупиВкредит»);
- запрос
сancelOrder
(используется для уведомления об отмене заказа при оплате в кредит); - новый способ оплаты: сервис «Куппи.ру»;
- реестры возвращенных переводов.
Дополнили:
- особенности вызова
checkOrder
до приема средств от пользователя при оплате через ВПС и наличными через терминалы; - особенности проведения возвратов методом returnPayment.