Привязать счет к магазину
https://securepay.tinkoff.ru/v2/AddAccountQr
Метод инициирует привязку счета покупателя к магазину и возвращает информацию о нем.
Авторизация
Security
Запрос
Request body schema application/json
Required
TerminalKey
String
Идентификатор терминала. Выдается мерчанту в Т‑Бизнес при заведении терминала.
Required
Description
String
Подробное описание деталей заказа.
DataType
String
Requirements: [PAYLOAD, IMAGE]
Default: PAYLOAD
Тип возвращаемых данных:
PAYLOAD— в ответе возвращается только Payload;IMAGE— в ответе возвращается SVG-изображение QR.
Значение по умолчанию — PAYLOAD.
BankId
String<uuid>
Внутренний идентификатор банка, который выбран для оплаты.
Cписок доступных BankId запрашивается методом Получить список банков-участников СБП для платежа.
При передаче BankId, в ответе в параметре Data будет возвращен deeplink вместо функциональной платежной ссылки (payload).
Следует передавать BankId только для DataType = 'PAYLOAD' или null.
Data
Object
JSON-объект, который содержит дополнительные параметры в виде ключ:значение. Эти параметры будут
переданы на страницу оплаты, если она кастомизирована.
Максимальная длина для каждого передаваемого параметра:
- ключ — 20 знаков;
- значение — 100 знаков.
Максимальное количество пар ключ:значение — не больше 20.
Если ключи или значения содержат в себе специальные символы,
получившееся значение должно быть закодировано функцией urlencode.
Data
Object
JSON-объект, который содержит дополнительные параметры в виде ключ:значение. Эти параметры будут
переданы на страницу оплаты, если она кастомизирована.
Максимальная длина для каждого передаваемого параметра:
- ключ — 20 знаков;
- значение — 100 знаков.
Максимальное количество пар ключ:значение — не больше 20.
Если ключи или значения содержат в себе специальные символы,
получившееся значение должно быть закодировано функцией urlencode.
RedirectDueDate
String<datatime>
Cрок жизни ссылки или динамического QR-кода СБП, если выбран этот способ оплаты.
Если дата в параметре меньше текущей, оплата по ссылке и QR будет недоступна.
- Минимальное значение — 1 минута от текущей даты.
- Максимальное значение — 90 дней от текущей даты.
- Формат даты —
YYYY-MM-DDTHH24:MI:SS+GMT.
Пример даты: 2016-08-31T12:28:00+03:00.
Если параметр не был передан, проверяется настроечный параметр терминала REDIRECT_TIMEOUT, который содержит значение срока жизни ссылки в часах.
Если его значение:
- больше нуля — оно будет установлено в качестве срока жизни ссылки или динамического QR-кода;
- меньше нуля — устанавливается значение по умолчанию: 1440 мин. (1 сутки).
Required
Token
String
Подпись запроса. Формируется по инструкции.
Ответ
Это полезный материал?