K
KMS.CM WHMCS MASTER GUIDE
Guide d'Ingénierie & Procédure d'Interconnexion
Documentation Technique Officielle • Production Ready

Déploiement de billing.kms.cm & Automatisation WHMCS

Ce guide exhaustif détaille pas-à-pas la création du sous-domaine de facturation, l'installation durcie de WHMCS 8.x, la configuration monétaire CEMAC (XAF / TVA 19.25%), l'automatisation des serveurs DirectAdmin Pro et VPS, l'intégration des APIs de domaines (Namecheap & Dynadot avec 35% de marge), le routage des passerelles Mobile Money et la synchronisation bidirectionnelle avec la suite Zoho CRM, Zoho Books, Zoho Invoice & Zoho Projects.

01

Création du Sous-domaine billing.kms.cm & Architecture WHMCS

L'instance WHMCS gère l'ensemble de la relation client, des commandes, de la facturation et du déclenchement des approvisionnements automatisés. Pour garantir une sécurité absolue et éviter les interférences avec le frontal web en PHP natif de kms.cm, WHMCS doit être hébergé sur son sous-domaine dédié : https://billing.kms.cm.

1.1 Création dans DirectAdmin Pro

  1. Connectez-vous à la console DirectAdmin : https://163.245.192.41:2222 ou https://servers.kms.cm:2222.
  2. Naviguez dans Account Manager > Subdomain Management.
  3. Cliquez sur Add Subdomain, saisissez billing et validez.
  4. DirectAdmin génère automatiquement le répertoire racine : /home/admin/domains/kms.cm/public_html/billing.
  5. Naviguez dans Account Manager > SSL Certificates, sélectionnez Free & automatic certificate from Let's Encrypt, cochez billing.kms.cm et cliquez sur Save.
Architecture Système des Répertoires :
/home/admin/
├── whmcs_keys/                       <-- Hors racine web : stockage de cc_encryption_hash
├── whmcs_storage/                    <-- Stockage sécurisé hors web
│   ├── attachments/
│   ├── downloads/
│   └── templates_c/
└── domains/kms.cm/public_html/
    ├── index.php                     <-- Frontal KMS Vitrine Cloud
    ├── my/                           <-- Espace passerelle my.kms.cm
    ├── servers/                      <-- Console infrastructure servers.kms.cm
    └── billing/                      <-- RACINE WEB WHMCS (billing.kms.cm)
        ├── admin/                    <-- À renommer (ex: kms_control_984)
        ├── configuration.php         <-- Chiffré, permissions 0400 / 0444
        └── crons/                    <-- Script d'automatisation quotidien
                        

1.2 Base de Données MariaDB 10.11

Sous DirectAdmin > MySQL Management, créez une base de données isolée :

  • Nom de la base : admin_whmcs
  • Utilisateur : admin_whmcsuser
  • Collation : utf8mb4_unicode_ci (support emojis et caractères internationaux)

1.3 Configuration des Tâches Planifiées (Crons)

WHMCS requiert une tâche cron principale pour renouveler les domaines, générer les factures récurrentes, suspendre les impayés et déclencher les sauvegardes :

0 0 * * * php -q /home/admin/domains/kms.cm/public_html/billing/crons/cron.php all > /dev/null 2>&1
02

Paramétrage Entreprise, Monnaie XAF & Conformité Fiscale CEMAC

Pour opérer légalement au Cameroun et dans les 6 pays membres de la CEMAC (Cameroun, Gabon, République du Congo, Tchad, Centrafrique, Guinée Équatoriale), WHMCS doit être calibré sur la monnaie BEAC (XAF) et appliquer les règles du Code Général des Impôts (CGI).

2.1 Table des Devises dans WHMCS

Naviguez dans System Settings > Currencies :

Code ISO Préfixe Suffixe Format Décimales Taux Pivot Rôle
XAF (aucun) XAF 1 234 567 0 1.00000 Devise de Base (Défaut)
USD $ USD 1,234.56 2 0.00165 Diaspora & International
EUR € EUR 1 234,56 2 0.00152 Parité Fixe BEAC (655.957 XAF)

2.2 Application de la TVA à 19.25%

Sous System Settings > Tax Configuration :

  • Tax Support : Activé (Enabled).
  • Tax Type : Inclusive (TTC) ou Exclusive (HT) selon la cible (Exclusive recommandé pour B2B).
  • Règle Fiscale Niveau 1 : Pays = Cameroon (CM), Nom = TVA (19.25%), Taux = 19.25% (composé de 17.5% principal + 10% CAC).
  • Exemption fiscale : Clients hors CEMAC ou organisations internationales avec attestation d'exonération.

