Documentation / Vendre de l'hébergement avec NimboBilling — installation et premiers pas

Vendre de l'hébergement avec NimboBilling — installation et premiers pas

NimboBilling est l'application de boutique et de facturation fournie avec chaque licence Nimbopanel payante. C'est une application distincte, qui ne fait pas partie du panneau : le panneau n'encaisse aucun paiement et ne sert aucune page de vente. NimboBilling vous donne une boutique sur votre propre domaine, des factures, des comptes clients et un centre d'assistance, et lorsqu'une facture est payée, il crée pour vous le compte d'hébergement sur le panneau. Ce guide couvre l'installation et la première heure. Ce que l'application propose se trouve sur la page NimboBilling, et la version courte de la mise en place est dans Site marketing.

Seul un administrateur ou un revendeur l'installe, depuis sa propre session, sur un compte d'hébergement qui lui appartient.

Avant de commencer

  • Une licence payante. Au niveau Gratuit, le catalogue affiche NimboBilling en grisé, avec la mention « Nécessite une licence payante ».
  • Un compte d'hébergement pour la boutique. Son domaine principal est l'adresse où vivra la boutique (yourbrand.com, ou un nom tel que shop.yourbrand.com), et ce nom pointe vers le serveur. NimboBilling prend la racine du site : utilisez donc un compte qui n'a aucun autre site web. Il utilise toujours HTTPS.
  • PHP 8.3 ou plus récent sur ce compte. Si le compte fait tourner une version plus ancienne, la carte d'installation vous avertit ; changez-la d'abord sous Version de PHP.
  • Votre propre session. Ne l'installez pas après avoir utilisé Se connecter pour ouvrir le panneau d'un client.

L'installer, pas à pas

  1. Dans Comptes, ouvrez Gérer → Applications sur le compte. Un raccourci : Rechercher des outils propose « Vendre de l'hébergement (NimboBilling) », qui vous amène à Comptes avec NimboBilling déjà choisi à l'ouverture de la fenêtre Applications.
  2. Choisissez NimboBilling dans la liste. Sa carte dit ce que c'est et ce qu'il faut, et chaque champ a une ligne d'aide.
  3. Remplissez le formulaire. Il n'y a pas de champ dossier, car NimboBilling prend toujours l'adresse principale du domaine :
    • Titre du site — le nom de votre boutique.
    • Votre nom — affiché uniquement dans l'application. Vous vous connectez avec votre adresse e-mail, pas avec ce nom.
    • E-mail admin — ce avec quoi vous vous connectez, et l'adresse à laquelle l'application vous envoie ses messages.
    • Mot de passe admin — saisissez-en un d'au moins 12 caractères, avec des lettres et des chiffres, ou laissez le champ vide pour qu'un mot de passe robuste soit créé pour vous.
    • Langue — la langue dans laquelle démarre l'administration de l'application, et la langue par défaut de la boutique : anglais ou Bahasa Indonesia. Ce choix fixe aussi la devise et le fuseau horaire avec lesquels la boutique démarre. L'anglais démarre avec les dollars américains et UTC ; l'autre langue démarre avec la devise et le fuseau horaire qui l'accompagnent d'ordinaire. Vous pouvez modifier les trois plus tard (voir plus bas).
  4. Cliquez sur Installer. Cela prend environ une minute.

Si le domaine a déjà un site

Le panneau demande avant d'agir. Une boîte de dialogue intitulée Remplacer le site de ce domaine ? liste les fichiers trouvés et explique ce qui se passe : NimboBilling devient le site du domaine, le site actuel cesse d'être servi dès la fin de l'installation, et vos fichiers ne sont pas supprimés, sauf ceux qui portent le même nom qu'un fichier propre à l'application, qui sont remplacés. Supprimer NimboBilling plus tard vide le dossier. Le bouton sûr, Annuler, est celui qui a le focus. Pour garder l'ancien site, annulez et installez NimboBilling sur un nouveau compte d'hébergement ou un nouveau domaine, ou faites d'abord une sauvegarde.

La carte après l'installation

La carte affiche l'adresse de la boutique et l'adresse de l'administration, votre e-mail, votre nom et le mot de passe, chacun avec un bouton Copier. Enregistrez le mot de passe maintenant : il n'est affiché qu'une seule fois.

Les deux adresses sont sécurisées (https). Le certificat d'un nouveau nom prend quelques minutes ; tant qu'il n'est pas prêt, la carte affiche donc les adresses en texte brut, avec une note, et les transforme en liens toute seule dès que le certificat est actif (elle indique « L'adresse sécurisée est prête. »). Ouvrir la boutique avant cela affiche un avertissement de certificat.

