Запрос прав на регистрацию чеков в сервисе Мой налог
The mass payouts protocol is now outdated. If you want to make payouts via the API, use the YooMoney API.
Чтобы при выплатах Ю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, адрес страницы, на которую самозанятый вернется в случае успешной отправки данных, и адрес страницы, на которую он вернется, если при отправке данных что-то пойдет не так.
Описание параметров
| Parameter | Type | Description |
|---|---|---|
agentId | xs:long | Идентификатор вашего шлюза. Выдается ЮKassa. Required parameter |
success_url | xs:string, up to 250 characters | Адрес страницы, на которую вернется получатель выплаты при успешной отправке данных. Required parameter |
fail_url | xs:string, up to 250 characters | Адрес страницы, на которую вернется получатель выплаты в случае ошибки, например если он не имеет статуса самозанятого или на сервис Мой налог недоступен. Required parameter |
Пример ссылки для перенаправления
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 также добавит их к адресу.
| Parameter | Type | Description |
|---|---|---|
itn | xs:string, 12 символов | ИНН самозанятого. Обязательный параметр при успехе |
status | xs:string | Статус выдачи прав ЮKassa:
Обязательный параметр при успехе |
error | xs:string | Описание ошибки. Возможные значения:
Обязательный параметр при неудаче |
Пример ответа при успехе
https://example.com/success/?itn=123456789012&status=Confirmed
Пример ответа при неудаче
https://example.com/fail/?error=unregistered
See also