Contents

SKExternalPurchaseLink

A dictionary that contains URLs to websites where people using your app can make external purchases for supported regions.

Properties

NameTypeDescription
Any Keystring

Discussion

Use this information property list key if your app has the com.apple.developer.storekit.external-purchase-link entitlement.

The keys for this dictionary are lowercased ISO 3166-1 alpha-2 country codes. Valid country codes include those for the European Union: Austria (at), Belgium (be), Bulgaria (bg), Croatia (hr), Cyprus (cy), Czechia (cz), Denmark (dk), Estonia (ee), Finland (fi), France (fr), Germany (de), Greece (gr), Hungary (hu), Ireland (ie), Italy (it), Latvia (lv), Lithuania (lt), Luxembourg (lu), Malta (mt), Netherlands (nl), Poland (pl), Portugal (pt), Romania (ro), Slovakia (sk), Slovenia (si), Spain (es), Sweden (se); and Iceland (is), Norway (no), and Russia (ru).

Include one key entry for each country code where your app supports an external purchase link. Provide a destination URL (link to your website) for your app to open when the country code in the key matches the device’s App Store storefront. If you support multiple country codes, you may provide the same or different destination URLs for each country code.

Make sure the destination URL meets all of the following conditions:

  • Uses the HTTPS scheme

  • Forms a valid, absolute URL

  • Contains no query parameters

  • Contains 1,000 or fewer ASCII characters.

The following code example shows a property list entry with a single country code key, for the Netherlands (nl). Replace the string “https://example.com” below with your link:

<plist>
<dict>
    <key>SKExternalPurchaseLink</key>
    <dict>
        <key>nl</key>
        <string>https://example.com</string>
    </dict>
</dict>
</plist>

The following code example shows a property list entry with keys for more than one country code. Replace the “https://example.com” strings with your links:

<plist>
<dict>
    <key>SKExternalPurchaseLink</key>
    <dict>
        <key>at</key>
        <string>https://ex1.example.com</string>
        <key>nl</key>
        <string>https://ex2.example.com</string>
        <key>it</key>
        <string>https://ex2.example.com</string>
    </dict>
</dict>
</plist>

For more information, see External Purchase.

See Also

StoreKit