Авторизация

В данном разделе приводится описание операций для управления авторизацией в LIFE POS Checkout. Для начала работы с LIFE POS Checkout необходимо произвести авторизацию. Под авторизацией понимается активация рабочего места.

Активировать рабочее место можно вручную, запустив приложение LIFE POS Checkout иконкой на рабочем столе и введя код активации полученный в СМС отправленной из ЛК LIFE POS.

Также возможна активация рабочего места из родительского приложения через запрос по интентам. Для этого следует использовать операцию Активация рабочего места. Коды активации при этом можно получать при помощи API LIFE POS используя запрос Сгенерировать код активации для рабочего места.

Для проверки необходимости активации рабочего места следует использовать операцию Получение статуса активации рабочего места.

Таблица операций:

Название операции	Действие (action)
Активация рабочего места	ru.lifepay.checkout.auth.activate_workplace
Получение статуса активации рабочего места	ru.lifepay.checkout.auth.get_workplace_activation_status

Активация рабочего места

Операция: Активация рабочего места

Действие: ru.lifepay.checkout.auth.activate_workplace

Параметры запроса:

Название	Тип	Обязательность	Значение/описание
activation_code	String	да	Код активации. Длина от 1 до 8 символов включительно. Только цифры.

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

В случае успешной обработки запроса приложение LIFE POS Checkout возвращает resultCode = Activity.RESULT_OK (-1) и экземпляр класса Intent с действием action которое было указано во входящем интенте. Если resultCode отличается от Activity.RESULT_OK или intent == null, то следует рассматривать данную ситуацию как ошибку.

Для определения факта успешной/не успешной активации рабочего места следует ориентироваться на значение параметра code, значение 0 означает, что рабочее место было успешно активировано, значение отличное от 0 соответствует ошибке.

Параметры результата запроса в случае успешной активации рабочего места:

Название	Тип	Обязательность	Значение/описание
code	Int	да	0 - успешная активация рабочего места.

Значения полей можно извлекать из экземпляра класса Bundle получаемого из свойства extras (метод getExtras() в случае java) класса Intent при помощи методов extras.getInt(...) и extras.getString(...).

Параметры результата запроса в случае ошибки:

Название	Тип	Обязательность	Значение/описание
code	Int	да	Отличное от нуля значение. Означает, что произошла ошибка.
message	String	да	Текст ошибки для вывода пользователю.

Получение статуса активации рабочего места

Операция: Получение статуса активации рабочего места

Действие: ru.lifepay.checkout.auth.get_workplace_activation_status

Параметры запроса: отсутствуют

Операция предоставляет возможность узнать привязано ли данное устройство к рабочему месту. Запрос предполагается использовать в рамках родительского приложения, чтобы понимать нужно ли производить активацию рабочего места, либо она уже была произведена.

В случае успешной обработки запроса приложение LIFE POS Checkout возвращает resultCode = Activity.RESULT_OK (-1) и экземпляр класса Intent с действием action которое было указано во входящем интенте. Если resultCode отличается от Activity.RESULT_OK или intent == null, то следует рассматривать данную ситуацию как ошибку.

Для определения факта успешного получения статуса активации рабочего места следует ориентироваться на значение параметра code, значение 0 означает, что статус получен, значение отличное от 0 соответствует ошибке.

Для определения статуса рабочего места (активировано/не активировано) в случае когда значение параметра code равно 0, следует ориентироваться на значение параметра status.

Параметры результата запроса в случае успешной активации рабочего места:

Название	Тип	Обязательность	Значение/описание
code	Int	да	0 - успешное получен статус активации рабочего места.
status	String	да	Возможные значения: authorized - рабочее место активировано unauthorized - рабочее место не активировано
workplace_guid	String	да, если рабочее место активировано	Идентификатор рабочего места

Значения полей можно извлекать из экземпляра класса Bundle получаемого из свойства extras (метод getExtras() в случае java) класса Intent при помощи методов extras.getInt(...) и extras.getString(...).

Параметры результата запроса в случае ошибки:

Название	Тип	Обязательность	Значение/описание
code	Int	да	Отличное от нуля значение. Означает, что произошла ошибка.
message	String	да	Текст ошибки для вывода пользователю.