> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kemypay.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Vue d'ensemble de l'API

> Adresse de base, authentification, format des réponses et pagination

## Adresse de base

```
https://api.kemypay.com/v1
```

## Authentification

Envoyez votre clé secrète dans l'en-tête `Authorization` : `Bearer sk_live_…` ou `Bearer sk_test_…`. Les appels doivent venir d'une adresse IP autorisée. Voir [Authentification](https://docs.kemypay.com/fr/authentication.md).

## Format des réponses

```json theme={null}
{ "success": true, "data": { }, "meta": { "request_id": "a4f8e2c1b3d97056", "timestamp": "2026-10-29T10:00:00+00:00", "mode": "live" } }
```

Les listes ajoutent un objet `pagination` (`page`, `limit`, `total`, `pages`). Utilisez `?page=` et `?limit=` (de 1 à 100, 20 par défaut).

Erreurs : `{ "success": false, "error": { "code", "message", "details" }, "meta" }`. Voir [Erreurs](https://docs.kemypay.com/fr/guides/errors.md).

## Conventions

* Les montants sont des **chaînes** (`"1000.00"`), pour garder chaque décimale exacte.
* Les pays sont en ISO 3166-1 alpha-3 (`CMR`), les devises en ISO 4217 (`XAF`).
* Les opérateurs ont des codes stables (`MTN_CMR`). Enregistrez les codes, pas les noms.
* Les dates sont en ISO 8601 avec fuseau horaire.

## Points d'entrée

| Groupe | Points d'entrée |
| - | - |
| Catalogue | `GET /mobile-money/countries`, `GET /mobile-money/countries/{country}`, `GET /mobile-money/categories` |
| Services | `POST`, `GET /mobile-money/services`, `GET`, `PATCH /mobile-money/services/{code}`, `POST /services/{code}/disable`, `/enable`, `/rotate-secret` |
| Encaissements (bêta) | `POST /mobile-money/quote`, `POST /mobile-money/predict-operator`, `POST`, `GET /mobile-money/collections`, `GET /mobile-money/collections/{code}` |
| Soldes | `GET /mobile-money/balances` |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.