Effectuer des achats dans une application mobile avec le SDK Android

Afficher des paywalls dans votre application mobile est une étape essentielle pour offrir aux utilisateurs l’accès à des contenus ou services premium. Cependant, se contenter d’afficher ces paywalls suffit à gérer les achats uniquement si vous utilisez le Paywall Builder pour les personnaliser.

Si vous n’utilisez pas le Paywall Builder, vous devez utiliser une méthode dédiée appelée .makePurchase() pour finaliser un achat et débloquer le contenu souhaité. Cette méthode sert de point d’entrée pour que les utilisateurs interagissent avec les paywalls et procèdent à leurs transactions.

Si votre paywall comporte une offre promotionnelle active pour le produit qu’un utilisateur souhaite acheter, Adapty l’appliquera automatiquement au moment de l’achat.

Gardez à l’esprit que l’offre de lancement ne sera appliquée automatiquement que si vous utilisez des paywalls configurés avec le Paywall Builder.

Dans les autres cas, vous devrez vérifier l’éligibilité de l’utilisateur à une offre de lancement sur iOS. Ignorer cette étape peut entraîner le rejet de votre application lors de la publication. De plus, cela pourrait conduire à facturer le plein tarif à des utilisateurs pourtant éligibles à une offre de lancement.

Assurez-vous d’avoir effectué la configuration initiale sans sauter la moindre étape. Sans elle, nous ne pouvons pas valider les achats.

Effectuer un achat

Vous utilisez le Paywall Builder ? Les achats sont traités automatiquement — vous pouvez ignorer cette étape.

Vous cherchez un guide pas à pas ? Consultez le guide de démarrage rapide pour des instructions d’implémentation complètes avec tout le contexte nécessaire.

Adapty.makePurchase(activity, product, null) { result ->
    when (result) {
        is AdaptyResult.Success -> {
            when (val purchaseResult = result.value) {
                is AdaptyPurchaseResult.Success -> {
                    val profile = purchaseResult.profile
                    if (profile.accessLevels["YOUR_ACCESS_LEVEL"]?.isActive == true) {
                        // Grant access to the paid features
                    }
                }

                is AdaptyPurchaseResult.UserCanceled -> {
                    // Handle the case where the user canceled the purchase
                }

                is AdaptyPurchaseResult.Pending -> {
                    // Handle deferred purchases (e.g., the user will pay offline with cash)
                }
            }
        }
        is AdaptyResult.Error -> {
            val error = result.error
            // Handle the error
        }
    }
}

Adapty.makePurchase(activity, product, null, result -> {
    if (result instanceof AdaptyResult.Success) {
        AdaptyPurchaseResult purchaseResult = ((AdaptyResult.Success<AdaptyPurchaseResult>) result).getValue();

        if (purchaseResult instanceof AdaptyPurchaseResult.Success) {
            AdaptyProfile profile = ((AdaptyPurchaseResult.Success) purchaseResult).getProfile();
            AdaptyProfile.AccessLevel premium = profile.getAccessLevels().get("YOUR_ACCESS_LEVEL");

            if (premium != null && premium.isActive()) {
                // Grant access to the paid features
            }
        } else if (purchaseResult instanceof AdaptyPurchaseResult.UserCanceled) {
            // Handle the case where the user canceled the purchase
        } else if (purchaseResult instanceof AdaptyPurchaseResult.Pending) {
            // Handle deferred purchases (e.g., the user will pay offline with cash)
        }
    } else if (result instanceof AdaptyResult.Error) {
        AdaptyError error = ((AdaptyResult.Error) result).getError();
        // Handle the error
    }
});

Paramètres de la requête :

Paramètre	Présence	Description
Product	requis	Un objet `AdaptyPaywallProduct` récupéré depuis le paywall.

Paramètres de la réponse :

Paramètre	Description
Profile	Si la requête a réussi, la réponse contient cet objet. Un objet AdaptyProfile fournit des informations complètes sur les niveaux d’accès, les abonnements et les achats uniques d’un utilisateur dans l’application. Vérifiez le statut du niveau d’accès pour déterminer si l’utilisateur dispose de l’accès requis à l’application.

Paramètre

Description

Profile