Une seconde carte indique NimboBilling est connecté à ce panneau. Pendant l'installation, le panneau a créé un jeton API pour la boutique, nommé NimboBilling, avec accès à Comptes (lecture et modification), et la boutique y a enregistré ce panneau, de sorte qu'une commande payée peut créer un compte d'hébergement sans autre réglage. Le jeton figure sous Jetons API, où vous pouvez le révoquer, et il est révoqué lorsque l'application est supprimée. Pour vérifier la connexion, ouvrez Services → Panel servers dans NimboBilling et cliquez sur Test connection. Si le panneau n'a pas pu créer le jeton, la carte liste les étapes pour relier les deux à la main. La ligne du planificateur de l'application est ajoutée pour vous aux Tâches cron du compte ; si cela a échoué, la carte affiche la ligne à ajouter.

Une dernière ligne de la carte compte : les clients ne verront aucun moyen de payer tant que vous n'aurez pas ajouté vos coordonnées bancaires sous Settings → Gateway: Manual transfer.

Ce que contient une nouvelle boutique

Une nouvelle installation est remplie une seule fois avec une boutique d'exemple, pour que les menus de la boutique fonctionnent dès la première visite au lieu de mener à des pages vides :

  • des plans d'exemple en quatre groupes : hébergement mutualisé, serveurs VPS, un serveur dédié et noms de domaine,
  • un centre d'aide de départ avec des articles sur la commande, les paiements, les services et votre compte,
  • quelques articles de blog, publiés, et deux annonces qui restent des brouillons jusqu'à ce que vous les publiiez.

Chaque nom, spécification et prix qu'elle contient est un exemple. Les plans d'exemple sont affichés en dollars américains, ou dans la devise de la boutique si vous avez choisi l'autre langue à l'installation. Les plans d'hébergement et de serveurs n'ont aucun serveur de panneau associé : une commande pour l'un d'eux attend donc votre équipe tant que vous n'avez pas relié un produit à votre serveur de panneau et au nom exact de l'un de vos forfaits (les champs Panel server et Package name on the panel du produit). Remplacez les plans d'exemple par les vôtres, ou supprimez-les, avant d'ouvrir la boutique. Rien ne les ramène : la boutique enregistre que l'exemple a été proposé une fois.

Préparer votre boutique

À partir de NimboBilling 1.0.7, une nouvelle boutique exige la connexion à deux facteurs pour chaque membre de l'équipe : la première connexion du propriétaire passe directement à sa configuration. Une boutique installée avant la 1.0.7 n'est pas basculée ; son tableau de bord le recommande au propriétaire, et le réglage est Settings → Security → Require 2FA for all staff.

Le tableau de bord de l'administration affiche une carte, Getting your store ready, jusqu'à ce que chaque étape soit terminée. Chaque étape est cochée d'après les données elles-mêmes, pas à la main :

  1. Connect your hosting panel — n'apparaît que si l'installation ne l'a pas déjà relié. Services → Panel servers.
  2. Add your company email — affiché sur les factures et utilisé par les clients pour vous joindre. Settings → General.
  3. Set up outgoing email (SMTP) — sans lui, les factures et les rappels n'atteignent pas les clients. Settings → Email (SMTP).
  4. Set up payment: start with bank transfer. Voir plus bas.
  5. Replace the sample plans with your own. L'étape compte comme terminée lorsqu'un plan à vous existe, ou lorsque vous avez modifié un plan d'exemple.
  6. Choose your store's look — sous Theme, logo & slides, choisissez un modèle prêt à l'emploi, puis ajustez les couleurs, les polices et le logo.

Prix, majoration et parrainages

Un prix dans la boutique est le prix de base du produit plus une majoration. Sous Settings → Billing & Pricing, Default markup (%) vaut 10 % au départ, et un produit peut porter son propre chiffre sur sa page. La majoration est ce qui finance les commissions de parrainage : elles sont désactivées tant que vous ne les activez pas sous Settings → Referrals & Commissions, et elles peuvent aller jusqu'à cinq niveaux.

Add a markup to selling prices est l'interrupteur. Désactivé, chaque produit se vend à son prix de base et il n'y a pas d'argent pour les commissions de parrainage. Il s'applique aux nouvelles commandes et aux renouvellements qui les suivent ; les factures déjà émises ne changent pas. À partir de NimboBilling 1.0.7, les plans d'exemple d'une nouvelle boutique suivent aussi la majoration par défaut, de sorte que désactiver l'interrupteur se voit tout de suite sur leurs prix (un plan à 3,99 USD se vend à 4,39 avec la majoration par défaut de 10 %). Une boutique installée avec une version antérieure garde des plans d'exemple dotés d'une majoration propre fixée à 0 %. Quand un membre de l'équipe passe une commande à un prix supérieur à celui du catalogue alors que l'interrupteur est désactivé, la différence compte comme prix de base, et non comme majoration : elle ne finance donc aucune commission de parrainage.

Taxe

