Выполнить платеж

POST

https://secured-openapi.tbank.ru/api/v1/payment/ruble-transfer/pay

Метод для выплаты денег с рублевых счетов компании на счета резидентов юридических и физических лиц в банках РФ.

Деньги со счета выплачиваются асинхронно. Чтобы совершать налоговые платежи за себя и третьих лиц, передайте значения в блоке tax.

Результат запроса на выплату можно получить через метод Получить статуса платежа, передав в нем соответствующий paymentId.

Чтобы использовать метод, нужен доступ: opensme/inn/[{inn}]/kpp/[{kpp}]/payments/rub-pay — Совершение платежей с рублевого расчетного счета компании с ИНН {inn} и КПП {kpp}.

Все вызовы метода дедуплицируются:

Прямая интеграция

Дедупликация происходит по paymentId в контексте вашей компании. Это значит, что paymentId должен быть уникален в рамках всех платежей от лица вашей компании. Если вызвать метод два и более раза с одинаковыми paymentId в рамках одной компании, создастся только один платеж.

Партнерская интеграция

Дедупликация происходит по paymentId и clientId. Это значит, что связка paymentId и clientId должна быть уникальна. Если вызвать метод два и более раза с одинаковыми paymentId и clientId, создастся только один платеж. clientId выдается при регистрации партнера в Т-Банке и отправляется на почту.

Лимиты

Лимиты на выполнение платежей через API можно установить в личном кабинете Т-Бизнеса в разделе Лимиты.

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

Авторизация

Security

Bearer API Token

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

Запрос

Request body schema application/json

Required

String

Requirements: non-empty and <= 64 characters

Идентификатор платежа. Должен быть уникален в пределах интеграции.

Required

from

Object (PayerRequisites)

Реквизиты плательщика.

Required

accountNumber

String

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

Номер расчетного счета для списания.

kpp

String

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

КПП плательщика.

Required

Object (ReceiverRequisites)

Реквизиты получателя платежа.

Required

name

String

Получатель.

Required

inn

String

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

ИНН получателя. Если платеж выполняется в пользу физ. лица и его ИНН неизвестен, передайте 0. Во всех остальных случаях передавайте фактический ИНН получателя.

kpp

String

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

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

Required

bik

String

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

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

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

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

bankName

String

Requirements: non-empty and <= 255 characters

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

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

corrAccountNumber

String

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

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

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

Required

accountNumber

String

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

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

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}

Уникальный идентификатор платежа. Поле платежки 22. Обязательное поле для налоговых платежей. Подробнее.

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)$

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

Required

purpose

String

Requirements: non-empty and <= 210 characters

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

При заполнении назначения платежа для налоговых платежей за третьих лиц следуйте шаблону: ИНН того, кто перечисляет / КПП того, кто перечисляет / наименование лица, за которого происходит оплата / назначение платежа. Подробнее.

documentNumber

Integer<int32>

Requirements: >= 1

Номер распоряжения, определяемый клиентом. Заполняется на усмотрение плательщика. Номер документа — не больше 6 цифр.

executionOrder

Integer<int32>

Requirements: >= 1 and <= 5

Очередность платежа. По умолчанию — 5.

1 — алиментные удержания из заработной платы, компенсации вреда жизни и здоровью. Основания для уплаты — алиментный договор, заверенный у нотариуса, судебный приказ, исполнительный лист от судебных приставов.
2 — погашение задолженностей по зарплатам сотрудникам, выплаты выходных пособий и авторских вознаграждений. Основание для уплаты — исполнительный лист, судебный приказ.
3 — выплаты зарплат сотрудникам по трудовым соглашениям, принудительная уплата налогов и отчислений во внебюджетные фонды. Основание для уплаты — расчетная документация, платежные требования и инкассовые поручения от ИФНС, ФСС, ПФР.
4 — принудительные выплаты, которые не вошли в первую, вторую и третью очередь, например задолженности по договорам, штрафы, неустойки, коммунальные платежи. Основание для уплаты — исполнительные документы, требования, постановления, приказы, судебные решения.
5 — все остальные, не вошедшие в первую, вторую, третью и четвертую категории — например, добровольная уплата долгов, пеней, штрафов.

Подробнее

Required

amount

Number

Сумма платежа в рублях.

dueDate

String<date-time>

Дата, до которой нужно провести платеж. При неуспешных попытках платежа он будет повторен вплоть до указанной даты. Если дату не передать, платеж не будет повторен в случае неуспешной попытки. Время на проведение платежа не может быть больше 30 дней.

revenueTypeCode

String

Requirements: [1, 2, 3, 4, 5]

Код вида выплаты. Подробнее.

collectionAmount

Number

Удержанная сумма из заработной платы и иных доходов работника в рублях. Подробнее.

Ответ

201

Платеж поставлен в очередь на исполнение

400

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

401

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

403

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

422

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

429

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

500

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

502

Bad Gateway

503

Service Unavailable

504

Gateway Timeout

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

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