Перепродажа SSL-сертификатов через BILLmanager

В BILLmanager доступна автоматизация перепродажи SSL-сертификатов.

Возможности интеграции

Требования для перепродажи SSL

Для настройки интеграции необходимы актуальные версии панели ispmanager 6 и платформы BILLmanager.

Создание и настройка обработчика услуг SSL

Для настройки интеграции начните с подключения обработчика услуг в BILLmanager:

1. Авторизуйтесь в BILLmanager под учетной записью администратора по адресу https://ВАШ_ДОМЕН/billmgr.
2. Перейдите в раздел Интеграция → Обработчики услуг.
3. На панели инструментов нажмите Создать.
4. На шаге Тип продукта выберите SSL сертификат.
5. На шаге Модуль обработки выберите Ispmanager (SSL).
6. На шаге Настройка интеграции укажите данные:

   • URL ispmanager — адрес биллинг-системы ispmanager, которая будет предоставлять SSL-сертификаты: 

     для клиентов РФ	для клиентов других стран
     https://api.ispmanager.com	https://api-eu.ispmanager.com

   • Имя пользователя — логин учетной записи, из-под которой будут совершаться покупки в личном кабинете ispmanager

   • Пароль — пароль учетной записи, из-под которой будут совершаться покупки в личном кабинете ispmanager

     Если в личном кабинете ispmanager для учетной записи установлена 2FA, в BILLmanager появится ошибка при подключении обработчика. Отключите 2FA или используйте другую учетную запись для интеграции.

7. Нажмите Далее.
8. На шаге Параметры обработчика услуг укажите данные:

   • Дата-центр — комплекс серверов, которые подключаются со стороны BILLmanager

     Как создать дата-центр

     1. Перейдите в раздел Интеграция → Дата-центры.
     2. На панели инструментов нажмите Создать.
     3. В настройках введите данные для создания дата-центра:
        • Наименование — название дата-центра в интерфейсе с конкретной локализацией
        • Внешний идентификатор дата-центра — служебный код дата-центра из сторонней системы
        • Порядок сортировки — приоритет дата-центра среди других подключенных в BILLmanager. Для сортировки выбирается дата-центр с наименьшим приоритетом. Используются натуральные целые числа от 1 до N
     4. Нажмите Ok.
   • Наименование — название обработчика в интерфейсе с конкретной локализацией

   • Ответственный — ответственный отдел в BILLmanager, на который будут назначаться задачи от обработчика. Пример: «Технический отдел», «Отдел продаж» или «Служба обработки услуг». Задачи будут видны только выбранному отделу

     Как создать ответственный отдел

     1. Перейдите в раздел Провайдер → Отделы.
     2. На панели инструментов нажмите Создать.
     3. В настройках введите данные для создания отдела:
        • Основное:
          • Наименование — название отдела в интерфейсе с конкретной локализацией
          • График — рабочие часы отдела, в которые учитывается регламент ответа отдела. Для выбора графика создайте его в разделе Провайдер → Графики работы
          • Доступен в центре поддержки — установите галочку для отображения отдела при создании запроса клиентом в техническую поддержку. Позволяет заполнить Настройки отдела технической поддержки
          • Локализация задач — локализация, в которой будут формироваться уведомления в задачах, назначенных на отдел. Дополнительные языки доступны, если были добавлены в разделе Настройки → Локализации
        • Настройки отдела технической поддержки:
          • Показывать клиенту провайдеров — провайдеры, клиентам которых будет доступен выбор отдела при создании запроса
          • Глава отдела — главный сотрудник отдела технической поддержки. Для выбора сотрудника создайте его в разделе Провайдер → Сотрудники
          • Описание категории запроса — краткое описание отдела и задач, которые будут решаться. Отображается клиенту при выборе отдела во время создания запроса
          • Сортировка — приоритет отдела среди других подключенных в BILLmanager. Для сортировки выбирается отдел с наименьшим приоритетом. Используются натуральные целые числа от 1 до N
   • Сортировка — приоритет обработчика среди других подключенных в BILLmanager. Для обработки услуги выбирается обработчик с наименьшим приоритетом. Используются натуральные целые числа от 1 до N
   • Минимальный баланс обработчика — минимальный баланс обработчика для успешного продления услуги. Требуется аккаунт в ispmanager с пополненным балансом. Значения указываются в валюте лицевого счета личного кабинета ispmanager. То есть валюты должны быть одинаковыми для продающей и перепродающей платформ
9. Нажмите Завершить. 

После создания обработчика услуг (центра выдачи сертификации) импортируйте необходимые тарифные планы.

Управление тарифами SSL

Чтобы клиентам был доступен заказ SSL-сертификата, импортируйте, настройте и включите тариф.

