Перепродажа модулей ispmanager через HostBill
В HostBill реализован модуль ispmanager reselling, который автоматизирует перепродажу модулей ispmanager.
Возможности модуля
| Возможность | Партнер | Клиент |
|---|---|---|
| Заказ | ||
| Продление | ||
| Остановка | ||
| Смена тарифа | ||
| Просмотр названия, ключа и IP лицензии | ||
| Смена расчетного периода | ||
| Просмотр истории изменений для лицензии |
Требования модуля
Модуль ispmanager reselling доступен бесплатно.
Установка модуля
- Скачайте модуль по ссылке.
- Авторизуйтесь в HostBill под учетной записью администратора по адресу https://ВАШ_ДОМЕН/admin или по SSH.
- Загрузите архив в корневую директорию HostBill.
- Распакуйте архив.
- Авторизуйтесь на сервере с HostBill под учетной записью администратора по SSH.
Скачайте модуль в корневую директорию HostBill:
wget-P /КОРЕНЬ/HOSTBILL/ https://static.ispmanager.com/static/files/hostbill/ispmanager_reselling.zipПерейдите в корневую директорию HostBill:
cd /КОРЕНЬ/HOSTBILL/Распакуйте архив:
unzip ispmanager_reselling.zip
Активация модуля
- Авторизуйтесь в HostBill под учетной записью администратора по адресу https://ВАШ_ДОМЕН/admin.
- Перейдите в раздел Settings → Modules → Hosting Modules.
На вкладке Inactive найдите модуль ispmanager_reselling и нажмите Activate.

Настройка подключения к ispmanager
- Авторизуйтесь в HostBill под учетной записью администратора по адресу https://ВАШ_ДОМЕН/admin.
Перейдите в раздел Settings → Apps Connections → Add new Connection.

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

Заполните параметры подключения. Обязательные поля отмечены звездочками.
- Name* — произвольное название, под которым подключение сохранится в HostBill. Название будет доступно для просмотра только администратору HostBill.
- Hostname* — доменное имя личного кабинета ispmanager — my.ispmanager.ru или eu.ispmanager.com.
- Username* — имя пользователя в личном кабинете ispmanager.
- Password* — пароль пользователя в личном кабинете ispmanager.
Оставьте без изменений.
- Нажмите Test Configuration для проверки подключения. Если подключение успешно установлено, появится уведомление со статусом Success.
- Нажмите Add New Connection.
Создание услуг
Создание услуг доступно после создания хотя бы одной страницы заказа.
Страницы заказа
Страницы заказа позволяют сгруппировать услуги в клиентской зоне HostBill.
Для создания страницы заказа:
- Авторизуйтесь в HostBill под учетной записью администратора по адресу https://ВАШ_ДОМЕН/admin.
- Перейдите в Settings → Products & Services.
- Нажмите Add new order page.
- Заполните поля. Обязательные поля отмечены звездочками.
- 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.
- Нажмите Add new order page.
Услуги
- Авторизуйтесь в HostBill под учетной записью администратора по адресу https://ВАШ_ДОМЕН/admin.
- Перейдите в Settings → Products & Services.
- Выберите созданную ранее страницу заказа.
- Нажмите:
- Add new product — чтобы создать услугу вручную
- Import products — чтобы импортировать существующую услугу, используя файл в формате JSON
Заполните или отредактируйте поля на вкладках. Обязательные поля отмечены звездочками.
General — основные настройки- Product Name* — название услуги.
- Product Code — внутренний код услуги, который виден только администратору HostBill.
- Product Description — нажмите Add description, чтобы добавить описание услуги, которое будет отображаться в карточке услуги в клиентской зоне HostBill.
Price* — тип оплаты:
Услуга будет доступна бесплатно.
Услуга будет доступна по подписке.
Выберите платежный период*.
Используйте только те платежные периоды, которые доступны для услуги в личном кабинете ispmanager. При выборе других периодов заказ лицензии завершится ошибкой.
- Monthly — ежемесячно
- Quarterly — раз в 3 месчца
- Semi-Annually — раз в полгода
- Annually — раз в год
- Setup Fee — единовременный платеж за открытие услуги
- Upgrade Fee — единовременный платеж за повышение тарифа услуги
- Billing Type* — выберите форму оплаты:
- Pre-paid — предоплата
- Post-paid — постоплата
- Hybrid — гибрид: для покупки услуг действует предоплата, для повышения тарифа услуг — постоплата
Для каждого платежного периода и стоимости создайте отдельную цену, нажав Add pricing option.
- Tax — налог, который будет добавлен к стоимости услуги. Для включения налога активируйте опцию Yes и выберите налоговую группу из списка Tax Group.

