# Vue d’ensemble
Source: https://docs.lomi.africa/api

Utilisez l’API marchande publique lomi. pour accepter des paiements, gérer les objets commerce, déplacer l’argent et traiter les événements opérationnels.

***

title: Vue d’ensemble
description: 'Utilisez l’API marchande publique lomi. pour accepter des paiements, gérer les objets commerce, déplacer l’argent et traiter les événements opérationnels.'
index: true
-----------

La référence API documente l’API marchande publique : les endpoints qu’un développeur doit utiliser depuis une intégration serveur. Elle n’expose volontairement pas les services internes de providers, organisations, administration marchande ou agents.

Si vous choisissez encore votre chemin d’intégration, commencez par [Parcours d’intégration](/start/integration-journey) ou [Quelle intégration choisir ?](/build/choose-integration).

## URLs de base

| Environnement | URL de base                       | Clé secrète        |
| ------------- | --------------------------------- | ------------------ |
| Test          | `https://sandbox.api.lomi.africa` | `lomi_sk_test_...` |
| Live          | `https://api.lomi.africa`         | `lomi_sk_live_...` |

Envoyez la clé secrète dans l’en-tête `X-API-Key` depuis votre serveur.

## Encaisser des paiements

| Objectif                                   | API                                            |
| ------------------------------------------ | ---------------------------------------------- |
| Checkout hébergé                           | [Sessions de checkout](/api/checkout-sessions) |
| URLs de paiement partageables              | [Liens de paiement](/api/payment-links)        |
| Demandes de paiement créées par le backend | [Demandes de paiement](/api/payment-requests)  |
| Flux Wave, MTN et carte plus bas niveau    | [Encaissements directs avancés](/api/charge)   |

## Gérer votre commerce

| Objectif                                      | API                               |
| --------------------------------------------- | --------------------------------- |
| Clients et sessions de portail client         | [Clients](/api/customers)         |
| Produits, prix et catalogues                  | [Produits](/api/products)         |
| Facturation récurrente et abonnements clients | [Abonnements](/api/subscriptions) |
| Codes promo et performance des coupons        | [Coupons](/api/coupons)           |

## Déplacer et réconcilier l’argent

| Objectif                                  | API                               |
| ----------------------------------------- | --------------------------------- |
| Lire les soldes disponibles et en attente | [Soldes](/api/balances)           |
| Inspecter les enregistrements de paiement | [Transactions](/api/transactions) |
| Créer et inspecter des remboursements     | [Remboursements](/api/refunds)    |
| Créer et inspecter des reversements       | [Reversements](/api/payouts)      |

## Opérer de façon fiable

| Objectif                                                                                       | API                       |
| ---------------------------------------------------------------------------------------------- | ------------------------- |
| Configurer les endpoints, tester les livraisons, inspecter les journaux et relancer les échecs | [Webhooks](/api/webhooks) |

## Conventions de référence

* Les guides expliquent les décisions produit et les flux complets.
* Les pages API décrivent les opérations HTTP exactes.
* Les encaissements directs sont avancés ; le checkout hébergé reste la recommandation par défaut.
* Utilisez la sandbox pour développer et le live seulement après [Que vérifier avant le live ?](/start/go-live).

## Règles de contrat

* **Montants :** les champs `amount` publics sont des entiers en unités mineures. `10000` vaut 10 000 XOF, ou 100,00 USD/EUR. Envoyez toujours `currency_code`.
* **Idempotence :** `Idempotency-Key` est obligatoire sur `POST /checkout-sessions`, `POST /payment-requests`, `POST /refunds`, `POST /payouts`, `POST /settlements/instant` et `POST /charge/*`. Voir [Clés d’idempotence](/build/reliability/idempotency-keys).
* **Listes :** interrogez avec `cursor` et `limit` (défaut 20, max 100). Réponse `{ object: "list", data, has_more, next_cursor, limit }`.
* **Erreurs :** `{ error: { code, message, details }, request_id }`. Voir [Gestion des erreurs](/api/errors).
* **Limites :** les réponses réussies incluent `X-RateLimit-Remaining` et les en-têtes IETF `RateLimit` / `RateLimit-Policy`. Un `429` inclut `Retry-After`.
* Les routes restent sans version. La `info.version` OpenAPI est la version du schéma. Envoyez `Lomi-Version` pour figer un schéma connu.