В разделе «Настройки» отображаются текущие настройки юридического лица и его предприятий. Для просмотра данного раздела необходимо, чтобы пользователь имел соответствующие права на просмотр. Администратор юридического лица может изменять настройки, доступные для редактирования.
Настройки юридического лица
В разделе настройки юридического лица можно посмотреть и при необходимости изменить данные юридического лица. Данный раздел разделен на 4 вкладки «Общие», «Реквизиты», «Настройки mPOS» и «Мобильные устройства».
Общая информация
В подразделе «Общие» отображаются данные юридического лица, представленные в табл. ниже.
Перечень отображаемых данных юридического лица
Название параметра | Комментарий |
ID | Идентификационный номер юридического лица (справочно) |
Название | Полное название юридического лица (редактируемое поле) |
Административный контакт | Административный контакт (ФИО, Должность, Телефон, Мобильный телефон, E-mail) – доступно для редактирования, в поле E-mail возможно указание нескольких адресов через запятую. |
Технический контакт | Технический контакт (ФИО, Должность, Телефон, Мобильный телефон, E-mail) – доступно для редактирования, в поле E-mail возможно указание нескольких адресов через запятую. |
Юридический адрес | Юридический адрес юридического лица (справочно) |
Почтовый адрес | Почтовый адрес юридического лица (справочно) |
Временная зона | Временная зона юридического лица (справочно) |
Все изменения вступают в силу после нажатия кнопки «Сохранить».
Изменять настройки может только администратор юридического лица.
Реквизиты
На вкладке «Реквизиты» отображаются реквизиты юридического лица. Для редактирования доступно только поле «E - mail бухгалтера».
Перечень отображаемых реквизитов юридического лица
Название параметра | Комментарий |
Банк | Название банка |
БИК | Банковский идентификационный код |
ОКВЭД | ОКВЭД юридического лица |
ОКПО | ОКПО юридического лица |
Расчетный счет | Номер расчетного счета юридического лица |
Корреспондентский счет | Номер корреспондентского счета юридического лица |
ИНН | ИНН юридического лица |
E-mail бухгалтера | E-mail бухгалтера |
КПП | КПП юридического лица |
Все изменения вступают в силу после нажатия кнопки «Сохранить».
Изменять настройки может только администратор юридического лица.
Настройки mPOS
Вкладка предназначена для настроек юридического лица при работе с мобильным приложением Assist mPOS.
На вкладке «Настройки mPOS» можно посмотреть и отредактировать следующие параметры юридического лица.
Перечень отображаемых настроек mPOS
Название параметра | Комментарий |
Срок действия токена доступа | Срок действия токена доступа для всех пользователей данного юридического лица в формате ДДД:ЧЧ.ММ. Если срок действия не задан, то он считается неограниченным. |
Мерчант по умолчанию | Выпадающий список мерчантов. Если у данного юридического лица имеется несколько мерчантов, здесь можно выбрать мерчанта по умолчанию, на который будет настроено приложение Assist mPOS при его запуске. |
Сценарий получения данных заказа | Выпадающий список. Выбор сценария получения данных заказа приложением Assist mPOS: Ввод вручную, Запрос веб-сервиса мерчанта, Получение через intent. |
Веб-сервис мерчанта | |
URL | Адрес для запроса данных заказа через веб-сервис из информационной системы компании–продавца или курьерской службы. |
Логин | Наименование учетной записи пользователя для доступа к веб-сервису компании–продавца или курьерской службы. |
Пароль | Пароль пользователя для доступа к веб-сервису компании–продавца или курьерской службы. |
Автоматическая генерация номера заказа | Чекбокс, разрешает автоматическую генерацию номера заказа в приложении Assist mPOS. |
Опции | Дополнительные специализированные параметры для работы данного юридического лица с приложением Assist mPOS в формате: <параметр>=<значение>, <параметр> =<значение>. Список параметров в настоящий момент находится в разработке. |
Внимание! Настройки на этой вкладке распространяются на всех мерчантов данного юридического лица, если в настройках мерчантов не указано иное.
После изменения настроек следует нажать кнопку «Сохранить».
Мобильные устройства
Вкладка предназначена для просмотра статусов устройств с установленным приложением SoftPos, зарегистрированных в АПК Ассист. Также здесь можно зарегистрировать новое устройство.
Каждое устройство отображается строкой в списке устройств.
Список устройств
Нажатие на черный треугольник в начале строки с записью об устройстве позволяет открыть дополнительное окно, в котором выводятся данные по истории изменения параметров этого устройства в виде таблицы.
История изменения параметров устройства
Дополнительное нажатие на черный треугольник в начале строки с записью об устройстве закрывает окно истории изменения параметров устройства.
Общий список отображаемых параметров устройства приведен в таблице ниже.
Перечень отображаемых параметров устройств с приложением SoftPos
Название параметра | Комментарий |
SSAID | ANDROID_ID – уникальный 64-битный идентификатор устройства |
Модель | Наименование модели устройства |
Название устройства | Наименование устройства |
Версия ОС | Текущая версия ОС устройства |
Версия mPOS | Текущая версия приложения mPOS, установленная на устройстве |
Версия SoftPos | Текущая версия приложения SoftPos, установленная на устройстве |
Эмулятор | Чекбокс. Указывает на то, что приложение запущено в эмуляторе. |
Root | Чекбокс. Указывает на наличие прав root. |
Статус | Текущий статус устройства (Новое, Неактивно, Активно, Заблокировано) |
Ошибка | Ошибка лимита на регистрацию устройств |
Дата и время использования устройства | Дата и время последнего использования устройства (при регистрации или оплате) |
После первоначального включения устройство с установленным приложением SoftPos отображается в списке устройств со статусом Новое. Через некоторое время статус устройства в списке изменится на Неактивно. Теперь такое устройство может быть зарегистрировано. Для регистрации следует нажать кнопку «Активировать устройство», расположенную слева над списком устройств. После нажатия этой кнопки открывается новое окно для активации. Обязательные параметры отмечены звездочками.
Форма регистрации нового устройства 1
Регистрацию устройства можно осуществить также с помощью вызова контекстного меню. Контекстное меню открывается при наведении курсора мыши на любую строку таблицы (устройство) и нажатии правой кнопки мыши. При этом пункт меню «Активировать устройство» будет активен только для устройства в статусе «Неактивно». В форме регистрации нового устройства в этом случае дополнительно отображается уникальный 64-битный идентификатор активируемого устройства.
Форма регистрации нового устройства 2
Параметры формы регистрации нового устройства представлены в таблице ниже.
Параметры регистрации нового устройства
Название параметра | Комментарий |
SSAID | ANDROID_ID – уникальный 64-битный идентификатор устройства (отображается справочно только в случае регистрации устройства с помощью контекстного меню) |
Логин | Справочно отображается текущий логин пользователя ЛК. |
Вендор | Наименование торговой марки устройства |
Код | Код, полученный на устройстве в приложении SoftPos при запросе на привязку устройства |
Если все параметры регистрации заданы верно (логин соответствует учетной записи пользователя в приложении, код активации соответствует полученному в приложении), то устройство переходит в состояние Активно.
В промежутке времени между получением кода активации приложением на устройстве и успешным окончанием процедуры активации в ЛК в списке это устройство будет отображаться со статусом Неактивно.
Настройки предприятий (мерчантов)
Данный раздел позволяет посмотреть и при необходимости изменить настройки предприятия. Выбор подраздела (группы настроек) осуществляется с помощью меню в правой части экранной формы. Во всех подразделах предусмотрен выбор предприятия, для которого необходимо показать настройки.
Меню выбора подраздела настроек
Общие
В подразделе «Общие настройки» представлена следующая информация:
Общие параметры предприятия
Название параметра | Комментарий |
ID | Идентификационный номер предприятия (справочно) |
Юридическое лицо | Юридическое лицо (справочно) |
Название | Названия предприятия на разных языках (редактирование см. ниже) |
Товары и услуги | Товары и услуги, на которых специализируется предприятие (справочно) |
URL | URL предприятия – доступно для редактирования |
Административный контакт | Административный контакт (ФИО, Должность, Телефон, Мобильный телефон, E-mail) – доступно для редактирования, в поле E-mail возможно указание нескольких адресов через запятую. |
Технический контакт | Технический контакт (ФИО, Должность, Телефон, Мобильный телефон, E-mail) – доступно для редактирования, в поле E-mail возможно указание нескольких адресов через запятую. |
E-mail для получения информации о мошенничестве | Адрес электронной почты для получения информации о мошеннических транзакциях – доступен для редактирования |
Адрес для обращения покупателей | Адрес, по которому при возникновении вопросов по заказу могут обращаться покупатели |
Значение параметра «Название» (название предприятия) может быть задано на разных языках. Для этого необходимо вписать напротив необходимых языков соответствующий перевод названия.
Все изменения вступают в силу после нажатия кнопки «Сохранить».
Настройки платежей
В этом подразделе справочно представлена информация о базовой валюте и режиме работы предприятия (Базовая валюта, Тестовый режим).
Также в подразделе «Настройки платежей» можно посмотреть и отредактировать такие параметры как Таймаут (в минутах), URL_RETURN, URL_RETURN_OK и Действие после авторизации.
Перечень параметров, отображаемых на вкладке «Настройки платежей»
Название параметра | Комментарий |
Базовая валюта | Код и название базовой валюты предприятия (справочно) |
Тестовый режим | Отображается справочно: «Да» - предприятие работает в тестовом режиме «Нет» - предприятие находится в рабочем режиме |
Таймаут перед платежом, мин. | Срок (в минутах от 10 до 40), в течение которого покупатель может ввести данные платежного средства при его проверке до создания заказа (например, при регистрации платежного средства в системе предприятия). По истечении этого срока действие отменяется по тайм-ауту. По умолчанию используется значение 15. |
Таймаут платежа, мин. | Срок (в минутах), в течение которого покупатель может ввести данные платежного средства на авторизационных страницах. По истечении этого срока транзакция завершается по тайм-ауту с результатом «ОТКАЗ В АВТОРИЗАЦИИ. Истекло время ожидания ввода данных платежного средства». |
URL_RETURN | URL, на который будет перенаправлен покупатель в двух случаях: 1) в случае неуспешной авторизации, если заполнено поле «URL_RETURN_OK»; 2) во всех случаях, если поле «URL_RETURN_OK» не заполнено. Для перенаправления покупателя должна быть выбрана опция «Перейти на страницу магазина» в поле «Действие после авторизации». В целях безопасности рекомендуется использовать протокол с шифрованием HTTPS. |
URL_RETURN_OK | Если в поле «Действие после авторизации» выбрана опция «Перейти на страницу магазина», то после осуществления платежа покупатель будет перенаправлен на указанную страницу в случае успешной авторизации. В целях безопасности рекомендуется использовать протокол с шифрованием HTTPS. |
Действие после авторизации | В раскрывающемся списке можно выбрать действие, которое будет совершаться после авторизации платежа: «Отобразить страницу с результатами авторизации», либо «Перейти на страницу магазина» |
Секретное слово | Секретное слово предприятия для формирования контрольной суммы. |
Все изменения вступают в силу после нажатия кнопки «Сохранить».
Необходимо обратить внимание, что значения параметров «URL_ RETURN _ OK» и «URL_ RETURN» используются только при переключателе, установленном в положение «Перейти на страницу магазина» в поле «Действие после авторизации», и при условии, что запрос на авторизационный сервер не содержал параметров URL_RETURN, URL_RETURN_OK, URL_RETURN_NO (иначе параметры, переданные в запросе, являются приоритетными).
Настройки счетов
В этом подразделе справочно представлена информация о способе формирования номера счета, шаблоне номера счета, варианте платежного токена/ID и настройке отображения счета при оплате.
Также в подразделе «Настройки счетов» можно посмотреть и отредактировать такие параметры как период оплаты счетов, необходимость отправки счета покупателю по электронной почте, а также необходимость отправки уведомления об аннулировании счета.
Перечень параметров, отображаемых на вкладке «Настройки счетов»
Название | Комментарий |
Способ формирования номера счета | Отображается справочно. |
Шаблон номера счета | Шаблон для генерации номеров счетов. Отображается справочно. |
Вариант токена | Отображается справочно. |
Показывать счет перед началом оплаты | По умолчанию покупателю показывается счет при переходе по ссылке. Если галочка не установлена, по ссылке покупатель сразу попадает на платежную страницу. Отображается справочно. |
Период оплаты счета | Значение периода времени, в течение которого счет должен быть оплачен (отображается в формате DD.HH.MM), по умолчанию - один день. Это поле не может быть пустым или нулевым. Если в счете не установлен параметр Pay_until, то к времени создания счета прибавляется значение этой настройки и результат используется в качестве значения параметра Pay_until счета. |
Отправлять уведомление об аннулировании | Чекбокс, отвечает за уведомление покупателя об аннулировании счета. По умолчанию уведомление отправляется. |
Секретное слово | Секретное слово предприятия для формирования контрольной суммы. Здесь отображается справочно, настроить можно в разделе « Настройки платежей ». |
Включение проверки Checkvalue для счета | Чекбокс, отвечает за использование контрольного кода checkvalue при создании счета. |
Значения по умолчанию | |
Отправлять счет | Выбор из выпадающего списка: Не отправлять, Отправить по E-mail, Отправить по SMS, Отправить по E-mail и SMS. |
Источник позиций чека | Выбор из выпадающего списка: Нет (позиции чека задаются вручную), Прайс-лист (позиции чека могут быть заданы как вручную, так и загружены из прайс-листа), Только прайс-лист (позиции чека могут быть только загружены из прайс-листа). |
Двухстадийный режим | Чекбокс. Разрешает оплату в двухстадийном режиме по счетам данного мерчанта. Если чекбокс неактивен, следует обратиться в службу поддержки Assist. |
Имя | Имя покупателя |
Фамилия | Фамилия покупателя |
Часть параметров подраздела «Настройки счетов» отображается справочно. Для изменения этих параметров необходимо обратиться в службу технической поддержки.
Все изменения вступают в силу после нажатия кнопки «Сохранить».
Настройки отправки результатов платежей
В подразделе «Настройки отправки результатов платежей» можно настроить отправку результатов платежей на сервер предприятия.
Внимание! По соображениям безопасности данные отправляются только на порты 443, 8443, 80, 8080. На другие порты данные отправляться не будут!
Для того, чтобы уведомления о результатах платежей отправлялись на сервер предприятия, необходимо поставить галочку в соответствующем пункте.
Примечание. Если задана отправка уведомлений о результатах платежей, то в случае их неуспешной отправки будет отсылаться уведомление об ошибке по адресу, указанному в параметре «Технический контакт» вкладки «Общие настройки» раздела «Настройки мерчанта».
Также можно указать URL для отправки результатов, выбрать тип протокола и тип подписи.
Параметры, отображаемые на данной вкладке, представлены в табл. ниже.
Настройки отправки результатов платежей
Название параметра | Комментарий |
Отправка результатов оплат | Чекбокс. Если галочка есть, то результаты оплат отправляются. |
Отправка результатов отмен | Чекбокс. Если галочка есть, то результаты отмен отправляются. |
Отправлять позиции заказа | Чекбокс. Если галочка есть, то позиции заказа отправляются. |
Отправка результатов фискализации | Чекбокс. Если галочка есть, то результаты фискализации отправляются. |
Отправка результатов подтверждений | Чекбокс. Если галочка есть, то результаты подтверждений отправляются. |
Только успешные | Чекбокс. Если галочка есть, то отправляются только успешные результаты из выбранных выше отправок. Активен, если выше выбрана хотя бы одна отправка результатов. |
Отправка результатов начисления баллов на сервер магазина | Чекбокс. Если галочка есть, то отправляются результаты начисления бонусных баллов по промоакции Сбербанка «Спасибо». |
Отправка результатов отмены начисления баллов на сервер магазина | Чекбокс. Если галочка есть, то отправляются результаты отмены начисления бонусных баллов по промоакции Сбербанка «Спасибо». |
URL для отправки результатов | URL, на который отправляются результаты платежей. Поле активно, если выше выбрана хотя бы одна отправка результатов. |
Тип протокола | Тип протокола – POST или SOAP. Поле активно, если выше выбрана хотя бы одна отправка результатов. |
Тип подписи | Тип подписи – PGP или md5. Поле активно, если выше выбрана хотя бы одна отправка результатов. |
Секретное слово | Секретное слово предприятия для формирования контрольной суммы. Здесь отображается справочно, настроить можно в разделе «Настройки платежей». |
Вид ответа мерчанта | Отображается справочно. Для изменения следует обратиться в службу поддержки. |
Фискальные настройки
В подразделе «Фискальные настройки» можно просмотреть текущие фискальные настройки для предприятия.
Фискальные настройки*
Название параметра | Комментарий |
Формировать фискальный чек для БК | Если галочка установлена, то разрешается формирования фискальных чеков по платежам банковскими картами данному предприятию. |
Формировать фиск. чек для кошельков | Если галочка установлена, то разрешается формирования фискальных чеков по платежам с помощью электронных кошельков данному предприятию. |
Формировать фиск. чек для неэлектронных средств | Если галочка установлена, то разрешается формирования фискальных чеков по платежам с помощью неэлектронных средств данному предприятию. |
Мерчант работает с внешней фискализацией | Если галочка установлена, то предприятие использует внешнюю фискализацию для своих платежей |
Этап формирования чека/уведомления | Авторизация или Подтверждение. Подтверждение может применяться только для двухстадийного механизма. |
Не отправлять фискальный чек | Разрешение не отправлять фискальные чеки покупателям. |
Признак способа расчета по умолчанию | Признак способа расчета по умолчанию (в режиме без передачи позиций чека). |
Адрес места расчета | Адрес места расчета, указываемый в чеке (возможен адрес домена при покупке онлайн) |
Ставка налога по умолчанию | Ставка налога по умолчанию (в режиме без передачи позиций чека). |
Система налогообложения по умолчанию | Система налогообложения по умолчанию (в режиме без передачи позиций чека). |
Url ОФД | Url адрес ОФД |
Текст позиции чека по умолчанию | Наименование товара по умолчанию (в режиме без передачи позиций чека). |
Текст позиции внешнего чека по умолчанию | Наименование товара по умолчанию (в режиме без передачи позиций чека при фискализации внешних операций). |
Отправлять уведомление по неуспешной оплате | Если галочка установлена, то будет отправляться уведомление покупателю в случае неуспешной оплаты. |
E-mail отправителя чека | Адрес E-mail отправителя чека (по согласованию с предприятием). |
E-mail покупателя по умолчанию | Адрес E-mail покупателя по умолчанию. |
*Все параметры в таблице «Фискальные настройки» отображаются справочно. Для изменения фискальных настроек необходимо обратиться в службу технической поддержки.
Настройки отправки реестров и уведомлений
Параметры, отображаемые в этом подразделе можно условно разделить на два блока - «Отправка ежедневных реестров» и «Отправка уведомлений».
Отправка ежедневных реестров
Название параметра | Комментарий |
Присылать ежедневные реестры | Если поставлена галочка, то по указанным адресам будут отправляться ежедневные реестры |
Адреса для получения реестров | Поле для указания адресов, по которым будут присылаться ежедневные реестры |
Тип отчета | Выпадающий список для выбора типа отчета: Все; Только успешные; Все, кроме незавершенных |
Временная зона дат в реестре | Можно выбрать временную зону (часовой пояс) дат в реестре: GMT или время юридического лица |
Десятичный разделитель | Установка запятой или точки в качестве десятичного разделителя. |
Переотправить реестр за | Элемент управления позволяет ввести число, месяц, год – дату, за которую требуется заново отправить реестр. Примечание. Можно формировать реестры только за прошедшие даты, не позднее вчерашней. Формирование и отправка реестра запускается кнопкой «Отправить». Кнопка «Отправить» активна только тогда, когда отправка ежедневных реестров настроена. |
Если настроена отправка ежедневных реестров, то по указанным адресам по окончании дня будет отправлено письмо с вложенным архивом, содержащим информацию о проведенных платежах по предприятию за прошедшие сутки в файле формата .txt. Реестр отправляется даже в том случае, если за текущий день не проведено ни одного платежа. В этом случае присланный файл будет содержать строку «NO PAYMENTS THIS DAY».
Следует обратить внимание на особенности работы с файлами в формате .txt
Пример строки из ежедневного реестра:
BillNumber:000000000000001;BillNumberExt:000000000000001.1;OrderNumber:0001-01; OrderState:Approved; OrderTest:1;OrderAmount:100.00;OrderCurrency:RUB;OrderDate:01.01.2011 07:00:05;OrderComment:тестовый платеж;CustomerName:Testov Test T.;OperationType:Approve;OperationState:Success;Protocol:NET; OperationAmount:100.00;OperationCurrency:RUB;OperationDate:01.01.2011 07:00:08;MeanType:VISA; MeanSubType:Visa Gold;MeanNumber:411111****1111;CardHolder:Testov Test;OperationResult:Success; ErrorMessage:;Recommendation:;Response_Code:AS000;ApprovalCode:F00001;ProcessingName:Name;
Если настроена отправка уведомлений, то после операции платежа по указанному адресу немедленно будет отправлено письмо, содержащее информацию об этом платеже.
Отправка уведомлений
Название параметра | Комментарий |
Адрес для отправки уведомлений | Поле для указания адреса, по которому будут присылаться уведомления об оплате |
Отправлять уведомления об оплате | Если поставлена галочка, то по указанному адресу будут отправляться уведомления об оплате |
Отправлять уведомления о подтверждении оплаты | Если поставлена галочка, то по указанному адресу будут отправляться уведомления о подтверждении оплаты |
Отправлять уведомления об отмене оплаты | Если поставлена галочка, то по указанному адресу будут отправляться уведомления об отмене оплаты |
Пример уведомления о платеже:
BillNumber: 000000000000001 OperationType:Approve OrderNumber:0001-01 Total:100.00 Currency:RUB Status:Approved Comment:тестовый платеж Response_Code:AS000 MeanType:MasterCard
Пример уведомления о подтверждении оплаты:
BillNumber: 000000000000001 OperationType:Charge OrderNumber:0001-01 Total:100.00 Currency:RUB Status:Approved Comment:тестовый платеж Response_Code:AS000 MeanType:MasterCard
Пример уведомления об отмене оплаты:
BillNumber:000000000000001 OperationType:PaymentCancel OrderNumber:0001-01 Total:100.00 Currency:RUB Status:Canceled Comment:тестовый платеж Response_Code:AS000 MeanType:MasterCard
Настройки лимитов
В данном подразделе в табличном виде отображаются лимиты и ограничения, настроенные для предприятия. В таблице отображаются:
- названия лимитов ;
- их текущие значения;
- предельные значения.
Активные лимиты отмечены галочками в колонке «Активно».
Редактирование лимитов в Личном Кабинете не допускается. Для изменения предельных значений лимитов необходимо обратиться в службу технической поддержки.
Настройки подписи заказа
В данном подразделе имеется возможность настроить проверку контрольного кода (MD5) и/или подписи заказа, если предприятие использует такие проверки. Список параметров представлен в табл. ниже.
Настройка подписи заказа
Название параметра | Комментарий |
Проверка контрольного кода (MD5) | |
Проверять контрольный код (MD5) | Если галочка установлена, то контрольный код (MD5) проверяется |
Секретное слово | Секретное слово предприятия. Здесь отображается справочно, настроить можно в разделе «Настройки платежей». |
Проверка подписи заказа | |
Проверять подпись заказа | Если галочка установлена, то подпись заказа проверяется |
Новый публичный ключ | Публичный ключ RSA длиной 1024 бит следует сгенерировать самостоятельно и загрузить в виде файла формата *.pem с помощью кнопки «Выбрать файлы», при нажатии которой открывается проводник для выбора файла публичного ключа. |
Текущий публичный ключ | Поле, в котором справочно отображается текущий публичный ключ |
Период действия нового и старого ключей (дней) | Период (в днях), в течении которого возможна проверка не только по новому, но и по старому публичному ключу в случае, если проверка по новому была неуспешной. Если предприятию необходимо деактивировать старый публичный ключ ранее установленного срока, то необходимо обратиться в службу поддержки Assist |
После изменения настроек необходимо нажать кнопку «Сохранить».
Внимание! Если предприятие активирует проверку контрольного кода (MD5), то при передаче авторизационного запроса необходимо передавать параметр Checkvalue c соответствующим значением, иначе все заказы будут завершаться неуспешно, т.к. не пройдут проверку контрольного кода (MD5). Более подробную информацию можно получить из раздела «Формирование строки для подписи или для контрольной суммы в запросах к интерфейсам АПК Ассист».
При сохранении изменений в секции «Проверка подписи заказа» появляется сообщение о том, что новый публичный ключ активирован, а старый будет активен в течение установленного срока.
Внимание! Если предприятие активирует проверку подписи заказа, то при передаче авторизационного запроса необходимо передавать параметр Signature c соответствующим значением, иначе все заказы будут завершаться неуспешно, т.к. не пройдут проверку подписи заказа. Более подробную информацию можно получить из раздела «Формирование строки для подписи или для контрольной суммы в запросах к интерфейсам АПК Ассист».
One Click
В подразделе One Click в справочном режиме отображаются настроенные параметры подключения программы One Click для данного предприятия (мерчанта). Возможность редактирования этих параметров в личном кабинете отсутствует. Список параметров представлен в табл. ниже.
Отображение параметров функции One Click
Название параметра | Комментарий |
Разрешить One Click | Если галочка установлена, функция подключена для данного предприятия |
Режим работы | Выбор из выпадающего списка: Стандартный (покупатель может подключать новые карты к программе или платить ранее подключенными картами), Оплата только привязанными картами (покупатель может платить только привязанными картами), Только привязка карт (покупатель может только подключать новые карты к программе). |
Примечание. Все параметры в подразделе «One Click» отображаются справочно. Для изменения настроек подраздела необходимо обратиться в службу технической поддержки.
В блоке «Клиенты » вкладки One Click можно просмотреть информацию о клиенте по его уникальному номеру (присваивается предприятием и передается в качестве одного из параметров заказа, а также содержится в обязательной подписи этого заказа).
Поиск клиентов в списке происходит по полному совпадению. Для осуществления поиска нужно задать искомый номер клиента в поле «Номер клиента» и нажать кнопку «Поиск». Если оставить поле «Номер клиента» пустым и нажать кнопку «Поиск», то в качестве результатов поиска будет отображен полный список клиентов программы One Click данного мерчанта.
Отображение информации по клиенту One Click
Возможные значения статуса клиента:
Наименование статуса | Описание |
Новый | Клиент, успешно осуществивший один и более платежей, но не согласившийся сохранить ни одну из своих карт. Также такой статус будет иметь клиент, если его первый платеж был неуспешным или закрыт по истечении времени ожидания. |
Участник | Клиент, согласившийся сохранить карту для последующих платежей. |
Неактивный | Участник, у которого все сохраненные карты недействительны. Статус устанавливается автоматически. |
Отказ от участия | Клиент, отказавшийся от участия в программе One Click. |
Запрет по фродовой причине (выделяется красным цветом) | Платежи по одной из сохраненных карт заблокированы для всех предприятий и всех номеров клиентов, т.к. при оплате этой картой был получен статус «100% фрод» от СПМ или «StolenCard» от процессинга. |
Подозрительный по фродовой причине (выделяется желтым цветом) | Получен фродовый статус от СПМ по одной из карт данного клиента (при платеже любому мерчанту). Статус устанавливается автоматически, но может быть установлен и вручную. |
Нажатие правой кнопки мыши на строке клиента дает возможность пользователю изменить статус клиента в базе данных программы One Click.
Если клиент оплачивает заказы предприятию с помощью нескольких банковских карт, каждая из них включается в программу One Click по аналогичным правилам. При оплате очередного заказа клиент имеет возможность выбрать ту или иную карту из выпадающего списка его платежных средств, по которым были успешные оплаты.
Нажатие на черный треугольник в начале строки с записью о клиенте позволяет открыть дополнительное окно, в котором выводятся данные по всем сохраненным картам этого клиента в виде таблицы со следующими столбцами.
Название | Комментарий |
ID номера платежного средства | Идентификатор номера платежного средства. |
Тип платежного средства | Тип платежного средства (Visa, MasterCard и т.д.). |
Номер платежного средства | Отображается с помощью маски. |
Дата добавления | Дата сохранения карты с первым успешным платежом. |
Дата последнего успешного платежа | Дата и время последнего успешного платежа с помощью данного платежного средства. |
Число успешных платежей картой | Число успешных платежей данной картой. |
Порядок | Очередность последних платежей по картам данного клиента. По умолчанию при очередной оплате клиенту будет предложено оплатить заказ последней использованной им картой (порядок 1). |
Статус карты | Статус карты. |
Статус COF | Тип COF-платежа в процессинге. |
Статусы карт клиентов программы One Click и их описание:
Наименование статуса | Описание |
Участник | Карта, по которой успешно осуществлен один и более платежей, при этом клиент согласился ее сохранить. |
Карта скомпрометирована | Платежи по данной карте заблокированы для всех предприятий и всех номеров клиентов, т.к. при оплате этой картой был получен статус «100% фрод» от СПМ или «StolenCard» от процессинга. |
Просроченная карта | Карта, у которой закончился срок действия. |
Карта удалена | Карта была удалена из сервиса One Click. |
Отображение информации по картам клиента One Click
Нажатие правой кнопки мыши на строке карты дает возможность пользователю удалить данную карту из базы данных программы One Click.
Перед удалением карты открывается новое окно с запросом подтверждения действия.
Запрос подтверждения удаления карты
Более подробную информацию о работе программы One Click и условиях участия в ней можно получить из соответствующего раздела документации на сайте.
Оплата токеном
АПК Ассист предоставляет предприятиям сервис обработки платежей с использованием токенов (например, Apple Pay). В этом подразделе отображается информация о разрешениях оплаты для данного предприятия с помощью различных платежных сервисов, а также информация о сертификатах данного предприятия. Кроме того, здесь можно загрузить подписанный сертификат для проведения платежей с использованием токенов в АПК Ассист.
В верхней части вкладки отображается следующая информация о разрешениях оплаты с помощью платежных сервисов:
- чек-бокс «Разрешить оплату через Apple Pay на платежной странице»;
- чек-бокс «Разрешить оплату через Google Pay на платежной странице »;
- чек-бокс «Разрешить оплату через Samsung Pay на платежной странице »;
- чек-бокс «Разрешить оплату через Mir Pay на платежной странице»;
- чек-бокс «Разрешить оплату по QR-коду на платежной странице».
Информация отображается справочно, для подключения оплаты с помощью платежных сервисов следует обращаться с запросом в службу технической поддержки Assistт.
Ниже отображается информация о текущих сертификатах предприятия отдельно для различных платежных систем.
Внимание! Для получения прав на осуществление настроек по оплате токеном следует обратиться в службу технической поддержки.
Сертификаты для Apple Pay
В этом блоке отображается таблица текущих сертификатов Apple Pay предприятия.
Параметры сертификатов для оплаты токеном Apple Pay
Название параметра | Комментарий |
Тип | Тип сертификата: Apple Pay |
Хэш публичного ключа | Хэш публичного ключа, созданный АПК Ассист. |
Действителен | Срок действия загруженного сертификата. |
Статус | Текущий статус сертификата (Request – сертификат в процессе создания, Active – сертификат активен, Expired – срок действия сертификата истек). |
Для загрузки сертификата следует нажать кнопку «Новый сертификат». Далее появится окно, в котором описаны все необходимые действия для получения сертификата. Также здесь можно загрузить подписанный сертификат.
Загрузка подписанного сертификата
Нажатие кнопки «Загрузить подписанный сертификат» открывает стандартное окно обзора для выбора файла подписанного сертификата.
Примечание. Генерация файла запроса на подпись сертификата и загрузка подписанного сертификата может осуществляться только при использовании браузеров Chrome, Firefox, Edge, Opera и Safari (для Mac).
Если действия по загрузке сертификата не были завершены и окно загрузки закрыто, то строка сертификата в таблице сертификатов создается со статусом «Request» и срок действия сертификата отсутствует. Действия по загрузке подписанного сертификата можно завершить позже, используя контекстное меню.
Контекстное меню
Получить CSR
Загрузить подписанный сертификат
Удалить
осуществляет переход к действиям по созданию и загрузке сертификата;
дает возможность загрузить имеющийся подписанный сертификат;
удаляет строку сертификата из таблицы.
Сертификаты для Mir Pay
В этом блоке отображается таблица текущих сертификатов Mir Pay предприятия.
Параметры сертификатов для оплаты токеном Mir Pay
Название параметра | Комментарий |
Тип | Тип сертификата: Mir Pay |
KID | Идентификатор сертификата. |
Действителен | Срок действия сертификата. |
Статус | Текущий статус сертификата (Active – сертификат активен, Expired – срок действия сертификата истек). |
Предприятие генерирует секретный ключ и формирует CSR (Certificate Signing Request). В запросе CSR поле Organizational Unit Name (OU) элемента Subject должно заполняться значением MerchantId (зарегистрированный в АПК Ассист номер мерчанта). Значение MerchantId должно состоять из 15 символов M000...00<EXTMERCHANT_ID>, где EXTMERCHANT_ID это уникальный идентификатор, генерируемый при проведении регистрации. В элементе keyUsage должно быть указано назначение ключа «digitalSignature».
При первоначальной регистрации сертификата регистрация магазина в НСПК обязательна. Поэтому чек-бокс "Зарегистрировать магазин в НСПК" отмечен и неактивен. Также имеется указание на то, что ни один сертификат пока не сгенерирован.
Заголовок блока сертификатов Mir Pay
Далее следует загрузить запрос на сертификат с помощью кнопки «Загрузить CSR», после нажатия которой открывается стандартное окно обзора для выбора файла CSR.
После загрузки запроса в таблице создается строка сертификата со статусом «Active» и сроком его действия. Над таблицей отображается ссылка на готовый JSON Web Key Set (JWKS) с этим сертификатом. Отдельно сертификат также можно скачать с помощью контекстного меню (для вызова контекстного меню следует нажать правую кнопку мыши на строке интересующего сертификата).
Таблица сертификатов Mir Pay
После успешной регистрации магазина в НСПК чек-бокс "Зарегистрировать магазин в НСПК" становится активным, и отметка с него автоматически снимается. Если в дальнейшем понадобится сгенерировать новый сертификат (например, истек срок действия имеющегося сертификата), то регистрация в НСПК уже не требуется.
Если же по каким-либо причинам необходима повторная регистрация в НСПК, то следует заново отметить чек-бокс "Зарегистрировать магазин в НСПК" перед загрузкой запроса на сертификат с помощью кнопки «Загрузить CSR», в этом случае выдается специальное предупреждение:
Предупреждение о повторной регистрации
Настройки mPOS
Подраздел предназначен для настроек мерчанта при работе с мобильным приложением Assist mPOS.
В подразделе «Настройки mPOS» можно посмотреть и отредактировать следующие параметры мерчанта.
Параметры настроек mPOS
Название параметра | Комментарий |
Веб-сервис мерчанта | |
URL | Адрес для запроса данных заказа через веб-сервис из информационной системы компании–продавца или курьерской службы. |
Логин | Наименование учетной записи пользователя для доступа к веб-сервису компании–продавца или курьерской службы. Для веб-сервиса мерчанта введенное значение не валидируется. |
Пароль | Пароль пользователя для доступа к веб-сервису компании–продавца или курьерской службы. Для веб-сервиса мерчанта введенное значение не валидируется. На экране пароль не отображается. |
Автоматическая генерация номера заказа | Чекбокс, разрешает автоматическую генерацию номера заказа в приложении Assist mPOS |
Ежедневный отчет | |
Включить отправку ежедневного отчета | Чекбокс, разрешает отправку ежедневного отчета mPOS по заданному списку e-mail адресов. Отображается справочно. Для подключения необходимо обратиться в службу технической поддержки АПК Ассист. |
Добавить e-mail | Адрес e-mail для добавления в список рассылки ежедневного отчета mPOS. Осуществляется проверка введенного значения на соответствие формату электронного адреса. |
Список e-mail для отправки | Добавление адреса в список осуществляется с помощью кнопки «+», нажатие которой копирует введенный адрес из поля «Добавить e-mail». С помощью кнопки «-» можно удалить адрес из списка. |
Опции | Дополнительные специализированные параметры для работы данного мерчанта с приложением Assist mPOS в формате: <параметр>=<значение>, <параметр> =<значение>. Список параметров в настоящий момент находится в разработке. |
После изменения настроек следует нажать кнопку «Сохранить».
Смена пароля
Данный раздел предназначен для смены пароля пользователя, под именем которого был произведен вход в Личный кабинет.
Для смены пароля необходимо ввести старый пароль в строку «Текущий пароль», затем ввести в строку «Новый пароль» пароль, на который меняется старый, и подтвердить его в строке «Подтверждение нового пароля».
Внимание! Пароль может иметь длину от 8 до 20 символов включительно и содержать символы латинского алфавита (прописные и строчные) и цифры. Одновременное наличие в пароле как буквенных, так и цифровых символов обязательно.
Изменения сохранятся, и новый пароль вступит в силу только после нажатия кнопки «Сохранить».
Двухфакторная аутентификация
Для повышения уровня безопасности данных предприятия в Личном кабинете можно дополнительно использовать двухфакторную аутентификацию. При этом кроме основного пароля учетной записи используется специальный код, который можно получить с помощью мобильного устройства (смартфона). Для получения кода следует скачать приложение и выбрать более удобный для себя способ получения кода.
В данном разделе отображается краткая инструкция по включению двухфакторной аутентификации, а также имеется поле для ввода специального кода подтверждения.
Управление пользователями
В разделе управления пользователями отображаются все пользователи юридического лица. Администратор юридического лица имеет права на редактирование пользователей и создание новых.
Действия над пользователями
Администратор юридического лица имеет право создавать новых пользователей.
Кроме того, администратор юридического лица может выполнять над существующими пользователями следующие действия:
- смена пароля;
- разрешение/запрещение пользователю изменять пароль самостоятельно;
- изменение информации о пользователе;
- редактирование прав пользователя;
- редактирование прав пользователей на вкладку «Операции»;
- редактирование списка предприятий (мерчантов);
- удаление пользователя.
Окно создания нового пользователя
Если, например, необходимо создать пользователя, который сможет просматривать мониторинг заказов, то рекомендуется следующая последовательность действий:
- нажать на кнопку «Новый пользователь» и в появившейся форме создания пользователя ввести все необходимые данные (логин, пароль, повтор пароля, выбрать тип пользователя «USER», выбрать какой язык назначить по умолчанию для создаваемого пользователя, обязательные параметры отмечены звездочками);
- нажать на кнопку «Сохранить», после чего новый пользователь появится в таблице;
- на появившейся в таблице строке вновь созданного пользователя нажать правую кнопку мыши и выбрать пункт контекстного меню «Редактировать права»;
- в открывшемся окне редактирования прав в разделе «Роли» необходимо поставить галочку в колонке «Роли» напротив пункта «Пользователь»;
- на вкладке «Редактировать список мерчантов» убедиться, что у пользователя есть доступ ко всем необходимым предприятиям (мерчантам); при необходимости можно убрать доступ пользователя к предприятию (мерчанту) путем снятия галочки напротив соответствующего предприятия (мерчанта); а при необходимости разрешить пользователю доступ к предприятию (мерчанту), нужно проставить галочку напротив соответствующего предприятия (мерчанта);
- нажать кнопку «Сохранить».
Внимание! При создании нового пользователя необходимо обратить внимание на то, что к логину и паролю предъявляются следующие требования:
- логин - длина от 8 до 20 символов включительно, содержит не менее одного символа латинского алфавита (прописные и строчные буквы), может содержать также цифры и знак подчеркивания.
- пароль - длина от 8 до 20 символов включительно, содержит символы латинского алфавита (прописные и строчные) и цифры. Одновременное наличие в пароле как буквенных, так и цифровых символов обязательно.
Добавление роли пользователю.
Редактирование списка предприятий (мерчантов).
Теперь пользователь сможет с указанным логином и паролем зайти в Личный кабинет для просмотра заказов.
Если необходимо, чтобы у созданного пользователя была возможность совершать отмены и подтверждения и/или осуществлять экспорт в файл, то дополнительно к роли «Пользователь» нужно выполнить следующие действия:
- на строке с выбранным пользователем нажать правую кнопку мыши и зайти в пункт контекстного меню «Редактировать права»;
- в открывшемся окне редактирования прав в разделе «Компоненты» в колонке «Доступ» поставить галочки напротив пунктов «Отмены» и «Подтверждения» и/или пункта «Кнопка «экспорт»;
- убедиться, что у пользователя установлена галочка напротив пункта «Личный кабинет: Меню заказа»;
- нажать кнопку «Сохранить».
Выдача прав на отмены и подтверждения
Теперь пользователь сможет не только просматривать список заказов, но и делать на них отмены и подтверждения и/или экспортировать данные в файл.
Если администратор юридического лица хочет сменить пароль какому-либо пользователю, то ему необходимо выполнить следующие действия:
- на строке с выбранным пользователем нажать правую кнопку мыши, выбрать в контекстном меню пункт «Смена пароля»;
- в открывшемся окне смены пароля ввести новый пароль и повтор нового пароля;
- нажать кнопку «Сохранить».
Если требуется удалить пользователя, то администратору юридического лица необходимо выполнить следующие действия:
- на строке с выбранным пользователем нажать правую кнопку мыши, выбрать в контекстном меню пункт «Удалить»;
- подтвердить удаление в появившемся окне путем нажатия кнопки «ОК», после чего пользователь будет удален из системы.
Внимание! Удаленного пользователя восстановить невозможно!
Сохранение данных в файле
В окне Пользователи имеется возможность сохранить отображаемые данные в файле (экспортировать).
Примечание. Для осуществления экспорта пользователь должен обладать соответствующими правами.
Файл с данными формируется в формате .csv с именем users DDMMYYYY_hhmm, где DDMMYYYY_hhmm – текущие дата и время во временной зоне (часовом поясе) юридического лица.
Необходимо обратить внимание на особенности работы с файлами в формате .csv.
Работа с профилями
Механизм профилей удобно использовать в том случае, если по технологии работы предприятия нужно создавать большое количество разных пользователей ЛК с однотипными правами. Для этого создается специальный пользовательский профиль, которому все необходимые права уже присвоены. При создании очередного пользователя администратору будет достаточно задать только его личные данные и наименование профиля.
Использование профилей необходимо согласовать со службой технической поддержки АПК Ассист, при этом по заявке предприятия создаются необходимые профили и администратору предприятия выдаются соответствующие права.
После нажатия кнопки «Профили» открывается новое окно, в котором отображается информация о текущих профилях предприятия.
Параметры профилей
Название | Комментарий |
Название | Наименование профиля |
Тип пользователя | Тип пользователя |
Компания | Компания профиля пользователя |
Юр. лицо | Юридическое лицо профиля пользователя |
Электронная почта | E-mail адрес пользователя профиля по умолчанию (будет автоматически присвоен всем пользователям профиля, для которых не задан собственный адрес) |
Уровень | Уровень отображения ошибок |
Для создания пользователя профиля следует вызвать контекстное меню и выбрать пункт «Создать пользователя». Контекстное меню открывается при наведении курсора мыши на любую строку таблицы (профиль) и нажатии правой кнопки мыши.
Список полей формы создания нового пользователя профиля приведен в таблице:
Параметры создания нового пользователя
Название | Комментарий |
Профиль | Выбор из выпадающего списка профилей предприятия |
Логин | Содержит не менее одного символа латинского алфавита (прописные и строчные буквы), может содержать также цифры и знак подчеркивания, длина от 8 до 20 символов включительно (обязательное поле). |
Пароль | Латинские буквы (строчные и прописные), цифры, длина от 8 до 20 символов включительно. Обязательно должны входить и буквы, и цифры (обязательное поле). |
Имя | Текстовое поле |
Отчество | Текстовое поле |
Фамилия | Текстовое поле |
Электронная почта | Текстовое поле (100 символов). E-mail адрес пользователя, если не задан, то будет автоматически присвоен адрес профиля по умолчанию |
Для сохранения внесенных изменений необходимо нажать кнопку «Создать».