KappS Wissensdatenbank · Blog

App Store Externe Kauf-Links in 2026

Blog Tutorial

App-Review-Richtlinie 3.1.1 verlangt weiterhin, dass digitale Güter und Dienste, die in einer App Store-App verkauft werden, In-App-Käufe nutzen – doch die Liste der Ausnahmen ist erneut gewachsen, und 2026 gibt es drei verschiedene Wege, auf denen eine konforme App einen Kunden zu einer eigenen Zahlungsseite führen kann. Der aktuelle Wortlaut von Richtlinie 3.1.1(a) sagt es klar: Entwickler können Berechtigungen beantragen, um in ihrer App einen Link zu einer Website einzubinden, die sie besitzen oder für die sie die Verantwortung tragen, und – der Satz, der für US-Publisher am wichtigsten ist – „Diese Berechtigungen sind nicht erforderlich, damit Entwickler in ihren Apps im US-Storefront Schaltflächen, externe Links oder andere Handlungsaufrufe einbinden können.“ In jedem anderen Storefront dürfen Apps und ihre Metadaten laut derselben Richtlinie keine Schaltflächen, externen Links oder andere Handlungsaufrufe enthalten, die Kunden zu anderen Kaufmechanismen als In-App-Käufen führen.

Die Kurzfassung: Der US-Storefront benötigt keinerlei Entitlement; das com.apple.developer.storekit.external-purchase-link-Entitlement deckt die iOS/iPadOS Storefronts ab, in denen Apple einen Link nach außen erlaubt; und das neuere Entitlement für benutzerdefinierte Kauf-Links ist regionsgebunden, wobei Brasilien und Japan zu den EU-Ländercodes hinzukommen. ExternalPurchaseLink sagt Ihnen zur Laufzeit, ob davon etwas zutrifft, eligibleURLs und open(url:) öffnen den Link tatsächlich, und jedes zurückkommende Token muss über die External Purchase Server API gemeldet werden.

Schritt 1 — Ermitteln Sie, auf welcher der drei Routen Ihre App läuft

Route eins ist der US-Storefront: Link-outs sind ohne Entitlement erlaubt, und die Richtlinie sagt das ausdrücklich. Route zwei ist com.apple.developer.storekit.external-purchase-link, auch bekannt als StoreKit External Purchase Link Entitlement – Apple selbst fasst es so zusammen, dass es „qualifizierten Apps ermöglicht, einen Link einzubinden, der Nutzerinnen und Nutzer der App auf eine Website führt, um einen externen Kauf zu tätigen“, und die Entitlement-Vereinbarung beschränkt diesen Link darauf, darüber zu informieren, wo und wie In-App-Artikel gekauft werden können, einschließlich des Hinweises, dass sie möglicherweise zu einem vergleichsweise niedrigeren Preis erhältlich sind. Route drei ist com.apple.developer.storekit.custom-purchase-link.allowed-regions: ein Entitlement, das „einer qualifizierten App ermöglicht, in bestimmten Regionen externe Käufe innerhalb der App oder auf einer Website anzubieten“, und dessen Wert kein Boolean ist, sondern ein Array aus zweistelligen ISO-3166-1-Codes. Wie dokumentiert, umfassen die zulässigen Regionen für benutzerdefinierte Kauf-Links Brasilien (br), Japan (jp) und die EU-Ländercodes – Österreich, Belgien, Bulgarien, Kroatien, Zypern, Tschechien, Dänemark, Estland, Finnland, Frankreich, Deutschland, Griechenland, Ungarn, Irland, Italien, Lettland, Litauen, Luxemburg, Malta, Niederlande, Polen, Portugal, Rumänien, Slowakei, Slowenien, Spanien und Schweden.

Bevor Sie Code schreiben, listen Sie die Storefronts auf, in denen Sie tatsächlich ausliefern. Ein einziger globaler Link, der die Storefront-Grenze ignoriert, ist der häufigste Weg, auf dem diese Funktion zu einer Ablehnung wird.

Schritt 2 — Übertragen Sie die Entitlement auf Ihr Signaturprofil

Entitlements werden pro Entwicklerkonto gewährt, nicht pro Store-Eintrag, und Apple nennt die Einschränkung direkt: Die Entitlements „sind auf die Nutzung ausschließlich im iOS oder iPadOS App Store in bestimmten Storefronts beschränkt." Sobald das Konto das StoreKit External Purchase Link-Entitlement erhält, fügen Sie es Ihrer App hinzu, indem Sie die Datei .entitlements des Projekts in Xcode öffnen, den Schlüssel com.apple.developer.storekit.external-purchase-link hinzufügen und seinen Wert auf true setzen. Für die regionsbezogene Variante lautet der Schlüssel com.apple.developer.storekit.custom-purchase-link.allowed-regions, und der Wert ist ein Array der kleingeschriebenen Ländercodes, in denen Sie die Funktionalität anbieten möchten – Apple formuliert es so, dass es „nur Regionen enthalten darf, in denen Apple benutzerdefinierte Kauf-Link-Optionen unterstützt."

