Docs
Инструкции
Помощь
Подключить ЮKassa
Подключение выплат
В статье описан общий порядок подключения выплат.
Обычные выплаты отличаются от выплат в рамках Безопасной сделки: формат похож, но есть свои нюансы, процесс подключения тоже другой. Если вам нужна Безопасная сделка, используйте инструкции из раздела про Безопасную сделку.
Шаг 1. Напишите менеджеру ЮKassa
Сообщите менеджеру ЮKassa, что хотите делать выплаты по API ЮKassa. Если вы уже пользуетесь ЮKassa, напишите вашему личному менеджеру, если нет, отправьте заявку на почту merchants@yoomoney.ru.
Что указать в заявке:
Когда в ЮKassa получат заявку, с вами свяжется менеджер, обсудит детали и расскажет, что делать дальше.
Шаг 2. Подпишите необходимые документы
Порядок подключения зависит от вашей ситуации, поэтому дождитесь подробных инструкций от менеджера и следуйте им.
В процессе нужно будет предоставить информацию о вашей компании и ее деятельности, заполнить и подписать юридические документы, открыть расчетный счет в ЮBusiness, зарегистрироваться в ЮKassa и при необходимости выполнить дополнительные действия, которые нужны для подключения именно вам.
Если вы планируете не только делать выплаты, но и принимать платежи, вы можете настроить пополнение баланса выплат с того счета, на который будут поступать платежи через ЮKassa. Это можно сделать в личном кабинете ЮBusiness.
Шаг 3. Ознакомьтесь с основами работы с API
Ознакомьтесь с форматом взаимодействия с API ЮKassa.
Если вы раньше использовали Протокол массовых выплат ЮKassa, ознакомьтесь также с отличиями API ЮKassa от Протокола массовых выплат.
Если вы уже используете API ЮKassa, то формат взаимодействия такой же, как и для других платежных решений API (платежи, решения для платформ и маркетплейсов), но есть нюансы:
  • Для аутентификации запросов используется HTTP Basic Auth, в качестве логина необходимо указывать идентификатор шлюза (agentId), в качестве пароля — секретный ключ для него.
  • Для выплат нельзя настроить уведомления. Чтобы проверить статус объекта, отправляйте GET-запрос для получения информации об объекте.
Шаг 4. Проинтегрируйтесь с ЮKassa
Получите идентификатор шлюза и секретный ключ для аутентификации запросов.
Используя инструкции, подключите те возможности API, которые нужны для решения ваших задач. Протестируйте интеграцию.
Инструкции для интеграции
Выберите, кому вы хотите делать выплаты — физическим лицам или самозанятым.
Выплаты физическим лицам
Выплаты самозанятым
Шаг 5. Подготовьтесь к проведению выплат реальным пользователям
Переведите деньги на ваш расчетный счет в ЮBusiness, затем пополните баланс выплат.
Убедитесь, что в запросах используете идентификатор и секретный ключ шлюза для реальных выплат. Проведите пробную выплату на минимальную сумму.
Шаг 6. Начните делать выплаты
Начните делать реальные выплаты.
Для финансовой сверки используйте реестры успешных выплат, которые будут приходить вам на электронную почту раз в сутки. Информация о сумме проведенных выплат за сутки и сумме комиссии ЮKassa будет также доступна в личном кабинете ЮBusiness.
При необходимости в личном кабинете ЮKassa вы можете для каждого шлюза посмотреть список операций и баланс выплат, экспортировать список выплат, заказать выписку из реестра (для подтверждения факта успешной выплаты), скачать сформированные чеки при выплатах самозанятым.
В личном кабинете ЮKassa посмотреть информацию о шлюзе может только пользователь с ролью Владелец.
Что почитать еще
Условия работы с ЮKassa, информация о тарифахБезопасная сделкаВыплаты по спискамСправочник API