> ## Documentation Index
> Fetch the complete documentation index at: https://apidocs.gimpayapp.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 **Sandbox** 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.).

<Steps>
  <Step title="Générez un token">
    Ouvrez la page [Authentication](/getting-started/authentication), renseignez votre `client_id` et `client_secret` dans le panneau **Try it**, et cliquez sur **Send** pour obtenir un `access_token`.
  </Step>

  <Step title="Ouvrez l'endpoint à tester">
    Depuis l'onglet **Sandbox**, choisissez l'endpoint que vous souhaitez tester (par exemple *Collecter les pays*).
  </Step>

  <Step title="Renseignez l'autorisation">
    Dans le panneau **Try it**, collez votre `access_token` dans le champ `Authorization` au format `Bearer {{access_token}}`.
  </Step>

  <Step title="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.
  </Step>

  <Step title="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.
  </Step>
</Steps>

<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.
</Tip>

## 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](/getting-started/errors)** si un appel échoue, pour comprendre la cause probable avant de réessayer.

## Étapes suivantes

<CardGroup cols={2}>
  <Card title="Authentication" icon="key" href="/getting-started/authentication">
    Générez votre premier token d'accès.
  </Card>

  <Card title="Référence API" icon="code" href="/api-reference/introduction">
    Parcourez l'ensemble des endpoints disponibles dans le sandbox.
  </Card>
</CardGroup>