La taxe est désactivée tant que vous ne l'activez pas : Settings → Billing & Pricing → Charge tax (VAT/GST). Les taux se trouvent sous Tax rules. Son bloc Common tax rates ajoute en un clic le taux national standard de l'un des 18 pays. Cela crée seulement une règle, sans jamais activer la taxe, et les taux changent : confirmez-les donc avec votre comptable. Pour les ventes dans l'UE, vous pouvez aussi indiquer votre propre pays, activer l'autoliquidation pour les clients professionnels, et faire vérifier le numéro de TVA d'un client par le service VIES de la Commission européenne (activé par défaut ; lorsque VIES est injoignable, le numéro compte comme non vérifié, la TVA est facturée, et l'équipe peut le marquer comme vérifié à la main).

Fuseau horaire et langue

Settings → General contient le Time zone de la boutique. Les dates et les heures dans l'administration, les pages client, les PDF et les e-mails, ainsi que l'heure de l'exécution quotidienne automatique de la facturation, le suivent. Réglez-le avant les premières factures : les dates enregistrées ne changent pas quand vous changez de fuseau, une échéance de facture peut donc s'afficher un jour plus tôt ou plus tard ensuite, et le réglage le signale.

La même page contient Admin panel language (anglais ou Bahasa Indonesia), qui s'applique aux menus, aux formulaires et au Manual de l'administration pour tout votre personnel. Les textes de la boutique elle-même sont conservés dans la langue principale de la boutique, celle choisie à l'installation, et les champs qui contiennent ce texte indiquent (main language) dans l'administration en anglais ; à partir de NimboBilling 1.0.7, la boutique d'exemple est aussi écrite dans cette langue. Cela ne change pas la langue que voient les clients ; celle-ci se règle sous Settings → Language. La devise par défaut est aussi sur cette page, avec les devises que les clients peuvent choisir.

Paiements

Les passerelles se configurent sous Settings, une page chacune.

  • Le virement bancaire vient en premier, car il n'exige aucun compte de passerelle. Il est activé dès le départ, mais il n'est proposé aux clients qu'une fois que vous avez remplacé l'exemple de Settings → Gateway: Manual transfer par vos véritables coordonnées bancaires. Le client téléverse une preuve de virement et votre équipe l'approuve sous Payments.
  • Stripe (cartes) : Settings → Gateway: Stripe (cards). Il a un mode test ; utilisez-le d'abord.
  • PayPal : Settings → Gateway: PayPal, avec un interrupteur bac à sable.

Pour Stripe et PayPal, la page de réglages affiche une Webhook URL et les événements à sélectionner. Ajoutez-la chez la passerelle, sinon un paiement effectué après que le client a fermé l'onglet est confirmé tardivement.

Ce qui est prouvé. Stripe n'est prouvé que dans son mode test. PayPal n'est pas encore prouvé de bout en bout avec un vrai paiement. Faites vous-même un petit achat réel avant de faire la publicité de la boutique. Le Manual / guide de l'application contient le pas-à-pas pour chaque passerelle.

Mise à jour

Lorsqu'une version plus récente de NimboBilling est dans le catalogue, Gérer → Applications affiche Mise à jour disponible à côté et un bouton Mettre à jour. Le panneau fait d'abord une sauvegarde, remplace le code de l'application, conserve votre configuration .env, exécute la propre mise à niveau de l'application, et vérifie que le site répond. S'il ne repart pas proprement, le panneau remet l'ancienne version en place et indique que votre site est inchangé. Vos produits, clients, factures et réglages restent tels quels. Une boutique installée avant une version ne reçoit pas de nouveaux textes d'exemple écrits dedans.

La supprimer

Gérer → Applications → Supprimer, puis saisissez remove pour confirmer. Cela supprime les fichiers et la base de données de la boutique, avec ses factures, ses clients et ses tickets : faites donc d'abord une sauvegarde. Le dossier est laissé vide, et le jeton API utilisé par la boutique est révoqué. Les comptes d'hébergement qu'elle a créés sont des comptes du panneau et ne font pas partie de l'application.

Quand quelque chose ne va pas

  • La carte indique que le dossier contient déjà des fichiers. Lisez la boîte de dialogue ci-dessus, et choisissez un nouveau compte si vous voulez garder le site qui s'y trouve.
  • L'adresse de la boutique affiche un avertissement de certificat juste après l'installation. Attendez quelques minutes : la carte active les liens quand le certificat est prêt.
  • Les clients ne voient aucun moyen de payer. Ajoutez vos coordonnées bancaires sous Settings → Gateway: Manual transfer, ou activez une passerelle.
  • Une commande payée n'a pas créé de compte. Ouvrez le produit et vérifiez qu'il est relié à votre serveur de panneau et au nom exact de l'un de vos forfaits. Un plan d'exemple ne l'est pas. Voir aussi la vérification de la connexion plus haut.
  • L'installation est refusée à cause de PHP. Le compte fait tourner une version inférieure à 8.3. Changez-la sous Version de PHP et installez de nouveau.
  • NimboBilling est grisé dans la liste. Le serveur est au niveau Gratuit ; voir Comment fonctionne la licence.

Voir aussi : Site marketing · Guide du revendeur · Comment fonctionne la licence · Dépannage