Протокол массовых выплат устарел. Если хотите делать выплаты по API, используйте [API ЮKassa](/developers/payouts/overview). Чтобы при выплатах ЮKassa автоматически регистрировала чеки, нужно получить от самозанятого ИНН и разрешение для ЮMoney на регистрацию чеков в сервисе Мой налог. Для этого используйте специальную форму ЮKassa.

**Шаг 1.** Вы объясняете получателю выплаты, что ему нужно выдать разрешение ЮMoney для автоматической регистрации чеков в сервисе Мой налог. **Шаг 2.** Получатель выплаты переходит к вводу данных. **Шаг 3.** Вы перенаправляете получателя выплаты на форму. ![Форма для запроса прав в сервисе Мой налог](kassa/payment-solution/payout-recipient-data-form-1.png) **Шаг 4.** Получатель выплаты вводит данные и нажимает **Отправить**. ![Заполненная форма](kassa/payment-solution/payout-recipient-data-form-2.png) **Шаг 5.** ЮKassa запрашивает права в сервисе Мой налог. **Шаг 6.** Сервис Мой налог возвращает ЮKassa ответ. **Шаг 7.** ЮKassa перенаправляет получателя выплаты на страницу успеха или неудачи на вашей стороне и сообщает вам результат. В случае успеха ЮKassa вернет вам ИНН пользователя и текущий статус выдачи прав. После этого получатель выплаты самостоятельно переходит в сервис Мой налог и выдает права ЮMoney. Если после отправки формы вы получили статус **Ожидает подтверждения**, вам нужно самостоятельно проконтролировать, что получатель выплаты выдал разрешение ЮMoney в сервисе Мой налог.

Разместите на вашем сайте элемент, с помощью которого получатель выплаты будет перенаправлен на форму ЮKassa. Например, разместите кнопку, при нажатии на которую получатель будет переходить на форму. **Адрес для отправки формы** ``` https://yookassa.ru/self-employed-boarding ``` К ссылке добавьте идентификатор вашего шлюза в ЮKassa, адрес страницы, на которую самозанятый вернется в случае успешной отправки данных, и адрес страницы, на которую он вернется, если при отправке данных что-то пойдет не так. **Описание параметров**

Параметр	Тип	Описание
agentId	xs:long	Идентификатор вашего шлюза. Выдается ЮKassa. Обязательный параметр
success_url	xs:string, до 250 символов	Адрес страницы, на которую вернется получатель выплаты при успешной отправке данных. Обязательный параметр
fail_url	xs:string, до 250 символов	Адрес страницы, на которую вернется получатель выплаты в случае ошибки, например если он не имеет статуса самозанятого или на сервис Мой налог недоступен. Обязательный параметр

Параметр

Тип

Описание

agentId

xs:long

Идентификатор вашего шлюза. Выдается ЮKassa.

Обязательный параметр

success_url

xs:string,
до 250 символов

Адрес страницы, на которую вернется получатель выплаты при успешной отправке данных.

Обязательный параметр

fail_url

xs:string,
до 250 символов

Адрес страницы, на которую вернется получатель выплаты в случае ошибки, например если он не имеет статуса самозанятого или на сервис Мой налог недоступен.

Обязательный параметр

**Пример ссылки для перенаправления** ``` https://yookassa.ru/self-employed-boarding?agentId=123&success_url=https://example.com/success&fail_url=https://example.com/fail ``` Вы можете добавить к ссылке любые другие параметры, например идентификатор получателя выплаты в вашей системе. ЮKassa вернет дополнительные параметры без изменений. **Пример ссылки с дополнительными параметрами** ``` https://yookassa.ru/self-employed-boarding?agentId=123&success_url=https://example.com/success&fail_url=https://example.com/fail&employee_id=456 ```

После отправки формы ЮKassa перенаправляет получателя выплаты GET-методом на адрес, указанный в или . В случае успеха к адресу добавляется ИНН пользователя и статус выдачи прав, а в случае неудачи — описание ошибки. Если вы использовали дополнительные параметры, ЮKassa также добавит их к адресу.

Параметр	Тип	Описание
itn	xs:string, 12 символов	ИНН самозанятого. Обязательный параметр при успехе
status	xs:string	Статус выдачи прав ЮKassa: * — Ожидает подтверждения: самозанятому нужно подтвердить, что он разрешает ЮMoney регистрировать за него чеки; сообщите ему об этому и дождитесь, когда он выдаст права. * — Подтверждено: самозанятый выдал права ЮMoney; вы можете [делать выплаты](/docs/payment-solution/payouts/supplementary/self-employed/make-payout). Обязательный параметр при успехе
error	xs:string	Описание ошибки. Возможные значения: * — самозанятый с таким ИНН не зарегистрирован: ошибка при вводе ИНН или самозанятый снят с учета; * — сервис Мой налог не отвечает, получателю выплат необходимо заново отравить данные; * — внутренняя ошибка ЮKassa, обратитесь в техническую поддержку. Обязательный параметр при неудаче

Параметр

Тип

Описание

itn

xs:string,
12 символов

ИНН самозанятого.

Обязательный параметр при успехе

status

xs:string

Статус выдачи прав ЮKassa:

* — Ожидает подтверждения: самозанятому нужно подтвердить, что он разрешает ЮMoney регистрировать за него чеки; сообщите ему об этому и дождитесь, когда он выдаст права. * — Подтверждено: самозанятый выдал права ЮMoney; вы можете [делать выплаты](/docs/payment-solution/payouts/supplementary/self-employed/make-payout).

Обязательный параметр при успехе

error

xs:string

Описание ошибки. Возможные значения:

* — самозанятый с таким ИНН не зарегистрирован: ошибка при вводе ИНН или самозанятый снят с учета; * — сервис Мой налог не отвечает, получателю выплат необходимо заново отравить данные; * — внутренняя ошибка ЮKassa, обратитесь в техническую поддержку.

Обязательный параметр при неудаче

**Пример ответа при успехе** ``` https://example.com/success/?itn=123456789012&status=Confirmed ``` **Пример ответа при неудаче** ``` https://example.com/fail/?error=unregistered ```

Проведение выплат самозанятым Процесс выплат