Effectuer des achats dans une application mobile avec le SDK Flutter

Afficher des paywalls dans votre application mobile est une étape indispensable pour proposer aux utilisateurs l’accès à des contenus ou services premium. Cependant, l’affichage d’un paywall ne déclenche des achats de lui-même que lorsqu’Adapty affiche l’écran — c’est-à-dire un flow, ou un paywall issu de l’ancien Paywall Builder.

Si vous affichez l’écran dans votre propre code, vous devez utiliser une méthode distincte appelée .makePurchase() pour finaliser un achat et déverrouiller le contenu souhaité. Cette méthode constitue le point d’entrée permettant aux utilisateurs d’interagir avec les paywalls et de procéder à 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
}

Achats intégrés promus depuis l’App Store

Lorsqu’un utilisateur démarre un achat depuis la page produit de votre App Store et que la transaction est transférée vers votre application, le SDK la finalise automatiquement — l’écran d’achat Apple s’affiche immédiatement, et Adapty traite la transaction comme n’importe quel autre achat. Aucun code de votre côté n’est nécessaire.

Si le produit mis en avant comporte une offre d’abonnement, le SDK l’applique automatiquement lors de l’achat. L’offre est lue depuis l’intention d’achat App Store, qui l’expose sur iOS 18.0 et versions ultérieures. Sur iOS 16.4–17.x, l’achat est effectué au prix de base.

Pour gérer vous-même les achats mis en avant — par exemple pour afficher votre propre écran en premier — abonnez-vous à didReceivePromotedPurchaseStream et passez le produit à makePromotedPurchase :

Adapty().didReceivePromotedPurchaseStream.listen((product) async {
  try {
    final result = await Adapty().makePromotedPurchase(product: product);
    // process the purchase result
  } on AdaptyError catch (adaptyError) {
    // handle the error
  } catch (e) {
    // handle the error
  }
});

makePromotedPurchase ne prend aucun paramètre d’achat, car un produit promu provient de l’App Store plutôt que d’un paywall et ne porte aucun contexte de paywall. Elle retourne le même AdaptyPurchaseResult que makePurchase.

Qui complète l’achat est déterminé pour chaque événement, donc un stream que vous écoutez uniquement lorsqu’un écran est monté restitue les achats promus au SDK dès que cet écran disparaît. Vous pouvez vous abonner avant activate, ce qui vous permet de capturer un achat que le store délivre au lancement.

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

Si les utilisateurs de votre application 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),
);