Da eine Berechtigung an das Provisioning-Profil gebunden ist, lautet die praktische Reihenfolge: beantragen, warten bis die Funktion erscheint, Profile neu generieren, neu signieren, dann hochladen. Ein Build, der mit einem alten Profil signiert wurde, kann den Link schlicht nicht öffnen, und der Fehler zeigt sich zur Laufzeit statt beim Build.

Schritt 3 — Die Ziel-URLs in Info.plist konfigurieren

Zwei Property-List-Schlüssel erledigen die Arbeit, und die Wahl des richtigen entscheidet darüber, welche API Sie aufrufen. SKExternalPurchaseLink ist ein Dictionary, dessen Schlüssel kleingeschriebene ISO-3166-1-Alpha-2-Ländercodes sind – eine Ziel-URL pro Ländercode. Apple listet die gültigen Codes auf: die siebenundzwanzig EU-Mitgliedstaaten plus Island (is), Norwegen (no) und Russland (ru). SKExternalPurchaseMultiLink ist die Multi-Link-Variante: dieselbe Dictionary-Struktur, aber jeder Ländercode verweist auf ein Array mit einer bis fünf Ziel-URLs.

Jede Ziel-URL muss vier Bedingungen erfüllen, und die vierte wird oft übersehen: Sie muss das HTTPS-Schema verwenden, eine gültige absolute URL bilden, keine Query-Parameter enthalten und aus höchstens 1.000 ASCII-Zeichen bestehen. Darüber hinaus stellt Apple fest: „Die Ziel-URLs, die Sie im Property-List-Schlüssel angeben, müssen jederzeit mit den Werten in Ihrer App-Binary übereinstimmen, die Sie zur App-Prüfung einreichen" – die URLs sind also faktisch Teil Ihrer Prüfungseinreichung, und sie zu ändern ist ein Release, keine Konfigurationsänderung.

MultiLink ist nicht für alle verfügbar: Sie können einen oder mehrere Links pro Ländercode bereitstellen, wenn Ihre App für das StoreKit-External-Purchase-Link-Entitlement qualifiziert ist, wie Apple es beschreibt; andernfalls stellen Sie genau einen Link pro Ländercode bereit.

Schritt 4 — Sperren Sie die UI mit canOpen, bevor Sie etwas zeichnen

canOpen ist ein Boolean, der die Frage beantwortet: „Kann diese App den konfigurierten externen Kauflink im aktuellen App Store-Storefront erfolgreich öffnen?“ Apple dokumentiert genau drei Bedingungen, die alle erfüllt sein müssen: Der aktuelle Storefront erlaubt externe Käufe und die Person ist berechtigt, externe Käufe zu tätigen; Ihre App konfiguriert die Entitlement com.apple.developer.storekit.custom-purchase-link.allowed-regions oder com.apple.developer.storekit.external-purchase-link; und Ihre App konfiguriert einen Link für den aktuellen Storefront. Alles andere ergibt false. Eine erneute Prüfung ist nur nötig, wenn sich der App Store-Storefront ändert – Sie können den Wert also einmal beim Start auswerten und Ihre Paywall-Oberfläche anhand des Ergebnisses steuern. Wenn er false ist, besteht der dokumentierte Fallback darin, canMakePayments zu prüfen und beim In-App-Kauf zu bleiben.

Schritt 5 — Den Link öffnen: open() oder open(url:)

Mit einem einzelnen konfigurierten Link rufen Sie ExternalPurchaseLink.open() auf. Mit dem Multi-Link-Schlüssel lesen Sie eligibleURLs – das Array der Links, die die App für den aktuellen Storefront konfiguriert hat – und rufen open(url:) mit dem von Ihnen gewählten auf, als Reaktion auf eine bewusste Nutzerinteraktion wie das Tippen auf eine Schaltfläche. Apple stellt ausdrücklich klar, dass eligibleURLs in drei Situationen nil zurückgibt: der Storefront erlaubt keinen externen Kauf oder die Person ist nicht berechtigt; die Berechtigung fehlt; oder es sind keine Links für den aktuellen Storefront konfiguriert. Nil plus ein konfigurierter SKExternalPurchaseLink bedeutet Rückgriff auf canOpen; nil ohne einen bedeutet Rückgriff auf canMakePayments.

open(url:) ist asynchron und zeigt ein Fortsetzungsblatt an, auf dem die Person wählen kann, ob die App den externen Kauflink anzeigt. Die Methode kehrt zurück, bevor das Blatt angezeigt wird, und kann einen StoreKitError auslösen, wenn die Berechtigung fehlt, für den Storefront kein Link konfiguriert ist, der Storefront keine externen Käufe unterstützt, die Person nicht berechtigt ist oder ein Netzwerk- oder Systemfehler auftritt. Entscheidet sich die Person fortzufahren, öffnet StoreKit Ihre URL im Standardbrowser und hängt ein externes Kauftoken sowie die Bundle-ID der App an — genau dieses Token ist der ganze Grund, warum es den Reporting-Schritt gibt.

