YooMoney API
Old versions of the API
Help
Sign up for YooMoney
Запрос прав на регистрацию чеков в сервисе Мой налог

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 перенаправляет получателя выплаты на страницу успеха или неудачи на вашей стороне и сообщает вам результат.
In case of success, YooMoney will return to you the user's (INN) TIN and current rights granting status. Redirecting to the success page doesn't guarantee that the self-employed individual gave their consent to record receipts. It only reports a successful request for granting rights.
In order to grant the rights, the payout recipient needs to go to the My Tax service and give their consent to record receipts.

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

Форма для запроса прав
To request the rights for receipt recording, you need to redirect the self-employed individual to the form placed on YooMoney's side.
Step 1. Generate the link to redirect the payout recipient to the form. Add the following parameters to the address where the form is placed: the ID of your gateway in YooMoney, URL of the page that the user will return to after successfully adding the data, as well as the URL of the page they will return to in case something goes wrong during the process of sending the data.
You can add any other parameters that you need for processing (for example, the payout recipient ID in your system) to the form address. YooMoney will return the additional parameters without changes.
URL of the YooMoney form
https://yookassa.ru/self-employed-boarding
Описание параметров
ParameterTypeDescription
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
Any names not listed above
xs:string,
4096 characters (total length of all parameters)
Parameters added to the form address will be saved and used in the address success_url or fail_url when you receive the response after the form is sent.
Optional parameter
Пример ссылки для перенаправления
https://yookassa.ru/self-employed-boarding?agentId=123&success_url=https://example.com/success&fail_url=https://example.com/fail
Example of a redirect link with additional parameters
https://yookassa.ru/self-employed-boarding?agentId=123&success_url=https://example.com/success&fail_url=https://example.com/fail&employee_id=456
Step 2. Разместите на вашем сайте элемент, с помощью которого получатель выплаты будет перенаправлен на форму ЮKassa. For example, place the button that will redirect the user to the link you've generated.
Step 3. Process the response after the form is sent.
Done!
Ответ после отправки формы
После отправки формы ЮKassa перенаправляет получателя выплаты GET-методом на адрес, указанный в success_url или fail_url.
В случае успеха к адресу добавляется ИНН пользователя и статус выдачи прав, а в случае неудачи — описание ошибки. If you've provided additional parameters, YooMoney will use them in the address without changes.
ParameterTypeDescription
itn
xs:string,
12 символов
ИНН самозанятого.
Обязательный параметр при успехе
status
xs:string
Статус выдачи прав ЮKassa:
  • AwaitingConfirmation — Ожидает подтверждения: самозанятому нужно подтвердить, что он разрешает ЮMoney регистрировать за него чеки; сообщите ему об этому и дождитесь, когда он выдаст права.
  • Confirmed — Подтверждено: самозанятый выдал права ЮMoney; вы можете делать выплаты.
  • Canceled: self-employed individual was already asked for the rights to record receipts and refused to grant them. You can request the rights again in 15 minutes or make a payout without recording receipts automatically as to a regular individual.
Обязательный параметр при успехе
error
xs:string
Описание ошибки. Возможные значения:
  • unregistered — самозанятый с таким ИНН не зарегистрирован: ошибка при вводе ИНН или самозанятый снят с учета;
  • notResponding — сервис Мой налог не отвечает, получателю выплат необходимо заново отравить данные;
  • internalError — внутренняя ошибка ЮKassa, обратитесь в техническую поддержку.
Обязательный параметр при неудаче
Пример ответа при успехе
https://example.com/success/?itn=123456789012&status=Confirmed
Пример ответа при неудаче
https://example.com/fail/?error=unregistered
See also
Проведение выплат самозанятым Процесс выплат
© 2024, "YooMoney", NBCO LLC