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

POST

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

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

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

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

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

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

Self-сценарий

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

Партнерский сценарий

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

Лимиты

По умолчанию на выполнение платежей через API установлены следующие лимиты:

максимальная сумма одного платежа — 100 000 рублей;
максимальная сумма платежей в день — 100 000 рублей;
максимальная сумма платежей в месяц — 1 000 000 рублей;
максимальное количество платежей в день на одного контрагента — 3.

Чтобы изменить лимиты для вашей компании, напишите на openapi@tinkoff.ru.

Ограничение на использование метода — 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})$

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

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

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

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

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

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