Подтвердить платеж передачей реквизитов.

POST

https://secured-openapi.tbank.ru/api/v1/acq/payments/authorize

Авторизация

Security

Bearer API Token

MTLS-сертификат

RPS

Ограничение — 100 запросов в секунду

Scopes

acq/read-write

Запрос

Header parameters

X-Request-Id

String<uuid>

Уникальный идентификатор для трассировки запроса. Не влияет на логику исполнения запроса.

Request body schema application/json

Required

terminalKey

String

Requirements: non-empty and <= 64 characters

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

additionalProperties

Object

JSON-объект, который позволяет передавать дополнительные параметры по операции и задавать определенные настройки в формате ключ:значение. Максимальная длина для каждого передаваемого параметра: ключ — 20 знаков; значение — 100 знаков. Максимальное количество пар ключ:значение — 20.

property name*

Object

Required

payment

Object

Параметры операции.

Required

paymentId

String

Requirements: non-empty and <= 36 characters

Идентификатор операции в системе Т‑Бизнес.

rebillId

String

Requirements: <= 36 characters

Идентификатор рекуррентного платежа. Передается для проведения дочерних рекуррентных операций.

amount

Number

Requirements: <= 10 characters

Сумма операции в копейках. Например, 3 руб. 12 коп. — это число 312.

fingerprint

Object

Уникальный набор данных, собираемых об устройстве плательщика.

deviceChannel

String

Requirements: [APP, MOBILE_BRW, DESKTOP_BRW]

Канал устройства. Поддерживаются следующие каналы:

"APP" (Application)
"MOBILE_BRW" (Mobile Browser)
"DESKTOP_BRW" (Desktop Browser) Обязательный параметр в методе /acq/payments/authorize для 3DS второй версии и в методе /acq/payments/initiate для способов оплаты TPAY, SBERPAY. Для подключения 3DS второй версии канала "APP" обратитесь в поддержку.

String

Requirements: <= 30 characters

IP-адрес клиента. Передача адреса допускается в формате IPv4 и IPv6. DS платежной системы требует передавать данный адрес в полном формате, без каких-либо сокращений — 8 групп по 4 символа.

language

String

Requirements: <= 2 characters

Язык браузера в формате IETF BCP47. Рекомендуем получать значение в браузере из глобального объекта navigator — navigator.language. Обязательный параметр в методе /acq/payments/authorize для deviceChannel: "MOBILE_BRW" И "DESKTOP_BRW".

timezone

String

Requirements: <= 4 characters

Time-zone пользователя в минутах. Рекомендуем получать значение в браузере через вызов метода getTimezoneOffset(). Обязательный параметр в методе /acq/payments/authorize для deviceChannel: "MOBILE_BRW" И "DESKTOP_BRW".

screenHeight

String

Requirements: <= 4 characters

Высота экрана в пикселях. Рекомендуем получать значение в браузере из глобального объекта screen — screen.height. Обязательный параметр в методе /acq/payments/authorize для deviceChannel: "MOBILE_BRW" И "DESKTOP_BRW".

screenWidth

String

Requirements: <= 4 characters

Ширина экрана в пикселях. Рекомендуем получать значение в браузере из глобального объекта screen — screen.width. Обязательный параметр в методе /acq/payments/authorize для deviceChannel: "MOBILE_BRW" И "DESKTOP_BRW".

colorDepth

String

Requirements: <= 2 characters

Default: 48

Глубина цвета в битах. Допустимые значения — 1/4/8/15/16/24/32/48. Рекомендуем получать значение в браузере из глобального объекта screen — screen.colorDepth. Обязательный параметр в методе /acq/payments/authorize для deviceChannel: "MOBILE_BRW" И "DESKTOP_BRW".

isJavaEnabled

Boolean

Поддерживает ли браузер пользователя Java. Обязательный параметр в методе /acq/payments/authorize для deviceChannel: "MOBILE_BRW" И "DESKTOP_BRW". Возможные значения:

true,
false.

String

Requirements: <= 1024 characters

Операционная система устройства клиента, на которой открыта платежная форма. Возможные значения: iOS, Android, macOS, Windows, Linux. Обязательный параметр в методе /acq/payments/initiate для способов оплаты TPAY, SBERPAY.

isWebView

Boolean

Признак использования WebView. WebView — это встроенный в приложение браузер. true — WebView используется, false — WebView не используется. Обязательный параметр в методе /acq/payments/initiate для способов оплаты TPAY,SBERPAY.

browser

String

Requirements: <= 255 characters

Браузер, используемый клиентом. Возможные значения: Chrome, Firefox, JivoMobile, Microsoft Edge, Miui, Opera, Safari, Samsung, WebKit, WeChat, Yandex. Обязательный параметр в методе /acq/payments/initiate для способов оплаты TPAY,SBERPAY.

Required

paymentMethod

Object

Способ оплаты.

Required

name

String

Requirements: [CARD, BNPL, SBP, SBERPAY, TPAY]

Наименование способа оплаты:

CARD - Оплата картой
BNPL - Оплата Долями
SBP - Оплата по СБП
TPAY - Оплата через T-Pay
SBERPAY - Оплата через SberPay Обязательный параметр в методе /acq/payments/authorize для проведения дочернего рекуррентного платежа.

card

Object

Данные карты.

Required

pan

String

Requirements: >= 13 characters and <= 19 characters

PAN карты

Required

expDate

String

Requirements: Value must match regular expression ^((1[0-2])|(0[1-9]))[0-9]{2}$

Срок действия карты в формате MMYY.

cardHolder

String

Requirements: <= 100 characters

Имя и фамилия держателя карты — как на карте.

cvv

String

Requirements: >= 3 characters and <= 4 characters

Код защиты с обратной стороны карты.

eci

String

Requirements: <= 2 characters

Electronic Commerce Indicator. Индикатор, который показывает степень защиты, применяемую при предоставлении клиентом своих данных ТСП.

cavv

String

Requirements: <= 100 characters

Cardholder Authentication Verification Value или Accountholder Authentication Value.

tdsv2

Object

Параметры 3DS второй версии.

cresCallbackUrl

String<uri>

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

tdsCompInd

String

Requirements: [Y, N, U]

Идентификатор выполнения 3DS Method. Обязательный параметр для deviceChannel: "MOBILE_BRW" И "DESKTOP_BRW".

Y — выполнение метода успешно завершено N — выполнение метода завершено неуспешно или метод не выполнялся U — в ответе на вызов метода /acq/payments/cards/tds/version/get не было получено значение tdsMethodURL

Ответ

200

Successful operation

400

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

401

Ошибка аутентификации

403

Ошибка авторизации

422

Ошибка при обработке данных

429

Слишком много запросов

500

Ошибка сервера

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

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