Импорт тарифа

1. Авторизуйтесь в BILLmanager под учетной записью администратора по адресу https://ВАШ_ДОМЕН/billmgr.
2. Перейдите в раздел Продукты → Тарифные планы.
3. Нажмите Импорт на панели инструментов.
4. В настройках выберите созданный ранее модуль обработки.
5. Нажмите Далее.
6. Последовательно импортируйте необходимые тарифные планы:
   • Тип продукта — автоматически выбран SSL сертификат
   • Тарифный план — ID тарифа SSL-сертификата из биллинг-системы ispmanager

   • Провайдер — выберите провайдера для импорта тарифного плана. Это позволит брендировать услуги продажи, разделять продажи сертификатов, клиентов и вести расчеты в разной валюте

     Как создать провайдера

     1. Перейдите в раздел Провайдер → Провайдеры.
     2. На панели инструментов нажмите Создать.
     3. Введите данные для создания провайдера:
        • Основные настройки:
          • Наименование — название провайдера
          • Загрузить иконку 16х16 — изображение, которое будет использоваться в списке доступных провайдеров. Максимальный размер: 16х16 px
          • Email для отправки уведомлений — почта, с которой будут отправляться уведомления клиентам. Для успешной отправки уведомлений настройте внешний почтовый сервер и шлюз для исходящих писем
          • Email поддержки — почта, с которой будут отправляться уведомления: об активации пользователя, плательщика и о восстановлении пароля. Оставьте пустым, чтобы уведомления отправлялись с Email для отправки уведомлений
          • URL сайта — адрес вашего сайта
          • URL биллинга — публичный адрес с доступом к BILLmanager
          • URL справки — адрес страницы, которая будет открываться для клиента из раздела Справка → Вызов справки

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

            Если в системе есть активные платежи или расходы, смена валюты не произойдет.

          • Страна по умолчанию — страна и локализация интерфейса по умолчанию
        • Способы регистрации и авторизации:

          • По номеру телефона — включите авторизацию по номеру телефона. При регистрации или входе в BILLmanager будет запрошен код подтверждения через SMS-сообщение. Если номер телефона не указан или не подтвержден, то потребуется авторизация через логин и пароль

            • Количество попыток ввода кода — лимит на количество попыток неверно введенного кода. По достижении лимита потребуется новый код подтверждения.
            • Количество попыток получения кода — лимит на количество отправлений нового кода подтверждения на номер телефона. По достижении лимита потребуется время перед новой попыткой авторизации
            Подробнее о способах регистрации и авторизации сотрудников — в официальной документации ISPsystem.

7. Нажмите Завершить. 

После импорта в списке появится новый тариф с выбранным SSL-сертификатом. Для него автоматически установится цена на период «год». Это позволит сразу включить тариф и начать перепродажу сертификатов. 

При необходимости донастройте тариф.

Настройка тарифа

1. Авторизуйтесь в BILLmanager под учетной записью администратора по адресу https://ВАШ_ДОМЕН/billmgr.
2. Перейдите в раздел Продукты → Тарифные планы.
3. Выберите и отредактируйте существующий тариф.

4. Установите необходимые настройки в блоках:

   Основное

   • Наименование — название тарифа в интерфейсе с конкретной локализацией. Дополнительные языки доступны, если были добавлены в разделе Настройки → Локализации
   • Центр выдачи сертификатов — выберите ранее созданный обработчик услуг
   • Ежедневно снимать оплату — ежедневное списание средств за использование сертификата. Если опция включена, доступны параметры: 

     • Расчёт стоимости дня от периода заказа — сумма оплаты при ежедневном списании не будет зависеть от количества дней в месяце. Стоимость дня будет рассчитана из количества дней в периоде заказа. По умолчанию не установлено

       Пример

       В январе клиент заказывает услугу на «месяц». Сумма ежедневного списания — 10 рублей. Без включения опции сумма списания составит 310 рублей за 31 день в месяце. При включении опции стоимость будет рассчитана из количества дней в установленном периоде услуги — 30 дней. Так, клиент заплатит 300 рублей за 30 дней использования SSL. 

     • Разрешить клиенту запуск/остановку — клиент получит права на включение и отключение заказанного сертификата. По умолчанию не установлено
       • Списывать средства при остановке — если опция включена, клиент оплачивает время простоя в работе сертификата. Если опция выключена, клиенту будут возвращены средства за время простоя в работе сертификата. По умолчанию не установлено
     • Календарное списание средств — срок действия услуги будет выровнен по календарному месяцу. Недоступно при использовании опции Ежедневно снимать оплату. По умолчанию не установлено

       • Переходный день — если клиент заказывает услугу в день месяца до переходного дня, то срок действия услуги будет рассчитан до конца текущего месяца. Если в переходный день или позже — до конца следующего месяца. Вместе с периодом действия сертификата будет изменена стоимость заказа или продления. Значение по умолчанию: 15

         Пример

         Для переходного дня установлено значение 15. SSL-сертификат, который клиент заказал 12 июля, будет активен до 1 августа. SSL-сертификат, который клиент заказал 17 июля, будет активен до 1 сентября.

     • Быстрый заказ — заказ сертификата без указания параметров. Позволяет отложить настройку до заказа сертификата. По умолчанию не установлено
     • Шаблон уведомления об открытии услуги — шаблон уведомления с инструкцией по работе с сертификатом. Уведомление отправляется на почту клиенту после открытия услуги и дублируется в BILLmanager. Доступно, если был добавлен шаблон в разделе Настройки → Шаблоны сообщений
     • Условия предоставления услуг — шаблон лицензионного соглашения, с которым клиенту необходимо согласиться при заказе сертификата. Доступно, если был добавлен шаблон в разделе Настройки → Шаблоны документов
   Дополнительные настройки

   • Тип сертификата — сертификат, выбранный из списка SSL-сертификатов в ispmanager
   Цены за периоды

   • За год — стоимость сертификата или его продления на год
   • Выключить период заказа "год" — запрет на заказ сертификата на год
   • Цена установки — снятие дополнительной суммы при покупке сертификата
   • Продление по специальной цене — отдельная стоимость продления сертификата на выбранный период. Если опция включена, то доступно:
     • Продление на год — стоимость продления сертификата на год
        
   Политики

   • Разрешить группам клиентов — группы клиентов, которым доступны заказ и смена тарифа

     Как создать группу клиентов

     1. Перейдите в раздел Клиенты → Группы клиентов.
     2. На панели инструментов нажмите Создать.
     3. Установите необходимые настройки:
        • Наименование — название группы клиентов
        • Разрешить остановку/включение услуг — установите галочку, чтобы разрешить клиентам группы останавливать и возобновлять работу сертификатов
        • Разрешить удаление услуг — установите галочку, чтобы разрешить клиентам группы удалять SSL-сертификаты
        • Игнорировать количество услуг на аккаунт — установите галочку, чтобы отменить политику Количество услуг доступных для заказа в настройках тарифа
     4. Нажмите Ok.
   • Запретить группам клиентов — группы клиентов, которым недоступны заказ и смена тарифа
   • Минимальный период заказа — минимальный срок использования сертификата после заказа. Если опция используется, то доступна:
     • Длина минимального периода — количество дней или месяцев в минимальном периоде заказа
   • Количество услуг доступных для заказа — количество сертификатов, доступных для заказа 1 клиенту. Если клиент достиг лимита, заказ сертификата по тарифу будет недоступен
   • Одновременный заказ услуг — клиенту доступно параллельное добавление нескольких услуг в корзину. Если опция используется, то доступно:
     • Максимальное количество услуг — количество параллельно добавленных услуг в корзину. Большое количество параллельно заказываемых услуг может повлиять на работу BILLmanager
   • Штраф за просрочку продления — взимание штрафа за позднее продление сертификата. Штраф взимается во время продления сертификата клиентом. Доступны значения:
     • Без штрафа — позднее продление сертификата не облагается штрафом
     • Фиксированная сумма — к стоимости продления добавляется фиксированная сумма штрафа

     • Процент от стоимости периода просрочки — к стоимости продления добавляется процент от стоимости периода просрочки

       Пример

       За позднее продление сертификата устанавливается штраф 50%. 

       Срок действия услуги истек 1 сентября, а продление произойдет 5 сентября. 
       Для вычисления суммы штрафа система рассчитает стоимость услуги за каждый день (даже если сертификат приобретался на год). Допустим, в день начисляется штраф 10 рублей. После, будет подсчитана стоимость просрочки: 

       5 дней х 10 рублей = 50 рублей. 

       Итоговая сумма штрафа: 25 рублей, так как процент штрафа — 50%.

     • Продление с даты остановки — срок действия услуги будет рассчитан не с даты ее продления, а с даты остановки услуги. То есть штраф взимается не денежными средствами, а сроком действия услуги

       Пример

       Срок действия услуги истек 3 августа, а продление происходит только 15. После продления сертификат активируется не до 15 сентября, а до 3. 

   • Период автоудаления — резерв дней, заданный для автоматического удаления непродленных сертификатов. Оставьте пустым, чтобы использовался период автоудаления из настроек типа услуги («SSL сертификат»). Если период автоудаления не указан и в типе услуги, то просроченные услуги не будут удаляться
   • Выключение услуг по выходным — переопределение политики остановки работы сертификата. Доступны значения:
     • Использовать настройки типа продукт — тариф будет использовать политики из настроек соответствующего типа продукта
     • Останавливать услуги — услуги тарифа будут останавливаться в выходные дни (субботу, воскресенье) при отсутствии у клиента средств на оплату продления
     • Не останавливать услуги — услуги данного тарифа не будут останавливаться в выходные дни (субботу, воскресенье) в случае отсутствия у клиентов средств на их продление. При наличии штрафа за продление остановленной услуги средства за дополнительные дни работы будут списаны со счета клиента при оплате продления услуги
   • Политика смены тарифа — политика расчетов используется при смене тарифа услуги. Доступны значения:
     • Изменение периода действия — при смене тарифа будет пересчитан срок действия услуги в сторону увеличения при переходе на более дешевый тариф, либо в сторону уменьшения при переходе на более дорогой тариф
     • Доплата/возврат средств — при переходе на более дорогой тариф потребуется доплата разницы в стоимости тарифов за оставшийся период действия услуги. При переходе на более дешевый тариф клиенту будет возвращена разница в стоимости за оставшийся срок действия услуги
     • Смена тарифа запрещена — переход на другой тариф будет невозможен
     • Только доплата, при понижении нет возврата — при переходе на более дорогой тариф потребуется доплата разницы в стоимости тарифов за оставшийся период действия услуги. При переходе на более дешевый — возврата средств не будет, но клиенту будет доступен предыдущий тариф без доплаты
     • Полная оплата нового тарифа — с клиента будет снята полная стоимость нового тарифа, срок действия услуги будет рассчитан по выбранному периоду заказа с даты смены тарифа
       • Продление с — политика продления услуги на новый тарифный план. Доступны значения:
         • текущей даты — услуга продлевается с текущей даты
         • даты окончания срока действия услуги — услуга продлевается с даты окончания срока действия
   • Политика заказа доп.ресурсов — способ расчета стоимости дополнительных ресурсов при заказе сертификата в период его действия. Для работы опции создайте и настройте дополнительные ресурсы, в разделе Продукты → Тарифные планы → выберите тарифный план → Конфиг. Доступны значения:

     • Стоимость до срока действия услуги — стоимость дополнений рассчитывается до даты окончания действия сертификата

       Пример

       Услуга действует до 30 ноября. Заказ дополнительных ресурсов для сертификата происходит 15 ноября. Стоимость дополнений будет рассчитана только за 15 дней.

     • Полная стоимость за период — полная стоимость дополнений, независимо от даты окончания действия сертификата. Для дополнения выбирается последний оплаченный или продленный период действия сертификата

       Примеры

       Пример 1:

       Для услуги 10 ноября заказываются дополнительные ресурсы. Ранее сертификат приобретался на месяц до 20 ноября. Дополнения будут активны лишь 10 дней, но будут оплачены по их полной стоимости. 

       Пример 2:

       Клиент пользовался услугой три месяца и каждый раз продлевал эту услугу на месяц. Увидев, что срок действия услуги вновь подошел к концу, клиент продлил услугу на период «три месяца». После этого он пользовался услугой 2 месяца, после чего решил заказать дополнительные ресурсы. Если используется Полная стоимость за период, то стоимость дополнений будет оплачена на «три месяца». Даже если до конца действия услуги остался 1 месяц, это не повлияет на стоимость дополнений. 

   • Политика отказа от доп.ресурсов — отказ от дополнений к тарифному плану. Возможен возврат средств за оставшийся срок действия сертификата или его удаление без компенсации
   • Заметки — текстовые заметки к тарифу. Видны только сотрудникам компании
   Настройка заказа услуги

   • Сортировка — сортировка тарифов из списка по приоритету. Для обработки выбирается тариф с наименьшим приоритетом. Используются натуральные целые числа от 1 до N. Если значения тарифов совпадают, то они сортируются в алфавитном порядке
   • Загрузить иконку — изображение для конкретного тарифа в интерфейсе BILLmanager
   • Отображать иконки ресурсов — правило отображения иконок дополнений к тарифному плану
   • Описание тарифа — описание тарифа в интерфейсе BILLmanager с привязкой к активной локализации. Доступна разметка Markdown
   • Метки — список значений, необходимых для фильтрации тарифов клиентами. Значения записываются с новой строки
5. Нажмите Ok.

После настройки включите тариф.

Включение тарифа

1. Авторизуйтесь в BILLmanager под учетной записью администратора по адресу https://ВАШ_ДОМЕН/billmgr.
2. Перейдите в раздел Продукты → Тарифные планы.
3. В списке нажмите на импортированный тариф.
4. Нажмите Вкл. на панели инструментов.
5. Подтвердите включение тарифа.

При необходимости повторите действия для всех созданных тарифов.