Привязать карту

/v2/AttachCard

POST

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

Для мерчантов c собственной платежной формой

Метод завершает привязку карты к клиенту.

Для прохождения 3DS v2 перед вызовом метода нужно вызвать поочередно методы Проверить версию 3DS и Пройти этап 3DS Method.

Авторизация

Security

Bearer API Token

Запрос

Request body schema application/json

Required

TerminalKey

String

Requirements: <= 20 characters

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

Required

RequestKey

String<uuid>

Идентификатор запроса на привязку карты.

Required

CardData

String

Зашифрованные данные карты в формате:

PAN=4300000000000777;ExpDate=0519;CardHolder=IVAN PETROV;CVV=111

DATA

Object

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

Максимальная длина ключа — 20 знаков, значения — 100 знаков.

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

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

Для 3DS v2 в DATA нужно передавать параметры, которые описаны в объекте 3DSv2. В HttpHeaders запроса обязательны заголовки User-Agent и Accept.

oneOf

3DSv2

Required

threeDSCompInd

String

deviceChannel 02 — BRW

Идентификатор выполнения метода Пройти этап 3DS Method:

• Y — выполнение метода успешно завершено;
• N — выполнение метода завершено неуспешно или метод не выполнялся;
• U — в ответе метода Проверить версию 3DS не вернулось значение threeDSMethodURL.

Required

language

String

deviceChannel 02 — BRW

Язык браузера в формате IETF BCP47. Рекомендуем получать значение в браузере из глобального объекта navigator — navigator.language.

Required

timezone

String

deviceChannel 02 — BRW

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

Required

screen_height

String

deviceChannel 02 — BRW

Высота экрана в пикселях. Рекомендуем получать значение в браузере из глобального объекта screen — screen.height.

Required

screen_width

String

deviceChannel 02 — BRW

Ширина экрана в пикселях. Рекомендуем получать значение в браузере из глобального объекта screen — screen.width.

Required

cresCallbackUrl

String

Requirements: <= 256 characters

deviceChannel 02 — BRW

URL, который будет использоваться для получения результата (CRES) после завершения Challenge Flow — аутентификации с дополнительным переходом на страницу ACS.

colorDepth

String

Default: 48

deviceChannel 02 — BRW

Глубина цвета в битах.

Допустимые значения — 1/4/8/15/16/24/32/48.

Рекомендуем получать значение в браузере из глобального объекта screen — screen.colorDepth.

javaEnabled

String

deviceChannel 02 — BRW

Поддержка Java браузером пользователя:

• true,
• false.

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

Required

Token

String

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

Ответ

200

OK

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

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

Loading...