Журнал Провайдеры содержит всех провайдеров, имеющихся в системе Армакс. По умолчанию агент видит доступных ему провайдеров — провайдеров, у которых прописаны шлюзы в платёжные системы, представленные в счетах агента. Чтобы увидеть всех провайдеров, имеющихся в системе, переключите фильтр со значения «доступные для проведения провайдеры» на «системные провайдеры». Если фильтр провайдеров находится в значении «субпровайдеры», агент видит созданных им субпровайдеров и местных провайдеров.

Чтобы увидеть, какие провайдеры есть в  конкретной платёжной системе, введите название платёжной системы в поле «Поиск ПС» (воспользуйтесь подсказкой, начав вводить название ПС,  выберите из списка).

Чтобы открыть описание провайдера, кликните по нему дважды.

Описание провайдера содержит следующие поля:

• Базовый провайдер — поле заполняется только для субпровайдеров и содержит название провайдера, на основе которого создан субпровайдер;
• Группа - группа, к которой относится провайдер;
• Тип проведения — тип проведения платежа по этому провайдеру, все системные провайдеры имеют тип «Проводится на сервере», остальные типа проведения см. в Местные провайдеры;
• Полное наименование - Наименование провайдера. Под этим названием провайдер будет виден в отчетах, правилах проведения, тарифных планах и т.п;
• Название на чеке - Название провайдера, которое будет печататься пользователю на чеке;
• Алиас - фразы, по которым это провайдер будет находиться в Поиске провайдеров. Например, для провайдера Теле2 алиас может иметь вид - tele2, tele-2, теле-2, теле 2.
• Сервис - описание вида услуги провайдера (в общем случае совпадает с названием группы).
• Юр. лицо - название огранизации - поставщика услуг провайдера;
• ИНН - ИНН организации - поставщика услуг;
• Регион - регион, в котором представлен данный провайдер;
• Адрес - адрес организации - поставщика услуг;
• Телефон - телефон службы поддержки по этому провайдеру;
• Сайт - сайт провайдера;
• Описание - дополнительное текстовое описание к провайдеру;
• Позиция штрих-кода с по, Значение штрих-кода с по - поля, предназначенные для автоматического определения провайдера по штрих-коду. Поля «позиция штрих-кода» отвечают за определение в штрих-коде группы, по которой будет идентифицироваться провайдер. Поля «Значение штрих-кода с по» отвечают за диапазон значений в этом группе. Например, пусть в штрих-коде оператора первый три цифры от 100 до 199. В таком случае Позиция штрих кода с 1 по 3, Значение штрих-кода с 100 по 199. Если значение части штрих-кода фиксировано, то «Значение с» и «Значение по» совпадают.
• Фиксированная сумма - по провайдеру возможны платежи только на указанную сумму. Применяется для провайдеров типа Skype, некоторых игр, пакетов программного обеспечения и т.п.
• Логотип провайдера - изображение в формате png. Рекомендуемый размер логотипа не более 250 pxl в ширину и не более 100 pxl в высоту

Поля ввода:

• Название - имя поля ввода, под этим именем реквизит в платеже приходит на сервер. Имя поля должно содержать только латинские буквы, цифры и знак подчёркивание и обязательно начинаться с буквы.
• Тип - тип поля ввода. Возможные варианты - простой, составной, со значением. Простой тип - одно поле ввода. Составной тип - поле ввода может быть разбито на произвольное число полей. Тип ввода «со значением» - поле ввода представляет собой набор пар вида "Название-Значение". Пользователь на терминале выбирает Название и в платёж попадают данные из Значение.
• Заголовок - заголовок поля ввода на терминале. Обычно начинается со слова "Введите"
• Заголовок на чеке - Заголовок поля при печати на чеке. Если рядом не стоит галочка, поле ввода не будет печататься на чеке.
• RegExp - регулярное выражение, по которому проверяется правильность ввода. Если введённые данные не соответствуют регулярному выражению, кнопка Далее не загорится.
• Маска - маска ввода для поля. задаёт число и вид символов для Простого поля ввода. Возможные виды символов в маске

