API ЮKassa
Помощь
Подключить ЮKassa
История изменений
2022 год
11 ноября
В ЮKassa появился особый тестовый режим для тех, кто хочет оценить возможности Протокола массовых выплат. Указывать данные компании и подписывать договор не нужно. Подробнее о тестировании выплат по API
11 июля
Протокол массовых выплат устарел, вместо него рекомендуется использовать API ЮKassa. Если хотите использовать новый API, напишите вашему менеджеру. Подробнее об отличиях API ЮKassa от Протокола массовых выплат
28 июня
  • Уведомления о неуспешном переводе (errorDepositionNotification) теперь могут приходить только при выплатах на банковские счета и мобильные телефоны. При выплатах на банковские карты результат зачисления теперь известен сразу.
  • При выплатах на кошельки больше не нужно проверять возможность зачисления с помощью запроса testDeposition.
14 апреля
Серверные SDK (PHP, Python) теперь размещены не на GitHub, а в репозитории ЮKassa.
4 апреля
  • Добавлена возможность при выплатах на банковские карты и банковские счета дополнительно указывать ИНН, СНИЛС и номер полиса ОМС получателя выплат. При выплатах по спискам данные нужно передавать в новых полях, при выплатах по протоколу — в новых параметрах pdr_oms, pdr_snils, pdr_inn.
  • В форме ЮKassa для сбора данных для выплат на банковскую карту изменился порядок заполнениях данных пользователем.
2021 год
24 декабря
Теперь для проведения выплат по API вы можете использовать готовые SDK на PHP и Python.
13 декабря
ЮKassa больше не поддерживает тестирование уведомлений о неуспешных зачислениях (errorDepositionNotification).
8 ноября
Для тех, кто использует форму для сбора персональных данных получателя при выплатах на банковские карты: теперь пользователи могут передавать данные второго документа (ИНН, СНИЛС или полиса ОМС).
6 августа
Добавлена возможность делать выплаты самозанятым с автоматической регистрацией чека в сервисе Мой налог.
20 июля
Для выплат на кошельки ЮMoney больше нельзя использовать номер мобильного телефона в качестве идентификатора пользователя. Чтобы сделать выплату, передайте номер кошелька ЮMoney. Номер телефона можно передавать в dstAccount только при выплатах на мобильный телефон.
12 июля
Для тех, кто использует форму для сбора персональных данных получателя при выплатах на банковские карты:
  • Теперь вы можете использовать идентификатор пользователя в ЮKassa только в течение одного года. Если срок действия закончился, нужно получить новый идентификатор или собрать персональные данные самостоятельно.
  • Если в запросе makeDeposition использовать идентификатор с истекшим сроком действия, ЮKassa вернет ошибку с кодом 160.
22 июня
  • Тестовый шлюз для тестирования выплат теперь нужно создавать вручную.
  • Присылать запросы на сервер ЮKassa теперь можно с любых IP-адресов.
18 мая
  • добавлена возможность проверить зачисления на кошельки с разными статусами;
  • добавлена возможность проверить неуспешный сценарий зачисления на анонимные кошельки (error=57).
16 марта
Изменился адрес формы ЮKassa для сбора данных для выплат на банковскую карту: пользователя теперь нужно перенаправлять на https://yookassa.ru/cardauth. Старый адрес https://yoomoney.ru/cardauth/payout тоже можно продолжать использовать.
2020 год
10 декабря
Запросы на зачисление выплат и на получение информации о балансе теперь нужно отправлять по новому адресу: https://payouts.yookassa.ru:9094/
4 декабря
  • Для аутентификации соединений с серверами ЮKassa теперь нужен сертификат, выданный удостоверяющим центром ООО НКО «ЮМани» (NBCO YooMoney). В инструкции для получения сертификата обновлены заявка на сертификат, цепочка сертификации для проверки сертификата конечного сервера и список отозванных сертификатов (CRL).
  • Запрос на получение синонима банковской карты теперь нужно отправлять по новому адресу: https://paymentcard.yoomoney.ru/gates/card/storeCard
  • Для сбора данных через форму ЮKassa теперь нужно перенаправлять пользователя на новый адрес: https://yoomoney.ru/cardauth/payout
  • Адрес электронной почты для связи с менеджерами ЮKassa изменен на merchants@yoomoney.ru.
22 мая
Теперь при выплатах по спискам данные о банковской карте и получателе можно собирать с помощью ЮKassa. В результате вы получите синоним карты и идентификатор получателя, которые можно безопасно хранить на своей стороне и передавать ЮKassa при проведении выплат.
24 апреля
В личном кабинете появилась возможность получить выписку об успешно сделанной выплате.
2019 год
12 декабря
Добавлен новый способ интеграции — выплаты по спискам получателей.
21 июля
В реестры успешных и возвращенных выплат добавлена информация о комиссии.
28 июня
  • сократили количество обязательных полей при переводах на карты (makeDeposition);
  • добавили возможность собирать данные банковской карты и персональные данные получателя выплаты на стороне ЮKassa.
11 июня
Демо-среда ЮKassa выводится из эксплуатации. Для тестирования выплат используйте тестовый шлюз.
2017 год
25 августа
В ответ на запрос Зачисление переводов параметр identification приходит только в тех случаях, когда перевод отправляется в кошелек ЮMoney.
28 февраля
При выплатах на банковский счет или банковскую карту сразу после запроса makeDeposition проводится проверка паспортных данных получателя.
26 января
Уточнили:
  • При выплатах на банковский счет обязательно указывать дату рождения получателя (pdr_birthDate).
  • Обработка повторного запроса на зачисление денег (makeDeposition) с тем же идентификатором операции (clientOrderId) зависит от значений обязательных параметров (clientOrderId, dstAccount и amount). Если значения этих параметров в исходном и повторном запросе совпадают, ЮKassa вернет результат обработки ранее отправленного запроса. Если отличаются — запрос будет отвергнут.
2016 год
14 декабря
В описании выплатных реестров уточнили, что ФИО получателя передается только для выплат на банковские карты и счет.
14 сентября
Добавили описание нового формата реестров успешных выплат.
2015 год
1 сентября
Запуск публичной документации.