Gestion des erreurs

Exceptions typées

Toutes les méthodes de la façade Gimpay lèvent des exceptions typées dérivées de GimPayApiException.

Exception	Cas
`ValidationException`	Donnée invalide, rejetée avant l’appel réseau (`statusCode` `null`) ou par le serveur (`422`)
`UnauthorizedException`	token/credentials invalides (`401`) ou échec du `tokenProvider`
`NotFoundException`, `BadRequestException`, `ForbiddenException`	Erreurs `4xx` correspondantes
`ConflictException`	`409` — notamment sur `executeOperation` quand le `requestId` fourni a déjà été traité. Ne rejouez pas l’opération avec un nouveau `requestId` sans vérifier le statut de la tentative d’origine
`ServerException`	Erreurs `5xx` (le SDK a déjà retenté automatiquement)
`NetworkException`, `RequestTimeoutException`	Connectivité / délai dépassé
`GimpayNotInitializedException`	Méthode appelée avant l’initialisation du SDK

try {
  await Gimpay.getBalance(reference);
} on ValidationException catch (e) {
  log(e.message);
} on GimPayApiException catch (e) {
  log('${e.statusCode} ${e.message}', details: e.details);
}

Les énumérations renvoyées par l’API (statutOperation, statutMmp…) valent null si le serveur renvoie une valeur inconnue de votre version du SDK. Prévoyez toujours le cas null.

Bonnes pratiques

Sécurité

Utilisez le mode tokenProvider en production ; appelez Gimpay.logout() à la déconnexion de l’utilisateur ; ne journalisez jamais PAN, CVV ou tokens côté application ; n’activez enableLogs qu’en debug.

Dates

Le SDK prend des DateTime et formate lui-même au format attendu par l’API (yyyy-MM-dd).

MSISDN

Le SDK expose msisdn partout et gère lui-même la conversion vers le nom de champ attendu par l’API.

Montants

Les montants sont des double, strictement positifs. Validés côté SDK avant l’appel réseau.

Retries

Timeouts, erreurs réseau et 5xx sont retentés automatiquement (2 tentatives). N’ajoutez pas votre propre logique de retry par-dessus.

Flutter

Java

Exceptions typées

Bonnes pratiques

Étapes suivantes

Démarrage rapide

Couverture des APIs

​Exceptions typées

​Bonnes pratiques

​Étapes suivantes

Démarrage rapide

Couverture des APIs

Exceptions typées

Bonnes pratiques

Étapes suivantes