Подтвердить платеж (двухстадийная оплата).

POST

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

Авторизация

Security

Bearer API Token

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

RPS

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

Scopes

acq/read-write

Запрос

Header parameters

Required

Idempotency-Key

String

Requirements: non-empty and <= 36 characters, Value must match regular expression ^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$

Ключ идемпотентности, формат UUID. Время жизни ключа — 24 часа.

X-Request-Id

String<uuid>

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

Request body schema application/json

Required

terminalKey

String

Requirements: non-empty and <= 64 characters

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

String

Requirements: <= 30 characters

IP-адрес клиента.

Required

payment

Object

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

Required

paymentId

String

Requirements: non-empty and <= 36 characters

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

amount

Number

Requirements: <= 10 characters

Сумма операции в копейках. Например, 3 руб. 12 коп. — это число 312. Если не передан, используется amount, переданный в методе /acq/payments/initiate.

Ответ

200

Successful operation

400

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

401

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

403

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

422

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

429

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

500

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

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

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