Это старая версия API. Переходите на [API ЮKassa](/developers).

Протокол больше не поддерживает способы оплаты Альфа-Клик и ЕРИП (Беларусь).

Добавлен новый способ оплаты через [Mir Pay](/docs/payment-solution/payments/payment-process/details/mir-pay).

Протокол больше не поддерживает способ оплаты MasterPass.

Протокол больше не поддерживает способы оплаты Apple Pay и Google Pay.

При [оплате наличными через терминалы](/docs/payment-solution/payments/payment-process/details/cash) больше нельзя выдавать многоразовые коды платежа. Уже выпущенные коды можно продолжать использовать. Если хотите принимать платежи наличными, запросите генерацию одноразового кода: в [платежной форме](/docs/payment-solution/payments/payment-form/http) укажите способ оплаты и передайте сумму платежа в параметре .

В России приостановлены операции по картам Visa, MasterCard, JCB и AmericanExpress, поэтому в работе Apple Pay и Google Pay есть ограничения: * Оплата через Apple Pay доступна только при использовании карты Мир. * Прием платежей через Google Pay временно недоступен. Оплата с помощью этого способа оплаты будет доступна, если появится возможность добавить в Google Pay карту Мир.

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

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

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

Добавлена [ошибка с кодом 616](/docs/payment-solution/payments/supplementary/reference/errors#transaction-request), которая приходит в ответе на запрос при попытке вернуть перевод с истекшим сроком возврата.

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

Добавлено ограничение на [возврат переводов](/docs/payment-solution/payments/payment-management/financial/return-payment): успешный перевод с оплатой через СберБанк Онлайн (код способа оплаты — ) можно вернуть только в течение одного года с момента регистрации заказа в ЮKassa ( в [уведомлении о проверке заказа](/docs/payment-solution/payments/notifications/http/check-order)).

* Для аутентификации соединений с серверами ЮKassa теперь нужен сертификат, выданный удостоверяющим центром ООО НКО «ЮМани» (NBCO YooMoney). В [инструкции для получения сертификата](/docs/payment-solution/payments/supplementary/security) обновлены заявка на сертификат, цепочка сертификации для проверки сертификата конечного сервера и список отозванных сертификатов (CRL). * [Платежную форму](/docs/payment-solution/payments/payment-form/basics) теперь нужно отправлять на новый адрес: * Запросы по [Протоколу управления заказами](/docs/payment-solution/payments/payment-management/basics) теперь нужно отправлять по новому адресу: * Адрес электронной почты для связи с менеджерами ЮKassa изменен на **merchants@yoomoney.ru**, адрес для связи по техническим вопросам изменен на **b2b_support@yoomoney.ru**.

Добавлено ограничение на [возврат переводов](/docs/payment-solution/payments/payment-management/financial/return-payment): вернуть успешный перевод можно только в течение трех лет с момента регистрации заказа в ЮKassa ( в [уведомлении о проверке заказа](/docs/payment-solution/payments/notifications/http/check-order)).

Возможность принимать платежи от юрлиц через [Сбербанк Бизнес Онлайн](/docs/payment-solution/payments/payment-process/details/b2b) теперь доступна клиентам любых банков.

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

* Добавили возможность при создании и возврате платежа передавать для чека данные о пользователе (параметр ) и дополнительные данные о товаре (параметры , , и ). * Параметр устарел. Его всё еще можно использовать, но рекомендуется передавать данные в параметре .

Демо-среда ЮKassa выводится из эксплуатации. Для тестирования платежей используйте [тестовый магазин](/docs/payment-solution/payments/testing-and-examples/testing).

Добавили поддержку ФФД 1.05 для работы с онлайн-кассами: в платежной форме вместе с [данными для чека](/docs/payment-solution/payments/payment-form/receipts) можно передавать два новых параметра — признак предмета расчета () и признак способа расчета (), оба параметра необязательные.

Способ оплаты «КупиВкредит» () больше не поддерживается.

* Добавили [описание ошибки 425](/docs/payment-solution/payments/supplementary/reference/errors) (техническая ошибка при ответе на запрос ). * Исправили несколько важных мелочей.

* Добавили [описание ошибки 428](/docs/payment-solution/payments/supplementary/reference/errors) (запрещен возврат для этого способа оплаты). * В платежной форме [HTTP](/docs/payment-solution/payments/payment-form/http) и [Email](/docs/payment-solution/payments/payment-form/email) в параметре можно передавать только адрес электронной почты, иначе запрос проходит с ошибкой.

* Появилась [оплата через мобильное приложение СберБанка](/docs/payment-solution/payments/payment-process/details/sberbank): покупатель переходит к выставленному счету по deeplink. * В [paymentAviso](/docs/payment-solution/payments/notifications/http/payment-aviso) теперь передаются параметры для формирования чека. С их помощью можно отправлять электронный чек покупателю. * При отправке параметров для чека название товара (параметр ) увеличилось до 128 символов. См. например [Параметры для чека в платежной форме](/docs/payment-solution/payments/payment-form/receipts).

Добавили пояснение про [отправку данных для чека при холдировании](/docs/payment-solution/payments/payment-process/details/hold). Данные для чека отправляются в онлайн-кассу на первом этапе: при успешной авторизации. Если при подтверждении оплаты сумма меняется, отправляется чек возврата, а потом — чек для новой операции. Если оплата на второй стадии отменяется, отправляется чек возврата.

* В методе [listOrders](/docs/payment-solution/payments/payment-management/information/list-orders) добавился параметр environment, который позволяет различать тестовые и настоящие операции. * Если вы отправляете параметры для чека в методе [returnPayment](/docs/payment-solution/payments/payment-management/financial/return-payment) и не можете получить точную сумму (только на копейку меньше или на копейку больше), следует передавать вариант с суммой на копейку больше. * Уточнили: время платежа в [реестрах принятых переводов](/docs/payment-solution/payments/supplementary/registers/payments) — это время создания операции в ЮKassa.

Добавили пояснения в [описание параметров для формирования чека](/docs/payment-solution/payments/payment-form/receipts). Примеры тоже поменялись.

Добавили возможность передавать фискальные данные в онлайн-кассу подключенного магазина. Эти данные онлайн-касса передает в ОФД (оператор фискальных данных), из них можно сформировать чек для покупателя (в рамках этого протокола чек для покупателя не формируется). Все изменения описаны в отдельном разделе: [Изменения в протоколе для работы по 54-ФЗ](/docs/payment-solution/payments/supplementary/guides/54fz) Добавлены разделы: * [Отправка данных для чека](/docs/payment-solution/payments/payment-process/details/receipt) — описание сценария оплаты с отправкой фискальных данных * [Параметры для формирования чека](/docs/payment-solution/payments/payment-form/receipts) — дополнительные параметры для передачи фискальных данных в платежной форме Внесены изменения на страницы: * [Описание процесса оплаты](/docs/payment-solution/payments/payment-process/basics) * [Форма для HTTP-уведомлений](/docs/payment-solution/payments/payment-form/http) * [Форма для Email-уведомлений](/docs/payment-solution/payments/payment-form/email) * [Метод returnPayment](/docs/payment-solution/payments/payment-management/financial/return-payment) * [Метод repeatCardPayment](/docs/payment-solution/payments/payment-management/financial/repeat-card-payment) * [Метод createInvoice](/docs/payment-solution/payments/payment-management/financial/create-invoice) * [Коды ошибок](/docs/payment-solution/payments/supplementary/reference/errors)

Уточнили: * отложенные платежи можно проводить только для (оплата с банковской карты); * при оплате через КупиВкредит () все параметры с префиксом **goods_** необязательные. Параметр не передается. (см. [Платежная форма](/docs/payment-solution/payments/payment-form/http)).

Уточнили: * параметры и во всех случаях ; * при оплате через КупиВкредит () и передавать не обязательно (см. [Платежная форма](/docs/payment-solution/payments/payment-form/http)).

Поменяли: * платежный метод Куппи.ру () перестал работать (сервис закрылся); * способ подключения к ЮKassa **Модуль в CMS** теперь называется в **Платежный модуль**.

Уточнили: * в параметрах метода [listReturns](/docs/payment-solution/payments/payment-management/information/list-returns) должны быть одновременно указаны и или , и ; * в заявке на [SSL-сертификат](/docs/payment-solution/payments/supplementary/security) добавилась причина запроса — плановая замена; * если можно сделать возврат по платежному поручению, то автоматически его тоже можно сделать; * в запросе [createInvoice](/docs/payment-solution/payments/payment-management/financial/create-invoice) в параметре по умолчанию передается .

При [отложенной оплате с банковской карты](/docs/payment-solution/payments/payment-process/details/hold) после успешной блокировки денег на карте плательщика магазин получает уведомление .

Добавили: * описание запроса для генерации QR-кода: можно отправить запрос с данными платежной формы для оплаты заказа, получить в ответ QR-код в формате SVG и отобразить пользователю (или распечатать и наклеить на коробку с товаром); * [коды ошибок](/docs/payment-solution/payments/supplementary/reference/errors), которые приходят в ответ на запрос ( и ). Уточнили: * [процесс пополнения тестового кошелька](/docs/payment-solution/payments/testing-and-examples/testing) (поменялась ссылка на форму пополнения); * в разделе [Взаимодействие по SSL](/docs/payment-solution/payments/supplementary/security) поменялся файл с цепочкой сертификации.

Уточнили: * порядок действий в [процессе приема платежей](/docs/payment-solution/payments/payment-process/basics): в большинстве сценариев сначала магазину приходит запрос [проверки заказа](/docs/payment-solution/payments/notifications/http/check-order), а потом уже пользователь подтверждает платеж; * при использовании [динамических адресов для возврата покупателя в магазин](/docs/support/merchant/payments/settings#settings__payment-params) со страницы успешной оплаты ( и ), необходимо указывать оба адреса; * срок блокировки при [отложенных платежах](/docs/payment-solution/payments/payment-process/details/hold) — до 7 дней, его можно продлить до 30 дней, но без гарантии, что банк-эмитент не разблокирует деньги в любой момент.

Добавили: * описание оплаты через СберБанк Онлайн без перехода в сервис ЮKassa (в примечании к [сценарию оплаты через внешние платежные системы](/docs/payment-solution/payments/payment-process/details/invoicing)); * дополнительные параметры для этого способа оплаты (в описание метода [createInvoice](/docs/payment-solution/payments/payment-management/financial/create-invoice)); * [коды ошибок](/docs/payment-solution/payments/supplementary/reference/errors), которые приходят в ответе на и ; * новый способ оплаты — через ЕРИП в Беларуси (в разделе [Оплата наличными через терминалы](/docs/payment-solution/payments/payment-process/details/cash) и в [списке способов оплаты](/docs/payment-solution/payments/supplementary/reference/payment-types)).

Добавили: * [описание оплаты по счету в смс](/docs/payment-solution/payments/payment-process/details/sms); * описание двух методов, которые используются при оплате по смс — [createInvoice](/docs/payment-solution/payments/payment-management/financial/create-invoice) и confirmInvoice; * и новые [коды ошибок](/docs/payment-solution/payments/supplementary/reference/errors) для этого способа оплаты.

Дополнили: * в [описание процесса оплаты](/docs/payment-solution/payments/payment-process/basics) добавили информацию про Умный платеж; * дополнили описание оплаты в кредит; * поправили описание нескольких параметров и добавили пару важных примечаний.

Добавили: * [описание отложенной оплаты](/docs/payment-solution/payments/payment-process/details/hold) с банковской карты; * [описание повтора оплаты](/docs/payment-solution/payments/payment-process/details/recurring-payments) с банковской карты. Дополнили: * в списке [способов оплаты](/docs/payment-solution/payments/supplementary/reference/payment-types) появилась информация о времени жизни счета при оплате через внешние платежные системы; * исправили несколько мелких неточностей.

Дополнили новый платежный сценарий, с выбором способа оплаты на стороне ЮKassa ([описание двух сценариев](/docs/payment-solution/payments/payment-form/basics), [примеры платежных форм](/docs/payment-solution/payments/testing-and-examples/testing)).

Дополнили: * особенности работы с [repeatCardPayment](/docs/payment-solution/payments/payment-management/financial/repeat-card-payment) (дополнительные параметры платежной формы, запросов и ); * описание работы с тестовыми кошельками при [тестировании оплаты](/docs/payment-solution/payments/testing-and-examples/testing).

Дополнили: * новые [коды ошибок](/docs/payment-solution/payments/supplementary/reference/errors); * особенности оплаты [наличными через терминалы](/docs/payment-solution/payments/payment-process/details/cash) за пределами РФ.

Добавили: * [защищенное взаимодействие по PKCS#7](/docs/payment-solution/payments/notifications/http/basics); * взаимодействие при оплате заказа в кредит (новый способ оплаты: «КупиВкредит»); * запрос (используется для уведомления об отмене заказа при оплате в кредит); * новый способ оплаты: сервис «Куппи.ру»; * [реестры возвращенных переводов](/docs/payment-solution/payments/supplementary/registers/refunds). Дополнили: * особенности вызова до приема средств от пользователя при оплате [через ВПС](/docs/payment-solution/payments/payment-process/details/invoicing) и [наличными через терминалы](/docs/payment-solution/payments/payment-process/details/cash); * особенности проведения возвратов методом [returnPayment](/docs/payment-solution/payments/payment-management/financial/return-payment).