Skip to main content

​
Exceptions typées

Toutes les méthodes de la façade Gimpay lèvent des exceptions typées dérivées de GimPayApiException.
ExceptionCas
ValidationExceptionDonnée invalide, rejetée avant l’appel réseau (statusCode null) ou par le serveur (422)
UnauthorizedExceptiontoken/credentials invalides (401) ou échec du tokenProvider
NotFoundException, ConflictException, BadRequestException, ForbiddenExceptionErreurs 4xx correspondantes
ServerExceptionErreurs 5xx (le SDK a déjà retenté automatiquement)
NetworkException, RequestTimeoutExceptionConnectivité / délai dépassé
GimpayNotInitializedExceptionMé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

1

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.
2

Dates

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

MSISDN

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

Montants

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

Retries

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

​
Étapes suivantes

Démarrage rapide

Revoir le parcours d’intégration type.

Couverture des APIs

La liste complète des endpoints disponibles.