Gestion des erreurs

SdkException (base)
├── TechnicalException (réseau, timeout, sérialisation...)
└── ApiException (réponse d'erreur de l'API GIMpay)
    ├── BadRequestException (400)
    ├── AuthenticationException (401)
    ├── UnauthorizedException (403)
    ├── NotFoundException (404)
    └── ServerErrorException (5xx)

import com.gimpaysdk.exception.*;

try {
    Double balance = sdk.wallets().getBalance("REF_WALLET_INEXISTANT");
    System.out.println("Solde : " + balance);
} catch (NotFoundException e) {
    log.warn("La ressource (portefeuille) n'a pas été trouvée.", e);
} catch (AuthenticationException e) {
    log.error("Erreur d'authentification. Vérifiez vos identifiants.", e);
} catch (UnauthorizedException e) {
    log.error("Droits insuffisants pour effectuer cette action.", e);
} catch (ApiException e) {
    log.error("Erreur API non gérée : Status={}, Body={}", e.getStatusCode(), e.getResponseBody(), e);
} catch (TechnicalException e) {
    log.error("Erreur technique (réseau, etc.) : {}", e.getMessage(), e);
}

// Exemple dans une application Spring
@Configuration
public class GIMpayConfig {
    @Bean
    public GIMpaySdk gimpaySdk(
        @Value("${gimpay.client-id}") String clientId,
        @Value("${gimpay.client-secret}") String clientSecret,
        @Value("${gimpay.base-url}") String baseUrl
    ) {
        return GIMpaySdk.init(clientId, clientSecret, baseUrl);
    }
}