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

POST

https://acq.t-tech.team/openapi/api/v1/acq/terminals/subscriptions/add

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

Авторизация

Security

Bearer API Token

MTLS-сертификат

Запрос

Request body schema application/json

Required

terminalKey

String

Requirements: <= 64 characters

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

bankId

String<uuid>

Внутренний идентификатор банка.

Required

description

String

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

redirectDueDate

String<date-time>

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

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

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

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

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

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

fingerprint

Array of objects ()

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

deviceChannel

String

Requirements: [APP, BRW]

Канал устройства.

Поддерживаются следующие каналы:

APP (Application);
BRW (Browser).

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

String

IP-адрес клиента в формате IPv4 и IPv6. DS платежной системы требует передавать IPv6 в полном формате — 8 групп по 4 символа.

language

String

Язык браузера в формате IETF BCP47. Рекомендуем получать значение в браузере из глобального объекта navigator — navigator.language. Параметр обязательный, если в методе Подтвердить платеж передается "deviceChannel":"BRW".

timezone

String

Часовой пояс пользователя в минутах. Рекомендуем получать значение в браузере через вызов метода getTimezoneOffset(). Параметр обязательный, если в методе Подтвердить платеж передается "deviceChannel":"BRW".

screenHeight

String

Высота экрана в пикселях. Рекомендуем получать значение в браузере из глобального объекта screen — screen.height. Параметр обязательный, если в методе Подтвердить платеж передается "deviceChannel":"BRW".

screenWidth

String

Ширина экрана в пикселях. Рекомендуем получать значение в браузере из глобального объекта screen — screen.width. Параметр обязательный, если в методе Подтвердить платеж передается "deviceChannel":"BRW".

colorDepth

String

Requirements: [1, 4, 8, 15, 16, 24, 32, 48]

Default: 48

Глубина цвета в битах. Рекомендуем получать значение в браузере из глобального объекта screen — screen.colorDepth. Параметр обязательный, если в методе Подтвердить платеж передается "deviceChannel":"BRW".

Допустимые значения:

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

isJavaEnabled

Boolean

Requirements: [true, false]

Поддержка Java браузером пользователя. Параметр обязательный, если в методе Подтвердить платеж передается "deviceChannel":"BRW".

deviceId

String

Requirements: <= 1024 characters

Идентификатор устройства клиента.

referrer_url

String

Requirements: <= 1024 characters

URL-адрес, с которого был переход на платежную форму.

String

Requirements: <= 1024 characters, [iOS, Android, macOS, Windows, Linux]

Операционная система устройства клиента, на котором открыта платежная форма.

userAgent

String

Requirements: <= 1024 characters

UserAgent браузера, в котором будет открыта платежная форма.

cookieId

String

Requirements: <= 1024 characters

Идентификатор сессии/cookie клиента.

webView

Boolean

Requirements: [true, false]

Признак использования WebView — встроенного в приложение браузера.

browser

String

Requirements: <= 255 characters, [Chrome, Firefox, JivoMobile, Microsoft Edge, Miui, Opera, Safari, Samsung, WebKit, WeChat, Yandex]

Браузер клиента.

Ответ

200

400

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

401

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

422

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

429

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

500

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

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

Обратиться в поддержку