Зарегистрировать покупателя

/api/v1/acq/customers/add

POST

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

Метод регистрирует покупателя в связке с терминалом.

Авторизация

Security

Bearer API Token

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

Запрос

Header parameters

Required

Idempotency-Key

String

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

Request body schema application/json

Required

terminalKey

String

Requirements: <= 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 символов. В значении параметра разрешены только цифры, исключение — первый символ может быть +.

email

String<email>

Requirements: non-empty and <= 100 characters

Email клиента.

ip

String

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

Ответ

200

OK

400

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

401

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

403

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

422

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

429

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

500

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

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

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

Loading...