Отправить набор платежных поручений
https://secured-openapi.tbank.ru/api/v1/payments-orders/payments-by-requisites/submit
Метод для отправки платежных поручений в рублях.
Обратите внимание: чтобы использовать метод, нужно выпустить mTLS-сертификат и один или несколько сертификатов криптографической подписи — их количество зависит от ваших настроек правил подписания документов. Подробнее про сертификаты.
Авторизация
Security
RPS
Ограничение — 100 запросов в минуту
Scopes
Платежи → Метод для отправки платежных поручений
Запрос
Header parameters
Required
Signature
String
Криптографическая подпись с данными в формате Signature keyId=", где:
keyId— уникальный ключ, полученый от менеджера.algoritm— алгоритм. Сейчас поддерживается только HMAC-SHA256.headers— список с порядком подписанных заголовков запроса. Допускаются только хедеры с названиями, которые указаны в примерах запроса.signature— подпись.
Request-Target для метода — post /api/v1/payments-orders/payments-by-requisites/submit?. Значение Request-Target формируется путем объединения нескольких частей запроса:
название метода (глагола) в нижнем регистре, пути метода и всех его параметров.
Пример: для запроса get /api/v1/get?param1=str1¶m2=str2 часть get — это
метод (глагол) запроса, /api/v1/get — его путь, а ?param1=str1¶m2=str2 — Query-параметры
запроса.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, 06, 08, 13, 15, 16, 17, 19, 20, 24, 28, 29, 30, 31, 33]
Бюджетный статус плательщика. Обязателен для бюджетных и налоговых платежей.
budgetPaymentOktmo
String
Requirements: Value must match regular expression ^(\d{1,8}|0)$
ОКТМО бюджетной организации. Для бюджетных и налоговых платежей.
budgetPaymentThirdPartyPayerPersonInn
String
Requirements: Value must match regular expression ^(\d{1,12}|0)$
ИНН третьего лица. Для бюджетных и налоговых платежей.
budgetPaymentThirdPartyPayerPersonName
String
Requirements: >= 2 characters and <= 160 characters
Наименование третьего лица. Для бюджетных и налоговых платежей.
budgetPaymentThirdPartyPayerPersonKpp
String
Requirements: Value must match regular expression ^(\d{1,10}|0)$
КПП третьего лица. Для бюджетных и налоговых платежей.
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
Номер налогового документа. Обязателен для налоговых платежей.
Ответ
Это полезный материал?