Skip to main content

Отправить набор платежных поручений

/api/v1/payments-orders/payments-by-requisites/submit

POST

https://secured-openapi.tbank.ru/api/v1/payments-orders/payments-by-requisites/submit

Процесс от создания платежа до его отправки, в случае соблюдения всех условий

Авторизация

Security

RPS

Ограничение — 100 запросов в минуту

Scopes

Платежи в рубляхМетод для отправки платежных поручений

Запрос

Header parameters

Required

Signature

String

Подпись с данными в формате: Signature keyId="",algorithm="",[headers=""],signature="" keyId -- уникальный ключ, полученый от менеджера. algoritm -- алгоритм. На данный момент поддерживается только hmac-sha256. headers -- список с порядком подписанных заголовков запроса. Допустимы только хедеры, название которых указано в примере. signature -- подпись. параметр (request-target) определяется как "post /api/v1/payments-orders/payments-by-requisites/submit?

X-Request-Id

String<uuid>

Уникальный идентификатор для трассировки запроса. Не влияет на логику исполнения запроса.

Required

data

String

Requirements: <= 128 characters

Hash (hmac-sha256) от тела запроса

Required

date

String

Requirements: Value must match regular expression ^(Mon|Tue|Wed|Thu|Fri|Sat|Sun), ([0-3][0-9]) (Jan|Feb|Mar|Apr|May|Jun|Jul|Aug|Sep|Oct|Nov|Dec) ([0-9]{4}) ([01][0-9]|2[0-3])(:[0-5][0-9]){2} GMT$

Время выполнения запроса.

Request body schema application/json

Required

documentId

String

Requirements: non-empty and <= 64 characters

Идентификатор платежа

Required

payerAccountNumber

String

Requirements: >= 20 characters and <= 20 characters, Value must match regular expression ^[0-9]{20}$

Номер счёта плательщика

payeePersonName

String

Requirements: >= 2 characters and <= 160 characters

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

payeePersonInn

String

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

ИНН получателя. Обязателен для бюджетного и налогового платежа

payeePersonKpp

String

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

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

payeePersonBankName

String

Requirements: Value must match regular expression ^.{2,160}$

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

payeePersonBankCorrespondentAccount

String

Requirements: Value must match regular expression ^\d{1,20}$

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

payeePersonBankBic

String

Requirements: Value must match regular expression ^\d{1,9}$

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

payeePersonAccountNumber

String

Requirements: >= 20 characters and <= 20 characters, Value must match regular expression ^[0-9]{20}$

Номер счёта получателя

paymentPurpose

String

Requirements: non-empty and <= 210 characters

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

paymentAmount

String

Requirements: Value must match regular expression ^\d+(?:\.\d{1,2})?$

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

Required

documentNumber

Integer

Requirements: >= 1 and <= 999999

Номер платежного поручения

paymentExecutionDate

String<date-time>

Дата исполнения платежа (в какую дату исполнить платеж)

budgetPaymentUin

String

Requirements: Value must match regular expression ^(.{1,25}|0)$

УИН. Обязателен для бюджетного и налогового платежа

counterpartyUip

String

Requirements: Value must match regular expression ^(.{1,25}|0)$

УИП. Обязателен для платежа контрагенту

Required

paymentExecutionOrder

Integer

Requirements: >= 1 and <= 5

Ставится цифра от 1 до 5, которая сообщает банку, в какой последовательности списывать деньги со счета при их недостатке

revenueTypeCode

Integer

Requirements: >= 1 and <= 5

Код назначения платежа

Required

isExpressPayment

Boolean

Флаг срочности платежа

budgetPaymentPayeePersonKbk

String

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

КБК бюджетной организации. Может быть для бюджетного и налогового платежа

budgetPaymentBudgetPayerPersonStatus

String

Requirements: [01, 02, 06, 08, 09, 10, 11, 12, 13, 17, 19, 21, 22, 24, 31]

Бюджетный статус плательщика. Обязателен для бюджетного и налогового платежа

budgetPaymentOktmo

String

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

ОКТМО бюджетной организации. Может быть для бюджетного и налогового платежа

budgetPaymentThirdPartyPayerPersonInn

String

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

ИНН 3-го лица. Может быть для бюджетного и налогового платежа

budgetPaymentThirdPartyPayerPersonName

String

Requirements: >= 2 characters and <= 160 characters

Наименование 3-го лица. Может быть для бюджетного и налогового платежа

budgetPaymentThirdPartyPayerPersonKpp

String

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

КПП 3-го лица. Может быть для бюджетного и налогового платежа

taxPaymentTaxType

String

Requirements: [0, АВ, ПЕ, СА, ВЗ, ПЛ, ПЦ, АШ, ИШ, НС, ГП]

Тип налогового платежа. Может быть для налогового платежа

taxPaymentTaxEvidence

String

Requirements: [0, 00, PC, ОТ, РТ, ПБ, ИН, ТЛ, ЗТ, ДЕ, ПО, КТ, ИД, ИП, ТУ, КП, КЭ, УВ, ИЛ, ТГ, ТБ, ТД, ПВ, ТП, ЗД]

Основание налогового платежа. Обязателен для налогового платежа

taxPaymentTaxDocumentDate

String

Requirements: Value must match regular expression ^(\d\d\.\d\d\.\d\d\d\d|0|00)$

Дата налогового документа. Может быть для налогового платежа

taxPaymentTaxPeriod

String

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

Налоговый период. Может быть для налогового платежа

taxPaymentTaxDocumentNumber

String

Requirements: non-empty and <= 15 characters

Номер налогового документа. Обязателен для налогового платежа

Ответ

200

Успешный ответ на запрос на отправку платежного поручения

400

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

401

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

403

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

422

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

429

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

500

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

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

Loading...

openapi@tbank.ru

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