Effectuer des achats dans une application mobile avec le SDK Capacitor

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 un paywall ne suffit à lui seul à traiter les achats 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ébloquer 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’applique automatiquement au moment de l’achat.

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

Effectuer un achat

try {
  const result = await adapty.makePurchase({ product });
  
  if (result.type === 'success') {
    const isSubscribed = result.profile?.accessLevels?.['YOUR_ACCESS_LEVEL']?.isActive;
    
    if (isSubscribed) {
      // Grant access to the paid features
      console.log('User is now subscribed!');
    }
  } else if (result.type === 'user_cancelled') {
    console.log('Purchase cancelled by user');
  } else if (result.type === 'pending') {
    console.log('Purchase is pending');
  }
} catch (error) {
  console.error('Purchase failed:', error);
}

Paramètres de 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 comportement dépend du store :

• Pour l’App Store, l’abonnement est automatiquement mis à jour au sein du groupe d’abonnements. Si un utilisateur souscrit à 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 devrez 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 {
  const result = await adapty.makePurchase({ 
    product,
    params: {
      android: {
        subscriptionUpdateParams: {
          oldSubVendorProductId: 'old_product_id',
          prorationMode: 'charge_prorated_price'
        },
        isOfferPersonalized: true
      }
    }
  });
  
  if (result.type === 'success') {
    const isSubscribed = result.profile?.accessLevels?.['YOUR_ACCESS_LEVEL']?.isActive;
    
    if (isSubscribed) {
      // Grant access to the paid features
      console.log('Subscription updated successfully!');
    }
  } else if (result.type === 'user_cancelled') {
    console.log('Purchase cancelled by user');
  } else if (result.type === 'pending') {
    console.log('Purchase is pending');
  }
} catch (error) {
  console.error('Purchase failed:', error);
}

Paramètre de requête supplémentaire :

La structure MakePurchaseParamsInput comprend :

{
  android: {
    subscriptionUpdateParams: {
      oldSubVendorProductId: 'old_product_id',
      prorationMode: 'charge_prorated_price'
    },
    isOfferPersonalized: true
  }
}

Vous pouvez en savoir plus sur les abonnements et les modes de remplacement dans 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 offres prépayées (Android)

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

await adapty.activate({
  apiKey: 'YOUR_PUBLIC_SDK_KEY',
  params: {
    android: {
        pendingPrepaidPlansEnabled: true,
    },
  }
});

Utiliser les codes de réduction sous iOS

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

try {
  await adapty.presentCodeRedemptionSheet();
} catch (error) {
  console.error('Failed to present code redemption sheet:', error);
}

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

Lorsqu’un utilisateur lance un achat depuis la page produit de votre App Store et que la transaction est transmise à votre app, 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 n’est nécessaire de votre côté.

Si le produit mis en avant est associé à 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 à partir d’iOS 18.0. Sur iOS 16.4–17.x, l’achat s’effectue au prix de base.

Pour prendre en charge la finalisation vous-même — par exemple pour afficher votre propre écran en premier — écoutez l’événement 'onPromotedPurchaseReceived' et passez le produit à makePromotedPurchase :

const listener = await adapty.addListener('onPromotedPurchaseReceived', async ({ product }) => {
  const result = await adapty.makePromotedPurchase({ product });
  // process the purchase result
});

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

L’appel à adapty.removeAllListeners() supprime votre écouteur d’achats promus avec tous les autres, et la complétion automatique du SDK reprend à la place. Réenregistrez l’écouteur si votre application doit toujours gérer la complétion.