Les lignes directrices de la boutique iOS pour les achats in-app

Pour obtenir votre application approuvée sur l'App Store, il faut accorder une grande attention aux lignes directrices d'Apple, surtout lors de l'implémentation des achats et des abonnements en ligne. Ce guide couvre tout ce dont vous avez besoin pour passer la revue à votre première soumission.

Avant de soumettre

Terminer la configuration de App Store Connect

Avant que Apple examine votre flux d'achat, assurez-vous que l'enregistrement de l'application soit complet :

• Ajoutez un Lien vers la politique de confidentialité dans App Store Connect
• Ajoutez un Lien vers le support qui mène à des informations de contact réelles pour les utilisateurs
• Terminez le questionnaire sur la classification d'âge afin que l'application soit publiable
• Ajoutez Détails de contact pour la revue d'applications et notes de réviseur claires
• Si un connexion est requise, fournissez un compte de démonstration qui ne expire pas pendant la revue

Note

Apple considère le site de support comme plus qu'un lien de remplacement. Il doit contenir des informations de contact réelles afin que les utilisateurs puissent vous contacter concernant les problèmes d'applications, les commentaires et les demandes de fonctionnalités.

Préparez des captures d'écran réelles

• Utilisez des captures d'écran actuelles provenant de la version de build réellement en revue
• Pour iPhone, 1290 x 2796 (6.7 pouces) est la taille par défaut la plus facile à utiliser
• Si votre application fonctionne sur iPad, téléchargez également des captures d'écran d'iPad
• Les tailles d'iPad acceptées actuellement incluent 2064 x 2752 (13 pouces) et 2048 x 2732 (12,9 pouces)
• N'ajoutez jamais de captures d'écran d'iPhone pour simuler le support d'iPad

Effectuez une simulation du parcours du Reviewer dans TestFlight

Exécutez le chemin exact que suivra Apple sur un appareil réel :

• Installez la dernière version de TestFlight
• Connectez-vous avec le compte de revue que vous prévoyez fournir
• Parvenez à la barrière de paiement sans menus de débogage ou sans gestes cachés
• Flux d'achat, de restauration et de gestion de l'abonnement
• Vérifiez que l'application se comporte toujours correctement si les permissions sont refusées

Exigences d'Achat en Ligne

Transparence des Tarifs (Critique)

Apple exige une transparence totale des tarifs avant toute achat :

Éléments Impératifs :

• Affichez le prix exact avant le bouton d'achat
• Affichez la fréquence de facturation (par exemple, « $9,99 $/mois »)
• Définissez clairement ce que les utilisateurs obtiennent pour leur argent
• Indiquez quand les factures auront lieu

Rejet Général:

“Le prix d'abonnement doit être clair et explicite.”

:::attention Coût Uniforme Tous les prix doivent correspondre à :

• Liste de métadonnées de l'App Store
• Écrans d'achat en application
• Écrans de gestion d'abonnement

Même une différence de 1 $ entre la liste de l'App Store (4,99 $) et l'application (5,99 $) déclenchera un rejet automatique. :::

Présentation du Plan d'Abonnement

Informations Protégées :

• Tous les niveaux d'abonnement disponibles affichés ensemble
• Comparaison claire des fonctionnalités par niveau
• Pas de redirige vers les niveaux premium par des astuces de l'interface utilisateur
• Instructions de suppression faciles à localiser

Exemple d'interface utilisateur conforme :

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

function SubscriptionScreen() {
  return (
    <div>
      <h2>Choose Your Plan</h2>

      {/* Show all tiers equally */}
      <PlanCard
        title="Basic"
        price="$4.99/month"
        features={['Feature A', 'Feature B']}
      />
      <PlanCard
        title="Premium"
        price="$9.99/month"
        features={['All Basic', 'Feature C', 'Feature D']}
        highlighted={false} // Don't force premium
      />

      {/* Clear cancellation info */}
      <Text>
        Cancel anytime in Settings > Subscriptions.
        No refunds for partial periods.
      </Text>
    </div>
  );
}

Restaurer les achats

Implémentation requise :

Tout application avec IAP doit fournir un moyen pour les utilisateurs de restaurer les achats précédents sans contacter le support.

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

async function restorePurchases() {
  try {
    await NativePurchases.restorePurchases();

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

    const activeSub = purchases.find(
      (purchase) => purchase.isActive && purchase.expirationDate,
    );

    if (activeSub) {
      unlockPremiumFeatures();
      showMessage('Purchases restored successfully!');
      return;
    }

    const { purchases: iaps } = await NativePurchases.getPurchases({
      productType: PURCHASE_TYPE.INAPP,
    });
    const hasIap = iaps.some((purchase) => purchase.productIdentifier === 'premium_unlock');

    showMessage(
      hasIap ? 'Premium purchase restored!' : 'No previous purchases found.',
    );
  } catch (error) {
    showError('Failed to restore purchases. Please try again.');
  }
}

