Запрос прав на регистрацию чеков в сервисе Мой налог
Чтобы при выплатах ЮKassa автоматически регистрировала чеки, нужно получить от самозанятого ИНН и разрешение для ЮMoney на регистрацию чеков в сервисе Мой налог. Для этого используйте специальную форму ЮKassa.
 
Сценарий взаимодействия
Шаг 1. Вы объясняете получателю выплаты, что ему нужно выдать разрешение ЮMoney для автоматической регистрации чеков в сервисе Мой налог.
Шаг 2. Получатель выплаты переходит к вводу данных.
Шаг 3. Вы перенаправляете получателя выплаты на форму.
Форма для запроса прав в сервисе Мой налог
Шаг 4. Получатель выплаты вводит данные и нажимает Отправить.
Заполненная форма
Шаг 5. ЮKassa запрашивает права в сервисе Мой налог.
Шаг 6. Сервис Мой налог возвращает ЮKassa ответ.
Шаг 7. ЮKassa перенаправляет получателя выплаты на страницу успеха или неудачи на вашей стороне и сообщает вам результат.
В случае успеха ЮKassa вернет вам ИНН пользователя и текущий статус выдачи прав.
После этого получатель выплаты самостоятельно переходит в сервис Мой налог и выдает права ЮMoney.
Если после отправки формы вы получили статус Ожидает подтверждения, вам нужно самостоятельно проконтролировать, что получатель выплаты выдал разрешение ЮMoney в сервисе Мой налог.
 
Форма для запроса прав
Разместите на вашем сайте элемент, с помощью которого получатель выплаты будет перенаправлен на форму ЮKassa. Например, разместите кнопку, при нажатии на которую получатель будет переходить на форму.
Адрес для отправки формы
https://yookassa.ru/self-employed-boarding
К ссылке добавьте идентификатор вашего шлюза в ЮKassa, адрес страницы, на которую самозанятый вернется в случае успешной отправки данных, и адрес страницы, на которую он вернется, если при отправке данных что-то пойдет не так.
Описание параметров
ПараметрТипОписание
agentIdxs:long
Идентификатор вашего шлюза. Выдается ЮKassa.
Обязательный параметр
success_urlxs:string,
до 250 символов
Адрес страницы, на которую вернется получатель выплаты при успешной отправке данных.
Обязательный параметр
fail_urlxs: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-методом на адрес, указанный в 
success_url
или
fail_url
.
В случае успеха к адресу добавляется ИНН пользователя и статус выдачи прав, а в случае неудачи — описание ошибки. Если вы использовали дополнительные параметры, ЮKassa также добавит их к адресу.
ПараметрТипОписание
itnxs:string,
12 символов
ИНН самозанятого.
Обязательный параметр при успехе
statusxs:string
Статус выдачи прав ЮKassa:
  • AwaitingConfirmation
     — Ожидает подтверждения: самозанятому нужно подтвердить, что он разрешает ЮMoney регистрировать за него чеки; сообщите ему об этому и дождитесь, когда он выдаст права.
  • Confirmed
     — Подтверждено: самозанятый выдал права ЮMoney; вы можете делать выплаты.
Обязательный параметр при успехе
errorxs:string
Описание ошибки. Возможные значения:
  • unregistered
     — самозанятый с таким ИНН не зарегистрирован: ошибка при вводе ИНН или самозанятый снят с учета;
  • notResponding
     — сервис Мой налог не отвечает, получателю выплат необходимо заново отравить данные;
  • internalError
     — внутренняя ошибка ЮKassa, обратитесь в техническую поддержку.
Обязательный параметр при неудаче
Пример ответа при успехе
https://example.com/success/?itn=123456789012&status=Confirmed
Пример ответа при неудаче
https://example.com/fail/?error=unregistered
 
Что почитать еще
Проведение выплат самозанятымПроцесс выплат