Initialiser un projet

La commande lomi init prépare une intégration lomi. dans votre répertoire de projet : client SDK, exemples et fichier .env avec vos identifiants API.

Nécessite un lomi login préalable (ou LOMI_ACCESS_TOKEN en CI).

Usage

cd mon-projet
lomi init

Options

Option	Description
`-y, --yes`	Mode non interactif (requiert `--environment`, `--language`, `--api-key`)
`-e, --environment`	`production` ou `sandbox`
`-L, --language`	`ts` ou `js`
`--api-key`	Clé secrète écrite dans `.env`
`--skip-package-install`	Ignorer l'installation npm
`--skip-rules-install`	Ignorer l'installation des règles agent (`--yes` installe Cursor + llms.txt par défaut)
`--with-ui <name>`	Installer un composant lomi. UI après le scaffold (sans interaction)
`--skip-ui-install`	Ignorer l'invite d'installation lomi. UI
`[path]`	Répertoire projet (défaut : répertoire courant)

Exemple CI

lomi init --yes \
  --environment sandbox \
  --language ts \
  --api-key lomi_sk_test_xxx \
  --skip-package-install \
  --skip-rules-install

Avec lomi. UI (headless)

lomi init --yes \
  --environment sandbox \
  --language ts \
  --api-key lomi_sk_test_xxx \
  --with-ui payment-provider-selector \
  --skip-package-install

Nécessite Node.js et shadcn dans le projet cible (ou passez --yes pour que shadcn init s'exécute en non interactif).

Flux interactif

En mode interactif, lomi init demande :

Environnement: Production ou Sandbox (définit LOMI_API_URL)
Langage: TypeScript ou JavaScript pour les exemples générés
Clé API: Votre clé secrète depuis le portail marchand

Il peut aussi proposer lomi install-rules si vous n'avez pas encore installé les règles agent, et optionnellement un composant checkout lomi. UI via lomi ui.

Fichiers créés

Fichier	Rôle
`.env`	`LOMI_SECRET_KEY`, placeholder `LOMI_WEBHOOK_SECRET`, `LOMI_API_URL`
`lib/lomi./client.{ts\|js}`	Client SDK initialisé depuis `.env`
`examples/create-checkout-session.{ts\|js}`	Exemple création session checkout
`examples/webhook-handler.{ts\|js}`	Exemple handler webhook basique
`examples/embed-checkout.html`	Exemple embed modal, remplacez `CHECKOUT_URL` après `lomi checkout create`
`lomi.config.ts`	Configuration projet lomi.

Exemple .env :

LOMI_SECRET_KEY=lomi_sk_test_xxx
LOMI_WEBHOOK_SECRET=whsec_your_webhook_secret_here
LOMI_API_URL=https://sandbox.api.lomi.africa

Secrets hors git

Ajoutez .env à votre .gitignore. Ne commitez jamais de clés API secrètes ni de secrets webhook.

Dépendances

Si package.json existe (ou est créé), lomi init installe :

@lomi./sdk
dotenv

Utilisez --skip-package-install pour ignorer cette étape en CI et installer manuellement.

Après init

Relire les exemples générés

Ouvrez lib/lomi./client.ts et les fichiers dans examples/.

Ajouter votre secret webhook

Remplacez le placeholder LOMI_WEBHOOK_SECRET dans .env par le secret de signature du portail marchand.

Tester les webhooks en local

lomi dev

Pointez l'URL webhook du tableau de bord vers un tunnel (ex. ngrok) ou utilisez le serveur local en développement. Voir Serveur de développement local.

Vérifier l'auth CLI

lomi status

Prérequis

lomi login effectué (ou LOMI_ACCESS_TOKEN défini)
Une clé API secrète du portail marchand (lomi_sk_test_… ou lomi_sk_live_…)