// Add a visible "Restore Purchases" button
<Button onClick={restorePurchases}>
  Restore Purchases
</Button>

Raisons de refus courantes

1. L'application s'effondre ou ne fonctionne pas

Pourquoi cela échoue :

• L'application s'effondre lors du lancement
• La passerelle de paiement ne parvient pas à se terminer
• Les fonctionnalités montrées dans les captures d'écran ne fonctionnent pas

Prévention :

• Testez sur des appareils réels (pas seulement des simulateurs)
• Testez toutes les flux de souscription de bout en bout
• Vérifiez que la validation des réceptions fonctionne
• Vérifiez la gestion des erreurs de réseau

2. Mismatches de métadonnées

Pourquoi cela ne fonctionne pas :

• Les captures d'écran montrent des fonctionnalités qui ne sont pas dans la dernière version
• La description mentionne des fonctionnalités qui n'existent pas
• Le prix dans les métadonnées diffère de celui en application

Prévention :

// Document exactly what's in each tier
const SUBSCRIPTION_FEATURES = {
  basic: ['Ad-free', 'Cloud sync', 'Basic themes'],
  premium: ['Ad-free', 'Cloud sync', 'All themes', 'Priority support']
};

// Use these in both your app AND App Store description

3. Explications manquantes des permissions

Pourquoi cela ne fonctionne pas :

• Demande de l'accès à la caméra/position/santé sans explication
• Demandes d'autorisation enfouies à plusieurs écrans de profondeur
• Descriptions d'autorisation vagues ou génériques

Prévention :

Mettez à jour votre Info.plist avec des explications claires :

<key>NSCameraUsageDescription</key>
<string>Camera access is needed to scan product barcodes for quick subscription upgrades.</string>

<key>NSLocationWhenInUseUsageDescription</key>
<string>Location helps us show relevant local content in your Premium subscription.</string>

4. Publicité trompeuse

Pourquoi cela ne fonctionne pas :

• Revendications comme « l'application n°1 dans le monde » sans preuve
• Fonctionnalités « illimitées » qui ont des limites cachées
• Tactiques d'urgence fausses (« Seulement 2 places restantes ! »)

Prévention :

• Soyez spécifique et factuel dans les descriptions
• Évitez les superlatifs sans preuves
• N'obligez pas les utilisateurs avec de la fausse rareté

5. Procédure de résiliation cachée

Pourquoi cela ne fonctionne pas :

• Aucune mention de la procédure de révocation
• Le bouton d'annulation est caché ou obscurci
• Procédure d'annulation à plusieurs étapes sans flux natif d'Apple

Prévention :

// Always inform users about cancellation
function SubscriptionInfo() {
  return (
    <div>
      <h3>How to Cancel</h3>
      <ol>
        <li>Open iPhone Settings</li>
        <li>Tap your name at the top</li>
        <li>Tap Subscriptions</li>
        <li>Select this app and tap Cancel</li>
      </ol>

      <p>Or manage directly in the App Store app.</p>

      <Button onClick={openSubscriptionManagement}>
        Manage Subscription in Settings
      </Button>
    </div>
  );
}

async function openSubscriptionManagement() {
  // Direct link to iOS subscription management
  await NativePurchases.showManageSubscriptions();
}

Confidentialité et utilisation des données (Section 5.1.1)

Apple a considérablement renforcé les exigences de confidentialité en 2025.

Déclarations obligatoires

Pour chaque autorisation :

1. Pourquoi vous en avez besoin (utilisation spécifique)
2. When il sera utilisé
3. Comment les données sont stockées/échangées
4. Est-ce qu'il est facultatif ou obligatoire

Exemple : Flux de permission correct

async function requestCameraPermission() {
  // Show explanation BEFORE requesting
  await showDialog({
    title: 'Camera Access',
    message: 'We need camera access to let you scan barcodes for quick product lookup. Your photos are never uploaded or stored.',
    buttons: ['Not Now', 'Allow']
  });

  // Then request permission
  const result = await Camera.requestPermissions();
  return result.camera === 'granted';
}

Étiquettes de nutrition de la vie privée

Assurez-vous que vos étiquettes de vie privée de l'App Store reflètent avec précision :

• Collecte de l'historique des achats
• Adresses e-mail (pour les reçus)
• Identifiants de dispositif (pour la prévention de la fraude)
• Données d'utilisation (pour les analyses)

Les étiquettes de confidentialité inexactes constituent une raison courante de refus en 2025. Auditez soigneusement vos collectes de données.

Liste de vérification avant soumission

