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

# Introduction

> Catalogue des pays et réseaux mobile money supportés par SasPay.

## Vue d'ensemble

SasPay opère sur plusieurs pays d'Afrique de l'Ouest et du Centre, chacun rattaché à une devise, et sur les réseaux mobile money disponibles dans chacun d'eux.

```
Pays (Country)
├── iso_code           ── "BJ", "CI", "SN"...
├── default_currency    ── "XOF", "XAF"...
│
└── Réseaux (Network)   ── rattachés à un pays
    ├── code             ── "mtn_bj", "moov_ci"...  ← à utiliser dans vos requêtes
    ├── name
    └── is_active
```

<Note>
  `code` (ex. `"mtn_bj"`) est la valeur à utiliser dans le champ `network` de [Initier un paiement softpay](/api-reference/payments/softpay) et dans le champ `method` de [Initier un retrait](/api-reference/payouts/initialize). C'est la clé technique qui relie ce catalogue de référence aux endpoints de paiement.
</Note>

## Pays

* [Lister les pays](/api-reference/reference/countries)
* [Détail d'un pays](/api-reference/reference/country-get)

| Champ                       | Type     | Description                     |
| --------------------------- | -------- | ------------------------------- |
| `id`                        | uuid     | Identifiant du pays             |
| `iso_code`                  | string   | Code ISO 2 lettres, ex. `BJ`    |
| `name`                      | string   | Nom du pays                     |
| `default_currency`          | string   | Devise ISO 3 lettres, ex. `XOF` |
| `created_at` / `updated_at` | datetime | —                               |

**Exemple**

```json theme={null}
{
  "id": "6d1a...",
  "iso_code": "BJ",
  "name": "Bénin",
  "default_currency": "XOF"
}
```

<Note>
  `GET /countries/` est **public** — aucune authentification requise, fonctionne même sans clé API. Pratique pour peupler un formulaire d'inscription avant qu'un compte n'existe. La liste n'est **pas paginée** (tableau JSON brut, pas d'enveloppe `{count, results}`) : c'est un catalogue borné, à récupérer en un seul appel.

  `GET /countries/{id}/`, en revanche, nécessite une authentification (clé API valide) — contrairement à la liste.
</Note>

## Réseaux

* [Lister les réseaux](/api-reference/reference/networks)
* [Détail d'un réseau](/api-reference/reference/network-get)

| Champ                       | Type     | Description                                                                                       |
| --------------------------- | -------- | ------------------------------------------------------------------------------------------------- |
| `id`                        | uuid     | Identifiant du réseau                                                                             |
| `country`                   | uuid     | Pays auquel ce réseau est rattaché                                                                |
| `code`                      | string   | Valeur technique, ex. `mtn_bj` — utilisée comme `network`/`method` dans les endpoints de paiement |
| `name`                      | string   | Nom lisible, ex. `MTN Mobile Money`                                                               |
| `is_active`                 | boolean  | Réseau actuellement opérationnel côté SasPay                                                      |
| `created_at` / `updated_at` | datetime | —                                                                                                 |

<Warning>
  Contrairement à `/countries/`, `GET /networks/` nécessite une authentification et **est paginé**. Il n'existe surtout **aucun filtre `?country=`**, malgré le besoin évident de "quels réseaux pour ce pays" — vous devez lister l'ensemble et filtrer côté client sur le champ `country`.
</Warning>