Effectuer des achats dans une application mobile avec le SDK Flutter

Afficher des paywalls dans votre application mobile est une étape essentielle pour offrir aux utilisateurs l’accès à des contenus ou services premium. Cependant, 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 distincte appelée .makePurchase() pour finaliser un achat et débloquer le contenu souhaité. Cette méthode constitue le point d’entrée permettant aux utilisateurs d’interagir avec les paywalls et de finaliser 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.

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

Effectuer un achat

try {
  final purchaseResult = await Adapty().makePurchase(product: product);
    switch (purchaseResult) {
      case AdaptyPurchaseResultSuccess(profile: final profile):
        if (profile.accessLevels['premium']?.isActive ?? false) {
          // Grant access to the paid features
        }
        break;
      case AdaptyPurchaseResultPending():
        break;
      case AdaptyPurchaseResultUserCancelled():
        break;
      default:
        break;
    }
} on AdaptyError catch (adaptyError) {
    // Handle the error
} catch (e) {
    // Handle the error
}

Paramètres de la requête :

Paramètres de la réponse :

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 :

• Pour l’App Store, l’abonnement est mis à jour automatiquement au sein du groupe d’abonnements. Si un utilisateur achète un abonnement appartenant à un groupe alors qu’il possède déjà un abonnement d’un autre groupe, les deux abonnements seront actifs simultanément.
• Pour Google Play, l’abonnement n’est pas mis à jour automatiquement. Vous devez gérer le changement dans le code de votre application, 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 :

try {
  final subscriptionUpdateParams = AdaptyAndroidSubscriptionUpdateParameters(
    'OLD_PRODUCT_ID',
    AdaptyAndroidSubscriptionUpdateReplacementMode.immediateWithTimeProration,
  );

  final result = await Adapty().makePurchase(
    product: product,
    parameters: AdaptyPurchaseParameters(
      subscriptionUpdateParams: subscriptionUpdateParams,
    ),
  );
  
  // successful cross-grade
} on AdaptyError catch (adaptyError) {
  // Handle the error
} catch (e) {
  // Handle the error
}

Paramètre de requête supplémentaire :

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’interviendra qu’à la fin de la période de facturation en cours.

Utiliser les codes de promotion sur iOS

Pour afficher la feuille de saisie de code dans votre application :

try {
  await Adapty().presentCodeRedemptionSheet();
} on AdaptyError catch (adaptyError) {
  // handle the error
} catch (e) {
  // handle the error
}

Gérer les plans prépayés (Android)

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

await Adapty().activate(
  configuration: AdaptyConfiguration(apiKey: 'YOUR_PUBLIC_SDK_KEY')
    ..withGoogleEnablePendingPrepaidPlans(true),
);