Skip to main content

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

/v2/AttachCard

POST

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

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

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

Для прохождения 3DS v.2 перед вызовом метода нужно вызвать поочередно методы Проверить версию 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 второй версии в DATA нужно передавать параметры, которые описаны в объекте 3DSv2. В HttpHeaders запроса обязательны заголовки User-Agent и Accept.

oneOf

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

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

Required

screen_height

String

deviceChannel 02 — BRW

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

Required

screen_width

String

deviceChannel 02 — BRW

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

Required

cresCallbackUrl

String

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...

openapi@tbank.ru

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