2.3 Mentions Légales Obligatoires des Factures

Raison Sociale : Kestrel Managed Systems (KMS.cm) SARL
Numéro d'Identifiant Unique (NIU) : M0524XXXXXXXXXX
Registre du Commerce (RCCM) : RC/DLA/2024/B/XXXX
Régime Fiscal : Réel Simplifié / DGE Douala
Siège Social : Akwa, Douala — République du Cameroun
03

Connexion de l'API DirectAdmin Pro & Approvisionnement Instantané

L'intégration WHMCS <-> DirectAdmin Pro permet la création instantanée d'un compte d'hébergement web dès confirmation du paiement Mobile Money, sans intervention humaine.

3.1 Génération d'une "Login Key" Sécurisée dans DirectAdmin

Ne fournissez JAMAIS le mot de passe root ou admin principal. Utilisez une Login Key restreinte aux commandes API requises :

  1. Dans DirectAdmin (en tant qu'utilisateur admin), allez dans Password / Login Keys.
  2. Cliquez sur Create Login Key.
  3. Nom de la clé : WHMCS_PROVISIONING_KEY.
  4. Autorisez uniquement les commandes suivantes :
    CMD_API_ACCOUNT_USER
    CMD_API_SHOW_USERS
    CMD_API_DOMAIN
    CMD_API_USER_PASSWD
    CMD_API_PACKAGES_USER
    CMD_API_SELECT_USERS
  5. Restreignez l'adresse IP cliente à : 163.245.192.41 (l'IP du serveur WHMCS).
  6. Copiez la clé générée.

3.2 Ajout du Serveur dans WHMCS

Sous WHMCS > System Settings > Servers > Add New Server :

  • Module : DirectAdmin
  • Hostname : servers.kms.cm
  • IP Address : 163.245.192.41
  • Nameservers : ns1.kms.cm (163.245.192.41) & ns2.kms.cm (163.245.192.41)
  • Server Node Type : OpenLiteSpeed + CloudLinux
  • Access Hash / Password : Collez la Login Key générée.
  • Secure : Cochez Use SSL Mode (Port 2222).

3.3 Correspondance des Packages (Packages Mapping)

Forfait KMS Package DirectAdmin Stockage NVMe Bases SQL Profil LVE CloudLinux
Starter kms_starter 5 120 Mo (5 Go) 3 1 vCPU, 1 Go RAM, 20 EP
Business kms_business 25 600 Mo (25 Go) 15 2 vCPU, 2 Go RAM, 40 EP
Unlimited kms_unlimited Illimité (Fair use) Illimité 4 vCPU, 4 Go RAM, 80 EP
04

