Добавлен новый способ оплаты через Mir Pay.
Протокол больше не поддерживает способ оплаты MasterPass.
Протокол больше не поддерживает способы оплаты Apple Pay и Google Pay.
При оплате наличными через терминалы больше нельзя выдавать многоразовые коды платежа. Уже выпущенные коды можно продолжать использовать.
Если хотите принимать платежи наличными, запросите генерацию одноразового кода: в платежной форме укажите способ оплаты
paymentType=GP
и передайте сумму платежа в параметре sum
.В России приостановлены операции по картам Visa, MasterCard, JCB и AmericanExpress, поэтому в работе Apple Pay и Google Pay есть ограничения:
- Оплата через Apple Pay доступна только при использовании карты Мир.
- Прием платежей через Google Pay временно недоступен. Оплата с помощью этого способа оплаты будет доступна, если появится возможность добавить в Google Pay карту Мир.
Способ оплаты WebMoney (
WM
) отключен, так как у расчетного банка WebMoney отозвали лицензию. Платежи и возвраты этим способом недоступны.Способ оплаты СберБанк Онлайн выведен из эксплуатации. Если вам понадобится вернуть платежи через СберБанк Онлайн, вы сможете сделать это до 10 апреля 2022 года включительно (до 23:59:59 по московскому времени).
Для приема платежей через СберБанк используйте способ оплаты SberPay.
Способ оплаты СберБанк Онлайн выводится из эксплуатации:
- Если вы хотите начать принимать платежи через СберБанк, используйте способ оплаты SberPay.
- Если вы уже принимаете платежи через СберБанк Онлайн, вы перейдете на SberPay автоматически.
Добавлена ошибка с кодом 616, которая приходит в ответе на запрос
returnPayment
при попытке вернуть перевод с истекшим сроком возврата.Добавлен новый способ оплаты через СберБанк — SberPay. ЮKassa переводит на него тех, кому доступен способ оплаты СберБанк Онлайн.
Добавлено ограничение на возврат переводов: успешный перевод с оплатой через СберБанк Онлайн (код способа оплаты —
SB
) можно вернуть только в течение одного года с момента регистрации заказа в ЮKassa (orderCreatedDatetime
в уведомлении о проверке заказа).- Для аутентификации соединений с серверами ЮKassa теперь нужен сертификат, выданный удостоверяющим центром ООО НКО «ЮМани» (NBCO YooMoney). В инструкции для получения сертификата обновлены заявка на сертификат, цепочка сертификации для проверки сертификата конечного сервера и список отозванных сертификатов (CRL).
- Платежную форму теперь нужно отправлять на новый адрес:
https://yoomoney.ru/eshop.xml
- Запросы по Протоколу управления заказами теперь нужно отправлять по новому адресу:
https://shop.yookassa.ru
- Адрес электронной почты для связи с менеджерами ЮKassa изменен на merchants@yoomoney.ru, адрес для связи по техническим вопросам изменен на b2b_support@yoomoney.ru.
Добавлено ограничение на возврат переводов: вернуть успешный перевод можно только в течение трех лет с момента регистрации заказа в ЮKassa (
orderCreatedDatetime
в уведомлении о проверке заказа).Возможность принимать платежи от юрлиц через Сбербанк Бизнес Онлайн теперь доступна клиентам любых банков.
Добавили возможность принимать оплату с баланса мобильного телефона.
- Добавили возможность при создании и возврате платежа передавать для чека данные о пользователе (параметр
customer
) и дополнительные данные о товаре (параметрыproductCode
,countryOfOriginCode
,customsDeclarationNumber
иexcise
). - Параметр
customerContact
устарел. Его всё еще можно использовать, но рекомендуется передавать данные в параметреcustomer
.
Демо-среда ЮKassa выводится из эксплуатации. Для тестирования платежей используйте тестовый магазин.
Добавили поддержку ФФД 1.05 для работы с онлайн-кассами: в платежной форме вместе с данными для чека можно передавать два новых параметра — признак предмета расчета (
paymentSubjectType
) и признак способа расчета (paymentMethodType
), оба параметра необязательные.Способ оплаты «КупиВкредит» (
paymentType=KV
) больше не поддерживается.- Добавили описание ошибки 425 (техническая ошибка при ответе на запрос
createInvoice
). - Исправили несколько важных мелочей.
- Добавили описание ошибки 428 (запрещен возврат для этого способа оплаты).
- В платежной форме HTTP и Email в параметре
cps_email
можно передавать только адрес электронной почты, иначе запрос проходит с ошибкой.
- Появилась оплата через мобильное приложение СберБанка: покупатель переходит к выставленному счету по deeplink.
- В paymentAviso теперь передаются параметры для формирования чека. С их помощью можно отправлять электронный чек покупателю.
- При отправке параметров для чека название товара (параметр
text
) увеличилось до 128 символов. См. например Параметры для чека в платежной форме.
Добавили пояснение про отправку данных для чека при холдировании. Данные для чека отправляются в онлайн-кассу на первом этапе: при успешной авторизации. Если при подтверждении оплаты сумма меняется, отправляется чек возврата, а потом — чек для новой операции. Если оплата на второй стадии отменяется, отправляется чек возврата.
- В методе listOrders добавился параметр environment, который позволяет различать тестовые и настоящие операции.
- Если вы отправляете параметры для чека в методе returnPayment и не можете получить точную сумму (только на копейку меньше или на копейку больше), следует передавать вариант с суммой на копейку больше.
- Уточнили: время платежа в реестрах принятых переводов — это время создания операции в ЮKassa.
Добавили пояснения в описание параметров для формирования чека. Примеры тоже поменялись.
Добавили возможность передавать фискальные данные в онлайн-кассу подключенного магазина. Эти данные онлайн-касса передает в ОФД (оператор фискальных данных), из них можно сформировать чек для покупателя (в рамках этого протокола чек для покупателя не формируется).
Все изменения описаны в отдельном разделе: Изменения в протоколе для работы по 54-ФЗ
Добавлены разделы:
- Отправка данных для чека — описание сценария оплаты с отправкой фискальных данных
- Параметры для формирования чека — дополнительные параметры для передачи фискальных данных в платежной форме
Внесены изменения на страницы:
- Описание процесса оплаты
- Форма для HTTP-уведомлений
- Форма для Email-уведомлений
- Метод returnPayment
- Метод repeatCardPayment
- Метод createInvoice
- Коды ошибок
Уточнили:
- отложенные платежи можно проводить только для
paymentType=AC
(оплата с банковской карты); - при оплате через КупиВкредит (
paymentType=KV
) все параметры с префиксом goods_ необязательные. Параметрseller_id
не передается. (см. Платежная форма).
Уточнили:
- параметры
customerNumber
иorderNumber
во всех случаяхnormalizedString
; - при оплате через КупиВкредит (
paymentType=KV
)category_code_N
иgoods_description_N
передавать не обязательно (см. Платежная форма).
Поменяли:
- платежный метод Куппи.ру (
QP
) перестал работать (сервис закрылся); - способ подключения к ЮKassa Модуль в CMS теперь называется в Платежный модуль.
Уточнили:
- в параметрах метода listReturns должны быть одновременно указаны
invoiceId
иshopId
илиfrom
,till
иshopId
; - в заявке на SSL-сертификат добавилась причина запроса — плановая замена;
- если можно сделать возврат по платежному поручению, то автоматически его тоже можно сделать;
- в запросе createInvoice в параметре
payMethod
по умолчанию передаетсяoffline
.
При отложенной оплате с банковской карты после успешной блокировки денег на карте плательщика магазин получает уведомление
paymentAviso
.Добавили:
- описание запроса для генерации QR-кода: можно отправить запрос с данными платежной формы для оплаты заказа, получить в ответ QR-код в формате SVG и отобразить пользователю (или распечатать и наклеить на коробку с товаром);
- коды ошибок, которые приходят в ответ на запрос
createInvoice
(614
и615
).
Уточнили:
- процесс пополнения тестового кошелька (поменялась ссылка на форму пополнения);
- в разделе Взаимодействие по SSL поменялся файл с цепочкой сертификации.
Уточнили:
- порядок действий в процессе приема платежей: в большинстве сценариев сначала магазину приходит запрос проверки заказа, а потом уже пользователь подтверждает платеж;
- при использовании динамических адресов для возврата покупателя в магазин со страницы успешной оплаты (
successUrl
иfailUrl
), необходимо указывать оба адреса; - срок блокировки при отложенных платежах — до 7 дней, его можно продлить до 30 дней, но без гарантии, что банк-эмитент не разблокирует деньги в любой момент.
Добавили:
- описание оплаты через СберБанк Онлайн без перехода в сервис ЮKassa (в примечании к сценарию оплаты через внешние платежные системы);
- дополнительные параметры для этого способа оплаты (в описание метода createInvoice);
- коды ошибок, которые приходят в ответе на
createInvoce
иconfirmInvoice
; - новый способ оплаты — через ЕРИП в Беларуси (в разделе Оплата наличными через терминалы и в списке способов оплаты).
Добавили:
- описание оплаты по счету в смс;
- описание двух методов, которые используются при оплате по смс — createInvoice и confirmInvoice;
- и новые коды ошибок для этого способа оплаты.
Дополнили:
- в описание процесса оплаты добавили информацию про Умный платеж;
- дополнили описание оплаты в кредит;
- поправили описание нескольких параметров и добавили пару важных примечаний.
Добавили:
- описание отложенной оплаты с банковской карты;
- описание повтора оплаты с банковской карты.
Дополнили:
- в списке способов оплаты появилась информация о времени жизни счета при оплате через внешние платежные системы;
- исправили несколько мелких неточностей.
Дополнили новый платежный сценарий, с выбором способа оплаты на стороне ЮKassa (описание двух сценариев, примеры платежных форм).
Дополнили:
- особенности работы с repeatCardPayment (дополнительные параметры платежной формы, запросов
checkOrder
иpaymentAviso
); - описание работы с тестовыми кошельками при тестировании оплаты.
Дополнили:
- новые коды ошибок;
- особенности оплаты наличными через терминалы за пределами РФ.
Добавили:
- защищенное взаимодействие по PKCS#7;
- взаимодействие при оплате заказа в кредит (новый способ оплаты: «КупиВкредит»);
- запрос
сancelOrder
(используется для уведомления об отмене заказа при оплате в кредит); - новый способ оплаты: сервис «Куппи.ру»;
- реестры возвращенных переводов.
Дополнили:
- особенности вызова
checkOrder
до приема средств от пользователя при оплате через ВПС и наличными через терминалы; - особенности проведения возвратов методом returnPayment.