Créer une souscription iOS Auto-Renewable

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

Les abonnements auto-renouvelables fournissent un accès récurrent à du contenu, des services ou des fonctionnalités premium dans votre application iOS. Ce guide vous guide à travers la création d'abonnements dans App Store Connect.

Vue d'ensemble

Les abonnements auto-renouvelables se renouvellent automatiquement à la fin de chaque période de facturation jusqu'à ce que les utilisateurs annulent. Ils sont parfaits pour :

Contenu et fonctionnalités premium
Expériences sans publicités
Stockage cloud et synchronisation
Services de streaming
Outils professionnels et utilitaires

Prerequisites

Avant de créer des abonnements, vous devez :

Créer un groupe d'abonnements pour organiser vos abonnements
Posséder un abonnement actif au programme Apple Developer
Compléter les informations bancaires et fiscales dans App Store Connect

Créer un Abonnement

Naviguez jusqu'aux Abonnements

Dans App Store Connect, sélectionnez votre application et allez à Monétiser > Abonnements.

Sélectionnez votre groupe d'abonnements ou créez-en un nouveau si nécessaire.
Créer un Nouvel Abonnement

Cliquez sur l' + icône à côté de votre groupe d'abonnements pour ajouter un nouvel abonnement.
Entrer les Informations de Base

Nom de Rendez-vous: Nom déscriptif pour votre utilisation interne (pas affiché aux clients)
- Exemples : « Abonnement Premium Mensuel », « Abonnement Annuel Ultime », « Plan de Base »
ID de produit : Identifiant unique pour cette souscription (ne peut pas être modifié ultérieurement)
- Format : com.yourcompany.yourapp.premium_monthly
- Utilisez des noms décritifs en minuscule avec des tirets bas
- Requis pour la configuration du plugin native-purchases
Configurer la Durée

Sélectionnez la durée de la souscription parmi les options disponibles :
- 1 semaine
- 1 mois
- 2 mois
- 3 mois
- 6 mois
- 1 an
La durée détermine combien souvent les utilisateurs sont facturés.
Configurer les tarifs

Cliquez Ajouter le prix d'abonnement pour configurer les tarifs :

Territoire de base: Sélectionnez votre marché principal (généralement votre pays)

Prix: Définissez le prix de l'abonnement
- Apple convertit automatiquement en autres devises
- Choisissez parmi les niveaux de tarification d'Apple
- Considérez la valeur perçue et les taux du marché
Partage familial (Optionnel)

Décidez si vous souhaitez activer le partage familial, qui permet jusqu'à 6 membres de la famille d'accéder à l'abonnement.

Une fois le partage familial activé, il ne peut pas être désactivé pour ce produit.

Activer si :
- Le contenu est approprié pour un usage familial
- Vous souhaitez augmenter la valeur proposition
- Votre modèle commercial le soutient
N'activez pas si :
- La souscription est réservée à un usage individuel
- Le contenu est personnalisé pour l'utilisateur
- Vous souhaitez maximiser les revenus par utilisateur
Ajoutez les localisations

Add subscription display information in all languages your app supports:

Nom de la souscription : Nom destiné à l'utilisateur (par exemple, « Premium mensuel »)

Description : Description concise de ce que la souscription comprend
- Tenez-le concis et axé sur les avantages
- Mentionnez les fonctionnalités clés
- Mettre en avant la valeur ajoutée
Image de promotion de l'App Store (Facultative)

Télécharger une image de promotion pour cette souscription (312x390 pixels) :
- Affiché dans la page de souscription de l'App Store
- Doit correspondre à la conception de votre application
- Incluez le nom de l'abonnement pour plus de clarté
Les images sont facultatives pour la soumission initiale, mais nécessaires pour la mise en avant dans l'App Store. Vous pouvez les ajouter ultérieurement.
Sauvegarder et Soumettre

Click Enregistrer pour créer l'abonnement.

