App Store Liens d’achat externes en 2026
La directive 3.1.1 de l’examen de l’application impose toujours que les biens et services numériques vendus dans une application App Store passent par l’achat intégré — mais la liste des exceptions s’est encore allongée, et en 2026, trois voies différentes permettent à une application conforme d’envoyer un client vers sa propre page de paiement. Le texte actuel de la directive 3.1.1(a) le dit clairement : les développeurs peuvent demander des droits pour insérer dans leur application un lien vers un site web qu’ils possèdent ou dont ils assument la responsabilité et — la phrase qui compte le plus pour les éditeurs américains — « Ces droits ne sont pas requis pour que les développeurs incluent des boutons, des liens externes ou d’autres appels à l’action dans leurs applications destinées à la vitrine américaine. » Sur toutes les autres vitrines, la même directive précise que les applications et leurs métadonnées ne peuvent inclure de boutons, de liens externes ou d’autres appels à l’action dirigeant les clients vers des mécanismes d’achat autres que l’achat intégré.
En une phrase : la vitrine des États-Unis ne nécessite aucune autorisation ; l’autorisation com.apple.developer.storekit.external-purchase-link couvre les iOS/iPadOS vitrines où Apple autorise un lien sortant ; et la nouvelle autorisation de lien d’achat personnalisé est limitée par région, le Brésil et le Japon rejoignant les codes pays de l’UE. ExternalPurchaseLink vous indique à l’exécution si l’un de ces cas s’applique, eligibleURLs et open(url:) ouvrent réellement le lien, et chaque jeton renvoyé doit être déclaré via l’External Purchase Server API.
Étape 1 — Déterminez sur laquelle des trois voies se trouve votre application
La première voie est la vitrine américaine : les liens sortants y sont autorisés sans droit spécifique, et les règles le disent explicitement. La deuxième voie est com.apple.developer.storekit.external-purchase-link, également appelé droit StoreKit External Purchase Link — le résumé de Apple indique qu’il « permet aux applications éligibles d’inclure un lien qui dirige les utilisateurs de l’application vers un site web pour effectuer un achat externe », et l’accord relatif à ce droit limite ce lien à l’information des utilisateurs sur le lieu et la manière d’acheter des articles intégrés, y compris le fait qu’ils peuvent être disponibles à un prix comparativement inférieur. La troisième voie est com.apple.developer.storekit.custom-purchase-link.allowed-regions : un droit qui « permet à une application éligible de proposer des achats externes au sein de l’application ou sur un site web, dans des régions spécifiques », et dont la valeur n’est pas un booléen mais un tableau de codes ISO-3166-1 à deux lettres. Comme documenté, les régions autorisées pour les liens d’achat personnalisés incluent le Brésil (br), le Japon (jp) et les codes des pays de l’UE — Autriche, Belgique, Bulgarie, Croatie, Chypre, Tchéquie, Danemark, Estonie, Finlande, France, Allemagne, Grèce, Hongrie, Irlande, Italie, Lettonie, Lituanie, Luxembourg, Malte, Pays-Bas, Pologne, Portugal, Roumanie, Slovaquie, Slovénie, Espagne et Suède.
Avant d’écrire la moindre ligne de code, listez les storefronts où vous publiez réellement. Un lien global unique qui ignore la frontière du storefront est la façon la plus courante dont cette fonctionnalité se transforme en rejet.
Étape 2 — Obtenir l'autorisation sur votre profil de signature
Les droits sont accordés par compte développeur, et non par fiche App Store, et Apple énonce directement la limitation : les droits « sont limités à une utilisation uniquement dans le iOS ou le iPadOS App Store sur des vitrines spécifiques. » Une fois que le compte reçoit le droit StoreKit External Purchase Link, vous l'ajoutez à votre application en ouvrant le fichier .entitlements du projet dans Xcode, en ajoutant la clé com.apple.developer.storekit.external-purchase-link et en lui donnant la valeur true. Pour la variante limitée à une région, la clé est com.apple.developer.storekit.custom-purchase-link.allowed-regions et la valeur est un tableau des codes pays en minuscules où vous comptez proposer la fonctionnalité — la formulation de Apple est qu'elle « ne doit inclure que les régions où Apple prend en charge les options de lien d'achat personnalisé. »
Comme une entitlement est liée au profil de provisionnement, la séquence pratique est la suivante : faire la demande, attendre l’apparition de la capacité, régénérer les profils, re-signer, puis envoyer. Un build signé avec un ancien profil ne pourra tout simplement pas ouvrir le lien, et l’échec apparaît à l’exécution plutôt qu’à la compilation.
Étape 3 — Configurer les URL de destination dans Info.plist
Deux clés de liste de propriétés font le travail, et choisir la bonne détermine l'API que vous appelez. SKExternalPurchaseLink est un dictionnaire dont les clés sont des codes pays ISO 3166-1 alpha-2 en minuscules — une URL de destination par code pays. Apple liste les codes valides : les vingt-sept États membres de l'UE plus l'Islande (is), la Norvège (no) et la Russie (ru). SKExternalPurchaseMultiLink est la variante multi-liens : même structure de dictionnaire, mais chaque code pays pointe vers un tableau d'une à cinq URL de destination.
Chaque URL de destination doit satisfaire quatre conditions, et la quatrième est celle que l'on oublie : elle doit utiliser le schéma HTTPS, former une URL absolue valide, ne contenir aucun paramètre de requête et compter 1 000 caractères ASCII ou moins. En outre, Apple précise que « À tout moment, les URL de destination que vous fournissez dans la clé de la liste de propriétés doivent correspondre aux valeurs présentes dans le binaire de votre application que vous soumettez à l'examen App Review » — les URL font donc de facto partie de votre soumission à l'examen, et les modifier relève d'une version, pas d'une simple modification de configuration.
MultiLink n'est pas accessible à tous : vous pouvez fournir un ou plusieurs liens par code pays si votre application est éligible à l'entitlement StoreKit External Purchase Link tel que Apple le décrit ; sinon, vous fournissez exactement un lien par code pays.
Étape 4 — Conditionnez l’interface avec canOpen avant de dessiner quoi que ce soit
canOpen est un booléen qui répond à la question « cette application peut-elle ouvrir avec succès le lien d’achat externe configuré dans la vitrine App Store actuelle ? » Apple documente exactement trois conditions qui doivent toutes être réunies : la vitrine actuelle autorise l’achat externe et la personne est éligible aux achats externes ; votre application configure l’autorisation com.apple.developer.storekit.custom-purchase-link.allowed-regions ou com.apple.developer.storekit.external-purchase-link ; et votre application configure un lien pour la vitrine actuelle. Tout le reste vaut false. Inutile de le revérifier sauf si la vitrine App Store change, ce qui signifie que vous pouvez l’évaluer une fois au lancement et piloter l’interface de votre paywall à partir du résultat. Lorsqu’il vaut false, le repli documenté consiste à vérifier canMakePayments et à rester sur l’achat intégré.
Étape 5 — Ouvrir le lien : open() ou open(url:)
Avec un seul lien configuré, appelez ExternalPurchaseLink.open(). Avec la clé multi-liens, lisez eligibleURLs — le tableau des liens configurés par l’application pour la vitrine actuelle — et appelez open(url:) avec celui que vous choisissez, en réponse à une interaction délibérée de l’utilisateur, comme un appui sur un bouton. Apple précise explicitement que eligibleURLs renvoie nil dans trois situations : la vitrine n’autorise pas l’achat externe ou la personne n’est pas éligible ; l’autorisation est absente ; ou aucun lien n’est configuré pour la vitrine actuelle. Nil avec un SKExternalPurchaseLink configuré signifie un repli sur canOpen ; nil sans lien configuré signifie un repli sur canMakePayments.
open(url:) est asynchrone et présente une feuille de continuation qui permet à la personne de choisir si l'application affiche le lien d'achat externe. Elle renvoie avant la présentation de la feuille et peut lever une StoreKitError lorsque l'ayant droit est absent, qu'aucun lien n'est configuré pour la vitrine, que la vitrine ne prend pas en charge les achats externes, que la personne n'est pas éligible ou qu'une erreur réseau ou système survient. Si la personne choisit de continuer, StoreKit ouvre votre URL dans le navigateur par défaut et y ajoute un jeton d'achat externe ainsi que l'identifiant de bundle de l'application — ce jeton est toute la raison d'être de l'étape de reporting.
Étape 6 — Déclarez chaque jeton via l’External Purchase Server API
L'External Purchase Server API est une API REST que vous appelez depuis votre propre serveur pour « signaler les jetons d'achat externe et les transactions de vos clients liées à ces jetons ». L'instruction n'est pas facultative et ne se limite pas aux ventes réussies : signalez tous les jetons, y compris ceux qui n'ont donné lieu à aucune transaction. Concrètement, Apple liste quatre cas qui exigent chacun un signalement : un jeton avec lignes d'articles lorsqu'un client finalise une ou plusieurs transactions ; un jeton sans ligne d'articles lorsque le client n'en finalise aucune ; un jeton non reconnu, lorsqu'une notification serveur App Store arrive pour un jeton dont vous n'avez aucune trace ; et les jetons ACQUISITION et SERVICES en double. L'autorisation repose sur des jetons Web JSON générés à partir des clés d'API que vous créez dans App Store Connect.
Si vous utilisez déjà App Store Server Notifications V2, le pipeline de reporting est l’endroit naturel pour vous brancher : la notification vous indique qu’un token existe, votre store enregistre la transaction et le rapport de l’External Purchase Server API boucle la boucle.
Étape 7 — Garder la frontière de la vitrine en vue
Tout ce qui précède est encadré par une phrase répétée dans la directive et dans le droit : les droits sont limités au iOS ou au iPadOS App Store dans des vitrines spécifiques, et en dehors de la vitrine des États-Unis, l’application et ses métadonnées ne peuvent inclure de boutons, de liens externes ou d’autres appels à l’action qui dirigent les clients vers des mécanismes d’achat autres que l’achat intégré. Cette limite s’applique aussi aux métadonnées — une capture d’écran montrant un paiement externe dans une vitrine où les liens ne sont pas autorisés constitue un risque de rejet, pas un choix marketing.
Pièges à relire attentivement
- Les paramètres de requête sont interdits. Les paramètres de suivi sur l’URL de destination enfreignent les règles d’URL documentées ; c’est le jeton ajouté par StoreKit qui porte l’attribution.
- L'autorisation est une capacité de signature, pas un réglage serveur. Ajouter la clé dans
.entitlementssans la capacité accordée produit un profil qui ne peut pas l'utiliser. - Les URL doivent correspondre au binaire à tout moment. Rédiger une nouvelle URL de destination sans publication crée une incohérence que Apple documente comme une exigence, pas une préférence.
- Un lien par pays, sauf si vous êtes éligible à MultiLink. Un tableau de cinq URL dans une boutique où un seul lien est autorisé constitue un problème d'examen.
- Les applications réservées aux États-Unis n’ont rien à faire. Si vos fiches sont réservées aux États-Unis, la directive 3.1.1(a) autorise déjà le lien sortant — ne créez pas une capacité de profil dont vous n’avez pas besoin.
Par où commencer
Établissez la liste de vos storefronts, marquez chacun comme US, région d’éligibilité, région de lien d’achat personnalisé ou aucun, puis implémentez le contrôle une seule fois : vérifiez canOpen (ou eligibleURLs pour les liens multiples), n’affichez le contrôle que lorsqu’il renvoie true, et laissez l’achat intégré comme parcours par défaut pour tous les autres. La gestion des jetons côté serveur est ce qui détermine si la fonctionnalité reste conforme après la mise en ligne.
Vous gérez des comptes développeur à grande échelle ? Nous prenons en charge le volet opérationnel.
Nous avons bien reçu votre message et vous répondrons sous 24 heures.
← Retour à la modification