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

# Testez votre intégration

> Utilisez le sandbox interactif pour tester les APIs GIMgar Sud directement depuis la documentation.

Chaque page de l'onglet **API reference** intègre un panneau **Try it** qui vous permet d'exécuter un appel réel vers la plateforme de test GIMgar Sud, sans quitter la documentation ni installer d'outil externe (Postman, Insomnia, etc.).

**1. Générez un token**

Ouvrez la page [Authentication](https://sandbox.it-centrex.com/getting-started/authentication.md), renseignez votre `client_id` et `client_secret` dans le panneau **Try it**, et cliquez sur **Send** pour obtenir un `access_token`.

**2. Ouvrez l'endpoint à tester**

Depuis l'onglet **API reference**, choisissez l'endpoint que vous souhaitez tester (par exemple *Collecter les pays*).

**3. Renseignez l'autorisation**

Dans le panneau **Try it**, collez votre `access_token` dans le champ `Authorization` au format `Bearer {{access_token}}`.

**4. Complétez les paramètres**

Remplissez les paramètres de chemin, de requête ou le corps de la requête selon l'endpoint choisi.

**5. Envoyez la requête**

Cliquez sur **Send**. La réponse réelle de l'API. code de statut, en-têtes et corps  s'affiche directement dans la page.

> [!TIP]
>
> Le panneau **Try it** exécute un appel réel contre `{{baseUrl}}`, tel que défini dans la spécification OpenAPI. Utilisez des données de test, jamais des informations sensibles réelles.

## Bonnes pratiques de test

* **Commencez par les APIs de lecture** (`GET /countries`, `GET /wallets/type`...) pour vérifier que votre token fonctionne avant de tester les APIs qui modifient des données.
* **Suivez l'ordre d'un cas d'usage réel** : authentification → vérification des instruments de paiement → calcul des frais → génération d'un OTP → exécution de l'opération, plutôt que de tester les endpoints isolément.
* **Notez les références retournées** (`refUsagerGIMpay`, `referenceWallet`, `referenceOperation`...) au fil de vos tests : elles sont nécessaires en entrée des appels suivants.
* **Consultez la page [API Errors](https://sandbox.it-centrex.com/getting-started/errors.md)** si un appel échoue, pour comprendre la cause probable avant de réessayer.

## Étapes suivantes

> **[Authentication](https://sandbox.it-centrex.com/getting-started/authentication.md)**
>
> Générez votre premier token d'accès.

> **[Référence API](https://sandbox.it-centrex.com/api-reference/introduction.md)**
>
> Parcourez l'ensemble des endpoints disponibles dans API reference.


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