Créer une souscription iOS Auto-Renewable
Copier un prompt de configuration avec les étapes d'installation et la guide Markdown complète 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
Section intitulée « 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 et synchronisation cloud
- Services de streaming
- Outils et utilitaires professionnels
Prerequisites
Section intitulée « Prérequis »Avant de créer des abonnements, vous devez :
- Créer un groupe d'abonnements pour organiser vos abonnements
- Posséder une adhésion active au programme Apple Developer
- Compléter les informations bancaires et fiscales dans App Store Connect
Création d'un Abonnement
Section intitulée « Création d'un Abonnement »-
Naviguer vers les Abonnements
Dans App Store Connect, sélectionnez votre application et allez à Monétisation > Abonnements.
Sélectionnez votre groupe d'abonnements ou créez-en un nouveau si nécessaire.

-
Créer un Nouvel Abonnement
Cliquez sur le + icône à côté de votre groupe d'abonnements pour ajouter un nouvel abonnement.
-
Entrer les Informations de Base
Nom de Référence: Nom déscriptif pour votre utilisation interne (pas affiché aux clients)
- Exemples : « Abonnement Premium Mensuel », « Abonnement Annuel Ultime », « Plan de Base »
ID du Produit: Identifiant unique pour cet abonnement (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 l'abonnement 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éfinir le prix de l'abonnement
- Apple convertit automatiquement en autres devises
- Choisissez parmi les paliers de prix d'Apple
- Prenez en compte 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.
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 :
- L'abonnement est réservé à un usage individuel uniquement
- Le contenu est personnalisé pour l'utilisateur
- Vous souhaitez maximiser les revenus par utilisateur
-
Ajouter des localisations
Add subscription display information in all languages your app supports:
Nom de l'abonnementNom destiné à l'utilisateur (par exemple, « Premium mensuel »)
DescriptionDescription concise de ce que l'abonnement 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 (facultatif)
Téléchargez une image de promotion pour cette souscription (312x390 pixels) :
- Affichée dans la page de souscription de l'App Store
- Doit correspondre au design de votre application
- Incluez le nom de l'abonnement pour plus de clarté.
-
Enregistrer et Soumettre
Cliquez Enregistrer Créez la souscription.
Pour la première souscription :
- Doit être soumis avec une nouvelle version de l'application.
- Incluez dans votre prochaine soumission à l'App Store
- Impossible de soumettre indépendamment
Pour les souscriptions ultérieures :
- Can be submitted directly from the Souscriptions page
- N'obligez pas une nouvelle version de l'application
- Disponible après la première souscription est approuvée
État de la souscription
Section intitulée « État de la souscription »Votre souscription aura l'un de ces statuts :
| Statut | Description | Can Test? |
|---|---|---|
| Données manquantes | Configuration incomplète | Oui (sandbox) |
| Prêt à soumettre | Complet mais non soumis | Oui (sandbox) |
| En attente de revue | Soumis à Apple | Oui (sandbox) |
| En revue | En cours de revue par Apple | Oui (sandbox) |
| Approuvé | Disponible à l'achat | Oui |
| Rejected | Nécessite des modifications | Oui (sandbox) |
Utiliser dans Votre Application
Utilisation dans votre applicationUne fois créé, référez-vous à la souscription dans votre application en utilisant l'ID du produit :
import { NativePurchases, PURCHASE_TYPE } from '@capgo/native-purchases';
// Fetch subscription products direct from StoreKitconst { 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 dataconst { 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 des plans de 12 mois
Plan mensuel avec des plans d'engagement de 12 moisSi votre souscription App Store Connect est configurée 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', });}Pour la flux complet de la paywall et de l'entitlement, voir Plans de facturation mensuels pour les abonnements iOS.
Meilleures pratiques
Titre de la section « Meilleures pratiques »Stratégie de tarification
Section intitulée « Stratégie de tarification »- Plans mensuels : Barrière d'entrée plus faible, création de l'habitude
- Plans annuels: Better value, higher LTV, lower churn
- Niveaux multiples : Basique, Premium, Ultimate pour différents segments d'utilisateurs
- Analyse concurrentielle : Recherchez les tarifs similaires des applications concurrentes
IDs de produit
Section intitulée « Identifiants de produit »- Utilisez des noms cohérents :
company.app.tier_duration - Comprendre 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
Partage familial
Sous-section intitulée « Partage familial »- 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
Sous-section intitulée « Localisation »- Traduisez tous les noms et descriptions de souscriptions
- Tenir compte des différences de tarification régionale
- Test display en toutes les langues prises en charge
- Créez une souscription adaptée à votre public.
Images promotionnelles
Section intitulée « Images promotionnelles »- Maintenir un style visuel cohérent
- Inclure le nom de l'abonnement et son bénéfice clé
- Mise à jour pour les promotions saisonnières
- Conformez-vous au langage de design de l'application
Modèles d'abonnement courants
Section intitulée « Modèles d'abonnement courants »Niveau unique (Freemium)
Section intitulée « Single Tier (Freemium) »Free App + Premium Subscription- Basic: Free (limited features)- Premium Monthly: $4.99- Premium Annual: $39.99 (save 33%)Multi-Niveau (Bon, Mieux, Meilleur)
Section intitulée « Multi-Niveau (Bon, Mieux, Meilleur) »- Basic Monthly: $4.99- Premium Monthly: $9.99- Ultimate Monthly: $19.99
- Basic Annual: $49.99- Premium Annual: $99.99- Ultimate Annual: $199.99Consommable + Abonnement Hybride
Section intitulée « Consommable + Abonnement Hybride »- Credit packs (consumable)- Monthly subscription (unlimited credits)- Annual subscription (unlimited + bonus features)Troubleshooting
Section intitulée « Résolution de problèmes »L'abonnement ne charge pas dans l'application :
- Vérifiez que l'ID du produit correspond exactement (sensibilité à la casse)
- Vérifiez que la souscription est dans le groupe de souscriptions
- Ensure bundle identifier matches App Store Connect
- Attendez 2-3 heures après avoir créé le produit
Impossible de soumettre la souscription :
- Remplissez tous les champs obligatoires (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 est désactivée.
- Déjà activé (ne peut pas être désactivé)
- Vérifiez les détails de la souscription
- Contactez Apple Support si vous êtes bloqué
Tarif de prix non disponible :
- Peut être restreint dans certaines régions
- Choisissez un niveau alternatif
- Contactez Apple pour les questions de tarification
“Erreur de produit invalide”
- Erreur « Produit ID non valide » :
- Devoir être au format de domaine inversé
- Vérifiez les fautes d'orthographe
- Vérifiez les fautes d'orthographe
Étapes suivantes
Section titled “Next Steps”- Créez 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
- Configurez les tests de sandbox pour tester vos abonnements
- Configurez des offres promotionnelles pour le retour et la rétention
- Implémentez le suivi des statistiques d'abonnement
Ressources supplémentaires
Section intitulée « Ressources supplémentaires »Pour plus de détails, consultez la documentation officielle d'Apple sur les souscriptions auto-renouvelables.
Continuez de la section « Créer une souscription iOS auto-renouvelable »
Section intitulée « Continuez à partir de la création d'une souscription iOS Auto-Renewable »Si vous utilisez Créer une souscription iOS Auto-Renewable pour planifier l'approbation et la distribution dans les magasins, connectez-l’avec En utilisant @capgo/achats-natifs pour la capacité native dans En utilisant @capgo/achats-natifs, @capgo/capacitor-avis-de-l'utilisateur pour le détail d'implémentation dans @capgo/capacitor-avis-de-l'utilisateur, et 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 le détail d'implémentation dans @capgo/capacitor-marché-natif, et Utilisez @capgo/capacitor-native-market pour la capacité native dans Utilisez @capgo/capacitor-native-market.