Si la requête a réussi, la réponse contient cet objet. Un objet AdaptyProfile fournit des informations complètes sur les niveaux d’accès, les abonnements et les achats uniques d’un utilisateur dans l’application.

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

Remarque : si vous utilisez encore une version de StoreKit d’Apple inférieure à v2.0 et une version du SDK Adapty inférieure à v2.9.0, vous devez fournir le secret partagé de l’App Store Apple à la place. Cette méthode est actuellement dépréciée par Apple.

Changer d’abonnement lors d’un achat

Lorsqu’un utilisateur choisit un nouvel abonnement plutôt que de renouveler l’abonnement en cours, le fonctionnement dépend du store. Sur Google Play, l’abonnement n’est pas mis à jour automatiquement. Vous devrez gérer le changement dans le code de votre application mobile comme décrit ci-dessous.

Pour remplacer un abonnement par un autre sur Android, appelez la méthode .makePurchase() avec le paramètre supplémentaire suivant :

Adapty.makePurchase(
    activity, 
    product, 
    AdaptyPurchaseParameters.Builder()
        .withSubscriptionUpdateParams(subscriptionUpdateParams)
        .build()
) { result ->
    when (result) {
        is AdaptyResult.Success -> {
            when (val purchaseResult = result.value) {
                is AdaptyPurchaseResult.Success -> {
                    val profile = purchaseResult.profile

                    // successful cross-grade
                }

                is AdaptyPurchaseResult.UserCanceled -> {
                    // user canceled the purchase flow
                }

                is AdaptyPurchaseResult.Pending -> {
                    // the purchase has not been finished yet, e.g. user will pay offline by cash
                }
            }
        }
        is AdaptyResult.Error -> {
            val error = result.error
            // Handle the error
        }
    }
}

Paramètre de requête supplémentaire :

Paramètre	Présence	Description
subscriptionUpdateParams	requis	un objet `AdaptySubscriptionUpdateParameters`.

Adapty.makePurchase(
    activity, 
    product, 
    new AdaptyPurchaseParameters.Builder()
        .withSubscriptionUpdateParams(subscriptionUpdateParams)
        .build(),
    result -> {
    if (result instanceof AdaptyResult.Success) {
        AdaptyPurchaseResult purchaseResult = ((AdaptyResult.Success<AdaptyPurchaseResult>) result).getValue();

        if (purchaseResult instanceof AdaptyPurchaseResult.Success) {
            AdaptyProfile profile = ((AdaptyPurchaseResult.Success) purchaseResult).getProfile();

            // successful cross-grade
        } else if (purchaseResult instanceof AdaptyPurchaseResult.UserCanceled) {
            // user canceled the purchase flow
        } else if (purchaseResult instanceof AdaptyPurchaseResult.Pending) {
            // the purchase has not been finished yet, e.g. user will pay offline by cash
        }
    } else if (result instanceof AdaptyResult.Error) {
        AdaptyError error = ((AdaptyResult.Error) result).getError();
        // Handle the error
    }
});

Paramètre de requête supplémentaire :

Paramètre	Présence	Description
subscriptionUpdateParams	requis	un objet `AdaptySubscriptionUpdateParameters`.

Pour en savoir plus sur les abonnements et les modes de remplacement, consultez la documentation Google Developer :

À propos des modes de remplacement
Recommandations de Google pour les modes de remplacement
Mode de remplacement CHARGE_PRORATED_PRICE. Remarque : cette méthode est disponible uniquement pour les mises à niveau d’abonnement. Les rétrogradations ne sont pas prises en charge.
Mode de remplacement DEFERRED. Remarque : le changement d’abonnement effectif n’aura lieu qu’à la fin de la période de facturation en cours.

Gérer les plans prépayés

Si les utilisateurs de votre application peuvent acheter des plans prépayés (par exemple, souscrire à un abonnement non renouvelable pour plusieurs mois), vous pouvez activer les transactions en attente pour ces plans.


AdaptyConfig.Builder("PUBLIC_SDK_KEY")
    .withEnablePendingPrepaidPlans(true)
    .build()


new AdaptyConfig.Builder("PUBLIC_SDK_KEY")
    .withEnablePendingPrepaidPlans(true)
    .build();