История изменений — [Архив] Протокол приема платежей через ЮKassa

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

2020 год

22 декабря

Добавлено ограничение на возврат переводов: успешный перевод с оплатой через СберБанк Онлайн (код способа оплаты —

) можно вернуть только в течение одного года с момента регистрации заказа в Ю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-ФЗ

Добавлены разделы:

Отправка данных для чека — описание сценария оплаты с отправкой фискальных данных
Параметры для формирования чека — дополнительные параметры для передачи фискальных данных в платежной форме

Внесены изменения на страницы:

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.