Для партнеров

/
/
/
Перепродажа лицензий ispmanager через HostBill

Перепродажа лицензий ispmanager через HostBill

В HostBill реализован модуль ispmanager reselling, который автоматизирует перепродажу лицензий ispmanager.

Возможности модуля

ВозможностьПартнерКлиент
Заказ
Продление
Остановка 
Смена тарифа
Смена названия и IP лицензии
Генерация нового ключа лицензии✅ 
Смена расчетного периода
Просмотр истории изменений для лицензии

Требования модуля

Модуль ispmanager reselling доступен бесплатно.

Установка модуля

  1. Скачайте модуль по ссылке.
  2. Авторизуйтесь в HostBill под учетной записью администратора по адресу https://ВАШ_ДОМЕН/admin или по SSH.
  3. Распакуйте архив модуля в корневую директорию HostBill.

Активация модуля

  1. Авторизуйтесь в HostBill под учетной записью администратора по адресу https://ВАШ_ДОМЕН/admin.
  2. Перейдите в раздел Settings → Modules → Hosting Modules.
  3. На вкладке Inactive найдите модуль ispmanager_reselling и нажмите Activate.

Настройка подключения к ispmanager

  1. Авторизуйтесь в HostBill под учетной записью администратора по адресу https://ВАШ_ДОМЕН/admin.
  2. Перейдите в раздел SettingsApps ConnectionsAdd new Connection.

  3. В поле Application выберите ispmanager_reselling.

  4. Заполните параметры подключения. Обязательные поля отмечены звездочками.

    • Name* — произвольное название, под которым подключение сохранится в HostBill. Название будет доступно для просмотра только администратору HostBill.
    • Hostname* — доменное имя личного кабинета ispmanager — my.ispmanager.ru или eu.ispmanager.com.
    • Username* — имя пользователя в личном кабинете ispmanager.
    • Password* — пароль пользователя в личном кабинете ispmanager.

    Оставьте без изменений.

  5. Нажмите Test Configuration для проверки подключения. Если подключение успешно установлено, появится уведомление со статусом Success.
  6. Нажмите Add New Connection.

Создание услуг

Создание услуг доступно после создания хотя бы одной страницы заказа.

Страницы заказа

Страницы заказа позволяют сгруппировать услуги в клиентской зоне HostBill.

Для создания страницы заказа:

  1. Авторизуйтесь в HostBill под учетной записью администратора по адресу https://ВАШ_ДОМЕН/admin.
  2. Перейдите в Settings → Products & Services.
  3. Нажмите Add new order page.
  4. Заполните поля. Обязательные поля отмечены звездочками.
    • Name* — название страницы заказа, которое будет отображаться в клиентской зоне HostBill, например «Лицензии ispmanager».
    • Order page URL — нажмите Edit, чтобы отредактировать автоматически сгенерированный URL страницы заказа.
    • This category will contain* — выберите Products.
    • Order type* — выберите Other Services.
    • Cart Template — выберите шаблон корзины из стандартных или нажмите Here для покупки платного шаблона. Для предварительного просмотра нажмите Preview.

    • Description — описание услуг, которые будут размещены на странице заказа, для клиентской зоны.
    • Advanced : Order scenario — выберите сценарий заказа — последовательность шагов, которые должен выполнить клиент при заказе услуг на странице заказа. Подробнее о сценариях заказа — в официальной документации HostBill.
  5. Нажмите Add new order page.

Услуги

