YooMoney API
Old versions of the API
Help
Sign up for YooMoney
Payouts to clients
You can send money to individuals via YooMoney. This feature can be used by services which provide loans, make payouts to freelancers or contractors, and pay out marketing fees.
You can also officially make payouts to self-employed individuals. It's useful for online platforms where self-employed individuals offer their services: freelancing marketplaces, education platforms, or delivery services.
We credit money to: YooMoney Wallets, bank cards issued by Russian banks, standard bank accounts opened in Russian banks, mobile phone balances (Megafon, MTS, Beeline, Tele2, Yota, SkyLink, Rostelecom, Tinkoff mobile, Tattelecom, SMARTS, Motiv, ETK, Sotel, Penza-GSM).
Payouts may be performed by organizations: sole proprietors and corporations, including non-Russian residents. They can be recieved by individuals (citizens of the Russian Federation). Everything is set officially: we provide documents for accounting department and tax service.
 
How it works
  1. Add money to your YooMoney balance.
  2. When you need to pay a client, either send an API request with the payout data to YooMoney or create a list of recipients and use it as the basis for a payout.
  3. The client receives money, and you get notifications and documents.
Documents
YooMoney furnishes all documents that your accounting department or tax service may need.
We send Payment Registers daily via email. And separate ones for successful and returned payouts. More in documentation
Certificates on services rendered are created once a month and sent via email. You can additionally apply for accepting them in hard copy.
Onboarding
Технически есть два типа:
Без интеграции: каждый раз, когда нужно отправить выплату, вы присылаете нам список получателей в виде файла.
С интеграцией по API: есть новая версия протокола и старая. В процессе подключения проверим, какая версия вам подходит.
От типа подключения зависят доступные способы выплат. Подробнее о способах
Весь процесс подключения для новых клиентов — в инструкции ниже. Если вы уже работаете с ЮKassa, заново подключаться не нужно — просто напишите своему менеджеру, что хотите делать выплаты.
For residents of the Russian Federation
For non-residents of the Russian Federation
  1. Напишите нам на merсhants@yoomoney.ru:
    • что нужно подключить: только выплаты или выплаты + приём платежей,
    • кто будет получать выплаты: самозанятые или просто физлица,
  2. После этого у вас появится персональный менеджер, он запросит информацию о компании — нужно будет заполнить анкету.
  3. Дождитесь одобрения анкеты.
  4. Дальше нужно заключить договор и зарегистрироваться в ЮKassa и ЮBusiness — менеджер подскажет, как и в каком порядке это сделать.
    • В ЮBusiness у вас появится расчётный счёт — с него списываются деньги для выплат.
    • Через личный кабинет ЮKassa вы будете управлять настройками выплат.
  5. Если подключаетесь по API, проведите интеграцию, вот документация:
    Если у вас выплаты по спискам, почитайте инструкцию
  6. Для выплат самозанятым нужно сделать пару дополнительных шагов
  7. Пополните баланс выплат в ЮBusiness на нужную сумму — и можно начинать выплаты.
После подключения
У вас появится личный кабинет и шлюз для проведения выплат.
Личный кабинет
В нём можно посмотреть баланс и историю выплат, настройки и тарифы. Можно делать выплаты по списку, а также на время отключить выплаты.
Если вы используете для выплат счёт в ЮBusiness
У вас будет ещё один личный кабинет — в ЮBusiness, там вы сможете следить за балансом выплат и пополнять его (пока только в версии для браузера). Важно: доступ к расчётному счёту в ЮBusiness и к выплатам в ЮKassa есть только у директора компании. Когда полномочия директора истекают, нужно подтвердить продление — иначе доступ к обоим сервисам приостановится.
Шлюз для выплат
Выплаты проходят через шлюзы. Сразу после подключения у вас появится свой шлюз с уникальным номером, agentId. Этот номер используется, например, в запросах по API — по нему ЮKassa понимает, кто отправляет деньги, какие настройки у этой выплаты, какая комиссия и т.д.
Ваш agentId всегда видно в личном кабинете, в верхнем меню:
Payout balance
Есть разные варианты, как следить за балансом и пополнять его. Всё зависит от того, используете вы для выплат счёт в ЮBusiness или в другом банке.
Счёт в ЮBusiness
Счёт в другом банке
How to check your balance
Как пополнить баланс: с расчётного счёта в ЮBusiness. Зайдите в ЮBusiness, обязательно через браузер (не через приложение), найдите нужный договор выплат и нажмите «Пополнить» — дальше сайт подскажет, что делать. Сам расчётный счёт можно пополнять любым способом, доступным в ЮBusiness.
Как забрать остаток с баланса: зайдите в ЮBusiness и напишите в чат, что хотите перевести деньги с баланса выплат на расчётный счёт. Вам пришлют шаблон заявления, нужно будет заполнить его и прислать обратно в чат. Заявление обработают — и деньги вернутся на счёт.
Rates and conditions
СПОСОБЫ ВЫПЛАТSettlementFeesКОГДА ПРИХОДЯТ ДЕНЬГИLimits
YooMoney e-wallet
По новой версии API
По старой версии API
По списку
2,8%
instantly
Одному клиенту можно отправить за раз:
  • Anonymous user: up to 15,000 rubles at a time.
  • Reviewed user: up to 60,000 rubles at a time.
  • Identified user: up to 500,000 rubles at a time.
To any Wallet: up to 600,000 rubles a month.
Bank card
  • любые карты, выпущенные в России,
  • карты «Мир», выпущенные в других странах.
По новой версии API
По старой версии API
По списку
2,8% + 30 ₽
через несколько секунд
Если используете для выплат ЮBusiness, одному клиенту можно отправить:
  • from 5 to 500,000 rubles at a time when integrating via the new API version,
  • from 100 to 500,000 rubles at a time when integrating via the old API version or via the list,
  • up to 500,000 rubles a day,
  • up to 600,000 rubles a calendar month.
Если используете счёт в другом банке, одному клиенту можно отправить:
  • from 100 to 60,000 rubles at a time,
  • up to 300,000 rubles a day,
  • up to 600,000 rubles a calendar month.
This limits apply all client's cards (the check is made by passport details).
Через СБП с проверкой получателя выплаты
Мы сверяем ФИО, которые передали вы, с ФИО из банка — если они не совпадают, отклоняем выплату. Так мы отсеиваем тех, кто пытается получить выплату на чужое имя.
По новой версии API
2,8% + 30 ₽
через несколько секунд
Одному клиенту можно отправить от 1 до 500 000 ₽ за раз, других ограничений нет.
Через СБП без проверки получателя выплатыПо новой версии API2,8% + 30 ₽через несколько секундTo one client, you can pay 1 ₽ to 500,000 ₽ at a time.
Bank Account
По старой версии API
По списку
2,8%
in several hours
Если используете для выплат ЮBusiness, одному клиенту можно отправить от 20 до 300 000 ₽ за раз, других ограничений нет.
Если используете счёт в другом банке, одному клиенту можно отправить:
  • from 20 to 60,000 rubles at a time,
  • up to 300,000 rubles a day
  • up to 600,000 rubles a calendar month.
This limits apply all client's cards (the check is made by passport details).
Direct carrier billing
По старой версии API
По списку
4%
instantly
To one number, you can pay 1 ₽ to 15,000 ₽ at a time.