Aller directement au contenu

Lignes directrices de la boutique iOS pour les achats in-app

GitHub

Pour obtenir l'approbation de votre application sur l'App Store, il est essentiel de prêter attention aux directives d'Apple, en particulier lors de l'implémentation des achats en application et des abonnements. Cette guide couvre tout ce dont vous avez besoin pour passer la revue lors de votre première soumission.

Processus de revue de l'App Store iOS

Avant que Apple ne passe en revue votre flux d'achat, assurez-vous que l'enregistrement de l'application soit complet :

  • Ajoutez un URL de la politique de confidentialité dans App Store Connect
  • Ajoutez un Adresse de support qui mène à des informations de contact réelles pour les utilisateurs
  • Terminez le questionnaire d'âge de rating pour que l'application soit publiable Ajoutez
  • Détails de contact de la revue d'application et des notes de réviseur claires Si un connexion est requise, fournissez un
  • compte de démonstration qui ne expire pas pendant la revue __CAPGO_KEEP_0__
Méta-données de la liste de l'App Store avec liens de politique et de support
  • Utilisez les écrans actuels provenant de la build réelle en examen
  • Pour iPhone, 1290 x 2796 (6.7 pouces) est la taille par défaut la plus facile
  • Si votre application fonctionne sur iPad, téléchargez également des écrans d'iPad
  • Les tailles d'iPad acceptées actuellement incluent 2064 x 2752 (13 pouces) et 2048 x 2732 (12.9 pouces)
  • Ne déforme jamais les captures d'écran iPhone pour simuler la compatibilité iPad

Effectuez une simulation de la démarche de la révision dans TestFlight

Section intitulée « Effectuez une simulation de la démarche de la révision dans TestFlight »

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

  • Installez la dernière version depuis TestFlight
  • Connectez-vous avec le compte de révision que vous prévoyez fournir
  • Parvenez à la barrière de paiement sans utiliser de gestes cachés ou de menus de débogage
  • Terminez les 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

Apple exige une transparence totale des tarifs avant toute achat :

Éléments obligatoires :

  • Afficher le prix exact avant le bouton d'achat
  • Afficher la fréquence de facturation (par exemple, « $9,99 $/mois »)
  • État clair de ce que les utilisateurs obtiennent pour leur argent
  • Indiquer quand les factures seront émises

Rejet commun :

“Les tarifs de souscription doivent être clairs et explicites.”

:::⚕ Prévenir les incohérences de prix Tous les prix doivent correspondre à :

  • Liste de métadonnées de l'App Store
  • Écrans de paiement intégré
  • Écrans de gestion d'abonnement

Même une différence de 1 $ entre la liste de magasin (4,99 $) et l'application (5,99 $) déclenchera une réjection automatique.

Présentation du plan d'abonnement

Informations obligatoires :

Affichage de tous les niveaux d'abonnement disponibles ensemble

  • Comparaison claire des fonctionnalités par niveau
  • Pas de redirige vers les niveaux premium par des astuces de l'interface
  • Instructions de suppression faciles à localiser
  • Conseils de conception de l'interface : oui et non

Paywall avec restauration d'achats et liens juridiques

Paywall avec restauration d'achats et liens juridiques

Exemple de UI 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>
);
}

Implémentation requise :

Tout application avec IAP doit fournir un moyen pour les utilisateurs de récupérer 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>

Pourquoi cela échoue :

  • Les applications s'effondrent lors du lancement
  • Le flux d'achat ne se termine pas
  • 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 tous les flux de souscription de bout en bout
  • Vérifiez que la validation de la réception fonctionne
  • Vérifiez la gestion des erreurs de réseau

Pourquoi cela ne fonctionne pas :

  • Les captures d'écran montrent des fonctionnalités non présentes dans la dernière version
  • Description mentionne des fonctionnalités qui n'existent pas
  • Le prix dans les métadonnées diffère du prix en application

Liste de vérification des métadonnées

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 sur les permissions

Pourquoi cela ne fonctionne pas :

Demande de la caméra/lieu/santé sans explication

  • Demandes de permissions enterrées plusieurs écrans plus loin
  • Descriptions de permissions vagues ou génériques
  • Prévention :

Section intitulée “3. Explications manquantes sur les permissions”

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

Permission de copie qui est trop vague pour examen Permission de copie avec des explications plus 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>

Pourquoi cela ne fonctionne pas :

  • Des prétentions comme « l’application n°1 dans le monde » sans preuve
  • Des fonctionnalités « illimitées » qui ont des limites cachées
  • Des tactiques d’urgence fausses (« Seulement 2 places restantes ! »)

Exemples de lignes directrices de description

Lignes directrices supplémentaires de description

Prévention :

  • Soyez spécifique et factuel dans les descriptions
  • Évitez les superlatifs sans preuves
  • N’imposez pas aux utilisateurs une fausse pénurie

Pourquoi cela ne fonctionne pas :

  • Pas de mention de la façon de se désinscrire
  • Bouton d'annulation caché ou obscurci
  • Processus de désinscription en 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é & Utilisation des données (Section 5.1.1)

Section intitulée « Confidentialité & Utilisation des données (Section 5.1.1) »

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

