Comment faire un paiement de test ?

C’est le chemin le plus rapide pour vérifier que votre compte lomi., votre clé API, le checkout et vos hypothèses webhook fonctionnent ensemble.

Avant de commencer

Il vous faut :

Un compte lomi.
Accès CLI via lomi login, ou une clé secrète de test comme lomi_sk_test_....
Une URL de succès et une URL d’annulation, locales ou hébergées.

Option A : CLI (recommandé)

Installer et se connecter

npm install -g lomi.cli
lomi login
lomi quickstart

Créer une session de checkout

Mode interactif :

lomi checkout create

Sans interaction (scripts et agents) :

lomi checkout create \
  --amount 10000 \
  --currency XOF \
  --success-url https://example.com/success \
  --cancel-url https://example.com/cancel \
  --json

Ouvrez le checkout_url de la sortie dans le navigateur.

Relayer les webhooks (optionnel)

lomi listen http://localhost:3000/webhooks

Voir Démarrer avec le CLI pour le parcours terminal complet.

Option B : cURL

Créer une session de checkout

curl -sS -X POST "https://sandbox.api.lomi.africa/checkout-sessions" \
  -H "X-API-Key: $LOMI_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 10000,
    "currency_code": "XOF",
    "title": "Commande de test",
    "success_url": "https://example.com/success",
    "cancel_url": "https://example.com/cancel"
  }'

La réponse contient une URL de checkout hébergé. Ouvrez-la dans votre navigateur.

Page de paiement checkout hébergé lomi. en sandbox

2. Payer avec un moyen de test

Pour un paiement carte réussi simple, utilisez :

Champ	Valeur
Numéro de carte	`4242 4242 4242 4242`
Expiration	Une date future, par exemple `12/34`
CVC	Trois chiffres au choix

Vous pouvez aussi tester le mobile money en sandbox. Consultez paiements sandbox pour le comportement complet.

Vérifier le résultat

Après le paiement, vérifiez :

Le checkout redirige vers votre URL de succès.
La transaction apparaît dans la vue test du tableau de bord.
Votre solde de test évolue si la méthode crée une transaction complétée.
Votre endpoint webhook reçoit l’événement si les webhooks sont configurés.

Depuis le CLI :

lomi transactions list --json

Que construire ensuite ?

Suivez le parcours complet dans le Parcours d’intégration.
Utilisez le checkout hébergé pour une app ou boutique, exemple exécutable : plugin de référence checkout hébergé.
Utilisez les liens de paiement si vous voulez une URL partageable.
Pour Wave, MTN ou carte initiés côté serveur, voir Charges directes et le plugin de référence charge directe.
Utilisez les webhooks pour réconcilier les états côté serveur.
Consultez la référence API pour les détails exacts des endpoints.

Comment faire un paiement de test ?

Sur cette page