--- title: "Gérer les erreurs dans le SDK Android" description: "Gérez efficacement les erreurs du SDK Android grâce au guide de dépannage d'Adapty." --- Chaque erreur renvoyée par le SDK est de type `AdaptyError`. :::tip **Activez les journaux détaillés avant de déboguer.** La plupart des `AdaptyError` encapsulent une erreur sous-jacente de Play Billing, du réseau ou du backend. Avec les journaux détaillés activés (`Adapty.logLevel = AdaptyLogLevel.VERBOSE` — voir [Journalisation](sdk-installation-android#logging)), cette erreur encapsulée s'affiche dans la console, ce qui indique généralement la cause réelle. ::: :::important Si ces solutions ne résolvent pas votre problème, consultez [Autres problèmes](#other-issues) pour connaître les étapes à suivre avant de contacter le support afin de nous permettre de vous aider plus efficacement. ::: | Erreur | Solution | |----------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | UNKNOWN | Cette erreur indique qu'une erreur inconnue ou inattendue s'est produite. | | [ITEM_UNAVAILABLE](https://developer.android.com/reference/com/android/billingclient/api/BillingClient.BillingResponseCode#ITEM_UNAVAILABLE()) | Cette erreur survient principalement en phase de test. Elle peut signifier que les produits sont absents de la production ou que l'utilisateur n'appartient pas au groupe Testeurs dans Google Play. | | ADAPTY_NOT_INITIALIZED | Le SDK Adapty n'est pas activé.
Ce cas se présente le plus souvent quand un écran de démarrage ou un hook d'interface précoce appelle des méthodes Adapty avant que `Adapty.activate` ait terminé. Le symptôme est intermittent et peut ne pas se reproduire sur un émulateur, car le timing diffère d'un appareil réel. Attendez que `Adapty.activate` soit terminé avant de planifier tout autre appel SDK. Consultez [l'ordre des appels dans le SDK Android](android-sdk-call-order) pour la séquence complète. Vous devez également [configurer le SDK Adapty](sdk-installation-android#activate-adapty-module-of-adapty-sdk) correctement à l'aide de la méthode `Adapty.activate`. | | PROFILE_WAS_CHANGED | Le profil utilisateur a été modifié pendant l'opération.
Cela se produit lorsqu'une méthode est appelée alors qu'`Adapty.identify` est encore en cours — l'appel en vol atterrit sur un profil sur le point d'être remplacé, et le SDK le rejette. Attendez qu'`Adapty.identify` soit terminé avant de planifier d'autres appels SDK. Consultez [l'ordre des appels dans le SDK Android](android-sdk-call-order). | | PRODUCT_NOT_FOUND | Cette erreur indique que le produit demandé à l'achat n'est pas disponible dans le store. | | INVALID_JSON |

Le JSON du paywall de secours local n'est pas valide.

Corrigez votre paywall anglais par défaut, puis remplacez les paywalls locaux invalides. Consultez la rubrique [Personnaliser le paywall avec Remote Config](customize-paywall-with-remote-config) pour savoir comment corriger un paywall, et [Définir les paywalls de secours locaux](fallback-paywalls) pour savoir comment remplacer les paywalls locaux.

| |

CURRENT_SUBSCRIPTION_TO_UPDATE

\_NOT_FOUND_IN_HISTORY

| L'abonnement d'origine à remplacer est introuvable dans les abonnements actifs. | | [BILLING_SERVICE_TIMEOUT](https://developer.android.com/google/play/billing/errors#service_timeout_error_code_-3) | Cette erreur indique que la requête a atteint le délai d'attente maximal avant que Google Play puisse répondre. Cela peut être dû, par exemple, à un retard dans l'exécution de l'action demandée par l'appel à la Play Billing Library. | | [FEATURE_NOT_SUPPORTED](https://developer.android.com/reference/com/android/billingclient/api/BillingClient.BillingResponseCode#FEATURE_NOT_SUPPORTED()) | La fonctionnalité demandée n'est pas prise en charge par le Play Store sur l'appareil actuel. | | [BILLING_SERVICE_DISCONNECTED](https://developer.android.com/google/play/billing/errors#service_disconnected_error_code_-1) | Cette erreur indique que la connexion de l'application cliente au service Google Play Store via le `BillingClient` a été interrompue. | | [BILLING_SERVICE_UNAVAILABLE](https://developer.android.com/google/play/billing/errors#service_unavailable_error_code_2) | Cette erreur indique que le service Google Play Billing est actuellement indisponible. Dans la plupart des cas, cela signifie qu'il y a un problème de connexion réseau entre l'appareil client et les services Google Play Billing. | | [BILLING_UNAVAILABLE](https://developer.android.com/google/play/billing/errors#billing_unavailable_error_code_3) |

Cette erreur indique qu'un problème de facturation s'est produit pendant le processus d'achat. Causes possibles :

1. L'application Play Store sur l'appareil de l'utilisateur est absente ou obsolète.

2. L'utilisateur se trouve dans un pays non pris en charge.

3. L'utilisateur fait partie d'un compte entreprise dont l'administrateur a désactivé les achats.

4. Google Play n'a pas pu débiter le moyen de paiement de l'utilisateur (par exemple, une carte de crédit expirée).

5. L'utilisateur n'est pas connecté à l'application Play Store.

| | [DEVELOPER_ERROR](https://developer.android.com/google/play/billing/errors#developer_error) | Cette erreur indique que vous utilisez une API de manière incorrecte. | | [BILLING_ERROR](https://developer.android.com/google/play/billing/errors#error_error_code_6) | Cette erreur indique un problème interne à Google Play lui-même. | | [ITEM_ALREADY_OWNED](https://developer.android.com/reference/com/android/billingclient/api/BillingClient.BillingResponseCode#ITEM_ALREADY_OWNED()) | Le produit a déjà été acheté. | | [ITEM_NOT_OWNED](https://developer.android.com/reference/com/android/billingclient/api/BillingClient.BillingResponseCode#ITEM_NOT_OWNED()) | Cette erreur indique que l'action demandée sur l'article a échoué car l'utilisateur n'en est pas propriétaire. | | [BILLING_NETWORK_ERROR](https://developer.android.com/google/play/billing/errors#network_error_error_code_12) | Cette erreur indique qu'un problème de connexion réseau s'est produit entre l'appareil et les systèmes Play. | | NO_PRODUCT_IDS_FOUND |

Cette erreur indique qu'aucun des produits du paywall n'est disponible dans le store.

Si vous rencontrez cette erreur, suivez les étapes ci-dessous pour la résoudre :

  1. Vérifiez que tous les produits ont bien été ajoutés à l'Adapty Dashboard.
  2. Assurez-vous que le **Package name** de votre application correspond à celui indiqué dans la Google Play Console.
  3. Vérifiez que les identifiants de produits des stores correspondent à ceux que vous avez ajoutés au Dashboard. Notez que les identifiants ne doivent pas contenir le Bundle ID, sauf s'il est déjà inclus dans le store.
  4. Confirmez que le statut payant de l'application est **Active** dans vos paramètres fiscaux Google. Assurez-vous que vos informations fiscales sont à jour et que vos certificats sont valides.
  5. Vérifiez qu'un compte bancaire est associé à l'application afin qu'elle puisse être éligible à la monétisation.
  6. Vérifiez si les produits sont disponibles dans votre région.
  7. Assurez-vous que votre application figure dans l'un des canaux de test. Le canal **Internal testing** est l'option la plus simple, car il ne nécessite pas de validation et garde l'application invisible pour les clients.
| | NO_PURCHASES_TO_RESTORE | Cette erreur indique que Google Play n'a trouvé aucun achat à restaurer. | | AUTHENTICATION_ERROR | Vous devez [configurer le SDK Adapty](sdk-installation-android#activate-adapty-module-of-adapty-sdk) correctement à l'aide de la méthode `Adapty.activate`. | | BAD_REQUEST | Requête incorrecte.
Assurez-vous d'avoir effectué toutes les étapes nécessaires à l'[intégration avec Google Play](google-play-store-connection-configuration). | | SERVER_ERROR | Erreur serveur. | | REQUEST_FAILED | Cette erreur indique un problème réseau qui ne peut pas être défini précisément. | | DECODING_FAILED | Nous n'avons pas pu décoder la réponse.
Vérifiez votre code et assurez-vous que les paramètres que vous envoyez sont valides. Par exemple, cette erreur peut indiquer que vous utilisez une clé API invalide. | | ANALYTICS_DISABLED | Nous ne pouvons pas traiter les événements d'analyse, car vous avez [désactivé cette option](analytics-integration#disabling-external-analytics-for-a-specific-customer). | | WRONG_PARAMETER | Cette erreur indique que certains de vos paramètres sont incorrects : vide alors qu'il ne peut pas l'être, mauvais type, etc. | ## Autres problèmes \{#other-issues\} Si vous n'avez pas encore trouvé de solution, voici les prochaines étapes possibles : - **Mettre à jour le SDK vers la dernière version** : nous recommandons toujours de passer à la dernière version du SDK, car elle est plus stable et inclut des correctifs pour les problèmes connus. - **Contacter l'équipe support ou obtenir de l'aide auprès d'autres développeurs** dans le [forum d'assistance](https://adapty.featurebase.app/). - **Contacter l'équipe support via [support@adapty.io](mailto:support@adapty.io) ou via le chat** : si vous n'êtes pas prêt à mettre à jour le SDK ou si cela n'a pas résolu le problème, contactez notre équipe support. Notez que votre problème sera résolu plus rapidement si vous [activez la journalisation verbeuse](sdk-installation-android#logging) et partagez les logs avec l'équipe. Vous pouvez également joindre des extraits de code pertinents.