Архив
 
История изменений
Это старая версия API. Переходите на API Ю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 августа
 
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
    ).
Уточнили:
 
21 октября
Уточнили:
 
29 сентября
Добавили:
 
17 мая
Добавили:
 
12 апреля
Дополнили:
  • в описание процесса оплаты добавили информацию про Умный платеж;
  • дополнили описание оплаты в кредит;
  • поправили описание нескольких параметров и добавили пару важных примечаний.
 
2 марта
Добавили:
Дополнили:
  • в списке способов оплаты появилась информация о времени жизни счета при оплате через внешние платежные системы;
  • исправили несколько мелких неточностей.
 
2015 год
 
25 декабря
Дополнили новый платежный сценарий, с выбором способа оплаты на стороне ЮKassa (описание двух сценариев, примеры платежных форм).
 
23 ноября
Дополнили:
  • особенности работы с repeatCardPayment (дополнительные параметры платежной формы, запросов
    checkOrder
    и 
    paymentAviso
    );
  • описание работы с тестовыми кошельками при тестировании оплаты.
 
1 октября
Дополнили:
 
1 сентября
Добавили:
Дополнили: