Создать платёжное требование
https://secured-openapi.tbank.ru/api/v1/requests
Позволяет завести платёжное требование.
Требование спишется безакцептно, если соглашение о безакцептном списании на момент генерации требования активно и вы указываете:
WithoutAcceptanceв условии платежа — параметрpaymentCondition;- номер соглашения о безакцептном списании в назначении платежа — параметр
purpose; - ID соглашения о безакцептном списании — параметр
agreementId.
В ином случае банк попросит акцепт плательщика для списания платежа.
RPS
Ограничение — 10 запросов в секунду
Scopes
Управление платёжными требованиями → Управление платежными требованиями
Запрос
Header parameters
Required
Idempotency-Key
String
Requirements: non-empty and <= 64 characters
Ключ идемпотентности. Подробнее.
X-Request-Id
String<uuid>
Уникальный идентификатор для трассировки запроса. Не влияет на логику исполнения запроса.
Request body schema application/json
Required
docType
String
Requirements: [PaymentRequest]
Тип платёжного документа.
PaymentRequest — платёжное требование.
Required
amount
Number<decimal>
Сумма платежа.
paymentCondition
String
Requirements: [WithAcceptance, WithoutAcceptance]
Условие платежа:
WithAcceptance — с акцептом;
WithoutAcceptance — без акцепта.
acceptTerm
Integer<int32>
Requirements: >= 5 and <= 9
Количество дней для акцепта.
docDispatchDate
String
Requirements: Value must match regular expression ^(\d{4}-\d{2}-\d{2})$
Дата отсылки (вручения) плательщику предусмотренных договором документов в формате YYYY-MM-DD.
Required
payerAccount
String
Requirements: Value must match regular expression ^(\d{20})$
Номер счёта плательщика.
Required
payerINN
String
Requirements: Value must match regular expression ^(\d{10}|\d{12})$
ИНН плательщика.
Required
payerKPP
String
Requirements: Value must match regular expression ^(\d{9}|0)$
КПП плательщика. Если КПП нет, передавайте 0.
Required
payerName
String
Requirements: non-empty and <= 160 characters
Наименование плательщика.
Required
payerBIC
String
Requirements: Value must match regular expression ^(\d{9})$
БИК плательщика.
Required
payerCorAccount
String
Requirements: Value must match regular expression ^(\d{20})$
Корреспондентский счёт плательщика.
Required
recipientAccount
String
Requirements: Value must match regular expression ^(\d{20})$
Счёт получателя.
documentNumber
Number<decimal>
Requirements: >= 1 and <= 999999
Номер платёжного требования.
Required
purpose
String
Requirements: non-empty and <= 210 characters
Назначение платежа.
agreementId
String<uuid>
ID соглашения о безакцептных списаниях.
Ответ
Это полезный материал?
