# Настройка Устройства

Для того чтобы начать использовать приложение вам необходимо зарегистрировать устройство в системе и активировать для него имеющийся платежный терминал одним из доступных способов:

| Способ                                     | Отличие                                                                                                                                                                                                                                                                          |
| ------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| с помощью логина и пароля Главного кассира | Коды подтверждения отправляются в виде SMS-сообщения или на email Торговца. Вам необходим доступ к SMS и/или email, которые использовались поставщиком услуг эквайринга при регистрации.                                                                                         |
| с помощью кода устройства                  | Код устройства вводится в кабинете Торговца. Вам необходим доступ к кабинету Торговца для ввода кода устройства.                                                                                                                                                                 |
| с помощью QR кода                          | QR код сканируется в мобильном приложении. Вам необходим доступ к кабинету Торговца для генерации QR кода.                                                                                                                                                                       |
| с помощью активационной ссылки             | <p>Ссылка активации терминала используется на мобильном устройстве. Вам необходим доступ к кабинету Торговца для генерации активационной ссылки. <br>Ссылка активации терминала также может быть отправлена вашим поставщиком услуг эквайринга ввиде SMS или email сообщения</p> |

### Настройка устройства с помощью логина и пароля Главного кассира

{% hint style="info" %}
Настройку устройства должен проводить Главный кассир. Если вы не являетесь Главным кассиром, то сообщите ему о необходимости пройти этот процесс на вашем устройстве.
{% endhint %}

* Введите `Логин` и `Пароль` Главного кассира.

{% hint style="warning" %}