Pour la première abonnement :
- Doit être soumis avec une nouvelle version de l'application.
- Inclure dans votre prochaine soumission sur l'App Store
- Ne peut pas être soumis indépendamment
Pour les abonnements ultérieurs :
- Pouvez soumettre directement depuis la page Abonnements
- Ne nécessitent pas une nouvelle version de l'application
- Disponible après que le premier abonnement soit approuvé

État de l'abonnement

Votre abonnement aura l'un de ces statuts :

Statut	Description	Can Test?
Manque de métadonnées	Configuration incomplète	Oui (sandbox)
Prêt à soumettre	Complet mais non soumis	Oui (sandbox)
En attente de révision	Soumis à Apple	Oui (sandbox)
En examen	En cours d'examen par Apple	Oui (sandbox)
Approuvé	Disponible pour l'achat	Oui
Refusé	Besoin de modifications	Oui (sandbox)

Utilisation dans votre application

Une fois créé, référez-vous à l'abonnement dans votre application en utilisant l'ID de produit :

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

// Fetch subscription products direct from StoreKit
const { products } = await NativePurchases.getProducts({
  productIdentifiers: [
    'com.yourcompany.yourapp.premium_monthly',
    'com.yourcompany.yourapp.premium_annual',
  ],
  productType: PURCHASE_TYPE.SUBS,
});

products.forEach((product) => {
  console.log(`${product.title}: ${product.priceString}`);
  console.log(`Duration: ${product.subscriptionPeriod}`);
  console.log(`Description: ${product.description}`);
});

// Purchase a subscription (StoreKit 2 automatically handles intro pricing and offers)
try {
  const transaction = await NativePurchases.purchaseProduct({
    productIdentifier: 'com.yourcompany.yourapp.premium_monthly',
    productType: PURCHASE_TYPE.SUBS,
  });

  console.log('Transaction ID:', transaction.transactionId);

  // StoreKit receipts are included on iOS for server-side validation
  await sendReceiptToBackend(transaction.receipt);
} catch (error) {
  console.error('Purchase failed:', error);
}

// Check subscription status using the store's data
const { purchases } = await NativePurchases.getPurchases({
  productType: PURCHASE_TYPE.SUBS,
});

const premium = purchases.find(
  (purchase) => purchase.productIdentifier === 'com.yourcompany.yourapp.premium_monthly',
);

if (premium?.isActive) {
  console.log('Expires:', premium.expirationDate);
  console.log('Will renew:', premium.willCancel === false);
  console.log('Store state:', premium.subscriptionState);
  unlockPremiumFeatures();
} else {
  showPaywall();
}

Abonnement mensuel avec engagement de 12 mois

Si votre abonnement App Store Connect est configuré avec un plan de facturation mensuel et un engagement de 12 mois, StoreKit peut retourner des termes de tarification supplémentaires pour ce produit. Utilisez ces termes pour afficher le coût mensuel, le prix total de l'engagement et la période d'engagement complète avant l'achat.

const yearlyProduct = products.find(
  (product) => product.identifier === 'com.yourcompany.yourapp.premium_annual',
);

const monthlyCommitment = yearlyProduct?.pricingTerms?.find(
  (term) => term.billingPlanType === 'monthly',
);

if (yearlyProduct && monthlyCommitment) {
  console.log('Monthly charge:', monthlyCommitment.billingDisplayPrice);
  console.log('Total commitment:', monthlyCommitment.commitmentInfo?.priceString);

  await NativePurchases.purchaseProduct({
    productIdentifier: yearlyProduct.identifier,
    productType: PURCHASE_TYPE.SUBS,
    billingPlanType: 'monthly',
  });
}

Voir le flux de paywall et d'entitlement complet Plans de facturation mensuels pour les engagements iOS.

Meilleures pratiques

Stratégie de tarification

Plans mensuels : Barrière d'entrée plus faible, création de l'habitude
Plans annuelsUne valeur ajoutée, un LTV élevé, une faible dérive
Niveaux multiples : Basique, Premium, Ultimate pour différents segments d'utilisateurs
Analyse concurrentielle : Recherchez la tarification des applications similaires