1. Achetez chaque niveau de souscription

   • Testez les essais gratuits
   • Vérifiez que les offres d'introduction s'appliquent correctement
   • Testez la restauration des achats
   • Vérifiez que la partage de famille (si activé) fonctionne correctement
   • Testez sur plusieurs appareils
   • __CAPGO_KEEP_0__

2. Vérifiez la cohérence des tarifs

   • Vérifiez que les métadonnées de l'App Store correspondent aux prix en application
   • Vérifiez que tous les devises sont corrects
   • Confirmez que les durées des essais gratuits correspondent aux descriptions
   • Vérifiez que les termes des offres d'introduction sont exacts

3. Passer en revue Tous les Textes

   • Supprimer le texte de remplacement
   • Vérifiez que les revendications sont testables
   • Vérifiez l'orthographe et la ponctuation
   • Assurez-vous que les descriptions correspondent à la dernière version
   • Supprimer les mentions des concurrents

4. Testez les autorisations

   • Demander uniquement les autorisations nécessaires
   • Afficher des explications claires avant de demander
   • Tester les flux « Refuser » (l'application devrait toujours fonctionner)
   • Vérifier les descriptions de Info.plist sont claires

5. Préparer un compte de test

   • Créer un compte de revue qui reste valide pendant la revue
   • Documenter les informations de connexion dans les informations de revue de l'application
   • Vérifier que le réviseur peut atteindre la barrière payante et terminer le flux de paiement
   • Inclure des comptes supplémentaires ou des commutateurs spécifiques à l'application dans le champ Notes si nécessaire

6. Vérifier les métadonnées

   • Les captures d'écran correspondent à l'interface utilisateur actuelle
   • L'URL de support inclut des informations de contact réelles
   • L'URL de la politique de confidentialité est remplie
   • La note d'âge correspond au contenu dans la build
   • La vidéo de prévisualisation de l'application (si elle existe) montre la version actuelle
   • La description décrit avec précision les fonctionnalités
   • La politique de confidentialité est accessible en ligne et depuis la liste des applications

7. Écrire des notes de revue détaillées

   Contact:
   Name: Jane Developer
   Email: review@yourapp.com
   Phone: +1 555-0100
   
   Test Account:
   Email: reviewer@test.com
   Password: TestPass123!
   This account does not expire during review.
   
   Testing Instructions:
   1. Log in with test account above
   2. Tap "Upgrade to Premium" button
   3. Select "Monthly Premium" subscription
   4. Complete purchase (no charge in sandbox)
   5. Verify premium features unlock
   
   Note: Subscription pricing is clearly shown before purchase.
   Cancellation instructions are in Settings > Account.

Ligne du temps de revue

Révision standard : 24-48 heures Périodes de pointe : 3-5 jours (lancements de l'App Store pendant les vacances) Week-ends : Aucun avis n'est traité Examen accéléré : Disponible pour les correctifs critiques de bogues (demande via App Store Connect)

États courants que vous verrez dans App Store Connect :

• Waiting for Review
• In Review
• Pending Developer Release
• Rejected

Conseil

Soumettez vos applications dès le début de la semaine pour éviter les retards des week-ends. Les soumissions du lundi sont généralement examinées par mercredi.

Focus de soumission 2026

Domaines d'attention actuels

1. Clarté des abonnements

• Comparaisons de plans de côté à côté requises
• Aucun schéma « sombre » qui masque les options moins chères
• Itinéraires de dégradation/amelioration clairs

2. Exactitude des métadonnées

• Les captures d'écran doivent correspondre à la version du build en cours de revue
• Les captures d'écran iPad sont requises si le support iPad est activé
• L'URL de support et la politique de confidentialité doivent déjà être en ligne avant la soumission

3. Qualité des détails de la revue et confidentialité

• Les déclarations de confidentialité doivent correspondre à ce que vos SDK collectent réellement
• Les informations de contact et les notes de la revue de l'application doivent être complètes lors de la première soumission
• Les informations de démo doivent rester valides pendant toute la fenêtre de revue

4. Préparation de la soumission

• Apple met à jour régulièrement les exigences minimales SDK, assurez-vous donc de confirmer la date limite actuelle avant de télécharger une version de production
• TestFlight est le lieu le plus sûr pour vérifier le chemin exact du réviseur avant de soumettre

Meilleures pratiques pour le plugin d'achats natifs

Mettre en œuvre un traitement correct des erreurs

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

async function handlePurchase(productId: string) {
  try {
    const transaction = await NativePurchases.purchaseProduct({
      productIdentifier: productId,
      productType: PURCHASE_TYPE.SUBS,
    });

    // Success
    await validateReceiptOnServer(transaction.receipt);
    showSuccess('Subscription activated!');
    unlockFeatures();

  } catch (error: any) {
    // Handle specific error cases
    if (error.code === 'USER_CANCELLED') {
      // User cancelled - don't show error
      console.log('Purchase cancelled by user');
    } else if (error.code === 'PAYMENT_PENDING') {
      showInfo('Payment is pending. Please check back later.');
    } else if (error.code === 'PRODUCT_ALREADY_PURCHASED') {
      // Restore instead
      await NativePurchases.restorePurchases();
    } else {
      // Show user-friendly error
      showError('Unable to complete purchase. Please try again.');
    }
  }
}

Afficher les états de chargement

function PurchaseButton({ productId }: { productId: string }) {
  const [loading, setLoading] = useState(false);

  const handlePurchase = async () => {
    setLoading(true);
    try {
      await NativePurchases.purchaseProduct({ productIdentifier: productId });
    } finally {
      setLoading(false);
    }
  };

  return (
    <button onClick={handlePurchase} disabled={loading}>
      {loading ? 'Processing...' : 'Subscribe Now'}
    </button>
  );
}

Afficher les termes clairement

function SubscriptionTerms() {
  return (
    <div className="terms">
      <p>
        Subscription automatically renews unless cancelled at least 24 hours
        before the end of the current period.
      </p>
      <p>
        Your account will be charged for renewal within 24 hours prior to
        the end of the current period.
      </p>
      <p>
        Subscriptions may be managed by the user and auto-renewal may be
        turned off in Account Settings after purchase.
      </p>
      <p>
        <a href="/terms">Terms of Service</a> |
        <a href="/privacy/">Privacy Policy</a>
      </p>
    </div>
  );
}

Si votre application est rejetée

Étapes pour résoudre le problème

1. Lisez attentivement le rejet

   • Notez la norme spécifique citée (par exemple, 3.1.1, 5.1.1)
   • Comprenez exactement ce que Apple a signalé

2. Réparez le problème de manière approfondie

   • N'appliquez pas juste une solution de contournement - corrigez la cause racine
   • Testez la correction de manière approfondie
   • Documentez les modifications apportées

3. Répondez dans le Centre de Résolution

   Thank you for your feedback. I have addressed the issue:
   
   Issue: Subscription pricing not clear upfront
   
   Fix: Added explicit pricing display on subscription selection
   screen showing "$9.99/month" before purchase button. Also added
   cancellation instructions on the same screen.
   
   The changes are in this submission and can be tested using the
   provided test account.

4. Résubmittez rapidement

   • Les résubmissions sont généralement examinées plus rapidement
   • Généralement en 24 heures

Procédure d'Appel

Si vous pensez que la réjection est incorrecte :

1. Cliquez sur « Appelez l'attention » dans App Store Connect
2. Fournissez des preuves claires :
   • Captures d'écran montrant le respect des normes
   • Références à des lignes directrices spécifiques
   • Explication de la manière dont vous respectez les exigences
3. Soyez professionnel et factuel
4. Incluez un compte de test si la fonctionnalité est difficile à trouver

Ressources supplémentaires

• Lignes directrices de revue de l'App Store d'Apple
• Lignes directrices relatives aux achats en application
• Pratiques de souscriptions
• Aide de Apple App Store Connect
• Spécifications des captures d'écran
• Informations sur les versions de plateforme

Aide

Si vous rencontrez toujours des problèmes :

• Vérifiez les Documentation des achats natifs
• Vérifiez les Problèmes de dépannage courants
• Contactez le support Apple Developer pour des clarifications sur les lignes directrices

Besoin d'aide experte?

Vous avez du mal avec la revue de l'application ou avez besoin d'une assistance personnalisée? Réservez un appel de consultation avec notre équipe pour un soutien dédié avec :

• Révision et optimisation de l'implémentation de l'IAP
• Préparation et stratégie de revue de l'App Store
• Révision du checklist de soumission
• Résolution de rejets et recours
• Test complet et validation

Nos experts ont aidé avec succès des centaines d'applications à passer la revue!

__CAPGO_KEEP_0__

Si vous utilisez les lignes directrices de la boutique iOS pour les achats en application pour planifier l'approbation et la distribution de la boutique, connectez-le avec En utilisant @capgo/achats-natifs pour la capacité native dans En utilisant @capgo/achats-natifs, @capgo/capacitor-avis-de-lecture-en-ligne pour le détail d'implémentation dans @capgo/capacitor-avis-de-lecture-en-ligne, En utilisant @capgo/capacitor-avis-de-lecture-en-ligne pour la capacité native dans En utilisant @capgo/capacitor-avis-de-lecture-en-ligne, @capgo/capacitor-marché-natif pour le détail d'implémentation dans @capgo/capacitor-marché-natif, et Utilisez @capgo/capacitor-marché-natif pour la capacité native dans Utilisez @capgo/capacitor-marché-natif.