Чтобы при выплатах ЮKassa автоматически регистрировала чеки, нужно получить от самозанятого ИНН и разрешение для ЮMoney на регистрацию чеков в сервисе Мой налог. Для этого используйте специальную форму ЮKassa.
Шаг 1. Вы объясняете получателю выплаты, что ему нужно выдать разрешение ЮMoney для автоматической регистрации чеков в сервисе Мой налог.
Шаг 2. Получатель выплаты переходит к вводу данных.
Шаг 3. Вы перенаправляете получателя выплаты на форму.
Форма для запроса прав в сервисе Мой налог
Шаг 4. Получатель выплаты вводит данные и нажимает Отправить.
Заполненная форма
Шаг 5. ЮKassa запрашивает права в сервисе Мой налог.
Шаг 6. Сервис Мой налог возвращает ЮKassa ответ.
Шаг 7. ЮKassa перенаправляет получателя выплаты на страницу успеха или неудачи на вашей стороне и сообщает вам результат.
В случае успеха ЮKassa вернет вам ИНН пользователя и текущий статус выдачи прав.
После этого получатель выплаты самостоятельно переходит в сервис Мой налог и выдает права ЮMoney.
Разместите на вашем сайте элемент, с помощью которого получатель выплаты будет перенаправлен на форму ЮKassa. Например, разместите кнопку, при нажатии на которую получатель будет переходить на форму.
Адрес для отправки формы
https://yookassa.ru/self-employed-boarding
К ссылке добавьте идентификатор вашего шлюза в ЮKassa, адрес страницы, на которую самозанятый вернется в случае успешной отправки данных, и адрес страницы, на которую он вернется, если при отправке данных что-то пойдет не так.
Описание параметров
| Параметр | Тип | Описание |
|---|---|---|
| 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-методом на адрес, указанный в
success_url или fail_url.В случае успеха к адресу добавляется ИНН пользователя и статус выдачи прав, а в случае неудачи — описание ошибки. Если вы использовали дополнительные параметры, ЮKassa также добавит их к адресу.
| Параметр | Тип | Описание |
|---|---|---|
| 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