Pour chaque autorisation :

  1. Pourquoi vous en avez besoin (utilisation spécifique)
  2. Lorsqu'il sera utilisé
  3. Comment les données sont stockées/ partagées
  4. Est-ce qu'il s'agit d'une option ou d'une obligation ?
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';
}

Assurez-vous que les étiquettes de la vie privée de votre magasin d'applications 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 la vie privée inexactes constituent une raison courante de refus en 2025. Auditez soigneusement la collecte de vos données.

Vérifiez la liste de contrôle avant la soumission

  1. Testez tous les flux d'achat

    • 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
  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 toutes les devises sont correctes
    • Confirmez que les durées des essais gratuits correspondent aux descriptions
    • Vérifiez les conditions de l'offre d'introduction sont exactes
  3. Révisez tous les textes

    • Supprimez le texte de remplacement
    • Vérifiez que les affirmations sont testables
    • Vérifiez l'orthographe et la grammaire
    • Assurez-vous que les descriptions correspondent à la version actuelle
    • Supprimez les mentions des concurrents
  4. Testez les autorisations

    • Demandez uniquement les autorisations nécessaires
    • Montrez des explications claires avant de demander
    • Testez les flux de refus (l'application devrait toujours fonctionner)
    • Vérifiez que les descriptions d'Info.plist sont claires
  5. Préparez un compte de test

    • Créez un compte de revue qui reste valide pendant la revue
    • Documentez les informations de connexion dans les informations de revue de l'application
    • Vérifiez que le réviseur peut atteindre la barrière payante et terminer le flux de paiement
    • Incluez des comptes supplémentaires ou des commutateurs spécifiques à l'application dans le champ Notes si nécessaire
  6. Vérifiez 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 application et depuis la liste de l'application
  7. Écrire des notes de révision 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.

Chronologie de la révision de l'App Store

Révision standard : 24-48 heures Périodes de pointe : 3-5 jours (lancements d'applications de l'App Store pendant les vacances) Week-ends : Aucune révision traitée Examen accéléré : Déposé 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

1. Clarté des abonnements

  • Comparaisons de plans de côté à côté requises
  • No “dark patterns” qui masquent des options moins chères
  • Des chemins de dégradation/amélioration clairs

2. Précision des métadonnées

  • Les captures d'écran doivent correspondre à la version du build en revue
  • Les captures d'écran iPad sont obligatoires 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 revue et de confidentialité

  • Les déclarations de confidentialité doivent correspondre à ce que vos SDK collectent réellement
  • Les informations de contact et les notes de l'App Review 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, il faut donc confirmer la date limite actuelle avant de télécharger une version de build
  • Le TestFlight est le lieu le plus sûr pour vérifier le chemin de revue exact avant de soumettre

Meilleures Pratiques pour le Plugin d'Achats Natives

Section intitulée “Meilleures Pratiques pour le Plugin d'Achats Natives”

Mettre en œuvre un Traitement des Erreurs approprié

Section intitulée “Mettre en œuvre un Traitement des Erreurs approprié”
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.');
}
}
}
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>
);
}
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>
);
}
  1. Lisez attentivement le rejet

    • Notez la règle spécifique citée (par exemple, 3.1.1, 5.1.1)
    • Comprenez exactement ce que Apple a signalé
  2. Corrigez l'erreur en profondeur

    • N'appliquez pas juste une correction - 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ésubmit immédiatement

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

Si vous pensez que la réjection est incorrecte :

Procédure de clarification de l'App Store

  1. Cliquez sur “Appel” dans App Store Connect
  2. Fournir des preuves claires :
    • Captures d'écran montrant le respect des normes
    • Références à des lignes directrices spécifiques
    • Explication de comment vous remplissez les exigences
  3. Soyez professionnel et factuel
  4. Incluez un compte de test si la fonctionnalité est difficile à trouver

Exemple de demande de documents

Si vous rencontrez toujours des problèmes :

En difficulté 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 support dédié avec :

  • révision et optimisation de l'implémentation de la facturation intégrée
  • préparation et stratégie de revue de l'App Store
  • révision du checklist de soumission
  • résolution de rejets et d'appels
  • test complet et validation

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

Continuez de la section intitulée « Continuez de la section iOS App Store Review Guidelines pour la facturation intégrée »

Section intitulée « Continuez de la section iOS App Store Review Guidelines pour la facturation intégrée »

Si vous utilisez iOS App Store Review Guidelines pour la facturation intégrée pour planifier l'approbation et la distribution de l'App Store, connectez-le avec En utilisant @capgo/achats-natifs pour la capacité native dans En utilisant @capgo/achats-natifs, @capgo/capacitor-avis-en-ligne pour le détail d'implémentation dans @capgo/capacitor-avis-en-ligne, En utilisant @capgo/capacitor-avis-en-ligne pour la capacité native dans En utilisant @capgo/capacitor-avis-en-ligne, @capgo/capacitor-marché-natif pour le détail d'implémentation dans @capgo/capacitor-marché-natif, et En utilisant @capgo/capacitor-marché-natif pour la capacité native dans En utilisant @capgo/capacitor-marché-natif.