IDs de produit

Utilisez des noms cohérents : company.app.tier_duration
Incluez le niveau et la durée dans l'ID : premium_monthly, ultimate_annual
Avoid changing product IDs (they’re permanent)
Document all product IDs for your team

Activer pour les applications axées sur la famille (jeux, éducatif, divertissement)
Considérez l'impact sur les revenus
Testez soigneusement le comportement de partage
Communiquez la capacité de partage dans la publicité

Localisation

Traduire tous les noms et les descriptions de souscriptions
Tenir compte des différences de tarification régionale
Test display en toutes les langues prises en charge
Utiliser un langage marketing approprié à la culture

Images de promotion

Maintenir un style visuel cohérent
Incluez le nom de l'abonnement et le principal avantage.
Mettre à jour pour les promotions saisonnières
Conformez le design global de l'application

Modèles de souscriptions courants

Échelon unique (Freemium)

Free App + Premium Subscription
- Basic: Free (limited features)
- Premium Monthly: $4.99
- Premium Annual: $39.99 (save 33%)

Multi-niveaux (Bon, Meilleur, Meilleur)

- Basic Monthly: $4.99
- Premium Monthly: $9.99
- Ultimate Monthly: $19.99

- Basic Annual: $49.99
- Premium Annual: $99.99
- Ultimate Annual: $199.99

Hybride consommable + souscription

- Credit packs (consumable)
- Monthly subscription (unlimited credits)
- Annual subscription (unlimited + bonus features)

Troubleshooting

La souscription ne charge pas dans l'application :

Vérifiez que l'ID du produit correspond exactement (sensibilité à la casse)
Vérifiez que l'abonnement est dans le groupe d'abonnements
Assurez-vous que l'identifiant de l'ensemble correspond à App Store Connect
Attendez 2-3 heures après avoir créé le produit

Impossible de soumettre la souscription :

Remplissez tous les champs requis (nom, description, prix)
Ajoutez au moins une localisation
Verify banking/tax info is approved
Vérifiez si la première souscription (exige une version de l'application)

La partage familial désactivée :

Déjà activée (impossible de la désactiver)
Vérifiez les détails de l'abonnement
Contactez le support d'Apple si vous êtes bloqué

Tarif de niveau non disponible :

Peut être restreint dans certaines régions
Choisissez un niveau alternatif
Contactez Apple pour des questions de tarification

Erreur « Produit ID non valide » :

Doit être au format inverse du domaine
Ne doit pas contenir d'espaces ou de caractères spéciaux
Vérifiez les fautes d'orthographe
Vérifiez l'universalité dans tous les produits

Étapes suivantes

Créer une offre d'introduction pour attirer de nouveaux abonnés
Plans de facturation mensuels de produits dérivés pour les offres de souscription annuelles prises en charge
Configurer les tests de sandbox pour tester vos abonnements
Configurer des offres promotionnelles pour le retour et la fidélisation
Implémenter le suivi des statistiques d'abonnement

Ressources supplémentaires

Pour plus de détails, consultez le la documentation officielle d'Apple sur les abonnements auto-renouvelables.

Continuez de la création d'une souscription iOS auto-renouvelable

Si vous utilisez Créer une souscription iOS auto-renouvelable pour planifier l'approbation et la distribution dans l'app Store, connectez-l’à En utilisant @capgo/achats-natifs pour la capacité native dans En utilisant @capgo/achats-natifs, En @capgo/capacitor-avis-de-l'utilisateur pour le détail d'implémentation dans En @capgo/capacitor-avis-de-l'utilisateur, En utilisant @capgo/capacitor-avis-de-l'utilisateur pour la capacité native dans En utilisant @capgo/capacitor-avis-de-l'utilisateur, @capgo/capacitor-marché-natif pour les détails d'implémentation dans @capgo/capacitor-native-market, et En utilisant @capgo/capacitor-native-market pour la capacité native dans En utilisant @capgo/capacitor-native-market.