Passer à la navigation

Créer une souscription iOS Auto-Renewable

GitHub

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.

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

Avant de créer des abonnements, vous devez :

  1. Créer un groupe d'abonnements pour organiser vos abonnements
  2. Posséder une adhésion active au programme Apple Developer
  3. Compléter les informations bancaires et fiscales dans App Store Connect
  1. 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.

    Naviguez vers les abonnements

  2. Créer un Nouvel Abonnement

    Cliquez sur le + icône à côté de votre groupe d'abonnements pour ajouter un nouvel abonnement.

  3. 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

    Entrer les détails de l'abonnement

  4. 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.

  5. 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é

    Configurez les tarifs

  6. 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
  7. 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

    Ajouter des localisations

  8. 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é.
  9. 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

Votre souscription aura l'un de ces statuts :

StatutDescriptionCan Test?
Données manquantesConfiguration incomplèteOui (sandbox)
Prêt à soumettreComplet mais non soumisOui (sandbox)
En attente de revueSoumis à AppleOui (sandbox)
En revueEn cours de revue par AppleOui (sandbox)
ApprouvéDisponible à l'achatOui
RejectedNécessite des modificationsOui (sandbox)

Utiliser dans Votre Application

Utilisation dans votre application

Une 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 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 des plans de 12 mois

Plan mensuel avec des plans d'engagement de 12 mois

Si 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.

  • 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
  • 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
  • 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é
  • 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.
  • 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
Free App + Premium Subscription
- Basic: Free (limited features)
- Premium Monthly: $4.99
- Premium Annual: $39.99 (save 33%)
- Basic Monthly: $4.99
- Premium Monthly: $9.99
- Ultimate Monthly: $19.99
- Basic Annual: $49.99
- Premium Annual: $99.99
- Ultimate Annual: $199.99
- Credit packs (consumable)
- Monthly subscription (unlimited credits)
- Annual subscription (unlimited + bonus features)

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

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.