Skip to main content

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

/api/v1/acq/subscriptions/add

POST

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

Метод инициирует привязку счета покупателя к магазину.

Авторизация

Security

Запрос

Request body schema application/json

Required

terminalKey

String

Requirements: <= 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

Requirements: Value must match regular expression ^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}[+]\d{2}:\d{2}$

Cрок жизни ссылки или динамического QR-кода СБП, если выбран этот способ оплаты.

Если дата в параметре меньше текущей, оплата по ссылке и QR будет недоступна.

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

Пример даты — 2016-08-31T12:28:00+03:00.

Если параметр не был передан, проверяется настроечный параметр терминала REDIRECT_TIMEOUT, который содержит значение срока жизни ссылки в часах.
Если его значение:

  • больше нуля — оно будет установлено в качестве срока жизни ссылки или динамического QR-кода;
  • меньше нуля — устанавливается значение по умолчанию: 1440 мин. (1 сутки).

Ответ

200

OK

400

Некорректный запрос — неверные параметры, невалидный JSON и так далее

401

Неавторизованный запрос — нет токена или токен неверный

403

Неавторизованный запрос — нет токена или токен неверный

422

Ошибка валидации данных запроса

429

Превышен лимит запросов

500

Внутренняя ошибка сервера

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

Loading...

openapi@tbank.ru

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