Подтвердить платеж

/api/v1/acq/payments/authorize

POST

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

Метод подтверждает платеж:

• при одностадийной оплате — списывает деньги за покупку сразу после завершения оплаты;
• при двухстадийной — блокирует деньги за покупку на карте покупателя и только потом списывает их.

Авторизация

Security

Bearer API Token

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

Запрос

Request body schema application/json

Required

terminalKey

String

Requirements: <= 64 characters

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

additionalProperties

Object

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

• ключ — 20 знаков;
• значение — 100 знаков.

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

property_name*

(additional property)

Required

payment

Object

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

Required

paymentId

String

Requirements: <= 36 characters

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

rebillId

String

Requirements: <= 36 characters

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

fingerprint

Object

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

deviceChannel

String

Requirements: [MOBILE_BRW, DESKTOP_BRW]

Канал устройства.

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

• MOBILE_BRW — Mobile Browser;
• DESKTOP_BRW — Desktop Browser.

Параметр обязательный для 3DS второй версии.

ip

String

Requirements: <= 39 characters

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

Параметр обязательный для 3DS второй версии.

os

String

Requirements: <= 1024 characters, [iOS, Android, macOS, Windows, Linux]

Операционная система устройства клиента, на котором открыта платежная форма.

isWebView

Boolean

Requirements: [true, false]

Признак использования WebView — встроенного в приложение браузера.

browser

String

Requirements: <= 255 characters, [Chrome, Firefox, JivoMobile, Microsoft Edge, Miui, Opera, Safari, Samsung, WebKit, WeChat, Yandex]

Браузер клиента.

Required

paymentMethod

Object

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

Required

name

String

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

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

• SBP — оплата через СБП;
• TPAY — оплата через T‑Pay;
• SBERPAY — оплата через SberPay;
• CARD — оплата картой;
• BNPL — оплата «Долями».

Параметр обязательный для проведения дочернего рекуррентного платежа.

Ответ

200

OK

400

Некорректный запрос — неверные параметры, невалидный JSON и так далее

401

Неавторизованный запрос — нет токена или токен неверный

403

Неавторизованный запрос — нет токена или токен неверный

422

Ошибка валидации данных запроса

429

Превышен лимит запросов

500

Внутренняя ошибка сервера

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

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

Loading...