Set Up a Universal Link (iOS)

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:

Set up a dedicated subdomain. For example, my-subdomain.appcharge.com. For more information, see Apple’s official guide on supporting associated domains.
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.

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.

Migrate to the Payment Links SDK Set Up a Deep Link (Android)

⌘I

Overview

Appcharge AI

Web Store

Checkout

Game Portal

Payment Links

Events Center

Translations

Measurement Tools

Integrations