С — в данной позиции возможен ввод любой буквы;

0 — в данную позицию необходимо ввести цифру;

9 — в данной позиции может находиться цифра или она будет пустой;

пустая маска - формат ввода не задан.

• Значение - у поля ввода уже задано значение, ничего вводить не нужно.
• Клавиатура тип/язык - тип экранной клавиатуры (полная или цифровая и для полной клавиатуры язык ввода);
• Позиция штрих-кода - если поле может быть заполнено из штрих-кода, то указывается с какого по какой символ штрих-кода берётся для заполнения поля;
• Галочка «Не показывать» - не показывать это поле плательщику на терминале (не спрашивать этот реквизит).

Вкладка «Настройки ПС» содержит записи о всех платёжных системах, для которых прописаны шлюзы для этого провайдера, если в таблице нет нужной ПС, значит в системе Армакс пока нет шлюза. Номер шлюза можно посмотреть , выбрав нужную ПС и найдя поле  externalId в таблице справа. Обратите внимание, что одного номера шлюза не всегда достаточно для корректного проведения платежа по провайдеру.

                   Создание и использование субпровайдеров

Пользователь не может редактировать системного провайдера. Для того, чтобы внести изменения в провайдера, создаётся Субпровайдер на основе системного.

В каких случаях необходимо создать субпровайдера:

1. Агент хочет, чтобы у провайдера маска отличалась от системной. Например, первые цифры лицевого счёта - это код региона. И агент хочет, чтобы в его регионе эти цифры уже были введены.
2. Агент хочет изменить данные поставщика услуг в регионе (например, телефон службы поддержки, логотип или ИНН организации)
3. Агент хочет изменить названия полей ввода.
4. Агент хочет минимизировать число заполняемых пользователем полей, сделав некоторые поля предварительно заполненными.

Супровайдера можно создать с помошью двух кнопок: «Создать субпровайдера» - по кнопке открывается список провайдеров и нужно выбрать, на основе какого провайдера будет создаваться субпровайдер; «Создать субпровайдера из выбранного» - если в списке провайдеров выбран провайдер, то можно нажать эту кнопку и будет сразу создан субпровайдер на основе выбранного.

Чтобы субпровайдер был доступен на терминале, он должен быть добавлен в профиль комиссии для терминала и в профиль отображения.

Пример: создание субпровайдера Оплата детского садика "Солнышко" на основе провайдера "Платежи по свободным реквизитам"

Видео добавления субпровадера

Пусть агент хочет сделать оплату детского садика "Солнышко" отдельным провайдером. Для оплаты необходимо знать фамилию и имя ребёнка и номер группы. Реквизиты садика известны.

Так как детский садик оплачивается в бюджет, нам потребуется провайдер Платежи в бюджет по свободным реквизитам. Находим в списке провайдеров этот и нажимаем кнопку "Создать субпровайдера из выбранного", В открывшемся окне заполняем поля

• Полное наименование - Детский садик Солнышко,
• Регион - Курск,
• Адрес - Курск, ул. Ленина, д.12,
• Телефон - 252-553.

Если есть картинка-логотип садика, загружаем её (кнопка Загрузить картинку).
Переходим к полям ввода. В поля account, orgname, bik, inn, kbk, okato в строку Значение вводим данные получателя платежа (реквизиты садика), для этих полей ставим галочку «Не показывать».

Теперь пользователю на терминале осталось ввести свою фамилию, имя, отчество, адрес.

