Выплата налогов исполнителю
Метод payment_of_taxes выводит деньги с виртуального счёта типа for_ndfl — счёта, на котором бенефициар копит суммы на налоги. Куда именно уйдут деньги, задаёт тип получателя в параметре recipients. Поля метода — в автогенерируемом описании Выплатить налоги исполнителю.
Тип получателя определяет направление выплаты:
ndfl_from_virtual_account— оплата налога в бюджет, реквизиты налогового органаndfl_to_executor— вывод денег бенефициару на его расчётный счёт, чтобы он заплатил налог самndfl_to_executor_to_card— выплата на карту исполнителяndfl_to_executor_by_sbpиndfl_to_executor_by_sbp_v2— выплата самозанятому по номеру телефона через СБП
Виртуальный счёт плательщика во всех случаях должен быть типа for_ndfl.
Если добавить в запрос ext_key, метод станет идемпотентным: при повторном запросе с тем же ключом вернётся ответ оригинального запроса. Если запрос с этим ключом уже запущен, но ещё не завершён, вернётся ошибка 4909. Это защищает от случайной двойной выплаты.
Оплата налога в бюджет
Когда получатель — ndfl_from_virtual_account, платёж идёт в бюджет, и его нужно снабдить налоговыми полями tax_fields: КБК, ОКТМО, основание, статус плательщика и другие реквизиты платёжного поручения.
С 1 апреля 2026 года правила заполнения этих полей ужесточены. Платёж с некорректными полями отклоняется с ошибкой 4002 и описанием проблемы. Все допустимые значения полей 101, 106, 107, 108 и 109, а также привязку статуса к счёту получателя мы собрали на отдельной странице — Бюджетные платежи. Заполняйте tax_fields строго по ней.
Возможные ошибки
| Код | Текст |
|---|---|
4002 | No valid data in request |
4406 | Document not found |
4407 | Error loading document |
4408 | Document not yet uploaded |
4410 | Beneficiary no active |
4411 | Virtual account not found |
4415 | Insufficient funds on the virtual account |
4424 | Error type virtual account |
4425 | The recipient's INN differs from the recipient's INN |
4428 | Not found SBP bank by id |
4433 | System not registered in SBP |
4435 | Forbidden the ability to pay for the deal through the SBP |
4436 | An error occurred while requesting compliance |
4437 | Compliance has introduced a restriction on b2c transfers |
4451 | The purpose of the non-resident's payment contains incorrect or missing VO codes |
4909 | Idempotent request already in process |
4558 | It is impossible to perform the operation due to the fact that restrictions are imposed on the beneficiary based on the writ of execution |
4947 | Payment type not allowed for system |