Добавить кастомера.

POST

https://secured-openapi.tbank.ru/api/v1/acq/customers/add

Добавить кастомера.

Авторизация

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

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

Required

customer

Object

Информация о клиенте

Required

customerKey

String

Requirements: non-empty and <= 255 characters

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

phone

String

Requirements: >= 7 characters and <= 20 characters, Value must match regular expression ^\+?[0-9]*$

Номер телефона клиента в международном формате. Требования по заполнению: минимум — 7 символов, максимум — 20 символов, разрешены только цифры, исключение — первый символ может быть +.

String<email>

Requirements: <= 100 characters

Email клиента.

String

Requirements: <= 30 characters

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

Ответ

200

Successful operation

400

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

401

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

403

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

422

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

429

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

500

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

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

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