Make purchases in mobile app in Capacitor SDK

Afficher des paywalls dans votre application mobile est une étape essentielle pour donner aux utilisateurs 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 personnaliser vos paywalls.

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 sert de point d’entrée pour que les utilisateurs interagissent avec les paywalls et effectuent 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 cela, 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 la requête :

Paramètres de la réponse :

Changer d’abonnement lors d’un achat

Lorsqu’un utilisateur opte pour un nouvel abonnement plutôt que de renouveler l’abonnement actuel, le comportement 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 d’un groupe alors qu’il en a déjà un d’un autre groupe, les deux abonnements seront actifs en même temps.
• Pour Google Play, l’abonnement n’est pas mis à jour automatiquement. Vous devez 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 :

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 n’est disponible que 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’intervient qu’à la fin de la période de facturation de l’abonnement en cours.

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

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 les plans prépayés.

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

Utiliser des codes de réduction sur iOS

Pour afficher la feuille de saisie de code de réduction dans votre application :

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