Initialiser un projet
Intégrez lomi. dans le répertoire de votre projet existant.
La commande lomi. init amorce une intégration dans le répertoire de votre projet existant. Elle configure les fichiers indispensables et du code d’exemple issu du SDK Node.js lomi., pour que votre application communique avec l’API.
Utilisation
Placez-vous à la racine du projet dans le terminal et exécutez :
lomi. initComportement
La commande effectue notamment :
Invite de configuration
Demande interactive des paramètres pour le SDK dans votre projet :
- Clé API (
LOMI_API_KEY) : votre clé API secrète issue du portail marchand lomi., enregistrée dans.envpour authentifier le SDK. Ce n’est pas le jeton CLI utilisé parlomi. login. - Environnement :
production(live) ousandbox(tests) pour les points de terminaison API lomi. du SDK. - Secret webhook (
LOMI_WEBHOOK_SECRET) : secret de signature webhook du portail marchand lomi., dans.envpour que votre application vérifie les webhooks entrants. - Langage :
TypeScriptouJavaScriptpour l’exemple de code généré. - Gestionnaire de paquets :
npm,yarnoupnpmpour installer le SDK.
Création du fichier .env
Génère un .env à la racine avec les identifiants du SDK Node.js lomi. :
# Your lomi. API Key (get it from https://lomi.africa/portal/settings/api-keys)
LOMI_API_KEY=your_api_key_here
# Your Webhook Signing Secret (get it from https://lomi.africa/portal/webhooks)
LOMI_WEBHOOK_SECRET=whsec_your_webhook_secret_here
# API URL for the SDK (defaults to production)
# Use https://sandbox.api.lomi.africa for testing
LOMI_API_URL=https://api.lomi.africaSécurité : ignorer .env
Ajoutez toujours .env à .gitignore pour éviter de committer des secrets.
Fichiers d’exemple
Génère du code illustrant le SDK Node.js lomi. selon le langage choisi :
lib/lomi./client.{ts|js}: clients SDK initialisés, chargement depuis.env.examples/checkout.{ts|js}: création d’une session de paiement.examples/webhook.{ts|js}: serveur HTTP minimal pour recevoir et vérifier les webhooks avecLOMI_WEBHOOK_SECRET.
Installation des dépendances
Installe les paquets nécessaires (lomi., dotenv) avec le gestionnaire choisi.
Exemple de sortie
À la fin, un résumé s’affiche :
Project setup complete!
Created Files:
- .env (Contains SDK API Key & Webhook Secret - KEEP SAFE & add to .gitignore!)
- lib/lomi./client.ts
- examples/checkout.ts
- examples/webhook.ts
Installed Dependencies:
- lomi.
- dotenv
Next Steps:
1. Review the example code in `lib/` and `examples/`.
2. Load environment variables (from `.env`) in your application before initializing the lomi. SDK client.
3. Start building your lomi. integration!
4. Use `lomi. dev` to test webhook events locally during development.
5. Verify your CLI login status with `lomi. status` if needed.Prérequis
- Exécutez de préférence
lomi. loginavant ;initse concentre surtout sur le SDK. - Ayez sous la main votre clé API lomi. et votre secret webhook dans le portail marchand lomi. (Settings > API Keys et Webhooks).