Skip to main content

Инициировать привязку карты к клиенту

/v2/AddCard

POST

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

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

Авторизация

Security

Bearer API Token

Запрос

Request body schema application/json

Required

TerminalKey

String

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

Required

CustomerKey

String

Requirements: <= 36 characters

Идентификатор клиента в системе мерчанта.

Required

Token

String

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

CheckType

String

Requirements: [NO, HOLD, 3DS, 3DSHOLD]

Если CheckType не передается, автоматически проставляется значение NO. Возможные значения:

  • NO — сохранить карту без проверок. RebillID для рекуррентных платежей не возвращается.
  • HOLD — при сохранении сделать списание на 0 руб. RebillID возвращается для терминалов без поддержки 3DS.
  • 3DS — при сохранении карты выполнить проверку 3DS и выполнить списание на 0 р. В этом случае RebillID будет только для 3DS карт. Карты, которые не поддерживают 3DS, привязаны не будут.
  • 3DSHOLD – при привязке карты выполнить проверку, поддерживает карта 3DS или нет. Если карта не поддерживает 3DS, выполняется списание на 0 руб.

IP

String

Requirements: <= 40 characters

IP-адрес запроса.

ResidentState

Boolean

Признак резидентности добавляемой карты. Возможные значения:

  • true — карта РФ;
  • false — карта не РФ;
  • null — универсальная карта, не специфицируется.

Ответ

200

OK

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

Loading...

openapi@tbank.ru

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