Restaurer les achats dans une application mobile avec le SDK Android

Restaurer les achats est une fonctionnalité qui permet aux utilisateurs de récupérer l’accès à du contenu précédemment acheté, comme des abonnements ou des achats intégrés, sans être débité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 à leur contenu précédemment acheté sans repayer.

Note

Si vous avez conçu l’écran dans un builder, vous n’avez pas besoin de restaurer les achats manuellement. Associez son contrôle de restauration — l’action Restore purchases dans le Flow & Paywall Builder, ou un lien ou bouton de restauration dans l’ancien — et le SDK effectue la restauration.

Si vous avez conçu l’écran vous-même, 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

À partir d’Adapty Android SDK 3.17.3 et 4.0.2, 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 ce profil. 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 3.17.3 et 4.0.2, qui utilisent 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 les récupérer 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.

Tip

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