Skip to main content
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.).
1

Générez un token

Ouvrez la page Authentication, 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 Sandbox, 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.
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 si un appel échoue, pour comprendre la cause probable avant de réessayer.

Étapes suivantes

Authentication

Générez votre premier token d’accès.

Référence API

Parcourez l’ensemble des endpoints disponibles dans le sandbox.