Plans de facturation mensuelle de iOS d'engagement

Copiez une commande de configuration avec les étapes d'installation et le guide markdown complet pour ce plugin.

Apple prend en charge les abonnements qui facturent mensuellement tout en engageant le client à un terme plus long de 12 mois. Lorsque StoreKit et le système d'exploitation en cours de fonctionnement supportent ce plan de facturation, @capgo/native-purchases exposez les termes de tarification, permettez au client de sélectionner le plan de facturation mensuel lors de l'achat et renvoyez les métadonnées de la transaction et les informations de renouvellement.

Utilisez ceci pour les offres de souscription annuelle où les utilisateurs préfèrent les paiements mensuels mais vous voulez toujours la fidélité et la prévisibilité d'un terme annuel engagé.

Exigences

Configurez le paiement mensuel avec un plan de facturation de 12 mois de engagement dans App Store Connect ou dans StoreKit Testing dans Xcode.
Construisez l'application iOS avec un Xcode SDK contenant StoreKit pricingTerms et billingPlanType.
Exécutez sur une version iOS qui prend en charge les plans de facturation de l'engagement StoreKit.
Gardez une option de facturation standard disponible pour les appareils ou les points de vente qui ne retournent pas les termes de tarification d'engagement.

Charger et afficher les conditions tarifaires

Appeler getProducts() Comme d'habitude. Pour les produits de souscription iOS pris en charge, chaque produit peut inclure pricingTerms.

import { NativePurchases, PURCHASE_TYPE } from '@capgo/native-purchases';

const { products } = await NativePurchases.getProducts({
  productIdentifiers: ['com.example.app.premium.yearly'],
  productType: PURCHASE_TYPE.SUBS,
});

const premiumYearly = products.find(
  (product) => product.identifier === 'com.example.app.premium.yearly',
);
const monthlyCommitment = premiumYearly?.pricingTerms?.find(
  (term) => term.billingPlanType === 'monthly',
);

Afficher les valeurs fournies par la boutique au lieu des tarifs fixés à l'avance :

Champ	L'utiliser pour
`billingDisplayPrice`	Le montant facturé à répétition affiché à l'utilisateur, par exemple le coût mensuel.
`billingPeriod`	La fréquence de facturation pour le prix de facturation affiché.
`commitmentInfo.priceString`	Le prix total de l'engagement formatté pour le magasin de l'utilisateur.
`commitmentInfo.period`	La période d'engagement complète.
`subscriptionOffers`	Offres promotionnelles ou publicitaires liées au terme de tarification.

Exemple de texte de mur payant :

function commitmentLabel(term: NonNullable<typeof monthlyCommitment>) {
  const total = term.commitmentInfo?.priceString;
  return total
    ? `${term.billingDisplayPrice} billed monthly, ${total} total commitment`
    : term.billingDisplayPrice;
}

Achetez le Plan de Engagement Mensuel

Lorsque l'utilisateur sélectionne le plan de engagement mensuel, passez billingPlanType: 'monthly'.

const transaction = await NativePurchases.purchaseProduct({
  productIdentifier: 'com.example.app.premium.yearly',
  productType: PURCHASE_TYPE.SUBS,
  billingPlanType: 'monthly',
  appAccountToken: userStoreUuid,
});

Utilisez billingPlanType: 'upFront' seulement lorsque vous devez sélectionner explicitement le plan de facturation à l'avance standard. Si vous omittes billingPlanType, StoreKit utilise son comportement de purchase par défaut pour le produit.

Lire les métadonnées de l'engagement

Les transactions incluent le plan de facturation et l'avancement de l'engagement lorsque StoreKit le fournit :

if (transaction.billingPlanType === 'monthly') {
  console.log('Current billing period:', transaction.commitmentInfo?.billingPeriodNumber);
  console.log('Total billing periods:', transaction.commitmentInfo?.totalBillingPeriods);
  console.log('Commitment ends:', transaction.commitmentInfo?.expirationDate);
  console.log('Commitment total:', transaction.commitmentInfo?.price);
}

L'information de renouvellement peut inclure l'état de l'engagement suivant :

const { purchases } = await NativePurchases.getPurchases({
  productType: PURCHASE_TYPE.SUBS,
  onlyCurrentEntitlements: true,
});

for (const purchase of purchases) {
  const commitment = purchase.renewalInfo?.commitmentInfo;
  if (!commitment) continue;

  console.log('Renews into another commitment:', commitment.willAutoRenew);
  console.log('Next billing plan:', commitment.renewalBillingPlanType);
  console.log('Next renewal date:', commitment.renewalDate);
}

Utilisez les champs de niveau supérieur expirationDate et isActive pour prendre des décisions sur les droits. Utilisez commitmentInfo.expirationDate pour expliquer la ligne de temps de l'engagement complet au client.

Notes de revue de l'App Store

Afficher les deux prix de facturation récurrente et le prix total de l'engagement avant l'achat.
Faites l'engagement explicite près du bouton d'achat.
Utilisez product.title, product.priceString, pricingTerms[].billingDisplayPrice, et pricingTerms[].commitmentInfo.priceString from StoreKit au lieu de prix fixés par défaut.
Fournir les actions de restauration d'achat et de gestion d'abonnement sur la page de paiement ou l'écran de compte.

Continuez à partir des plans de facturation mensuelle iOS

Si vous utilisez Plans de facturation mensuelle iOS pour planifier les paiements et les achats, connectez-le avec En utilisant @capgo/native-purchases pour la capacité native en En utilisant @capgo/native-purchases, Tarification de Capgo pour le flux de travail du produit dans Tarification de Capgo, Système de paiement pour le détail d'implémentation dans Système de paiement, @capgo/achats natifs pour le détail d'implémentation dans @capgo/achats natifs, et Démarrage pour le détail d'implémentation dans Démarrage.