Запрос прав на регистрацию чеков в сервисе Мой налог

Протокол массовых выплат устарел. Если хотите делать выплаты по API, используйте API ЮKassa.

Чтобы при выплатах ЮKassa автоматически регистрировала чеки, нужно получить от самозанятого ИНН и разрешение для ЮMoney на регистрацию чеков в сервисе Мой налог. Для этого используйте специальную форму ЮKassa.

Форма для запроса прав в сервисе Мой налог

Сценарий взаимодействия

Вы объясняете получателю выплаты, что ему нужно выдать разрешение ЮMoney для автоматической регистрации чеков в сервисе Мой налог.
Получатель выплаты переходит к вводу данных.
Вы перенаправляете получателя выплаты на форму.
Получатель выплаты вводит данные и нажимает Отправить.
ЮKassa запрашивает права в сервисе Мой налог.
Сервис Мой налог возвращает ЮKassa ответ.
ЮKassa перенаправляет получателя выплаты на страницу успеха или неудачи на вашей стороне и сообщает вам результат.

В случае успеха ЮKassa вернет вам ИНН пользователя и текущий статус выдачи прав. Перенаправление на страницу успеха не гарантирует согласие самозанятого на регистрацию чека, а лишь сообщает об успешном запросе прав.

Для выдачи прав получатель выплаты самостоятельно переходит в сервис Мой налог и подтверждает согласие на регистрацию чеков.

Если после отправки формы вы получили статус Ожидает подтверждения, вам нужно самостоятельно проконтролировать, что получатель выплаты выдал разрешение ЮMoney в сервисе Мой налог.

Форма для запроса прав

Для запроса прав на регистрацию чеков вам нужно перенаправить самозанятого на форму, размещенную на стороне ЮKassa.

Шаг 1. Сформируйте ссылку для перенаправления получателя выплаты на форму ЮKassa. Для этого к адресу, по которому размещена форма, добавьте идентификатор вашего шлюза в ЮKassa, адрес страницы, на которую самозанятый вернется в случае успешной отправки данных, и адрес страницы, на которую он вернется, если при отправке данных что-то пойдет не так.

Вы можете добавить к адресу формы любые другие параметры, которые нужны вам для работы (например, идентификатор получателя выплаты в вашей системе). ЮKassa вернет дополнительные параметры без изменений.

Адрес, по которому размещена форма ЮKassa

https://yookassa.ru/self-employed-boarding

Описание параметров

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

Пример ссылки для перенаправления

https://yookassa.ru/self-employed-boarding?agentId=123&success_url=https://example.com/success&fail_url=https://example.com/fail

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

https://yookassa.ru/self-employed-boarding?agentId=123&success_url=https://example.com/success&fail_url=https://example.com/fail&employee_id=456

Шаг 2. Разместите на вашем сайте элемент, с помощью которого получатель выплаты будет перенаправлен на форму ЮKassa. Например, разместите кнопку, при нажатии на которую самозанятый будет переходить по сформированной вами ссылке.

Шаг 3. Обработайте ответ после отправки формы.

Готово!

Ответ после отправки формы

После отправки формы ЮKassa перенаправляет получателя выплаты GET-методом на адрес, указанный в success_url или fail_url.

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

Параметр	Тип	Описание
itn	xs:string, 12 символов	ИНН самозанятого. Обязательный параметр при успехе
status	xs:string	Статус выдачи прав ЮKassa: `AwaitingConfirmation` — Ожидает подтверждения: самозанятому нужно подтвердить, что он разрешает ЮMoney регистрировать за него чеки; сообщите ему об этому и дождитесь, когда он выдаст права. `Confirmed` — Подтверждено: самозанятый выдал права ЮMoney; вы можете делать выплаты. `Canceled` — Отменено: у самозанятого недавно уже запрашивали права на регистрацию чеков и он отказался их выдать. Вы можете запросить права повторно через 15 минут или сделать выплату без автоматической регистрации чеков, как обычному физическому лицу. Обязательный параметр при успехе
error	xs:string	Описание ошибки. Возможные значения: `unregistered` — самозанятый с таким ИНН не зарегистрирован: ошибка при вводе ИНН или самозанятый снят с учета; `notResponding` — сервис Мой налог не отвечает, получателю выплат необходимо заново отравить данные; `internalError` — внутренняя ошибка ЮKassa, обратитесь в техническую поддержку. Обязательный параметр при неудаче

Пример ответа при успехе

https://example.com/success/?itn=123456789012&status=Confirmed

Пример ответа при неудаче

https://example.com/fail/?error=unregistered

Что почитать еще

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