Docs
API ЮKassa
Помощь
Подключить ЮKassa
История изменений
Это старая версия API. Переходите на API ЮKassa.
2022 год
19 августа
Протокол больше не поддерживает способ оплаты MasterPass.
20 апреля
Протокол больше не поддерживает способы оплаты Apple Pay и Google Pay.
25 марта
При оплате наличными через терминалы больше нельзя выдавать многоразовые коды платежа. Уже выпущенные коды можно продолжать использовать.
Если хотите принимать платежи наличными, запросите генерацию одноразового кода: в платежной форме укажите способ оплаты
paymentType=GP
и передайте сумму платежа в параметре
sum
.
11 марта
В России приостановлены операции по картам Visa, MasterCard, JCB и AmericanExpress, поэтому в работе Apple Pay и Google Pay есть ограничения:
  • Оплата через Apple Pay доступна только при использовании карты Мир.
  • Прием платежей через Google Pay временно недоступен. Оплата с помощью этого способа оплаты будет доступна, если появится возможность добавить в Google Pay карту Мир.
11 февраля
Способ оплаты WebMoney (
WM
) отключен, так как у расчетного банка WebMoney отозвали лицензию. Платежи и возвраты этим способом недоступны.
7 февраля
Способ оплаты СберБанк Онлайн выведен из эксплуатации. Если вам понадобится вернуть платежи через СберБанк Онлайн, вы сможете сделать это до 10 апреля 2022 года включительно (до 23:59:59 по московскому времени).
Для приема платежей через СберБанк используйте способ оплаты SberPay.
2021 год
6 октября
Способ оплаты СберБанк Онлайн выводится из эксплуатации:
  • Если вы хотите начать принимать платежи через СберБанк, используйте способ оплаты SberPay.
  • Если вы уже принимаете платежи через СберБанк Онлайн, вы перейдете на SberPay автоматически.
21 мая
Добавлена ошибка с кодом 616, которая приходит в ответе на запрос
returnPayment
при попытке вернуть перевод с истекшим сроком возврата.
12 мая
Добавлен новый способ оплаты через СберБанк — SberPay. Ю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 сентября
Добавили:
Дополнили: