Это старая версия API. Переходите на API Ю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.