Skip to main content

Привязать счет к магазину

/v2/AddAccountQr

POST

https://securepay.tinkoff.ru/v2/AddAccountQr

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

Авторизация

Security

Bearer API Token

Запрос

Request body schema application/json

Required

TerminalKey

String

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

Required

Description

String

Подробное описание деталей заказа.

DataType

String

Requirements: [PAYLOAD, IMAGE]

Default: PAYLOAD

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

  • PAYLOAD — в ответе возвращается только Payload;
  • IMAGE — в ответе возвращается SVG-изображение QR.

Значение по умолчанию — PAYLOAD.

Data

Object

JSON-объект, который содержит дополнительные параметры в виде ключ:значение. Эти параметры будут переданы на страницу оплаты, если она кастомизирована.

Максимальная длина для каждого передаваемого параметра:

  • ключ — 20 знаков;
  • значение — 100 знаков.

Максимальное количество пар ключ:значение — не больше 20.

Если ключи или значения содержат в себе специальные символы, получившееся значение должно быть закодировано функцией urlencode.

property name*

String

RedirectDueDate

String<datatime>

Cрок жизни ссылки или динамического QR-кода СБП.

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

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

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

Если его значение:

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

Required

Token

String

Подпись запроса. Формируется по инструкции.

Ответ

200

OK

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

Loading...

openapi@tbank.ru

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