- Tags — теги для обозначения услуги, которые видны только администратору HostBill.
Connect with App — настройки подключения к ispmanager- App* — выберите из списка ispmanager_reselling.

- App Connection* — чтобы при заказе услуги модуль для клиента был заказан в ispmanager автоматически, выберите созданное ранее подключение.
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
- 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 — дополнительные услуги, доступные при заказе лицензийДля модулей ispmanager поддерживаются только формы («Forms»).
Формы позволяют получать и хранить информацию о клиентах и услугах в административной и клиентской зонах HostBill.
Для добавления собственной формы или поля нажмите одну из трех кнопок и выполните настройку:
- Add new form field — добавить новое поле
- Import — импортировать форму в виде файла в формате JSON или YML
- Copy from product — скопировать форму из другого продукта или услуги
Подробнее о настройке форм — в официальной документации HostBill.
Чтобы разрешить действие, нажмите Enable рядом с ним. Чтобы разрешить все действия, нажмите Enable all.

Разрешенные действия будут доступны для активных заказов клиента в его личном кабинете HostBill в разделе Services:
Возможные действия:
- License details — просматривать информацию о лицензии.
- Change Billing Cycle — менять платежный период, например с «раз в месяц» на «раз в полгода». Смена доступна, если для услуги лицензии настроено несколько платежных периодов.
- Change Label — менять ярлык, который отображается рядом с заказанной услугой.
- Change Ownership — передавать владение заказанной услуги лицензии другому пользователю HostBill.
- Contracts — просматривать соглашения, принятые при заказе услуги лицензии. Просмотр доступен, если для услуги настроено принятие соглашения.
- Edit Forms — просматривать и редактировать ответы в формах, добавленных на вкладке Component → Forms.
- Logs — просматривать журнал действий с услугой, таких как активация, продление, остановка.
- Manual Service Renew — продлевать услугу досрочно.
- Related Emails — просматривать письма, связанные с услугой.
- Related Invoices — просматривать счета по услуге.
- Related Services — просматривать связанные услуги. Связанные услуги настраиваются на вкладке Component → Forms → Custom/Extra field types → Related Services.
- Service Auto Renewal — просматривать дату автоматического продления услуги, настраивать продление и метод оплаты.
- Service notes — просматривать заметки к услуге, оставленные для клиента администратором HostBill.
- Status Updates — просматривать статус услуги.
Остальные действия не поддерживаются для модулей.
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 — разрешать
- Нажмите Save Changes.
- Для каждого тарифа ispmanager создайте отдельную услугу.
Действия с модулями
- Авторизуйтесь в HostBill под учетной записью администратора по адресу https://ВАШ_ДОМЕН/admin.
- Перейдите в раздел Orders and Accounts → Orders → Active Orders для активных заказов и Pending Orders — для ожидающих одобрения.
- Нажмите на нужный заказ в списке.
В открывшейся форме в блоке Order items нажмите на услугу.

- Выполните нужное действие:
- Create — заказать лицензию.
- Terminate — отключить лицензию. При отключении лицензии раньше окончания срока ее действия средства не возвращаются автоматически.
- Renewal — продлить лицензию.
- Package — сменить тариф на выбранный из списка.
Billing cycle — изменить платежный период.
Подробнее о действиях с услугами — в документации HostBill.
- Нажмите Save Changes.
Подробнее о всех возможностях, которые могут быть разрешены клиенту — в разделе Создание услуг → Услуги на вкладке Client Functions.
- Авторизуйтесь в HostBill под учетной записью клиента по адресу https://ВАШ_ДОМЕН/index.php.
- В меню слева в разделе Services выберите страницу заказа услуг.
В открывшемся списке выберите нужную услугу.

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