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

/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

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

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

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

Пример запроса

Payload

cURL

Go

Java

NodeJs

PHP

Python

Content type

application/json

Обычный платеж.

Налоговый платеж.

{

"type":

"REGULAR",

"beneficiaryId":

"61f656e0-0a86-4ec2-bd43-232499f7ad66",

"accountNumber":

"40702810110011000777",

"bankDetailsId":

"49e46893-9a7e-409b-8c79-647aecaae555",

"amount":

100,

"purpose":

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

}

Пример ответа

201

400

401

403

422

429

500

Content type

application/json

Успешный обычный платеж по реквизитам счета.

Неуспешный обычный платеж по реквизитам счета.

Успешный налоговый платеж.

Неуспешный налоговый платеж.

{

"type":

"REGULAR",

"paymentId":

"58097aa1-9660-47e7-8550-f2167fa80cea",

"beneficiaryId":

"61f656e0-0a86-4ec2-bd43-232499f7ad66",

"accountNumber":

"40702810110011000777",

"bankDetails": { ... },

"type":

"PAYMENT_DETAILS",

"bik":

"044525974",

"kpp":

"773401001",

"inn":

"906858195320",

"name":

"Киняев Фома Семенович",

"bankName":

"АО "ТБанк"",

"accountNumber":

"11223344556677889900",

"corrAccountNumber":

"30101810145250000974"

},

"dealId":

"dd6c3237-9958-47d9-9ba0-f6faeaa0e788",

"stepId":

"c87d3297-f4ae-4f88-add9-6722c1fc0b8c",

"recipientId":

"00021d4e-536f-11ec-ac0b-370ccfeacec2",

"amount":

100,

"status":

"SUCCEEDED",

"purpose":

"Назначение платежа",

"operationId":

"171f9b1f-9f7c-4d7d-b6b3-4bf4a1d6cc7d"

}