Вы можете создать по отдельной услуге для каждого тарифа ispmanager или одну общую с возможностью выбора тарифа из списка. Второй вариант особенно удобен, если лицензия продается вместе с услугой VPS/VDS-хостинга, т.к. позволяет создать всего один пакет услуг для каждого тарифа хостинга вместо трех — по одному на каждый платный тариф ispmanager.

  1. Авторизуйтесь в HostBill под учетной записью администратора по адресу https://ВАШ_ДОМЕН/admin.
  2. Перейдите в Settings → Products & Services.
  3. Выберите созданную ранее страницу заказа.
  4. Нажмите:
    • Add new product — чтобы создать услугу вручную
    • Import products — чтобы импортировать существующую услугу, используя файл в формате JSON
  5. Заполните или отредактируйте поля на вкладках. Обязательные поля отмечены звездочками.

    General — основные настройки
    • Product Name* — название услуги.
    • Product Code — внутренний код услуги, который виден только администратору HostBill.
    • Product Description — нажмите Add description, чтобы добавить описание услуги, которое будет отображаться в карточке услуги в клиентской зоне HostBill.
    • Price* — тип оплаты:

      Услуга будет доступна бесплатно.

      Для услуги будет доступна единовременная оплата.

      • Price — стоимость услуги
      • Setup Fee — единовременный платеж за открытие услуги

      Услуга будет доступна по подписке.

      • Выберите платежный период*.

        Используйте расчетные периоды «ежемесячно» и «раз в год». При выборе других периодов заказ лицензии завершится ошибкой.

        • Monthly — ежемесячно
        • Annually — раз в год
      • Price — стоимость услуги
      • Setup Fee — единовременный платеж за открытие услуги
      • Upgrade Fee — единовременный платеж за апргрейд услуги
      • Billing Type* — выберите форму оплаты:
        • Pre-paid — предоплата
        • Post-paid — постоплата
        • Hybrid — гибрид: для покупки услуг действует предоплата, для апгрейдов услуг — постоплата

      Для каждого платежного периода и стоимости создайте отдельную цену, нажав Add pricing option.

      Не поддерживается для лицензий ispmanager.

    • Tax — налог, который будет добавлен к стоимости услуги. Для включения налога активируйте опцию Yes и выберите налоговую группу из списка Tax Group.
    • Tags — теги для обозначения услуги, которые видны только администратору HostBill.
    Connect with App — настройки подключения к ispmanager
    1. App* — выберите из списка ispmanager_reselling.
    2. App Connection* — чтобы при заказе услуги лицензия для клиента была заказана в ispmanager автоматически, выберите созданное ранее подключение.
    3. Get values from server* — нажмите, чтобы импортировать тарифы из ispmanager.
    4. Product ID* — выберите нужный тариф из списка.
    Automation — автоматические действия с заказами клиента
    • Auto-create — заказ лицензии в ispmanager:
      • When the order is placed — при создании заказа в HostBill
      • When the first payment is received — после получения оплаты
      • After payment received, process by cron — с помощью периодического задания после получения оплаты
    • Automatic Upgrades — повышение/понижение тарифа:
      • When the order is placed — при создании заказа на повышение/понижение
      • After receiving payment — после получения оплаты
    • Automatic Renew — продление действия лицензии:
      • Renew account automatically after receiving payment — после получения оплаты
      • When renewal invoice is issued — после выставления счета на оплату
    • Automatic Suspension — приостановка лицензии:
      • Autosuspend account after X days past due date — приостанавливать лицензию через X дней после истечения срока оплаты
    • Automatic Unsuspension — возобновление лицензии:
      • Unsuspend account automatically after receiving due payment — действие лицензии будет возобновлено после получения оплаты
    • Automatic Termination — отключение лицензии:
      • Automatically terminate account after X days past due date — отключать лицензию через X дней после истечения срока оплаты
      • Automatically cancel related unpaid invoices — отменять неоплаченные счета по услуге
    • Auto-cancel unpaid orders — отменять неоплаченные заказы:
      • Cancel unpaid orders X days since creation — отменять неоплаченные заказы через X дней после создания
    • Generate invoices — выставление счетов на оплату:
      • X days before the due date for product/service — за X дней до истечения срока оплаты услуги
    • Advanced due date settings — расширенные настройки срока оплаты:
      • Invoice is expected to be paid X days before the due date for service/product — счет должен быть оплачен за X дней до истечения срока оплаты услуги
      • First invoice due date set to X days after order — первый срок оплаты наступает через X дней после создания заказа
      • Move due date X days into future for recurring invoices — перенести срок оплаты на X дней вперед для периодических счетов
    • Adjust Initial Period — скорректировать начало срока действия лицензии, если заказ был оплачен с задержкой, чтобы клиент получал услугу на полный срок
    Messages — уведомления для клиента и администратора HostBill

    Для настройки уведомления нажмите Change и выберите шаблон уведомления из списка.

    Создание шаблонов уведомлений доступно в разделе Settings → Message Templates.

    • Client email notifications — email-уведомления для клиентов:
      • Initial Order — о создании заказа
      • Account created email — о заказе лицензии в ispmanager 

        Пример

        Чтобы клиенту при покупке лицензии были отправлены название и ключ лицензии и адрес панели управления:

        1. Создайте соответствующие поля на вкладке Components → Forms.
        2. Используйте в шаблоне приветственного письма переменные:
        • {$service.forms.licname.value} — название лицензии
        • {$service.forms.lickey.value} — ключ лицензии
        • https://{$service.forms.ip.value}:1500 — адрес панели ispmanager
      • Account suspended email — о приостановке лицензии в ispmanager
      • Account unsuspended email — о возобновлении лицензии в ispmanager
      • Account terminated email — об отключении лицензии в ispmanager
      • Reminder of the service expiration — напоминание об истечении срока действия услуги
      • Client: Success upgrade — об успешном повышении/понижении тарифа
    • Admin email notifications — email-уведомления для администратора:
      • Staff: Success upgrade — об успешном повышении/понижении тарифа
      • Staff: Failed upgrade — о неудачной попытке повышения/понижения тарифа
    • Client mobile notifications — мобильные уведомления для клиентов:
      • Account created email — о заказе лицензии в ispmanager
    Components — дополнительные услуги, доступные при заказе лицензий

    Формы позволяют добавить собственные поля для услуги, например поле для IP-адреса, названия и ключа лицензии. Для добавления этих полей:

    1. Нажмите Add new form field.
    2. Выберите тип поля Text input.
    3. Нажмите Create new field.
    4. Заполните поля. Обязательные поля отмечены звездочкой.
      • Вкладка Basic Settings:

        • Field name* — название поля, под которым оно будет отображаться на форме заказа в клиентской зоне HostBill, например «Название лицензии»
        • Description — описание поля для клиента HostBill
        • Admin only description — описание поля для администратора HostBill
        • Form group — оставьте без изменений

        Прежде чем перейти к настройке остальных полей, нажмите Save Changes.

      • Вкладка Input settings — настройки вводимого в поле значения:

        • Unique — установите галочку, чтобы разрешить только уникальные значения
        • Regular expression — введите регулярное выражение для проверки введенного значения

        Остальные поля оставьте без изменений.

      • Вкладка Advanced:
        • Variable name* — укажите:
          • ip — для IP-адреса
          • licname — для названия лицензии
          • lickey — для ключа лицензии
        • Admin only — оставьте без изменений.
        • Required field — установите галочку, чтобы сделать поле обязательным для заполнения.
        • Client edit — установите галочку, чтобы разрешить клиентам редактировать поле в своем личном кабинете HostBill после заказа.
        • Show in cart* — установите галочку для полей названия и IP-адреса, чтобы они отображались на форме заказа в клиентской зоне HostBill.
        • Hide if empty — установите галочку, чтобы скрывать поле в личном кабинете клиента в HostBill, если оно не было заполнено.
        • Searchable — оставьте без изменений.
        • Show in Invoice — оставьте без изменений.
        • CSS Class — CSS-класс, который будет применен к полю.
        • Category Name — оставьте без изменений.
      • Вкладка Admin Access — настройка доступа к полю в административной зоне HostBill:
        • All staff members — доступ будет у всех администраторов HostBill
        • Selected staff members — доступ будет у выбранных администраторов HostBill
    5. Нажмите Save Changes

    Подробнее о настройке форм — в официальной документации HostBill.

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

    Для добавления аддона нажмите Assign addon(s), выберите дополнение из списка Addon и нажмите Add.

    Создание аддонов доступно в разделе HostBill Settings → Product Addons.

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

    • Hostname — имя хоста:
      • Require hostname for this product — установите галочку, чтобы поле Hostname было обязательным при заказе клиентом лицензии
      • Validation — проверка указанного клиентом имени хоста:
        • Do not validate provided hostname — не проверять
        • Check if provided hostname is valid DNS name — проверять, что указанное имя является валидным DNS-именем
        • Check if provided hostname is valid domain name — проверять, что указанное имя является валидным доменным именем
        • Check if provided hostname is valid FQDN — проверять, что указанное имя является валидным полным доменным именем (FQDN)
    • Auto-generate hostname — установите галочку Enable, чтобы генерировать имя хоста автоматически
      • Auto-hostname pattern — шаблон для генерации имени хоста
    • Enable domain options — нажмите Yes для настройки доменов при заказе лицензии:
      • Offer following domain registration/transfer options — выберите существующую страницу заказа домена из списка либо нажмите Create new domain order page, чтобы создать новую
      • Allow using own domain — разрешить клиенту использование своего домена
      • Only if domain was/will be registered with us — разрешить клиенту использование своего домена, только если он зарегистрирован/будет зарегистрирован у вас
      • Offer subdomain — установите галочку, чтобы предоставлять клиенту поддомены, и введите в поле домен, в котором будут создаваться поддомены

    Добавьте к лицензии другую услугу, которая будет доступна за отдельную плату и оформлена отдельным заказом. Для добавления услуги нажмите Enable sub-products и выберите услугу из списка.

    Client Functions — действия с заказанной услугой, доступные клиенту в личном кабинете HostBill

    Чтобы разрешить действие, нажмите Enable рядом с ним. Чтобы разрешить все действия, нажмите Enable all.

    Разрешенные действия будут доступны для активных заказов клиента в его личном кабинете HostBill в разделе Services:

    Возможные действия:

    • License details — просматривать и изменять информацию о лицензии: название, ключ и IP-адрес.
    • Change Billing Cycleизменять расчетный период для услуги. Смена доступна, если для услуги активировано несколько расчетных периодов.
    • Change Label — менять ярлык, который отображается рядом с заказанной услугой хостинга.
    • Change Ownership — передавать владение заказанной услуги лицензии другому пользователю HostBill.
    • Contracts — просматривать соглашения, принятые при заказе услуги лицензии. Просмотр доступен, если для услуги настроено принятие соглашения.
    • Domain Logs — неприменимо.
    • Downloads — неприменимо.
    • Edit Forms — просматривать и редактировать ответы в формах, добавленных на вкладке Component → Forms.
    • Graphs — неприменимо.
    • Login Details — неприменимо.
    • Logs — просматривать журнал действий с услугой, таких как активация, продление, остановка.
    • Manage IP — неприменимо.
    • Manual Service Renew — продлевать услугу досрочно. 

      Подробнее

      При ручном продлении из личного кабинета клиента в HostBill услуга продлится только в HostBill. Для продления в ispmanager администратор HostBill должен будет нажать Renewal в карточке услуги:

    • Metered Billing Details — неприменимо.
    • Related Emails — просматривать письма, связанные с услугой. 

      Подробнее

      Просмотр доступен, если для шаблонов писем, отправляемых клиенту, настроено логирование:

    • Related Invoices — просматривать счета по услуге.
    • Related Services — просматривать связанные услуги. Связанные услуги настраиваются на вкладке Component → Forms → Custom/Extra field types → Related Services.
    • Reverse DNS — неприменимо.
    • Service Auto Renewal — просматривать дату автоматического продления услуги, настраивать продление и метод оплаты.
    • Service notes — просматривать заметки к услуге, оставленные для клиента администратором HostBill.
    • Status Updates — неприменимо.
    • Update EPP code — неприменимо.
    • New Direct link — просматривать прямую ссылку на сервер с панелью ispmanager, если панель заказана вместе с сервером. Для настройки ссылки нажмите Edit:
    Other Settings — настройки отмен, повышения/понижения тарифа и др.
    • Limit Per Customer — максимальное количество заказов услуги, доступное одному клиенту. Для применения ограничения нажмите Yes и укажите количество услуг в поле One customer is allowed to order X products of this type.
    • Allow Cancellations — разрешить клиенту отменять заказ с услугой:
      • Yes, client can cancel service using this product — клиент сможет отменить заказ
      • Yes, client can cancel service after/for X days since account creation — клиент сможет отменить заказ в течение/через X дней после создания аккаунта
      • No, client cannot cancel service with this product — клиент не сможет отменить заказ
    • Allowed Cancellation Types — допустимые типы отмен:
      • Immediate — немедленная отмена
      • End of billing period — отмена в конце платежного периода
    • Pro-rate cancellations — отмена с перерасчетом стоимости услуги
      • No — запретить
      • Yes, for pre-paid services (for immediate cancelations) — разрешить для услуги с предоплатой (немедленная отмена)
      • Yes, for post-paid services — разрешить для услуги с постоплатой
    • Full Month Billing — биллинговая модель, при которой клиент оплачивает полную стоимость месяца независимо от даты активации услуги. Следующие платежи происходят в начала каждого месяца.
      • Enabled — включить
      • Disabled — выключить
    • Contract template — шаблон пользовательского соглашения. Выберите соглашение из списка или нажмите See all contract templates, чтобы настроить соглашения.
    • Clientarea Layout — расположение меню действий в клиентской зоне HostBill:
      • Left menu — слева
      • Right menu — справа
      • Top menu — сверху
    • Custom username — автоматическая генерация имени пользователя. Для настройки нажмите Enable и укажите шаблон имени в поле Username generation pattern.
    • Starting price calculation method — стоимость услуги, которая будет отображаться в клиентской зоне HostBill, если для услуги настроены дополнения на вкладке Components:
      • Calculate using lowest possible component prices — будет указана минимально возможная стоимость
      • Calculate using default components value — стоимость будет указана с учетом стоимости дополнений по умолчанию
    • Upgrades — повышения и понижения тарифов
      • Available Upgrades — выберите услуги, на которые клиент сможет перейти с текущей
      • Upgrade pro-rata — смена тарифа с перерасчетом стоимости услуги
        • Seconds — пересчитать с учетом количества секунд до даты следующего платежа
        • Hours — пересчитать с учетом количества часов до даты следующего платежа
        • Days — пересчитать с учетом количества дней до даты следующего платежа
      • Queue Pro-rata Charges — для услуг с предоплатой ставить пересчитанные платежи в очередь:
        • Disabled — выставлять счет за прошедший период сразу
        • Enabled — ставить счет за прошедший период в очередь
      • Credit on Downgrade — начислять разницу на счет клиента в HostBill при переходе на менее дорогой тариф
        • Default, use system billing settings — использовать настройки биллинга по умолчанию
        • No, do not credit customer pro-rated amount on package downgrade — не начислять разницу при понижении
        • Yes, credit customer pro-rated amount on package downgrade — начислять разницу при понижении
        • Yes, credit customer pro-rated amount on package downgrade, only after client doesn't have unpaid invoices (credit downgrade queue) — начислять разницу при понижении только после того, как клиент оплатит все счета (ставить начисление в очередь)
      • Credit note on Downgrade — создавать кредитную записку при понижении
        • Default, use system billing settings — использовать настройки биллинга по умолчанию
        • No, do not issue credit notes on downgrades — не создавать
        • Yes, issue credit notes on downgrades — создавать
      • Out-of-stock Upgrade — переход на текущую услугу, если ее нет в наличии
        • No, prevent upgrades to this product when it is out of stock — не разрешать
        • Yes, allow upgrades to this product even when it is out of stock — разрешать
  6. Нажмите Save Changes.
  7. Для каждого тарифа ispmanager создайте отдельную услугу.
  1. Авторизуйтесь в HostBill под учетной записью администратора по адресу https://ВАШ_ДОМЕН/admin.
  2. Перейдите в Settings → Products & Services.
  3. Выберите созданную ранее страницу заказа.
  4. Нажмите:
    • Add new product — чтобы создать услугу вручную
    • Import products — чтобы импортировать существующую услугу, используя файл в формате JSON
  5. Заполните или отредактируйте поля на вкладках. Обязательные поля отмечены звездочками.

    General — основные настройки
    • Product Name* — название услуги.
    • Product Code — внутренний код услуги, который виден только администратору HostBill.
    • Product Description — нажмите Add description, чтобы добавить описание услуги, которое будет отображаться в карточке услуги в клиентской зоне HostBill.
    • Price* — выберите тип оплаты:

      Услуга будет доступна бесплатно.

      Для услуги будет доступна единовременная оплата.

      Услуга будет доступна по подписке.

      • Выберите платежный период*.

        Используйте расчетные периоды «ежемесячно» и «раз в год». При выборе других периодов заказ лицензии завершится ошибкой.

        • Monthly — ежемесячно
        • Annually — раз в год
      • Billing Type* — выберите форму оплаты:
        • Pre-paid — предоплата
        • Post-paid — постоплата
        • Hybrid — гибрид: для покупки услуг действует предоплата, для апгрейдов услуг — постоплата

      Чтобы добавить платежный период, нажмите Add pricing option.

      Не поддерживается для лицензий ispmanager.

      Поля Price и Setup Fee оставьте без изменений. Настройка стоимости услуги и открытия услуги выполняется на вкладке Components с помощью форм.

    • Tax — налог, который будет добавлен к стоимости услуги. Для включения налога активируйте опцию Yes и выберите налоговую группу из списка Tax Group.
    • Tags — теги для обозначения услуги, которые видны только администратору HostBill.
    Connect with App — настройки подключения к ispmanager
    1. App* — выберите из списка ispmanager_reselling.
    2. App Connection* — чтобы при заказе услуги лицензия для клиента была заказана в ispmanager автоматически, выберите созданное ранее подключение.

    Настройка тарифов выполняется на вкладке Components с помощью форм.

    Automation — автоматические действия с заказами клиента
    • Auto-create — заказ лицензии в ispmanager:
      • When the order is placed — при создании заказа в HostBill
      • When the first payment is received — после получения оплаты
      • After payment received, process by cron — с помощью периодического задания после получения оплаты
    • Automatic Upgrades — повышение/понижение тарифа:
      • When the order is placed — при создании заказа на повышение/понижение
      • After receiving payment — после получения оплаты
    • Automatic Renew — продление действия лицензии:
      • Renew account automatically after receiving payment — после получения оплаты
      • When renewal invoice is issued — после выставления счета на оплату
    • Automatic Suspension — приостановка лицензии:
      • Autosuspend account after X days past due date — приостанавливать лицензию через X дней после истечения срока оплаты
    • Automatic Unsuspension — возобновление лицензии:
      • Unsuspend account automatically after receiving due payment — действие лицензии будет возобновлено после получения оплаты
    • Automatic Termination — отключение лицензии:
      • Automatically terminate account after X days past due date — отключать лицензию через X дней после истечения срока оплаты
      • Automatically cancel related unpaid invoices — отменять неоплаченные счета по услуге
    • Auto-cancel unpaid orders — отменять неоплаченные заказы:
      • Cancel unpaid orders X days since creation — отменять неоплаченные заказы через X дней после создания
    • Generate invoices — выставление счетов на оплату:
      • X days before the due date for product/service — за X дней до истечения срока оплаты услуги
    • Advanced due date settings — расширенные настройки срока оплаты:
      • Invoice is expected to be paid X days before the due date for service/product — счет должен быть оплачен за X дней до истечения срока оплаты услуги
      • First invoice due date set to X days after order — первый срок оплаты наступает через X дней после создания заказа
      • Move due date X days into future for recurring invoices — перенести срок оплаты на X дней вперед для периодических счетов
    • Adjust Initial Period — скорректировать начало срока действия лицензии, если заказ был оплачен с задержкой, чтобы клиент получал услугу на полный срок
    Messages — уведомления для клиента и администратора HostBill

    Для настройки уведомления нажмите Change и выберите шаблон уведомления из списка.

    Создание шаблонов уведомлений доступно в разделе Settings → Message Templates.

    • Client email notifications — email-уведомления для клиентов:
      • Initial Order — о создании заказа
      • Account created email — о заказе лицензии в ispmanager 

        Пример

        Чтобы клиенту при покупке лицензии были отправлены название и ключ лицензии и адрес панели управления:

        1. Создайте соответствующие поля на вкладке Components → Forms.
        2. Используйте в шаблоне приветственного письма переменные:
        • {$service.forms.licname.value} — название лицензии
        • {$service.forms.lickey.value} — ключ лицензии
        • https://{$service.forms.ip.value}:1500 — адрес панели ispmanager
      • Account suspended email — о приостановке лицензии в ispmanager
      • Account unsuspended email — о возобновлении лицензии в ispmanager
      • Account terminated email — об отключении лицензии в ispmanager
      • Reminder of the service expiration — напоминание об истечении срока действия услуги
      • Client: Success upgrade — об успешном повышении/понижении тарифа
    • Admin email notifications — email-уведомления для администратора:
      • Staff: Success upgrade — об успешном повышении/понижении тарифа
      • Staff: Failed upgrade — о неудачной попытке повышения/понижения тарифа
    • Client mobile notifications — мобильные уведомления для клиентов:
      • Account created email — о заказе лицензии в ispmanager
    Components — дополнительные услуги, доступные при заказе лицензий

    Формы позволяют добавить собственные поля для услуги, например поле для выбора тарифа, IP-адреса, названия и ключа лицензии.

    Настройка поля для выбора тарифа
    1. Нажмите Add new form field.
    2. Выберите тип поля Dropdown.
    3. Нажмите Create new field.
    4. Заполните поля. Обязательные поля отмечены звездочкой.
      • Вкладка Basic Settings:

        • Field name* — название поля, под которым оно будет отображаться на форме заказа в клиентской зоне HostBill, например «Тарифный план ispmanager»
        • Description — описание поля для клиента HostBill
        • Admin only description — описание поля для администратора HostBill
        • Form group — оставьте без изменений

        Прежде чем перейти к настройке остальных полей, нажмите Save Changes.

      • Вкладка Values:
        • В поле введите название тарифа ispmanager, например «ispmanager lite». Для настройки тарифа нажмите на значок шестеренки рядом с полем и заполните поля:
          • Value passed to App*ID тарифа ispmanager
          • Value description — описание тарифа для клиента HostBill
          • Set as default item — установите галочку, чтобы при заказе услуги тариф выбирался по умолчанию
        • Для настройки стоимости тарифа нажмите на значок доллара рядом с полем. Установите галочку Enable pricing options и для каждого платежного периода заполните поля:

          Для настройки будут доступны типы оплаты и платежные периоды, активированные в блоке Price на вкладке General.

          • Price — стоимость тарифа
          • Setup Fee — единовременный платеж за открытие услуги
          • Upgrade Fee — единовременный платеж при смене тарифа
        • Нажмите Save Changes.

          Чтобы добавить еще один тариф ispmanager, введите его название в поле под существующим тарифом, нажмите Add и повторите настройку.

      • Вкладка Field Logic — оставьте без изменений.
      • Вкладка Additional Settings — оставьте без изменений.
      • Вкладка Advanced:
        • Variable name* — укажите pricelist.
        • Admin only — оставьте без изменений.
        • Required field — оставьте без изменений.
        • Allow Downgrades/Allow Upgrades — установите галочку, чтобы разрешить для клиента смену тарифа.
        • Show in cart* — установите галочку, чтобы поле отображалось на форме заказа в клиентской зоне HostBill.
        • Don't discount — установите галочку, чтобы на услугу не распространялось действие промокодов.
        • Show in Invoice — показывать выбранный тариф при выставлении счета в корзине:
          • Default — если тариф платный или активирован в корзине и не является пустым значением
          • Priced — если тариф платный
          • Force — показывать в любом случае, даже если тариф бесплатный или является пустым значением
          • Hidden — не показывать тариф
        • Upgrade setup fee — единовременный платеж за смену тарифа:
          • No — платеж взиматься не будет
          • Price difference — если платеж за открытие услуги для нового тарифа выше, чем для старого, будет взиматься разница между ними
          • Full — будет взиматься полная сумма платежа за открытие услуги по новому тарифу
        • Upgrade fee/Downgrade fee — дополнительный платеж за смену тарифа.
        • Upgrade pro-rata — разрешить или запретить смену тарифа с перерасчетом стоимости услуги.
        • CSS Class — CSS-класс, который будет применен к полю.
        • Category Name — оставьте без изменений.
    5. Нажмите Save Changes.
    Настройка полей для IP-адреса, названия и ключа лицензии
    1. Нажмите Add new form field.
    2. Выберите тип поля Text input.
    3. Нажмите Create new field.
    4. Заполните поля. Обязательные поля отмечены звездочкой.
      • Вкладка Basic Settings:

        • Field name* — название поля, под которым оно будет отображаться на форме заказа в клиентской зоне HostBill, например «Название лицензии»
        • Description — описание поля для клиента HostBill
        • Admin only description — описание поля для администратора HostBill
        • Form group — оставьте без изменений

        Прежде чем перейти к настройке остальных полей, нажмите Save Changes.

      • Вкладка Input settings — настройки вводимого в поле значения:

        • Unique — установите галочку, чтобы разрешить только уникальные значения
        • Regular expression — введите регулярное выражение для проверки введенного значения

        Остальные поля оставьте без изменений.

      • Вкладка Advanced:
        • Variable name* — укажите:
          • ip — для IP-адреса
          • licname — для названия лицензии
          • lickey — для ключа лицензии
        • Admin only — оставьте без изменений.
        • Required field — установите галочку, чтобы сделать поле обязательным для заполнения.
        • Client edit — установите галочку, чтобы разрешить клиентам редактировать поле в своем личном кабинете HostBill после заказа.
        • Show in cart* — установите галочку для полей названия и IP-адреса, чтобы они отображались на форме заказа в клиентской зоне HostBill.
        • Hide if empty — установите галочку, чтобы скрывать поле в личном кабинете клиента в HostBill, если оно не было заполнено.
        • Searchable — оставьте без изменений.
        • Show in Invoice — оставьте без изменений.
        • CSS Class — CSS-класс, который будет применен к полю.
        • Category Name — оставьте без изменений.
      • Вкладка Admin Access — настройка доступа к полю в административной зоне HostBill:
        • All staff members — доступ будет у всех администраторов HostBill
        • Selected staff members — доступ будет у выбранных администраторов HostBill
    5. Нажмите Save Changes

    Подробнее о настройке форм — в официальной документации HostBill.

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

    Для добавления аддона нажмите Assign addon(s), выберите дополнение из списка Addon и нажмите Add.

    Создание аддонов доступно в разделе HostBill Settings → Product Addons.

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

    • Hostname — имя хоста:
      • Require hostname for this product — установите галочку, чтобы поле Hostname было обязательным при заказе клиентом лицензии
      • Validation — проверка указанного клиентом имени хоста:
        • Do not validate provided hostname — не проверять
        • Check if provided hostname is valid DNS name — проверять, что указанное имя является валидным DNS-именем
        • Check if provided hostname is valid domain name — проверять, что указанное имя является валидным доменным именем
        • Check if provided hostname is valid FQDN — проверять, что указанное имя является валидным полным доменным именем (FQDN)
    • Auto-generate hostname — установите галочку Enable, чтобы генерировать имя хоста автоматически
      • Auto-hostname pattern — шаблон для генерации имени хоста
    • Enable domain options — нажмите Yes для настройки доменов при заказе лицензии:
      • Offer following domain registration/transfer options — выберите существующую страницу заказа домена из списка либо нажмите Create new domain order page, чтобы создать новую
      • Allow using own domain — разрешить клиенту использование своего домена
      • Only if domain was/will be registered with us — разрешить клиенту использование своего домена, только если он зарегистрирован/будет зарегистрирован у вас
      • Offer subdomain — установите галочку, чтобы предоставлять клиенту поддомены, и введите в поле домен, в котором будут создаваться поддомены

    Добавьте к лицензии другую услугу, которая будет доступна за отдельную плату и оформлена отдельным заказом. Для добавления услуги нажмите Enable sub-products и выберите услугу из списка.

    Client Functions — действия с заказанной услугой, доступные клиенту в личном кабинете HostBill

    Чтобы разрешить действие, нажмите Enable рядом с ним. Чтобы разрешить все действия, нажмите Enable all.

    Разрешенные действия будут доступны для активных заказов клиента в его личном кабинете HostBill в разделе Services:

    Возможные действия:

    • License details — просматривать и изменять информацию о лицензии: название, ключ и IP-адрес.
    • Change Billing Cycleизменять расчетный период для услуги. Смена доступна, если для услуги активировано несколько расчетных периодов.
    • Change Label — менять ярлык, который отображается рядом с заказанной услугой хостинга.
    • Change Ownership — передавать владение заказанной услуги лицензии другому пользователю HostBill.
    • Contracts — просматривать соглашения, принятые при заказе услуги лицензии. Просмотр доступен, если для услуги настроено принятие соглашения.
    • Domain Logs — неприменимо.
    • Downloads — неприменимо.
    • Edit Forms — просматривать и редактировать ответы в формах, добавленных на вкладке Component → Forms.
    • Graphs — неприменимо.
    • Login Details — неприменимо.
    • Logs — просматривать журнал действий с услугой, таких как активация, продление, остановка.
    • Manage IP — неприменимо.
    • Manual Service Renew — продлевать услугу досрочно. 

      Подробнее

      При ручном продлении из личного кабинета клиента в HostBill услуга продлится только в HostBill. Для продления в ispmanager администратор HostBill должен будет нажать Renewal в карточке услуги:

    • Metered Billing Details — неприменимо.
    • Related Emails — просматривать письма, связанные с услугой. 

      Подробнее

      Просмотр доступен, если для шаблонов писем, отправляемых клиенту, настроено логирование:

    • Related Invoices — просматривать счета по услуге.
    • Related Services — просматривать связанные услуги. Связанные услуги настраиваются на вкладке Component → Forms → Custom/Extra field types → Related Services.
    • Reverse DNS — неприменимо.
    • Service Auto Renewal — просматривать дату автоматического продления услуги, настраивать продление и метод оплаты.
    • Service notes — просматривать заметки к услуге, оставленные для клиента администратором HostBill.
    • Status Updates — неприменимо.
    • Update EPP code — неприменимо.
    • New Direct link — просматривать прямую ссылку на сервер с панелью ispmanager, если панель заказана вместе с сервером. Для настройки ссылки нажмите Edit:

    Other Settings — настройки отмен, повышения/понижения тарифа и др.
    • Limit Per Customer — максимальное количество заказов услуги, доступное одному клиенту. Для применения ограничения нажмите Yes и укажите количество услуг в поле One customer is allowed to order X products of this type.
    • Allow Cancellations — разрешить клиенту отменять заказ с услугой:
      • Yes, client can cancel service using this product — клиент сможет отменить заказ
      • Yes, client can cancel service after/for X days since account creation — клиент сможет отменить заказ в течение/через X дней после создания аккаунта
      • No, client cannot cancel service with this product — клиент не сможет отменить заказ
    • Allowed Cancellation Types — допустимые типы отмен:
      • Immediate — немедленная отмена
      • End of billing period — отмена в конце платежного периода
    • Pro-rate cancellations — отмена с перерасчетом стоимости услуги
      • No — запретить
      • Yes, for pre-paid services (for immediate cancelations) — разрешить для услуги с предоплатой (немедленная отмена)
      • Yes, for post-paid services — разрешить для услуги с постоплатой
    • Full Month Billing — биллинговая модель, при которой клиент оплачивает полную стоимость месяца независимо от даты активации услуги. Следующие платежи происходят в начала каждого месяца.
      • Enabled — включить
      • Disabled — выключить
    • Contract template — шаблон пользовательского соглашения. Выберите соглашение из списка или нажмите See all contract templates, чтобы настроить соглашения.
    • Clientarea Layout — расположение меню действий в клиентской зоне HostBill:
      • Left menu — слева
      • Right menu — справа
      • Top menu — сверху
    • Custom username — автоматическая генерация имени пользователя. Для настройки нажмите Enable и укажите шаблон имени в поле Username generation pattern.
    • Starting price calculation method — стоимость услуги, которая будет отображаться в клиентской зоне HostBill, если для услуги настроены дополнения на вкладке Components:
      • Calculate using lowest possible component prices — будет указана минимально возможная стоимость
      • Calculate using default components value — стоимость будет указана с учетом стоимости дополнений по умолчанию
    • Upgrades — повышения и понижения тарифов
      • Available Upgrades — оставьте без изменений. Настройка смены тарифа выполняется на вкладке Components → Forms.
      • Upgrade pro-rata — смена тарифа с перерасчетом стоимости услуги:
        • Seconds — пересчитать с учетом количества секунд до даты следующего платежа
        • Hours — пересчитать с учетом количества часов до даты следующего платежа
        • Days — пересчитать с учетом количества дней до даты следующего платежа
      • Queue Pro-rata Charges — для услуг с предоплатой ставить пересчитанные платежи в очередь:
        • Disabled — выставлять счет за прошедший период сразу
        • Enabled — ставить счет за прошедший период в очередь
      • Credit on Downgrade — начислять разницу на счет клиента в HostBill при переходе на менее дорогой тариф:
        • Default, use system billing settings — использовать настройки биллинга по умолчанию
        • No, do not credit customer pro-rated amount on package downgrade — не начислять разницу при понижении
        • Yes, credit customer pro-rated amount on package downgrade — начислять разницу при понижении
        • Yes, credit customer pro-rated amount on package downgrade, only after client doesn't have unpaid invoices (credit downgrade queue) — начислять разницу при понижении только после того, как клиент оплатит все счета (ставить начисление в очередь)
      • Credit note on Downgrade — создавать кредитную записку при понижении:
        • Default, use system billing settings — использовать настройки биллинга по умолчанию
        • No, do not issue credit notes on downgrades — не создавать
        • Yes, issue credit notes on downgrades — создавать
      • Out-of-stock Upgrade — переход на текущую услугу, если ее нет в наличии:
        • No, prevent upgrades to this product when it is out of stock — не разрешать
        • Yes, allow upgrades to this product even when it is out of stock — разрешать
  6. Нажмите Save Changes.