1. При вводе пароля обращайте внимание, что он чувствителен к верхнему и нижнему регистру.
2. Если это первый вход Главного кассира в Приложение, то Пароль по умолчанию равен Логину (с учетом регистра).
3. Пароль, который вы получили в SMS-сообщении или в email при регистрации вас, как Торговца, Поставщиком услуг эквайринга не используется в Приложении. Это пароль от вашего личного кабинета на [портале Торговца](https://docs.tapxphone.com/master/portal-guide/web-sign-in).
   {% endhint %}

* При успешном вводе реквизитов Приложение запросит ввести `код инициализации` (4 цифры). Введите его в соответствующее поле и продолжите вход.&#x20;

<figure><img src="https://114795355-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MZUSwpZpDHn6o15IQfX-887967055%2Fuploads%2F9BotGg7006QeHnvRHDTy%2Finitialization.png?alt=media&#x26;token=2d5b22eb-7bee-4847-9cec-f31b05dd2824" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Код инициализации отправляется на email или в виде SMS-сообщения на номер телефона Торговца (данная информация, как правило, указывается при заключении договора эквайринга). В зависимости от того, что определил ваш Поставщик услуг эквайринга.
{% endhint %}

#### Активация платежного терминала

Активация платежного терминала может запрашиваться в следующих случаях:

* вы впервые настраиваете устройство,
* устройство было отвязано от платежного терминала

В случае возникновения  необходимости активации платежного терминала система запросит ввести `код активации` (6 цифр). Введите его в соответствующее поле и продолжите вход.&#x20;

{% hint style="warning" %}
Активацию платежного терминала должен проводить Главный кассир. Если вы не являетесь Главным кассиром, то сообщите ему о необходимости пройти этот процесс на вашем устройстве.
{% endhint %}

<figure><img src="https://114795355-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MZUSwpZpDHn6o15IQfX-887967055%2Fuploads%2FLBlCf61adsLS2ONU2CHD%2Factivation.png?alt=media&#x26;token=b13c40e8-a204-4845-a0ff-ea183b50a6fa" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Код активации отправляется на email или в виде SMS-сообщения на номер телефона Торговца (который, как правило, указывается при заключении договора эквайринга). В зависимости от того, что определил ваш Поставщик услуг эквайринга.
{% endhint %}

{% hint style="info" %}
Вы можете столкнуться с получением сообщения, что нет свободных терминалов для привязки текущего мобильного устройства. Это сообщение может возникать в случае, когда все платежные терминалы, которые были сгенерированы вашим Поставщиком услуг эквайринга, уже привязаны к другим вашим мобильным устройствам. В данной ситуации вы можете:

* обратиться к Поставщику услуг эквайринга с просьбой увеличить количество платежных терминалов
* или отвязать имеющийся платежный терминал, от другого мобильного устройства.
  {% endhint %}

{% hint style="warning" %}
Список доступных к привязке платежных терминалов находится в [веб портале Торговца](https://docs.tapxphone.com/master/portal-guide/device-management#platezhnye-terminaly).

Если нужно активировать платежный терминал с определенным идентификатором, то вам необходимо воспользоваться настройкой устройства с помощью [Кода устройства](#nastroika-ustroistva-s-pomoshyu-koda-ustroistva)
{% endhint %}

При успешном завершении инициализации устройства и (или) активации платежного терминала Приложение отобразит Экран ввода суммы.&#x20;

<figure><img src="https://114795355-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MZUSwpZpDHn6o15IQfX-887967055%2Fuploads%2FVqcxNRpfuTWp0EYQvfa6%2FEnterAmount.png?alt=media&#x26;token=3dee6e02-8f22-49b4-939b-25b69cd77924" alt=""><figcaption></figcaption></figure>

{% hint style="success" %}
Это означает, что устройство готово к работе в качестве платежного терминала.\
Главный кассир может осуществить выход и передать устройство для дальнейшего использования другим Пользователем/кассиром.
{% endhint %}

### Настройка устройства с помощью Кода устройства

* На экране входа в систему нажмите кнопку `Использовать код устройства`.
* Устройство сгенерирует временный `Код устройства` состоящий из 8-ми цифр.

<figure><img src="https://114795355-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MZUSwpZpDHn6o15IQfX-887967055%2Fuploads%2FMkrhjjQBLvLKNN6ubBLE%2FDevice%20code.png?alt=media&#x26;token=b9649ebe-427c-4a13-aeaf-49509cc5000a" alt=""><figcaption></figcaption></figure>

* Перейдите в [портал Торговца](https://docs.tapxphone.com/master/portal-guide/web-sign-in) или сообщите этот код человеку, который имеет доступ к порталу Торговца.
* На портале Торговца вам необходимо активировать платежный терминал с использованием кода устройства. Для этого:
  * перейдите в раздел в раздел `Платежные терминалы`,![](https://114795355-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MZUSwpZpDHn6o15IQfX-887967055%2Fuploads%2FnGTyKcOC55yLDlAzjiAR%2Fterminal_list.PNG?alt=media\&token=5dc79df0-ae7a-4b8c-8a12-d8154919565d)
  * найдите доступный для привязки терминал и нажмите кнопку `Привязать`,![](https://114795355-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MZUSwpZpDHn6o15IQfX-887967055%2Fuploads%2FUoqypa0sqg0DY347YLuP%2Fterminal_list_bind.PNG?alt=media\&token=9c976217-47a4-45a1-8905-22975e17151c)
  * введите `Код устройства`.
* Если `Код устройства` успешно введен на портале Торговца, то на мобильном устройстве нажмите кнопку `Обновить статус устройства` для того чтобы завершить настройку.

{% hint style="success" %}
При успешном завершении настройки устройства приложение отобразит экран ввода логина и пароля кассира для [входа в приложение.](https://docs.tapxphone.com/master/app-guide/sign-in)
{% endhint %}

{% hint style="info" %}
Код действителен в течении времени, которое указано на экране в момент его формирования. В данный период Код необходимо ввести в портале Торговца и нажать кнопку `Обновить статус` на мобильном устройстве. Если оба либо один из шагов были выполнены после указанного срока, процедуру настройки устройства необходимо начать заново.
{% endhint %}

#### Повторная настройка устройства

Существуют ситуации, когда есть необходимость перенастроить устройство (например удалили, скачали заново приложение, очистили его память и т.д.) В данном случае Вы можете воспользоваться в портале Торговца разделом `Активация устройства`, предварительно сформировав код на устройстве.

Также, данным разделом Вы можете воспользоваться, если для вас не имеет значения, к какому терминалу привяжется устройство. Если Вы введете код в этом разделе, система привяжет устройство к свободному терминалу.

### Настройка устройства с помощью QR кода

* Войдите в [портал Торговца](https://docs.tapxphone.com/master/portal-guide/web-sign-in) и выберите доступный платежный терминал. Нажмите кнопку `Привязать`. Будет сгенерирован QR-код, который вы сможете использовать в мобильном приложении.
* Откройте мобильное приложение и нажмите кнопку `Сканировать QR-код`.
* Предоставьте приложению необходимые разрешения на использование камеры устройства.
* Направьте свое устройство на экран портала продавца, чтобы захватить код.
* Подождите, пока приложение настроится автоматически.
* Вы можете войти в приложение после успешной настройки.

#### Повторная настройка устройства

Существуют ситуации, когда есть необходимость перенастроить устройство (например удалили, скачали заново приложение, очистили его память и т.д.). В данном случае на [портале Торговца](https://docs.tapxphone.com/master/portal-guide/web-sign-in) необходимо открыть выбранный профиль платежного терминала и нажмите кнопку `Перепривязать устройство`. Используйте сгенерированный новый QR-код активации на устройстве, которое необходимо перенастроить.

### Настройка устройства с помощью Активационной ссылки

* Войдите в [портал Торговца](https://docs.tapxphone.com/master/portal-guide/web-sign-in) и выберите доступный платежный терминал. Нажмите кнопку `Привязать`. Будет сгенерирована ссылка активации Терминала, которую вы сможете использовать в мобильном приложении.

{% hint style="info" %}
Ссылка для активации может быть создана вашим поставщиком услуг эквайринга. В этой ситуации вы получите от него ссылку активации по SMS или электронной почте.
{% endhint %}

* Скопируйте ссылку активации.
* Откройте ссылку на своем мобильном устройстве. Обратите внимание, что ссылка имеет срок действия.

{% hint style="info" %}
Активационную ссылку следует открываться в мессенджерах, в приложении электронной почты и т. д.&#x20;

Не следует открывать ее в браузере, так как процесс активации не начнется.
{% endhint %}

* Операционная система устройства предложит открыть ссылку с помощью Приложения. Выберите его.
* Подождите, пока приложение настроится автоматически.
* Вы можете войти в приложение после успешной настройки.

#### Повторная настройка устройства

Существуют ситуации, когда есть необходимость перенастроить устройство (например удалили, скачали заново приложение, очистили его память и т.д.). В такой ситуации на Торговом портале необходимо открыть выбранный профиль платежного терминала и нажмите кнопку `Перепривязать устройство`. Используйте сгенерированную новую ссылку активации терминала на устройстве, которое необходимо перенастроить.
