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

POST

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

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

Авторизация

Security

Bearer API Token

Запрос

Request body schema application/json

Required

terminalKey

String

Requirements: <= 64 characters

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

Required

description

String

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

dataType

String

Requirements: [QR, LINK]

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

Возможные значения:

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

redirectDueDate

String

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

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

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

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

data

Array of objects ()

Дополнительные данные, включая информацию о клиенте и устройстве.

deviceId

String

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

language

String

Язык интерфейса клиента (ISO 639-1 код).

referrer_url

String

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

String

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

userAgent

String

User Agent покупателя.

cookieId

String

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

screenSize

String

Разрешение экрана покупателя (например, "1920x1080").

Ответ

200

400

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

401

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

403

Доступ запрещен

404

Ресурс не найден

422

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

429

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

500

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

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

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