Регистрация клиента

Проверка данных клиента

Перед созданием новой клиентской записи необходимо проверить, не существует ли уже клиент с передаваемыми идентификаторами.

Для проверки используется метод получения информации о клиенте.
В запрос передаются клиентские идентификаторы (телефон, email, origin_user_id).

Важно

Идентификаторы необходимо проверять поочерёдно,
по одному идентификатору в запросе.

Если клиент при регистрации указал одновременно телефон и email, приложение должно выполнить два отдельных запроса:

• первый — с номером телефона;
• второй — с email.

При передаче нескольких идентификаторов в одном запросе сервер вернёт ошибку:

{
  "status": "error",
  "status_code": -1,
  "message": "Provide origin_user_id or user_phone not both"
}

Если запись с переданным идентификатором не найдена, сервер вернёт:

{
  "status": "error",
  "status_code": -4000,
  "message": "User not found"
}

---

Найден существующий клиент

В случае успеха метод вернёт объект с данными клиента:

{
  "status": "ok",
  "last_name": "Иванов",
  "first_name": "Иван",
  "middle_name": "Иванович",
  "sex": 1,
  "phone": "734853058432",
  "email": "ivanovii@gmail.com",
  "birth_date": "1981-12-31",
  "id": 123456,
  "origin_user_id": "53480256",
  "referral_promocode": "Q3957YE",
  "avatar": null
}

В этом случае рекомендуется:

• отобразить пользователю сообщение о том, что клиент уже зарегистрирован;
• либо обновить данные найденного клиента с помощью метода обновления клиента.

---

Объединение клиентских записей

При проверке нескольких идентификаторов одного клиента возможна ситуация,
когда для разных идентификаторов будут найдены разные клиентские записи
(например, одна запись по телефону, другая — по email).

Для таких случаев предусмотрен механизм объединения клиентских записей.

При объединении:

• бонусные баллы;
• теги;
• история покупок;
• другие связанные данные

будут объединены в одну клиентскую карточку.

---

Подтверждение регистрации по SMS

При регистрации клиента по номеру телефона и обнаружении записи с таким же номером, доступен механизм подтверждения регистрации по SMS.

Используется метод отправки SMS с 4-значным кодом подтверждения.

В интерфейсе приложения необходимо предусмотреть:

• поле для ввода кода подтверждения:
  • сотрудником (офлайн-сценарии, касса);
  • или самим клиентом (сайт / мобильное приложение).

После ввода кода необходимо сопоставить его с кодом, полученным в ответе API.

---

Добавление нового клиента

Если проверка данных клиента прошла успешно и существующие записи не были обнаружены приложение должно создать новую клиентскую запись.

Регистрация нового клиента выполняется путём отправки запроса к методу создания клиента.

Запрос должен содержать:

• авторизационные данные приложения;
• как минимум один идентификатор клиента:
  • user_phone;
  • email;
  • origin_user_id.