Выполнить платёж в пользу бенефициара на реальный счёт

/api/v1/nominal-accounts/payments

POST

https://secured-openapi.tbank.ru/api/v1/nominal-accounts/payments

Позволяет напрямую вывести средства с виртуального счёта бенефициара на реальный счёт. Для налогового платежа можно указать реквизиты целиком. Только для типа PAYMENT_DETAILS.

Ограничение на использование метода — 10 запросов в секунду.

Чтобы использовать метод, нужен доступ opensme/inn/[{inn}]/kpp/[{kpp}]/nominal-accounts/manage — Управление номинальными счетами.

Авторизация

Security

Bearer API Token

MTLS-сертификат

Запрос

Header parameters

Required

Idempotency-Key

String<uuid>

Ключ идемпотентности. Подробнее.

Request body schema application/json

oneOf

CreateRegularPaymentRequest

Required

type

String

Requirements: [REGULAR, TAX]

Тип платежа:

• REGULAR — обычный.
• TAX — налоговый.

Required

beneficiaryId

String<uuid>

Идентификатор бенефициара.

Required

accountNumber

String

Requirements: Value must match regular expression ^(\d{20}|\d{22})$

Номер номинального счёта.

bankDetailsId

String<uuid>

Идентификатор банковских реквизитов.

Required

amount

Number

Сумма платежа.

Required

purpose

String

Requirements: non-empty and <= 210 characters

Назначение платежа.

CreateTaxPaymentRequest

Required

type

String

Requirements: [REGULAR, TAX]

Тип платежа:

• REGULAR — обычный.
• TAX — налоговый.

Required

beneficiaryId

String<uuid>

Идентификатор бенефициара.

Required

accountNumber

String

Requirements: Value must match regular expression ^(\d{20}|\d{22})$

Номер номинального счёта.

Required

bankDetails

Object (BankDetails)

oneOf

CardBankDetails

Required

type

String

Requirements: [PAYMENT_DETAILS, CARD, SBP]

Тип банковских реквизитов:

• PAYMENT_DETAILS — По реквизитам счёта.
• CARD — На карту.
• SBP — Через СБП.

Required

cardId

String

Requirements: non-empty and <= 256 characters

Идентификатор карты в системе банка.

Required

terminalKey

String

Requirements: non-empty and <= 256 characters

Ключ терминала.

RkcBankDetails

Required

type

String

Requirements: [PAYMENT_DETAILS, CARD, SBP]

Тип банковских реквизитов:

• PAYMENT_DETAILS — По реквизитам счёта.
• CARD — На карту.
• SBP — Через СБП.

Required

bik

String

Requirements: Value must match regular expression \d{9}

БИК банка получателя.

С 1 января 2021 года при перечислении налоговых платежей указываются новые значения БИК банков получателя.

Подробнее о полях платёжного поручения

kpp

String

Requirements: Value must match regular expression ^(\d{9})$

КПП получателя

inn

String

Requirements: Value must match regular expression ^(\d{12}|\d{10}|0{1})$

ИНН. Укажите 0, чтобы не заполнять.

name

String

Requirements: <= 160 characters

Наименование получателя.

Required

bankName

String

Requirements: non-empty and <= 255 characters

Наименование банка получателя.

С 1 января 2021 года при заполнении платежей на перечисление налогов после названия банка указывается название счёта казначейства через знак //.

Required

accountNumber

String

Requirements: Value must match regular expression ^(\d{20}|\d{22})$

Номер расчетного счета. ВАЖНО: Для бюджетных платежей с 01.01.2021 в данном поле нужно указывать новые номера казначейских счетов.

Required

corrAccountNumber

String

Requirements: Value must match regular expression \d{20}

Корреспондентский счёт банка получателя.

С 1 января 2021 года при уплате налогов указывается номер счёта банка получателя, входящий в состав единого казначейского счёта (ЕКС). Раньше это поле заполнялось нулями.

SbpBankDetails

Required

type

String

Requirements: [PAYMENT_DETAILS, CARD, SBP]

Тип банковских реквизитов:

• PAYMENT_DETAILS — По реквизитам счёта.
• CARD — На карту.
• SBP — Через СБП.

Required

phoneNumber

String

Requirements: Value must match regular expression ^((\+7)([0-9]){10})$

Номер мобильного телефона.

Required

bankId

String

Requirements: Value must match regular expression ^\d{12}$

Идентификатор банка в системе быстрых платежей.

Required

terminalKey

String

Requirements: non-empty and <= 256 characters

Ключ терминала.

Required

amount

Number

Сумма платежа.

Required

purpose

String

Requirements: non-empty and <= 210 characters

Назначение платежа.

Required

uin

String

