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
- Connectez-vous à la console DirectAdmin :
https://163.245.192.41:2222ouhttps://servers.kms.cm:2222. - Naviguez dans Account Manager > Subdomain Management.
- Cliquez sur Add Subdomain, saisissez
billinget validez. - DirectAdmin génère automatiquement le répertoire racine :
/home/admin/domains/kms.cm/public_html/billing. - Naviguez dans Account Manager > SSL Certificates, sélectionnez Free & automatic certificate from Let's Encrypt, cochez
billing.kms.cmet cliquez sur Save.
/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 :
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
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 :
- Dans DirectAdmin (en tant qu'utilisateur
admin), allez dans Password / Login Keys. - Cliquez sur Create Login Key.
- Nom de la clé :
WHMCS_PROVISIONING_KEY. - 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 - Restreignez l'adresse IP cliente à :
163.245.192.41(l'IP du serveur WHMCS). - 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 |
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
.envsousINTERSERVER_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.
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)
- Connectez-vous à la console Dynadot > Tools > API.
- Générez votre API Key et inscrivez l'IP publique KMS :
163.245.192.41. - Dans WHMCS > System Settings > Domain Registrars, activez
Dynadotet saisissez la clé API.
5.2 Configuration de l'API Namecheap
- Accédez au tableau de bord Namecheap > Profile > Tools > Namecheap API Access.
- Ajoutez l'adresse IP serveur :
163.245.192.41à la liste blanche (Whitelist). - Renseignez le nom d'utilisateur API et la clé secrète dans
config/domain_pricing.phpet 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 :
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).
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) ou465(SSL) - SMTP Username : Votre nom d'utilisateur API SMTP2GO
- SMTP Password : Votre mot de passe généré SMTP2GO
- Sender Email :
support@kms.cmoubilling@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 :
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.
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.php2. Fapshi (Passerelle Directe)
Garantit un taux de conversion élevé avec vérification HMAC et garde de fréquence.
Fichier : modules/gateways/fapshi.php3. CinetPay (CEMAC Régional)
Agrégateur pour Gabon, Congo, Tchad, Centrafrique avec arrondi au pas de 5 XAF.
Fichier : modules/gateways/cinetpay.php4. NOWPayments (Crypto USDT/BTC)
Règlement en USDT TRC-20 / ERC-20 pour clients internationaux et diaspora.
Fichier : modules/gateways/nowpayments.phpInté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
- Accédez à la console développeur Zoho :
https://api-console.zoho.com/. - Créez un nouveau client de type Server-based Applications.
- Homepage URL :
https://kms.cm— Authorized Redirect URI :https://billing.kms.cm/modules/addons/kms_zoho/callback.php. - Scopes obligatoires :
ZohoCRM.modules.ALL
ZohoCRM.settings.ALL
ZohoBooks.fullaccess.all
ZohoProjects.projects.ALL - Générez le Refresh Token permanent et inscrivez-le dans
.envsousZOHO_REFRESH_TOKEN.
8.2 Flux Automatisé Lead > Deal (Webhook Hook)
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
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 :
- Recherche du client dans Zoho Books via son email ; s'il n'existe pas, création de la fiche contact avec son NIU.
- Création de la facture de vente dans Zoho Books avec les lignes d'articles et le code taxe
TVA_19.25. - Enregistrement immédiat du règlement bancaire lié à la transaction CamPay / Fapshi.
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)
Revente des Suites Collaboratives (Zoho Workplace, PrivateEmail, M365)
KMS commercialise 3 gammes d'emails professionnels adaptées aux différents profils d'entreprises :
mx.zoho.com, mx2.zoho.com, mx3.zoho.com), SPF (include:zoho.com) et DKIM.
Runbook d'Exploitation & Guide de Dépannage Rapide
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.
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é.
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.