Docs
API ЮKassa
Справочник API
API массовых выплат
Старая версия API
Помощь
Войти
Подключить ЮKassa
Docs
API ЮKassa
Справочник API
API массовых выплат
Старая версия API
Помощь
Войти

|

Подключить ЮKassa
English
История изменений
Это старая версия API. Переходите на API ЮKassa.
2022 год
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 сентября
Добавили:
Дополнили:
© 2022, ООО НКО «ЮМани»