Skip to main content

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

POST

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

Позволяет выплачивать деньги с рублёвых счетов компании.

Выплаты могут производиться на счета резидентов юридических и физических лиц в банках РФ. Выплата денег со счёта производится асинхронно. Если передать информацию в блоке Налоги, появится возможность совершать налоговые платежи и налоговые платежи за третьих лиц.

Результат запроса на выплату можно получить через метод Получить статуса платежа, передав в нём соответствующий 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

Запрос

Request body schema application/json

Required

id

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

to

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 — плательщик-физлицо, осуществляющий уплату страховых взносов и иных платежей в бюджетную систему РФ.
[Статус плательщика в платежном поручении в 2021 году — Бухонлайн (buhonline.ru)](https://www.buhonline.ru/pub/beginner/2019/10/15119_status-platelshhika-v-platezhke-2021)

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)](https://www.26-2.ru/art/356241-polya-106-platejnyh-1-oktyabrya-2021)

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. Как заполнить поля платежного поручения и не ошибиться (azbuha.ru).

Required

docDate

String

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

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

thirdParty

Object (TaxThirdParty)

Реквизиты для оплаты налогов за третьих лиц. Подробнее: https://glavkniga.ru/situations/s509587

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

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

meta

Object

Дополнительные метаданные в формате JSON. Сохраняются при создании платежа и возвращаются при получении статуса.

property name*

String

Ответ

201

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

400

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

401

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

403

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

422

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

429

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

500

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

Loading...

openapi@tinkoff.ru

АО «Тинькофф Банк» использует файлы «cookie», с целью персонализации сервисов и повышения удобства пользования веб-сайтом. «Cookie» представляют собой небольшие файлы, содержащие информацию о предыдущих посещениях веб-сайта. Если вы не хотите использовать файлы «cookie», измените настройки браузера.

АО «Тинькофф Банк» использует файлы «cookie», с целью персонализации сервисов и повышения удобства пользования веб-сайтом. «Cookie» представляют собой небольшие файлы, содержащие информацию о предыдущих посещениях веб-сайта. Если вы не хотите использовать файлы «cookie», измените настройки браузера.