Restaurer les achats dans une application mobile avec le SDK Android

La restauration des achats est une fonctionnalité qui permet aux utilisateurs de récupérer l’accès à des contenus précédemment achetés, tels que des abonnements ou des achats intégrés, sans être facturés à nouveau. Cette fonctionnalité est particulièrement utile pour les utilisateurs qui ont désinstallé et réinstallé l’application, ou qui ont changé d’appareil et souhaitent accéder à leurs achats précédents sans payer de nouveau.

Note

Dans les paywalls créés avec le Paywall Builder, les achats sont restaurés automatiquement sans code supplémentaire de votre part. Si c’est votre cas, vous pouvez ignorer cette étape.

Pour restaurer un achat si vous n’utilisez pas le Paywall Builder pour personnaliser votre paywall, appelez la méthode .restorePurchases() :

Adapty.restorePurchases { result ->
    when (result) {
        is AdaptyResult.Success -> {
            val profile = result.value
                      
            if (profile.accessLevels["YOUR_ACCESS_LEVEL"]?.isActive == true) {
            // successful access restore
            }
        }
        is AdaptyResult.Error -> {
            val error = result.error
            // handle the error
        }
    }
}

Adapty.restorePurchases(result -> {
    if (result instanceof AdaptyResult.Success) {
        AdaptyProfile profile = ((AdaptyResult.Success<AdaptyProfile>) result).getValue();
        
        if (profile != null) {
            AdaptyProfile.AccessLevel premium = profile.getAccessLevels().get("YOUR_ACCESS_LEVEL");
            
            if (premium != null && premium.isActive()) {
                // restauration de l'accès réussie
            }
        }
    } else if (result instanceof AdaptyResult.Error) {
        AdaptyError error = ((AdaptyResult.Error) result).getError();
        // gérer l'erreur
    }
});

Paramètres de réponse :

Paramètre Description

Paramètre	Description
Profile	Un objet `AdaptyProfile`. Ce modèle contient des informations sur les niveaux d’accès, les abonnements et les achats uniques. Vérifiez le statut du niveau d’accès pour déterminer si l’utilisateur a accès à l’application.

Profile

Un objet AdaptyProfile. Ce modèle contient des informations sur les niveaux d’accès, les abonnements et les achats uniques.

Vérifiez le statut du niveau d’accès pour déterminer si l’utilisateur a accès à l’application.

Info

Dans Adapty Android SDK 4.0.2 et versions ultérieures, restorePurchases() se termine avec succès même s’il n’y a rien à restaurer : il renvoie le profil actuel, vérifiez donc le statut du niveau d’accès dans celui-ci. Dans les versions antérieures du SDK, la méthode échoue avec l’erreur NO_PURCHASES_TO_RESTORE dans ce cas.

Ce qui peut être restauré

restorePurchases récupère les abonnements actifs et les achats uniques non consommés depuis Google Play.

À partir du SDK Adapty Android 4.0.2, qui utilise la bibliothèque Google Play Billing Library 8, le Play Store ne renvoie plus les abonnements expirés ni les achats uniques consommés. Pour permettre aux utilisateurs de récupérer ces achats sur d’autres appareils ou après une réinstallation, identifiez-les avec Adapty.identify. Adapty restaure alors l’historique des achats depuis son backend plutôt que depuis le store.

Note

Google Play ne signale que les achats actuellement détenus, donc restorePurchases() ne peut pas retrouver les abonnements expirés avant votre intégration dans Adapty. Pour les ajouter à Adapty, importez vos données historiques.

Vous souhaitez voir un exemple concret d’intégration du SDK Adapty dans une application mobile ? Consultez nos exemples d’applications, qui illustrent la configuration complète, notamment l’affichage des paywalls, les achats et d’autres fonctionnalités de base.