Продажа хостинга с NimboBilling — установка и первые шаги
NimboBilling — это приложение для магазина и биллинга, которое входит в каждую платную лицензию Nimbopanel. Это отдельное приложение, а не часть панели: панель не принимает платежи и не обслуживает страницы продаж. NimboBilling даёт вам магазин на вашем собственном домене, счета, клиентские аккаунты и службу поддержки, а когда счёт оплачен, сам создаёт для вас аккаунт хостинга в панели. Это руководство — об установке и о первом часе работы. Что умеет приложение, описано на странице NimboBilling, а краткая версия настройки — в разделе Маркетинговый сайт.
Установить его может только администратор или реселлер, из собственной сессии, на аккаунт хостинга, который принадлежит им самим.
Прежде чем начать
- Платная лицензия. На тарифе Free каталог показывает NimboBilling серым, с надписью «Требуется платная лицензия».
- Аккаунт хостинга для магазина. Его основной домен — это адрес, по которому
будет жить магазин (
yourbrand.comили имя вродеshop.yourbrand.com), и это имя указывает на сервер. NimboBilling занимает корень сайта, поэтому используйте аккаунт, на котором нет другого сайта. Он всегда работает по HTTPS. - PHP 8.3 или новее на этом аккаунте. Если на аккаунте более старая версия, карточка установки предупредит об этом; сначала смените её в разделе Версия PHP.
- Ваша собственная сессия. Не устанавливайте приложение после того, как открыли панель клиента кнопкой Войти.
Установка шаг за шагом
- В разделе Аккаунты откройте Управлять → Приложения у аккаунта. Быстрый путь: в Поиске инструментов есть «Продавать хостинг (NimboBilling)» — он ведёт в «Аккаунты», и при открытии окна «Приложения» NimboBilling уже выбран.
- Выберите в списке NimboBilling. Его карточка говорит, что это такое и что ему нужно, а у каждого поля есть строка подсказки.
- Заполните форму. Поля для папки нет, потому что NimboBilling всегда занимает
основной адрес домена:
- Заголовок сайта — название вашего магазина.
- Ваше имя — показывается только внутри приложения. Для входа вы используете адрес электронной почты, а не это имя.
- Email администратора — с ним вы входите, и на него приложение отправляет вам свои сообщения.
- Пароль администратора — введите пароль не короче 12 символов, с буквами и цифрами, либо оставьте поле пустым, чтобы надёжный пароль был создан за вас.
- Язык — язык, на котором стартует админка приложения, и язык магазина по умолчанию: английский или Bahasa Indonesia. Выбор также определяет валюту и часовой пояс, с которыми магазин стартует. Английский стартует с долларами США и UTC; другой язык — с валютой и часовым поясом, которые обычно к нему прилагаются. Все три параметра можно изменить позже (см. ниже).
- Нажмите Установить. Это занимает около минуты.
Если на домене уже есть сайт
Панель спрашивает, прежде чем что-либо сделать. Окно с заголовком Заменить сайт на этом домене? перечисляет найденные файлы и объясняет, что произойдёт: NimboBilling становится сайтом домена, нынешний сайт перестаёт отдаваться, как только установка завершится, а ваши файлы не удаляются, кроме тех, что называются так же, как собственные файлы приложения: они заменяются. Если позже удалить NimboBilling, папка будет очищена. Безопасная кнопка — Отмена — стоит в фокусе. Чтобы сохранить старый сайт, нажмите «Отмена» и установите NimboBilling на новый аккаунт хостинга или домен либо сначала сделайте резервную копию.
Карточка после установки
Карточка показывает адрес магазина и адрес админки, ваш email, ваше имя и пароль, у каждого — кнопка Копировать. Сохраните пароль сразу: он показывается только один раз.
Оба адреса — защищённые (https). Сертификату нового имени нужно несколько минут, поэтому пока он не готов, карточка показывает адреса обычным текстом, с пояснением, а когда сертификат становится активным, сама превращает их в ссылки (она пишет «Защищённый адрес готов»). Если открыть магазин раньше, появится предупреждение о сертификате.
Вторая карточка сообщает: NimboBilling подключён к этой панели. Во время установки панель создала для магазина токен API с названием NimboBilling и доступом к «Аккаунтам» (чтение и изменение), а магазин зарегистрировал с ним эту панель, так что оплаченный заказ может создать аккаунт хостинга без какой-либо дополнительной настройки. Токен указан в разделе Токены API, где его можно отозвать, и он отзывается при удалении приложения. Чтобы проверить подключение, откройте в NimboBilling раздел Services → Panel servers и нажмите Test connection. Если панели не удалось создать токен, карточка перечисляет шаги, чтобы связать их вручную. Строка планировщика приложения добавляется в Задания cron аккаунта за вас; если это не удалось, карточка показывает строку, которую нужно добавить.
Ещё одна строка на карточке важна: клиенты не увидят ни одного способа оплаты, пока вы не добавите банковские реквизиты в разделе Settings → Gateway: Manual transfer.
Что содержит новый магазин
Новая установка один раз наполняется примером магазина, чтобы меню магазина работали с первого посещения, а не вели на пустые страницы:
- примеры тарифов в четырёх группах: виртуальный хостинг, VPS-серверы, выделенный сервер и доменные имена,
- начальный центр справки со статьями о заказе, оплате, услугах и вашем аккаунте,
- несколько записей блога, опубликованных, и два объявления, которые остаются черновиками, пока вы их не опубликуете.
Все названия, характеристики и цены в нём — примеры. Примеры тарифов указаны в долларах США или в валюте магазина, если при установке вы выбрали другой язык. У тарифов хостинга и серверов нет привязанного сервера панели, поэтому заказ на них ждёт ваших сотрудников, пока вы не привяжете продукт к серверу панели и к точному названию одного из ваших пакетов (поля продукта Panel server и Package name on the panel). Замените примеры тарифов своими или удалите их, прежде чем открывать магазин. Ничто не вернёт их обратно: магазин запоминает, что пример был предложен один раз.
Подготовка магазина
Начиная с NimboBilling 1.0.7 новый магазин требует двухфакторный вход для каждого сотрудника: первый вход владельца сразу ведёт к его настройке. Магазин, установленный до 1.0.7, не переключается; его дашборд рекомендует это владельцу, а настройка находится в разделе Settings → Security → Require 2FA for all staff.
На дашборде админки показывается карточка Getting your store ready, пока не выполнены все шаги. Каждый шаг отмечается по самим данным, а не вручную:
- Connect your hosting panel — показывается, только если установка ещё не подключила её. Services → Panel servers.
- Add your company email — показывается в счетах, и по нему клиенты связываются с вами. Settings → General.
- Set up outgoing email (SMTP) — без этого счета и напоминания не доходят до клиентов. Settings → Email (SMTP).
- Set up payment: start with bank transfer. См. ниже.
- Replace the sample plans with your own. Шаг считается выполненным, когда есть ваш собственный тариф или когда вы отредактировали пример.
- Choose your store's look — в разделе Theme, logo & slides выберите готовый шаблон, затем настройте цвета, шрифты и логотип.
Цены, наценка и рефералы
Цена в магазине — это базовая цена продукта плюс наценка. В разделе Settings → Billing & Pricing Default markup (%) сначала равна 10 %, а у отдельного продукта на его странице может быть своя величина. Из наценки выплачиваются реферальные комиссии: они выключены, пока вы не включите их в разделе Settings → Referrals & Commissions, и могут идти до пяти уровней.
Переключатель Add a markup to selling prices — это и есть выключатель. При выключенном переключателе каждый продукт продаётся по базовой цене, и денег на реферальные комиссии нет. Он действует на новые заказы и следующие за ними продления; уже выставленные счета не меняются. Начиная с NimboBilling 1.0.7 примеры тарифов нового магазина тоже следуют наценке по умолчанию, так что выключение переключателя сразу видно по их ценам (тариф за USD 3.99 продаётся за 4.39 при наценке по умолчанию 10 %). Магазин, установленный более ранней версией, сохраняет примеры тарифов со своей наценкой, равной 0 %. Когда сотрудник оформляет заказ по цене выше каталожной при выключенном переключателе, разница считается базовой ценой, а не наценкой, поэтому реферальная комиссия из неё не выплачивается.
Налог
Налог выключен, пока вы не включите его: Settings → Billing & Pricing → Charge tax (VAT/GST). Ставки находятся в разделе Tax rules. Блок Common tax rates одним щелчком добавляет стандартную национальную ставку одной из 18 стран. Это только создаёт правило и никогда не включает налог, а ставки меняются, поэтому сверьтесь с вашим бухгалтером. Для продаж внутри ЕС можно также указать свою страну, включить reverse charge для бизнес-клиентов и проверять номер НДС клиента через сервис VIES Европейской комиссии (включено по умолчанию; когда VIES недоступен, номер считается непроверенным, НДС начисляется, а сотрудники могут отметить его проверенным вручную).
Часовой пояс и язык
В разделе Settings → General находится Time zone магазина. Даты и часы в админке, на страницах клиента, в PDF и письмах, а также час ежедневного автоматического запуска биллинга следуют ему. Задайте его до первых счетов: сохранённые даты не меняются при смене пояса, поэтому срок оплаты счёта после этого может показываться на день раньше или позже, и настройка об этом предупреждает.
На той же странице есть Admin panel language (английский или Bahasa Indonesia), который применяется к меню, формам и Руководству админки для всех ваших сотрудников. Тексты самого магазина хранятся на основном языке магазина — том, что выбран при установке, а поля, в которых лежит такой текст, в английской админке подписаны (main language); начиная с NimboBilling 1.0.7 пример магазина тоже написан на этом языке. Он не меняет язык, который видят клиенты; он задаётся в разделе Settings → Language. Валюта по умолчанию тоже указана на этой странице вместе с валютами, которые могут выбирать клиенты.
Платежи
Платёжные шлюзы настраиваются в разделе Settings, по странице на каждый.
- Банковский перевод идёт первым, потому что ему не нужен аккаунт в платёжном шлюзе. Он включён с самого начала, но клиентам предлагается, только когда вы замените пример в разделе Settings → Gateway: Manual transfer своими настоящими банковскими реквизитами. Клиент загружает подтверждение перевода, а ваши сотрудники одобряют его в разделе Payments.
- Stripe (карты): Settings → Gateway: Stripe (cards). У него есть тестовый режим; сначала пользуйтесь им.
- PayPal: Settings → Gateway: PayPal, с переключателем песочницы.
Для Stripe и PayPal страница настроек показывает Webhook URL и события, которые нужно выбрать. Добавьте его у шлюза, иначе платёж, сделанный после того, как клиент закрыл вкладку, подтвердится с опозданием.
Что доказано. Stripe доказан только в тестовом режиме. PayPal пока не доказан от начала до конца реальным платежом. Сами сделайте одну небольшую реальную покупку, прежде чем рекламировать магазин. В собственном разделе приложения Manual / guide есть пошаговая инструкция для каждого шлюза.
Обновление
Когда в каталоге появляется более новая версия NimboBilling, в разделе
Управлять → Приложения рядом с ним показывается Доступно обновление и
кнопка Обновить. Панель сначала делает резервную копию, заменяет код
приложения, сохраняет вашу конфигурацию .env, запускает собственное обновление
приложения и проверяет, что сайт отвечает. Если он не поднялся нормально, панель
возвращает старую версию и сообщает, что ваш сайт не изменился. Ваши продукты,
клиенты, счета и настройки остаются как есть. В магазин, установленный до выхода
версии, новые примеры текстов не записываются.
Удаление
Управлять → Приложения → Удалить, затем введите remove для подтверждения.
Это удаляет файлы и базу данных магазина вместе со счетами, клиентами и тикетами,
поэтому сначала сделайте резервную копию. Папка остаётся пустой, а токен API,
которым пользовался магазин, отзывается. Созданные им аккаунты хостинга — это
аккаунты панели, и они не входят в приложение.
Если что-то не так
- Карточка сообщает, что в папке уже есть файлы. Прочтите окно, описанное выше, и выберите новый аккаунт, если хотите сохранить находящийся там сайт.
- Сразу после установки адрес магазина показывает предупреждение о сертификате. Подождите несколько минут: карточка включит ссылки, когда сертификат будет готов.
- Клиенты не видят способа оплаты. Добавьте банковские реквизиты в разделе Settings → Gateway: Manual transfer или включите платёжный шлюз.
- Оплаченный заказ не создал аккаунт. Откройте продукт и проверьте, что он привязан к серверу вашей панели и к точному названию одного из ваших пакетов. Пример тарифа не привязан. См. также проверку подключения выше.
- Установка отклонена из-за PHP. На аккаунте версия ниже 8.3. Смените её в разделе Версия PHP и установите снова.
- NimboBilling показан серым в списке. Сервер работает на тарифе Free; см. Как работает лицензирование.
Связанное: Маркетинговый сайт · Руководство реселлера · Как работает лицензирование · Устранение неполадок