Skip to main content

Привязать счет.

/api/v1/acq/subscriptions/add

POST

https://secured-openapi.tbank.ru/api/v1/acq/subscriptions/add

Привязать счет.

Авторизация

Security

RPS

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

Scopes

acq/read-write

Запрос

Header parameters

X-Request-Id

String<uuid>

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

Request body schema application/json

Required

terminalKey

String

Requirements: non-empty and <= 64 characters

Идентификатор терминала. Выдается мерчанту в Т‑Бизнес при заведении терминала.

dataType

String

Requirements: [QR, LINK]

Тип возвращаемых данных:

  • LINK — в ответе возвращается только link на привязку. Значение по умолчанию.
  • QR — в ответе возвращается SVG-изображение QR.

bankId

String<uuid>

Внутренний идентификатор банка в системе Тбизнес.

Required

description

String

Requirements: non-empty and <= 250 characters

Подробное описание.

redirectDueDate

String<date-time>

Cрок жизни ссылки или динамического QR-кода СБП, если выбран этот способ оплаты. Если параметр RedirectDueDate не был передан, проверяется настроечный параметр платежного терминала REDIRECT_TIMEOUT, который может содержать значение срока жизни ссылки в часах. Если его значение больше нуля, оно будет установлено в качестве срока жизни ссылки или динамического QR-кода, если нет — устанавливается значение по умолчанию: 1440 мин (1 сутки).

Если текущая дата превышает дату, переданную в этом параметре, ссылка для оплаты или возможность платежа по QR-коду становятся недоступными и платёж выполнить нельзя.

Максимальное значение — 90 дней от текущей даты. Минимальное значение — 1 минута от текущей даты. Формат даты — YYYY-MM-DDTHH24:MI+GMT.

Ответ

200

Successful operation

400

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

401

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

403

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

422

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

429

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

500

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

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

Loading...

openapi@tbank.ru

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