Перепродажа лицензий в составе VPS/VDS-хостинга

Настройка перепродажи лицензий ispmanager в составе VPS/VDS-хостинга доступна двумя способами: 

  • с помощью пакета услуг — панель ispmanager будет обязательна для заказа в составе пакета с VPS/VDS-хостингом
  • через дополнение (sub-product) — при покупке VPS/VDS-хостинга панель ispmanager будет доступна в качестве дополнения, но необязательна для заказа

Для настройки:

  1. Авторизуйтесь в HostBill под учетной записью администратора по адресу https://ВАШ_ДОМЕН/admin.
  2. Создайте услугу VPS/VDS-хостинга.
  3. Создайте лицензию ispmanager.
  4. Настройте перепродажу:

    1. Создайте страницу заказа для пакета услуг.

      Как создать страницу заказа для пакета услуг
      1. Перейдите в Settings → Products & Services.
      2. Нажмите Add new order page.
      3. Заполните поля. Обязательные поля отмечены звездочками.
        • Name* — название страницы заказа, на которой будут расположены пакеты услуг в клиентской зоне HostBill, например «VPS + ispmanager».
        • Order page URL — нажмите Edit, чтобы отредактировать автоматически сгенерированный URL страницы заказа.
        • This category will contain* — выберите Products.
        • Order type* — выберите Bundles.
        • Cart Template — выберите шаблон корзины из стандартных или нажмите Here для покупки платного шаблона. Для предварительного просмотра нажмите Preview.
        • Description — описание услуг, которые будут размещены на странице заказа, для клиентской зоны.
        • Advanced : Order scenario — выберите сценарий заказа — последовательность шагов, которые должен выполнить клиент при заказе услуг на странице заказа. Подробнее о сценариях заказа — в официальной документации HostBill.
      4. Нажмите Add new order page.
    2. Создайте пакет услуг.

      Как создать пакет услуг
      1. На созданной странице заказа нажмите Add new product.
      2. Заполните поля. Обязательные поля отмечены звездочками.

        General — основные настройки
        • Product Name* — название услуги.
        • Product Code — внутренний код пакета услуг, который виден только администратору HostBill.
        • Product features — основные возможности, доступные при заказе пакета услуг. Для добавления возможности укажите ее в поле Feature. Для добавления дополнительных возможностей нажмите Add more feature descriptions.
        • Additional features — дополнительные возможности, доступные при заказе пакета услуг. Для добавления возможности укажите ее в поле Feature. Для добавления дополнительных возможностей нажмите Add more feature descriptions.
        • Price* — тип оплаты:
          • Оставьте без изменений, чтобы стоимость пакета равнялась сумме входящих в него услуг. При изменении стоимости отдельной услуги стоимость пакета также изменится. Для каждой услуги в пакете доступна настройка собственного платежного периода.
          • Установите галочку Set fixed price, чтобы стоимость пакета была фиксированной и не зависела от стоимости входящих в него услуг. Для всех услуг в пакете будет действовать один платежный период.

            Пакет будет доступен бесплатно.

            Для пакета будет доступна единовременная оплата.

            • Price — стоимость пакета
            • Setup Fee — единовременный платеж за открытие услуг

            Пакет будет доступен по подписке.

            • Выберите платежный период*.

              Используйте расчетные периоды «ежемесячно» и «раз в год». При выборе других периодов заказ лицензии завершится ошибкой.

              • Monthly — ежемесячно
              • Annually — раз в год
            • Setup Fee — единовременный платеж за открытие услуг
            • Upgrade Fee — единовременный платеж за апргрейд услуг
            • Billing Type* — выберите форму оплаты:
              • Pre-paid — предоплата
              • Post-paid — постоплата
              • Hybrid — гибрид: для покупки услуг действует предоплата, для апгрейдов услуг — постоплата

            Для каждого платежного периода и стоимости создайте отдельную цену, нажав Add pricing option.

        • Items — услуги в составе пакета. Добавьте созданные услуги VPS-сервера и панели ispmanager. Чтобы добавить услугу, выберите в списке опцию Products и нужную услугу.
        • Tax — налог, который будет добавлен к стоимости пакета услуг. Для включения налога активируйте опцию Yes и выберите налоговую группу из списка Tax Group.
        • Tags — теги для обозначения услуги, которые видны только администратору HostBill.
        Connect with App — настройки подключения

        Оставьте без изменений.

        Параметры на вкладках Automation, Messages, Components, Client Functions и Other Settings настройте так же, как для обычной услуги.

      3. Сохраните изменения.
    1. В услуге VPS/VDS-хостинга перейдите на вкладку Components → Sub-products.
    2. Нажмите Enable Sub-products.
    3. Выберите из списка лицензию ispmanager.