Approvisionnement VPS Multi-Cœurs (Jusqu'à 56 Slices)

L'offre VPS de KMS s'appuie sur le moteur KVM modulaire InterServer proposant de 1 à 56 tranches (slices). Chaque tranche ajoute 1 vCPU, 2 Go de mémoire vive, 30 Go de stockage NVMe SSD et 2 To de transfert mensuel.

4.1 Configuration du Module VPS InterServer

Dans WHMCS, activez le module d'approvisionnement VPS :

  • Clé API : Définie dans .env sous INTERSERVER_API_KEY.
  • URL de l'API : https://my.interserver.net/api/vps
  • Choix du Système d'Exploitation : Configurable par le client à la commande (Options personnalisées : Ubuntu 24.04, Ubuntu 22.04, AlmaLinux 9, Debian 12, Windows Server 2022).
  • Actions automatisées dans l'espace client WHMCS : Redémarrage (Reboot), Arrêt (Power Off), Console Web VNC directe, Réinstallation de l'OS en 1-clic.
05

APIs des Registrars (Namecheap, Dynadot) & Marge Minimale de 35%

KMS connecte Dynadot en tant que registrar primaire (notamment pour les extensions internationales à bas coût et l'accès API REST v2) et Namecheap en tant que registrar secondaire et fournisseur de messagerie PrivateEmail.

5.1 Configuration de l'API Dynadot (REST v2)

  1. Connectez-vous à la console Dynadot > Tools > API.
  2. Générez votre API Key et inscrivez l'IP publique KMS : 163.245.192.41.
  3. Dans WHMCS > System Settings > Domain Registrars, activez Dynadot et saisissez la clé API.

5.2 Configuration de l'API Namecheap

  1. Accédez au tableau de bord Namecheap > Profile > Tools > Namecheap API Access.
  2. Ajoutez l'adresse IP serveur : 163.245.192.41 à la liste blanche (Whitelist).
  3. Renseignez le nom d'utilisateur API et la clé secrète dans config/domain_pricing.php et dans le module WHMCS.

5.3 Règle de Marge Minimale de 35% (Formule Automatique)

Le fichier d'automatisation config/domain_pricing.php applique strictement la règle de rentabilité KMS :

Prix_Vente_XAF = ceil( ( Coût_Achat_USD * Taux_Change_XAF * 1.35 ) / 5 ) * 5

Exemple : Un domaine .com acheté 9.50 USD chez Dynadot avec un dollar à 605 XAF coûte 5 747.5 XAF. Appliqué de la marge de 35% : 7 759 XAF. Arrondi aux 5 XAF supérieurs : 7 760 XAF prix plancher, commercialisé à 10 500 XAF/an sur KMS.cm (soit 82% de marge brute).

06

Notifications SMTP2GO & Twilio WhatsApp

6.1 Relais SMTP Transactionnel SMTP2GO

Pour éviter que les factures et identifiants DirectAdmin finissent dans les courriers indésirables (Spam), configurez SMTP2GO dans WHMCS > System Settings > General Settings > Mail :

  • Mail Type : SMTP
  • SMTP Host : mail.smtp2go.com
  • SMTP Port : 587 (avec chiffrement TLS) ou 465 (SSL)
  • SMTP Username : Votre nom d'utilisateur API SMTP2GO
  • SMTP Password : Votre mot de passe généré SMTP2GO
  • Sender Email : support@kms.cm ou billing@kms.cm

6.2 Piping des Emails Entrants (Support Desk)

Pour que les réponses des clients par email soient automatiquement converties en tickets sous WHMCS, ajoutez un forwarder dans DirectAdmin :

|/usr/local/bin/php -q /home/admin/domains/kms.cm/public_html/billing/crons/pipe.php

6.3 WhatsApp Automatisé avec Twilio

Le hook WHMCS includes/hooks/kms_whatsapp_smtp2go.php intercepte les événements majeurs pour expédier une notification WhatsApp bilingue sur le téléphone du client camerounais (+237...) :

  • Facture générée : Lien de paiement Mobile Money 1-clic.
  • Paiement reçu : Confirmation immédiate avec identifiants DirectAdmin.
  • Alerte expiration de domaine : Rappel à J-15, J-7 et J-1 avant suspension.
07

Intégration des Passerelles de Paiement CEMAC & Crypto

1. CamPay (MTN & Orange MoMo)

Déclenche un push USSD instantané sur le mobile du client avec saisie du code PIN.

Fichier : modules/gateways/campay.php

2. Fapshi (Passerelle Directe)

Garantit un taux de conversion élevé avec vérification HMAC et garde de fréquence.

Fichier : modules/gateways/fapshi.php

3. CinetPay (CEMAC Régional)

Agrégateur pour Gabon, Congo, Tchad, Centrafrique avec arrondi au pas de 5 XAF.

Fichier : modules/gateways/cinetpay.php

4. NOWPayments (Crypto USDT/BTC)

Règlement en USDT TRC-20 / ERC-20 pour clients internationaux et diaspora.

Fichier : modules/gateways/nowpayments.php
08

Intégration Zoho CRM : Capture des Leads & Pipeline Commercial

L'intégration de Zoho CRM permet de centraliser tous les prospects générés par le site vitrine kms.cm et de suivre le cycle de vie du client jusqu'à la signature du contrat.

8.1 Authentification OAuth 2.0 Zoho

  1. Accédez à la console développeur Zoho : https://api-console.zoho.com/.
  2. Créez un nouveau client de type Server-based Applications.
  3. Homepage URL : https://kms.cm — Authorized Redirect URI : https://billing.kms.cm/modules/addons/kms_zoho/callback.php.
  4. Scopes obligatoires :
    ZohoCRM.modules.ALL
    ZohoCRM.settings.ALL
    ZohoBooks.fullaccess.all
    ZohoProjects.projects.ALL
  5. Générez le Refresh Token permanent et inscrivez-le dans .env sous ZOHO_REFRESH_TOKEN.

8.2 Flux Automatisé Lead > Deal (Webhook Hook)

// Événement 1 : Formulaire de Contact Soumis sur KMS.cm
POST https://www.zohoapis.com/crm/v6/Leads
Payload: {
  "Last_Name": "Eto'o",
  "Company": "Indomitable Tech SARL",
  "Email": "contact@indomitable.cm",
  "Phone": "+237699000000",
  "Lead_Source": "KMS.cm Contact Form",
  "Lead_Status": "Nouveau Prospect Qualifié",
  "Service_Interet": "Hébergement Business + Nom de Domaine .CM"
}

// Événement 2 : Commande Payée sous WHMCS (Hook: OrderPaid)
1. Conversion automatique du Lead en "Contact" & "Compte"
2. Création d'une "Opportunité" (Deal) :
  • Nom : "Hébergement Web Business — Indomitable Tech"
  • Montant : 22 900 XAF
  • Étape : "Fermé Gagné (Closed Won)"
  • Date de Clôture : Date du Jour
09

Synchronisation Comptable avec Zoho Books & Zoho Invoice

Pour tenir une comptabilité certifiée OHADA conforme aux normes de la Direction des Grandes Entreprises (DGE) de Douala, chaque paiement enregistré sous WHMCS génère une écriture comptable miroir sous Zoho Books.

9.1 Plan Comptable OHADA dans Zoho Books

  • Compte 706100 : Ventes de prestations informatiques & Cloud (Hébergements, VPS).
  • Compte 706200 : Redevances enregistrement de noms de domaine (.cm, .com).
  • Compte 706300 : Revente de licences logicielles (Zoho Workplace, M365).
  • Compte 443100 : TVA Collectée à 19.25% sur prestations de services.
  • Compte 521100 / 521200 : Comptes Mobile Money (MTN MoMo Float / Orange Money Float).

9.2 Automatisation par le Hook WHMCS `kms_zoho_sync.php`

Dès l'exécution de InvoicePaymentSuccess dans WHMCS :

  1. Recherche du client dans Zoho Books via son email ; s'il n'existe pas, création de la fiche contact avec son NIU.
  2. Création de la facture de vente dans Zoho Books avec les lignes d'articles et le code taxe TVA_19.25.
  3. Enregistrement immédiat du règlement bancaire lié à la transaction CamPay / Fapshi.
10

Automatisation Zoho Projects pour les Prestations Web & Réseau

Lorsqu'un client commande une prestation de développement web sur-mesure (pages/webdev.php) ou une architecture réseau d'entreprise (pages/networking.php), WHMCS initialise automatiquement un projet collaboratif dans Zoho Projects.

10.1 Modèle de Jalons (Milestones Template)

Jalons Projet Créés Automatiquement :
1. [Phase Cadrage] : Validation du Cahier des Charges & Wireframes UX (J+3)
2. [Phase Infra] : Déploiement DirectAdmin Pro / VPS KVM & Certificats SSL (J+5)
3. [Phase Dév] : Développement PHP/Tailwind sur environnement Staging (J+15)
4. [Phase Sécurité] : Audit WAF Imunify360 & Tests de charge HTTP/3 (J+18)
5. [Phase Livraison] : Bascule DNS, Formation Client & Clôture (J+20)
11

Revente des Suites Collaboratives (Zoho Workplace, PrivateEmail, M365)

KMS commercialise 3 gammes d'emails professionnels adaptées aux différents profils d'entreprises :

1. Zoho Workplace Partner Portal Inscrivez votre organisation au programme partenaire Zoho Partner Portal. Les comptes sont créés automatiquement via l'API Zoho Mail Organization avec enregistrement des enregistrements DNS MX (mx.zoho.com, mx2.zoho.com, mx3.zoho.com), SPF (include:zoho.com) et DKIM.
2. KMS PrivateEmail (Namecheap Reseller) Boîtes aux lettres 15 Go avec chiffrement OpenPGP natif et ActiveSync Exchange, idéales pour professions libérales et cabinets d'avocats.
3. Google Workspace & Microsoft 365 Revente via distributeur cloud agréé (Pax8 ou Microsoft CSP) avec intégration API pour activation automatique des licences.
12

Runbook d'Exploitation & Guide de Dépannage Rapide

Q : Le webhook Mobile Money CamPay/Fapshi ne valide pas la facture WHMCS.

Vérification : Consultez le journal des passerelles dans WHMCS : Billing > Gateway Log. Vérifiez que l'URL de rappel (Callback URL) est bien en HTTPS public : https://billing.kms.cm/modules/gateways/callback/campay.php et que le jeton secret ou la signature HMAC est identique dans .env.

Q : DirectAdmin renvoie une erreur "Unauthorized" lors de la création d'un compte.

Vérification : Vérifiez dans DirectAdmin que la Login Key n'a pas expiré et que l'IP 163.245.192.41 figure dans la liste des IPs autorisées pour cette clé.

Q : Le token OAuth 2.0 Zoho renvoie "invalid_token".

Vérification : Exécutez le script de rafraîchissement manuel : php crons/refresh_zoho_token.php pour générer un nouvel Access Token valide 3 600 secondes à partir du Refresh Token permanent.