Skip to main content
This article explains how to set up a Universal Link for redirecting iOS players from the checkout back to your app. To configure a Universal Link:
  1. Set up a dedicated subdomain. For example, my-subdomain.appcharge.com. For more information, see Apple’s official guide on supporting associated domains.
  2. On this subdomain, host a public .well-known/apple-app-site-association file. This file allows iOS to recognize the redirect URL as a Universal Link, so your app can open automatically after payment. Without this file, players will see a confirmation dialog asking if they want to open the app.
    Note: The file cannot be a .json extension, and must be served with the application/json MIME type.
  3. Run the following command with your domain to verify the MIME type:
    curl
    curl -I https://my-subdomain.appcharge.com/.well-known/apple-app-site-association
    The file content should follow this structure:
    json
    {
"applinks": {
    "details": [
    {
        "appIDs": [
        "{YOUR_TEAM_ID}.{YOUR_BUNDLE_ID}"
        ],
        "components": [
        {
            "/": "/checkout*",
            "comment": "Matches any URL whose path starts with /checkout"
        }
        ]
    }
    ]
}
}
    Make sure to prefix your App ID with your Apple Developer Team ID, located on the Apple Developer Membership page.
When a purchase is completed, this link redirects the player back to your app.