Schritt 6 — Melden Sie jedes Token über die External Purchase Server API

Die External Purchase Server API ist eine REST-API, die Sie von Ihrem eigenen Server aus aufrufen, um „externe Kauftokens und die Transaktionen Ihrer Kunden im Zusammenhang mit den Tokens zu melden“. Die Anweisung ist nicht optional und nicht auf erfolgreiche Verkäufe beschränkt: Melden Sie alle Tokens, auch solche, die zu keiner Transaktion geführt haben. Konkret nennt Apple vier Fälle, die jeweils eine Meldung erfordern – ein Token mit Positionen, wenn ein Kunde eine oder mehrere Transaktionen abschließt; ein Token ohne Positionen, wenn der Kunde keine abschließt; ein nicht erkanntes Token, wenn eine App Store-Server-Benachrichtigung für ein Token eingeht, zu dem Sie keinen Eintrag haben; sowie doppelte ACQUISITION- und SERVICES-Tokens. Die Autorisierung erfolgt über JSON Web Tokens, die aus API-Schlüsseln erstellt werden, die Sie in App Store Connect anlegen.

Wenn Sie bereits App Store Server Notifications V2 nutzen, ist die Reporting-Pipeline der natürliche Einstiegspunkt: Die Benachrichtigung meldet, dass ein Token existiert, Ihr Store erfasst die Transaktion, und der Report der External Purchase Server API schließt den Kreis.

Schritt 7 – Behalten Sie die Storefront-Grenze im Blick

Alles oben Genannte wird durch einen Satz begrenzt, der in der Prüfrichtlinie und der Berechtigung wiederholt wird: Berechtigungen sind auf den iOS oder iPadOS App Store in bestimmten Storefronts beschränkt, und außerhalb der US-Storefront dürfen die App und ihre Metadaten keine Buttons, externen Links oder sonstigen Handlungsaufforderungen enthalten, die Kunden zu Kaufmechanismen außer In-App-Käufen führen. Diese Grenze gilt auch für Metadaten – ein Screenshot, der einen externen Checkout in einer Storefront zeigt, in der Links nicht erlaubt sind, ist ein Ablehnungsrisiko und keine Marketingentscheidung.

Stolperfallen, die einen zweiten Blick wert sind

  • Query-Parameter sind unzulässig. Tracking-Parameter in der Ziel-URL verstoßen gegen die dokumentierten URL-Regeln; die Attribution trägt allein das Token, das StoreKit anhängt.
  • Die Berechtigung ist eine Signierfähigkeit, keine Servereinstellung. Das Hinzufügen des Schlüssels zu .entitlements ohne die gewährte Fähigkeit erzeugt ein Profil, das sie nicht nutzen kann.
  • URLs müssen jederzeit mit dem Binary übereinstimmen. Eine neue Ziel-URL zu entwerfen, ohne ein Release zu veröffentlichen, ist eine Abweichung, die Apple als Anforderung und nicht als Präferenz dokumentiert.
  • Ein Link pro Land, sofern Sie nicht für MultiLink qualifiziert sind. Ein Array mit fünf URLs in einem Storefront, in dem nur ein Link erlaubt ist, ist ein Prüfproblem.
  • Nur US-Apps brauchen nichts. Wenn Ihre Store-Einträge nur für die USA gelten, erlaubt Richtlinie 3.1.1(a) bereits den Link-out – legen Sie keine Profilfunktion an, die Sie nicht brauchen.

Wo Sie anfangen sollten

Schreiben Sie Ihre Storefront-Liste auf, markieren Sie jede als US, Entitlement-Region, Region für benutzerdefinierte Kauf-Links oder keine, und implementieren Sie das Gate dann einmal: Prüfen Sie canOpen (oder eligibleURLs bei mehreren Links), zeigen Sie das Steuerelement nur an, wenn true zurückgegeben wird, und lassen Sie den In-App-Kauf für alle anderen den Standardweg bleiben. Die Token-Anbindung auf Ihrem Server entscheidet darüber, ob das Feature auch nach dem Launch compliant bleibt.

Sie verwalten Entwicklerkonten im großen Stil? Wir übernehmen die operative Seite.

Klicken Sie, um eine Datei auszuwählen · Rechtsklick → Einfügen oder Ctrl/⌘+V drücken, um einen Screenshot einzufügen

Sie können eine Datei auch auf dieses Feld ziehen.

Wir antworten an die von Ihnen angegebene E-Mail-Adresse. Ihre Daten bleiben bei KappS.

✔ Eingereicht

Wir haben Ihre Nachricht erhalten und antworten innerhalb von 24 Stunden.


← Zurück zum Bearbeiten