При заказе IP-адрес сервера будет автоматически указан для лицензии ispmanager, и лицензия будет автоматически активирована.

Тестовый заказ лицензии

Чтобы проверить, что услуга стала доступна для клиентов и заказы обрабатываются корректно, совершите тестовый заказ:

  1. Создайте тестовую лицензию.

    Чтобы при тестовом заказе средства не списывались с вашего счета в ispmanager, используйте для тестовой лицензии в настройках модуля бесплатный тариф ispmanager trial.

  2. Авторизуйтесь в HostBill под тестовой учетной записью клиента по адресу https://ВАШ_ДОМЕН/index.php или создайте новую учетную запись.

    Как создать тестовую учетную запись клиента в HostBill
    1. В правом верхнем углу экрана нажмите в раздел Login / Register → Create Account.

    2. Заполните поля. Обязательные поля отмечены звездочками. Данные могут быть выдуманными. Список полей может отличаться, если он был изменен в разделе Clients Registration Fields.
      • Email Address* — контактный email.
      • Password* — пароль.
      • Repeat Password* — подтверждение пароля.
      • First Name* — имя клиента.
      • Last Name* — фамилия клиента.
      • Organization* — название компании, если выбран тип аккаунта Organization.
      • Address 1* — адрес 1.
      • Address 2 — адрес 2.
      • City* — город.
      • State* — область/край/округ/регион.
      • Postal Code* — почтовый индекс.
      • Country* — страна.
      • Phone* — номер телефона.
      • Account type — тип аккаунта:
        • Personal — для физического лица
        • Organization — для юридического лица
    3. Сохраните изменения.
  3. Закажите тестовую лицензию.

    Как заказать лицензию в HostBill

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

    1. Нажмите Order и выберите категорию услуг.
    2. Выберите услугу и нажмите Continue.
    3. Заполните необходимые поля и нажмите Checkout.
    4. Проверьте правильность данных заказа и подтвердите заказ.
    5. В случае успеха появится подтверждение заказа с его номером.

  4. Если при создании услуги была включена опция Auto-create на вкладке Automation, лицензия ispmanager для тестового клиента будет заказана автоматически. Если нет — подтвердите заказ.

    Подтверждение заказа

    Перейдите в раздел Orders & Accounts → Orders → Pending Orders, выберите нужную услугу и нажмите Accept.

    Вам на почту придет письмо от ispmanager с номером лицензии, а в вашем личном кабинете ispmanager в разделе Лицензии ispmanager появится заказанная лицензия.

  5. При необходимости удалите тестовый заказ.

    Как удалить тестовый заказ в HostBill
    1. В административной зоне HostBill перейдите в раздел Orders & Accounts → Orders → Active Orders.
    2. Выберите нужный заказ и нажмите Delete.
    3. Чтобы удалить аккаунт пользователя из панели ispmanager, в подтверждении выберите опцию Delete all order related data from HostBill and terminate accounts if any.

