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

# GET /v1/countries

> Obtenez les pays et opérateurs actifs pour les dépôts ou les payouts.

```http theme={null}
GET https://www.ashtechpay.com/v1/countries
```

Par défaut, cette requête retourne le catalogue des dépôts. Pour les retraits Mobile Money, ajoutez `?operation=payout` :

```http theme={null}
GET https://www.ashtechpay.com/v1/countries?operation=payout
```

La réponse payout contient le code à envoyer comme `country_code`, les opérateurs de retrait actifs et `wallet_currency`, le wallet interne résolu pour ce pays. Le champ `currency` reste la devise ISO normalisée. `wallet_currency` est informatif : le payout choisit toujours le wallet côté serveur à partir du `country_code`.

> [tab] Node.js
>
> ```javascript theme={null}
> const response = await fetch("https://www.ashtechpay.com/v1/countries", {
>   headers: {
>     Authorization: `Bearer ${process.env.ASHTECH_API_KEY}`,
>   },
> });
>
> const countries = await response.json();
> ```

> [tab] Python
>
> ```python theme={null}
> import os
> import requests
>
> response = requests.get(
>     "https://www.ashtechpay.com/v1/countries",
>     headers={"Authorization": f"Bearer {os.environ['ASHTECH_API_KEY']}"},
> )
> countries = response.json()
> ```

> [tab] cURL
>
> ```bash theme={null}
> curl https://www.ashtechpay.com/v1/countries \
>   -H "Authorization: Bearer $ASHTECH_API_KEY"
> ```

> [tab] PHP / Laravel
>
> ```php theme={null}
> <?php
>
> $ch = curl_init("https://www.ashtechpay.com/v1/countries");
> curl_setopt_array($ch, [
>     CURLOPT_RETURNTRANSFER => true,
>     CURLOPT_HTTPHEADER => [
>         "Authorization: Bearer " . getenv("ASHTECH_API_KEY"),
>     ],
> ]);
>
> $countries = json_decode(curl_exec($ch), true);
> curl_close($ch);
> ```

La réponse contient les pays actifs, leur devise ISO normalisée et les opérateurs disponibles pour l'opération choisie. Utilisez le champ `code` pour sélectionner le pays. En mode `operation=payout`, `wallet_currency` indique le wallet interne que le serveur débitera. Le champ `currency` (`XAF`, `XOF`, etc.) ne représente pas toujours ce code interne. Pour une conversion, envoyez plutôt `destination_country_code`; AshTech Pay résout le wallet correspondant. Consultez [Wallets et conversions](https://doc.ashtechpay.com/docs/direct-api/wallets-conversions.md) pour le détail.

```json theme={null}
[
  {
    "code": "TG",
    "name": "Togo",
    "currency": "XOF",
    "operators": ["Flooz (Moov)", "Mixx By Yas"],
    "unavailable_operators": []
  }
]
```

Le catalogue peut évoluer. Rafraîchissez-le régulièrement et refusez côté serveur les opérateurs qui ne sont plus actifs.


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