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

/openapi/api/v1/acq/customers/add

POST

https://acq.t-tech.team/openapi/api/v1/acq/customers/add

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

В поле scope у токена должен быть доступ вида acq/payment.

Авторизация

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: <= 255 characters

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

phone

String

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

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

email

String<email>

Requirements: <= 100 characters

Email клиента.

ip

String

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

Ответ

200

OK

400

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

401

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

403

Доступ запрещен — недостаточно прав, нет нужного scope

422

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

429

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

500

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

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

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

Loading...