Инициировать платеж

/api/v1/acq/payments/initiate

POST

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

Метод инициирует платеж.

Авторизация

Security

Bearer API Token

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

Запрос

Header parameters

X-Request-Id

String<uuid>

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

Request body schema application/json

Required

terminalKey

String

Requirements: <= 64 characters

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

Required

payment

Object

Параметры оплаты.

Required

orderId

String

Requirements: <= 50 characters

Идентификатор заказа в системе мерчанта. Должен быть уникальным для каждой операции.

Required

amount

Number

Requirements: <= 10 characters

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

description

String

Requirements: non-empty and <= 250 characters

Описание заказа. Параметр обязательный при привязке и одновременной оплате через СБП. Текст из этого параметра отобразится в мобильном банке клиента.

isRecurrent

Boolean

Признак рекуррентного платежа.

notificationUrl

String<uri>

URL на веб-сайте мерчанта, куда будет отправлен POST-запрос о статусе выполнения вызываемых методов.

fingerprint

Object

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

ip

String

Requirements: <= 39 characters

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

paymentMethod

Object

Список параметров.

name

String

Requirements: [SBP]

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

additionalProperties

Object

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

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

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

property_name*

String (additional property)

Ответ

200

OK

400

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

401

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

403

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

422

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

429

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

500

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

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

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

Loading...