Конкретизируем для пользователя поле Назначение платежа. Для этого у поля ввода purpose нажмём кнопку Добавить дочерний параметр. Дочерние параметры - это, по сути, разбивка одного параметра на несколько для удобства ввода. В платеже дочерние параметры склеиваются в один родительский. Чтобы у поля ввода можно было добавить дочерние параметры, поле ввода должно иметь тип Составной. В появившемся окне введём Название параметра (вместо new_param) - childname (название параметра задаётся латинскими буквами без пробелов), Заголовок - Введите фамилию и имя ребёнка, Заголовок на чеке - Ребёнок, RegExp - ^[А-Яа-яёЁ- ]{1,55}$, Клавиатура - полная, язык - русский. Ещё раз нажмём кнопку Добавить дочернего провайдера. Заполним данные для провайдера - group, Введите номер группы, Номер группы, ^[А-Яа-яёЁ- \d ]{1,25}$, полная, русский. Таким образом, в поле Назначение платежа будет ФИО ребёнка и номер группы. Пусть поле Назначение платежа должно ещё содержать строку "Родительская плата за детский садик". Сделаем ещё один дочерний параметр - txt, Платёж, Платёж, ^[А-Яа-яёЁ-\ ]{1,100}$, с помощью кнопок со стрелками поднимем его на позицию перед ФИО ребёнка. В поле Значение напишем текст "Родительская плата за детский сад" (без кавычек). Таким образом, в параметре Назначение платежа будет строка вида "Родительская плата за детский сад <фио ребёнка> <номер группы>".
Поле Адрес можно аналогичным образом разбить на несколько дочерних параметров - Город, улица, дом, квартира, а можно оставить как есть - одной строкой. Поле extra предназначено для расширенных реквизитов (какие-то данные, которые хочет видеть организация в отчётах). В нашем случае это поле остаётся без изменений.

Как скрыть поля провайдера:

Если агент хочет, чтобы некоторые поля провайдера не показывались пользователю, необходимо создать субпровайдера не основе выбранного провайдера и у полей ввода, которые не должны показываться клиенту, установить галочку "Не показывать". При этом желательно заполнить у этого параметра поле Значение - это значение возьмётся в случае необходимости (если параметр будет нужен для прохождения платежа в платёжной системе). Если у параметра снять галочку возле поля "Заголовок на чеке", то этот параметр не будет печататься в чеке.

                   Создание местного провайдера

Местные — провайдеры, платежи по которым не проходят в платёжную систему, а расчёт с поставщиком услуг осуществляется агентом самостоятельно. Чтобы создать местного провайдера нажмите кнопку «Создать местного провайдера». Обратите внимание, местного провайдера могут создавать только агенты верхнего уровня.

При создании провайдера все поля заполняются как у системного провайдера (см. Провайдеры), важным отличием является значение поля «Тип проведения». Для местных провайдеров в этом поле надо указать один из трёх вариантов:

• Проводится дилером вручную — платёж попадает в систему и ждёт ручного подтверждения агентом в Журнале оплат;
• Сразу промечается проведённым — платёж попадает на сервер и сразу помечается как проведённый;
• Сразу помечается ошибочным — платёж попадает на сервер и сразу помечается ошибочным. Важно понимать, что платёж помечается ошибочным сразу, а это означает, что если платёж пришёл от субагента, верхний агент это платёж у себя просто не увидит.

Чтобы добавить поле ввода, нажмите либо кнопку «Добавить параметр» и заполните все поля параметра (см. раздел Провайдер), либо выберите в выпадающем списке справа нужный шаблон и нажмите кнопку «Добавить шаблон».

Чтобы местный провайдер стал доступным для проведения, нужно, чтобы у агента был создан счёт в платёжную систему Местные.

               Шаблоны параметров

Шаблоны — предварительно заполненые поля для стандартных реквизитов. При создании местного провайдера вместо при добавлении поля надо обязательно заполнить значение маски, регулярного выражения и т.п. Если вместо добавления поля выбрать наиболее подходящий шаблон и добавить шаблон, то в провайдера добавится параметр с уже заполненными значениями всех полей. При необходимости эти поля можно просто подкорректировать.

Внимание: имя поля должно быть уникальным для каждого параметра провайдера.