Основные действия с лицензиями

  1. Авторизуйтесь в HostBill под учетной записью администратора по адресу https://ВАШ_ДОМЕН/admin.
  2. Перейдите в раздел Orders and Accounts → Orders → Active Orders для активных заказов и Pending Orders — для ожидающих одобрения.
  3. Нажмите на нужный заказ в списке.
  4. В открывшейся форме в блоке Order items нажмите на услугу.

  5. Выполните нужное действие:
    • Блок Account Details:
      • Synchronize — синхронизировать IP-адрес, название и ключ лицензии с данными из вашего личного кабинета ispmanager.
      • Create — заказать лицензию.
      • Terminate — отключить лицензию. При отключении лицензии раньше окончания срока ее действия средства не возвращаются автоматически.
      • Renewal — продлить лицензию.
      • Package сменить тариф на выбранный из списка.
      • Billing cycle — изменить платежный период.
    • Блок Service Actions:
      • Generate a new key — сгенерировать новый ключ лицензии
  6. Нажмите Save Changes.

Подробнее о действиях с услугами — в документации HostBill.

Подробнее о всех возможностях, которые могут быть разрешены клиенту — в разделе Создание услуг → Услуги на вкладке Client Functions.

  1. Авторизуйтесь в HostBill под учетной записью клиента по адресу https://ВАШ_ДОМЕН/index.php.
  2. В меню слева в разделе Services выберите страницу заказа услуг.
  3. В открывшемся списке выберите нужную услугу.

  4. Выполните нужное действие:
    • Upgrade/Downgrade — сменить тариф лицензии
    • License Details — просмотреть и изменить информацию о лицензии: название, IP-адрес, ключ.
    • Change Billing Cycle — изменить платежный период
    • Account Logs — просмотреть историю изменений для лицензии
    • Manual Service Renew — запросить продление лицензии
    • Service Auto Renewal — просмотреть информацию об автоматическом продлении и изменить его настройки
    • Request Cancellation — запросить отключение лицензии
  5. Сохраните изменения.