Comment faire un paiement de test ?
Créez une session de checkout en sandbox, ouvrez l’URL hébergée, payez avec un moyen de test et vérifiez le résultat.
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.
- 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.
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.

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.
Que construire ensuite ?
- Utilisez le checkout hébergé pour une app ou boutique.
- Utilisez les liens de paiement si vous voulez une URL partageable.
- Utilisez les webhooks pour réconcilier les états côté serveur.
- Consultez la référence API pour les détails exacts des endpoints.