Skip to main content
Chaque API GIMgar Sud retourne un code de statut HTTP standard accompagné d’une cause précise. Utilisez le code de statut pour déterminer la catégorie du problème, puis reportez-vous à la section Codes d’erreur de la page de l’endpoint concerné pour la cause exacte.

​
Codes de statut HTTP

Un paramètre requis est manquant, ou une donnée fournie est incorrecte (format invalide, valeur hors énumération, etc.). Corrigez la requête avant de réessayer.
Le token Bearer est manquant, invalide ou expiré. Générez un nouveau token via Authentication et réessayez.
L’entité demandée (usager, instrument de paiement, contributeur, MMP, service, opération, pays, terminal…) est introuvable. Vérifiez l’identifiant utilisé.
L’entité existe mais n’est pas dans le statut attendu pour cette action. Par exemple verrouiller un instrument de paiement déjà inactif, ou désenrôler un instrument déjà désenrôlé.
L’action entre en conflit avec un état existant. Par exemple ajouter un bénéficiaire ou une MMP déjà marqués comme favoris.
Problème côté serveur GIMgar Sud. Réessayez après un court délai ; contactez le support si l’erreur persiste.
L’API d’authentification (POST /api/v1/auth/token) ne retourne que les codes 400 et 500, puisqu’aucun token n’est requis pour l’obtenir.

​
Stratégie de nouvel essai

Ne réessayez pas une erreur 4xx sans modifier la requête. Le problème vient de la requête elle-même et le même appel échouera à nouveau. Réessayez une erreur 500 après un court délai. Si le problème persiste après plusieurs tentatives, contactez le support GIM-UEMOA.

​
Étapes suivantes

Authentication

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

Tester votre intégration

Utilisez le sandbox interactif pour observer ces erreurs en conditions réelles.