Requirements: Value must match regular expression 0|[А-Яа-яA-Za-z0-9]{4}|[А-ЯA-Z0-9]{15}|[а-яА-Яa-zA-Z0-9№\s!"#$%;'()*+,-\.\/:;;=>?@\]\[\\\^_{|}~]{20}|[а-яА-Яa-zA-Z0-9№\s!"#$%;'()*+,-./:;;=>?@][\^_{|}~]{25}

Уникальный идентификатор платежа.

Required

tax

Object (TaxPaymentParameters)

Реквизиты для уплаты налогов и иных бюджетных платежей.

Required

payerStatus

String

Requirements: Value must match regular expression \d{2}

Статус составителя расчётного документа. Поле платёжки 101.

При оплате налога за третьих лиц указывается налоговый статус человека, за которого происходит оплата. Может принимать следующие значения:

• 01 — налогоплательщик (плательщик сборов) — юрлицо;
• 02 — налоговый агент;
• 08 — плательщик-юрлицо (ИП), осуществляющий уплату страховых взносов и иных платежей в бюджетную систему РФ;
• 13 — физическое лицо, уплачивающее налоги, сборы за совершение налоговыми органами юридически значимых действий, страховые взносы и иные платежи, администрируемые налоговыми органами;
• 14 — указывается плательщиком, который осуществляет транзакции в пользу физлиц;
• 19 — организации и их филиалы, перечисляющие средства, удержанные из заработной платы (дохода) должника — физлица в счет погашения задолженности по платежам в бюджет на основании исполнительного документа;
• 24 — плательщик-физлицо, осуществляющий уплату страховых взносов и иных платежей в бюджетную систему РФ.

Статус плательщика в платёжном поручении в 2024 году

Required

kbk

String

Requirements: Value must match regular expression \d{20}|0

Код бюджетной классификации. Поле платёжки 104. Подробнее.

Required

oktmo

String

Requirements: Value must match regular expression \d{8}|\d{11}|0

Код ОКТМО территории, на которой мобилизуются денежные средства от уплаты налога, сбора и иного платежа. Поле платёжки 105. Подробнее.

Required

evidence

String

Requirements: Value must match regular expression [A-Za-zА-Яа-я]{2}|00|0

Основание налогового платежа. Поле платёжки 106. Может принимать следующие значения:

• ТП — платежи текущего года;
• ЗД — добровольное погашение задолженности по истекшим налоговым, расчётным (отчётным) периодам при отсутствии требования налогового органа об уплате налогов (сборов);
• РС — погашение рассроченной задолженности;
• ОТ — погашение отсроченной задолженности;
• РТ — погашение реструктурируемой задолженности;
• ПБ — погашение должником задолженности в ходе процедур, применяемых в деле о банкротстве;
• ИН — погашение инвестиционного налогового кредита;
• ТЛ — погашение учредителем (участником) должника или собственником имущества должника — унитарного предприятия или третьим лицом задолженности в ходе процедур, применяемых в деле о банкротстве;
• ЗТ — погашение текущей задолженности в ходе процедур, применяемых в деле о банкротстве;
• 00 — иные случаи (для таможенных платежей);
• 0 — при незнании основания платежа.

Новые правила заполнения поля 106 платёжных поручений с 1 октября 2021 года (26-2.ru)

Required

period

String

Requirements: Value must match regular expression ^(0)$|^(\d{8})$|^(.{2}\.\d{2}\.\d{4})$

Налоговый период. Поле платёжки 107. Формат — ДД.ММ.ГГГГ, первые два символа могут быть буквами или цифрами. В поле можно передать 0. Подробнее.

Required

docNumber

String

Requirements: Value must match regular expression [A-Za-zА-Яа-я]{2}\d{13}|\d{2};\d{1,20}|[A-Za-zА-Яа-я]{2}|0{1}

Номер налогового документа. Поле платёжки 108. Как заполнить поля платёжного поручения без ошибок.

Required

docDate

String

Requirements: Value must match regular expression \d{2}\.\d{2}\.\d{4}|0

Дата налогового документа. Поле платёжки 109. Формат — ДД.ММ.ГГГГ или 0. Подробнее.

thirdParty

Object (TaxThirdParty)

Реквизиты для оплаты налогов за третьих лиц. Подробнее.

Required

inn

String

Requirements: Value must match regular expression ^(\d{12}|\d{10}|0{1})$

ИНН третьего лица.

Required

kpp

String

Requirements: Value must match regular expression ^(\d{9}|0)$

КПП третьего лица.

Ответ

201

Created

400

Некорректный запрос

401

Ошибка аутентификации

403

Ошибка авторизации

422

Ошибка при обработке данных

429

Слишком много запросов

500

Ошибка сервера

Это полезный материал?

Обратиться в поддержку

Получить консультацию по интеграции

Loading...