Авторизация
Для начала работы с LIFE POS Checkout нужно выполнить авторизацию. В личном кабинете LIFE POS это называется активация рабочего места. Сделать это через Checkout можно двумя способами: вручную или по запросу из вашего приложения.
Чтобы активировать рабочее место вручную, запустите Checkout и укажите код активации полученный в СМС. Отправку кода активации выполняет администратор или владелец компании через ЛК LIFE POS.
Для активации рабочего места из вашего приложения, выполните запрос через intent
. Для этого используйте операцию Активация рабочего места. Для получения кодов активации используйте API LIFE POS, метод GenerateActivationCodeOfWorkplace
Чтобы проверить необходимость активации рабочего месте, используйте операцию Получение статуса активации рабочего места.
Доступные операции:
Название операции | Действие (action ) |
---|---|
Активация рабочего места | ru.lifepay.checkout.auth.activate_workplace |
Получение статуса активации рабочего места | ru.lifepay.checkout.auth.get_workplace_activation_status |
Активация рабочего места
Операция позволяет активировать рабочее место при помощи переданного кода активации. Если текущее рабочее место уже активировано, то данные о предыдущей активации удаляются и выполняется новая активация.
При успешном запросе Checkout возвращает resultCode = Activity.RESULT_OK (-1)
и экземпляр класса Intent
с действием action
, которое было указано во входящем интенте.
П ри ошибке Checkout вернёт resultCode
со значением отличным от Activity.RESULT_OK
или intent
будет содержать null
.
Для определения факта успешной или неуспешной активации проверяйте значение параметра code
:
- значение
0
— рабочее место было успешно активировано; - значение отличное от
0
— произошла ошибка.
Описание метода
Операция: Активация рабочего места
Действие: ru.lifepay.checkout.auth.activate_workplace
Параметры запроса:
Название | Тип | Обязательность | Значение/описание |
---|---|---|---|
activation_code | String | да | Код активации. Длина от 1 до 8 символов включительно. Только цифры. |
Параметры результата при успешной активации:
Название | Тип | Обязательность | Значение/описание |
---|---|---|---|
code | Int | да | 0 - успешная активация рабочего места. |
Значения полей можно извлекать из экземпляра класса Bundle
, получаемого из свойства extras
класса Intent
при помощи методов extras.getInt(...)
и extras.getString(...)
.
Параметры результата в случае ошибки:
Название | Тип | Обязательность | Значение/описание |
---|---|---|---|
code | Int | да | Отличное от нуля значение. Означает, что произошла ошибка. |
message | String | да | Текст ошибки для вывода пользователю. |
Получение статуса активации рабочего места
Операция позволяет узнать привязано ли данное устройство к рабочему месту. Запрос предназначен для использования в вашем приложении, чтобы определить необходимость активации рабочего места.
При успешном запросе Checkout возвращает resultCode = Activity.RESULT_OK (-1)
и экземпляр класса Intent
с действием action
, которое было указано во входяще м интенте.
При ошибке Checkout вернёт resultCode
со значением отличным от Activity.RESULT_OK
или intent
будет содержать null
.
Для определения факта успешного получения статуса активации рабочего места следует ориентироваться на значение параметра code
, значение 0
означает, что статус получен, значение отличное от 0
соответствует ошибке.
Для определения факта успешного получения статуса проверяйте значение параметра code
:
- значение
0
— статус получен успешно. Для определения текущего статуса рабочего места проверяйте значение параметраstatus
; - значение отличное от
0
— произошла ошибка.
Описание метода
Операция: Получение статуса активации рабочего места
Действие: ru.lifepay.checkout.auth.get_workplace_activation_status
Параметры запроса: отсутствуют
Параметры ответа при успешной активации:
Название | Тип | Обязательност ь | Значение/описание |
---|---|---|---|
code | Int | да | 0 - успешное получен статус активации рабочего места. |
status | String | да | Возможные значения: authorized - рабочее место активировано, unauthorized - рабочее место не активировано |
workplace_guid | String | да, если рабочее место активировано | Идентификатор рабочего места |
Значения полей можно извлекать из экземпляра класса Bundle
получаемого из свойства extras
класса Intent
при помощи методов extras.getInt(...)
и extras.getString(...)
.
Параметры ответа в случае ошибки:
Название | Тип | Обязательность | Значение/описание |
---|---|---|---|
code | Int | да | Отличное от нуля значение. Означает, что произошла ошибка. |
message | String | да | Текст ошибки для вывода пользователю. |