Перейти к основному содержимому

Создать черновик платёжного поручения

/api/v1/payment/create

POST

https://business.tbank.ru/openapi/api/v1/payment/create

Метод для создания черновиков платежей. Работает только для резидентов РФ.

Результат запроса на создание черновика платёжного поручения можно получить через метод Получить список статусов платёжных документов, передав в нём соответствующий documentId.

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

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

Авторизация

Security

Bearer API Token

Запрос

Request body schema application/json

Required

documentNumber

String

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

Номер распоряжения, определяемый клиентом.

date

String<date-time>

Дата и время исполнения платежа. Может быть в будущем или не передаваться. Если поле не передано, подписанный документ будет принят к исполнению немедленно.

Required

amount

Number

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

Required

recipientName

String

Получатель.

Required

inn

String

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

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

Required

kpp

String

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

КПП получателя. Если у получателя платежа нет КПП, например, это физ. лицо или ИП, передайте 0.

Required

bankAcnt

String

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

Required

bankBik

String

БИК банка.

Required

accountNumber

String

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

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

Required

paymentPurpose

String

Requirements: non-empty and <= 210 characters

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

executionOrder

Integer<int32>

Requirements: >= 1 and <= 5

Очерёдность платежа.

Required

taxPayerStatus

String

Статус составителя расчётного документа. Поле платёжки 101. Если платёж не бюджетный, передайте 0.

Required

kbk

String

Код бюджетной классификации. Поле платёжки 104. Если платёж не бюджетный или КБК отсутствует, передайте 0.

Required

oktmo

String

Код ОКТМО территории, на которой мобилизуются денежные средства от уплаты налога, сбора и иного платежа. Если платёж не бюджетный, передайте 0.

Required

taxEvidence

String

Основание налогового платежа. Поле платёжки 106. Если платёж не бюджетный или основание неизвестно, передайте 0.

Required

taxPeriod

String

Налоговый период. Поле платёжки 107. Формат — ДД.ММ.ГГГГ, первые два символа могут быть буквами. Если платёж не бюджетный или период отсутствует, передайте 0.

Required

uin

String

Уникальный идентификатор платежа. Если платёж не бюджетный, передайте 0.

Required

taxDocNumber

String

Номер налогового документа. Поле платёжки 108. Если платёж не бюджетный или задолженность оплачивается в добровольном порядке, передайте 0.

Required

taxDocDate

String

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

revenueTypeCode

String

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

Код вида выплаты. Обязательное поле для платежей в пользу физ. лиц. Подробнее.

collectionAmountNumber

Number

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

recipientCorrAccountNumber

String

Корреспондентский счёт банка получателя. Для налогового платежа обязательно указывается номер счёта банка получателя средств — номер банковского счёта, который входит в состав единого казначейского счёта (ЕКС).

thirdParty

Object (ThirdPartyInfo)

Информация для совершения налоговых платежей за третьих лиц.

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

name

String

ФИО третьего лица.

Ответ

200

OK

400

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

401

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

403

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

422

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

429

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

500

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

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

Loading...

openapi@tinkoff.ru

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